settings.json

allowedMcpServers

型array記述場所どの設定ファイルでも可

使用を許可する MCP サーバーのエンタープライズ・許可リスト。

記述例

{
  "allowedMcpServers": [
    { "serverCommand": ["npx", "-y", "@modelcontextprotocol/server-filesystem"] }
  ]
}

使い方・用途

  • 組織全体で利用可能な MCP サーバーを厳格に制限し、管理者が承認したサーバーのみをユーザーに利用させたい場合に設定します。
  • コマンドライン引数 --mcp-config を使用して設定ファイルを指定した場合でも、この管理ポリシーが優先的に適用され、制限の回避を防止します。
英語原文(公式ドキュメントより)

Enterprise allowlist of MCP servers that can be used. Applies to all scopes including enterprise servers from managed-mcp.json. If undefined, all servers are allowed. If empty array, no servers are allowed. Denylist takes precedence - if a server is on both lists, it is denied. See https://code.claude.com/docs/en/mcp#restriction-options

関連ドキュメント

関連する変更履歴

v2.1.305(1件)

Changed
allowedMcpServers を変更し、env 内でのみ ${VAR} を使用する managed-mcp.json の stdio サーバーをフィルタリングしないようにした。アップグレード時に許可リストに含まれないサーバーが読み込まれるため、オフのままにするには deniedMcpServers を使う。
英語原文を表示
Changed allowedMcpServers to stop filtering managed-mcp.json stdio servers that use ${VAR} only in env: one your allowlist left out now loads on upgrade; use deniedMcpServers to keep it off

変更後

allowedMcpServers の許可リストで、managed-mcp.json の stdio サーバーのうち env 内でのみ ${VAR} 展開を使うものがフィルタリングされなくなり、意図せず許可リストから漏れていたサーバーもアップグレード後に読み込まれるようになる。引き続きそのサーバーを読み込ませたくない場合は deniedMcpServers でブロックできる。

関連ドキュメント

v2.1.290(1件)

Fixed
disableClaudeAiConnectors と allowedMcpServers の URL ルールが、.mcp.json、プラグイン、エージェントで宣言された一部の MCP エントリに適用されない問題を修正した
英語原文を表示
Fixed disableClaudeAiConnectors and allowedMcpServers URL rules not being applied to some MCP entries declared in .mcp.json, plugins or agents

関連ドキュメント

v2.1.259(1件)

Changed
allowedMcpServers をユーザーが追加したサーバーのみに適用されるように変更:アップグレードすると、以前は許可リストで除外されていた managed-mcp.json に直接記述されたサーバーが読み込まれるため、無効のままにするには deniedMcpServers を使う
英語原文を表示
Changed allowedMcpServers to govern only servers users add: a literal managed-mcp.json server your allowlist used to filter out now loads on upgrade; use deniedMcpServers to keep it off

変更後

管理者が allowedMcpServers の許可リストを配っていても、managed-mcp.json に定義されたサーバーはリストで除外されずにそのまま読み込まれるようになった。これにより、以前はアップグレード時に許可リストの更新漏れで配備済みサーバーが突然読み込めなくなる場面がなくなり、配布するサーバーとユーザー自身が追加するサーバーを別々に制御できる。配備済みサーバーを使わせたくない場合は deniedMcpServers でブロックすればよい。

関連ドキュメント

v2.1.169(1件)

Fixed
エンタープライズ管理の MCP ポリシー(許可/拒否サーバー設定)が、再接続時や IDE からの設定、インストール直後の初回起動時など、一部の条件下で適用されない問題を修正しました。
英語原文を表示
Fixed enterprise managed MCP policies (allowedMcpServers/deniedMcpServers) not being enforced on reconnect, IDE-typed configs, --mcp-config servers during the first session after install, or before remote settings loaded; also fixed slow cold starts for orgs without remote settings

変更後

組織のセキュリティポリシーを例外なく徹底でき、管理の信頼性が向上します。

関連ドキュメント

v2.1.166(1件)

Fixed
管理設定(managed-settings)の allowedMcpServers および deniedMcpServers において、${VAR} 形式の環境変数参照を含むパターンが正しく一致しない問題を修正しました。
英語原文を表示
Fixed managed-settings allowedMcpServers/deniedMcpServers predicates not matching when they use ${VAR} references

変更後

エンタープライズ環境などでのセキュリティ統制が正確になり、環境に合わせた柔軟な管理が可能になります。

関連ドキュメント

v2.1.154(1件)

Fixed
マネージド設定内のallowedMcpServers/deniedMcpServersに1つでも無効なエントリがあると、すべてのポリシーが破棄されてしまう問題を修正しました。不正なエントリは除外され、claude doctorで警告が表示されるようになります。
英語原文を表示
Fixed a single invalid allowedMcpServers/deniedMcpServers entry in managed settings discarding all managed-settings policy; the bad entry is now dropped with a claude doctor warning

変更後

組織全体での運用において、設定の不備によるセキュリティホールを最小限に抑え、管理の健全性を維持できます。

関連ドキュメント

v2.1.83(1件)

Fixed
CLI フラグ --mcp-config を使用した際に、管理ポリシーによる MCP サーバーの許可/拒否リストが無視される問題を修正しました
英語原文を表示
Fixed --mcp-config CLI flag bypassing allowedMcpServers/deniedMcpServers managed policy enforcement

変更後

企業の管理者が設定したセキュリティ基準が確実に守られるようになり、組織全体での安全な AI 利用が保証されます。

関連ドキュメント