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