Skip to content
← リリースに戻る · 2.1.305
改善 / v2.1.305

allowedMcpServersのフィルタ範囲を変更

CHANGELOG 原文(英語)

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が、env内だけで${VAR}を使うmanaged-mcp.jsonのstdioサーバーをフィルタしないように変更。これまでallowlistで除外していたサーバーも、アップグレード後は読み込まれるようになる。除外を続けるにはdeniedMcpServersを使う。

ドキュメント

ドキュメントの抜粋(参考訳)

allowedMcpServers

追加できるMCPサーバーをallowlistで制限します。Claude Codeは、プラグインのサーバー、ユーザーが--mcp-configで渡すサーバー、claude.aiからのサーバーを含め、定義元を問わずエントリに一致しないサーバーをすべてブロックします。

Claude in Chromeや、起動中のVS CodeまたはJetBrainsのIDEでClaude Codeが接続するideサーバーなどの組み込みサーバー、およびCLI自体が設定するサーバーはallowlistの対象外ですが、denylistは引き続き適用されます。Claude Code v2.1.268以降では、Claude TagセッションのSlackツールもallowlistの対象外ですが、denylistは引き続き適用されます。インプロセスのtype: "sdk"サーバーはどちらのリストの対象外です。これらはセッションを開始したアプリが登録します。

組織が提供するサーバーもallowlistの対象外ですが、denylistは引き続き適用されます。この対象外扱いは、すべてのmanagedMcpServersエントリと、値がenv 以外で ${VAR} 展開を使わないmanaged-mcp.jsonエントリに及びます。チェックの完全な順序はサーバーの評価方法を参照してください。v2.1.259より前は、managed-mcp.jsonのサーバーも一致が必要でした。

  • スコープ: Any file。ユーザーが追加するサーバーについては、allowManagedMcpServersOnlyが設定されていない限り、各ファイルのエントリは1つのallowlistに統合されます。ユーザーがエントリを追加できないようにするには、両方のキーをmanaged設定でデプロイしてください。
  • 型: オブジェクトの配列。各オブジェクトはちょうど1つのキーを持つ。serverName(文字、数字、ハイフン、アンダースコアのみからなる文字列)、serverCommand(コマンドとその引数を完全一致で指定する配列)、またはserverUrl(*ワイルドカードを使うURLパターン)のいずれか
  • デフォルト: 未設定。この場合すべてのサーバーが許可される。空の配列を指定すると、ユーザーが追加するすべてのサーバーがブロックされる

この例では、指定したnpxコマンドが起動するstdioサーバーのみを許可します。

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

deniedMcpServersのエントリが優先されるため、両方のリストに載っているサーバーはブロックされます。リストにserverCommandのエントリが1つでも含まれると、stdioサーバーはserverCommandのエントリに一致する必要があり、serverUrlのエントリが1つでも含まれると、リモートサーバーはserverUrlのエントリに一致する必要があります。つまりserverNameの一致だけでは、その種類のサーバーは許可されなくなります。詳しくはallowlistとdenylistによるポリシーベースの制御を参照してください。

取得日 · 2026-11-20

変更の詳細