settings.json

deniedMcpServers

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

明示的にブロックされる MCP サーバーのエンタープライズ・拒否リスト。

記述例

{
  "deniedMcpServers": [
    { "serverName": "filesystem" }
  ]
}

使い方・用途

  • セキュリティ上の懸念がある外部サーバーや、利用を禁止したい特定の MCP ツールを確実に排除するために使用します。
  • 許可リストよりも優先度が高く、ホスト名に大文字・小文字が含まれる場合やクラウド経由のサーバーに対しても一貫してブロックが適用されます。
英語原文(公式ドキュメントより)

Enterprise denylist of MCP servers that are explicitly blocked. If a server is on the denylist, it will be blocked across all scopes including enterprise. Denylist takes precedence over allowlist - 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.301(1件)

Changed
セルフホストランナー: managed settings で MCP サーバーが制限されている際に、Slack から開始したセッションがリポジトリの検出やアタッチに失敗する問題を修正した。これらのツールを無効化するには deniedMcpServers を使用する
英語原文を表示
Self-hosted runner: Fixed sessions started from Slack being unable to find or attach a repository when managed settings restrict MCP servers; use deniedMcpServers to keep those tools off

変更後

マネージド設定で MCP サーバーが制限されている環境でも、Slack から開始したセッションがリポジトリを見つけられなかったりアタッチできなかったりする問題を解消する。特定の MCP ツールをオフにしたい場合は deniedMcpServers で個別に除外できるため、必要なリポジリアタッチ機能を損なわずにポリシーを維持できる。

関連ドキュメント

v2.1.273(1件)

Fixed
サーバー管理の設定も同時に存在する場合に、MDM または managed-settings.json で設定した allowManagedMcpServersOnly、deniedMcpServers、disableClaudeAiConnectors が無視される問題を修正する
英語原文を表示
Fixed allowManagedMcpServersOnly, deniedMcpServers and disableClaudeAiConnectors set via MDM or managed-settings.json being ignored when server-managed settings are also present

関連ドキュメント

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.129(1件)

Fixed
deniedMcpServersのURLワイルドカード指定において、大文字・小文字が混在するホスト名が正しく拒絶されない問題が修正されました
英語原文を表示
Fixed deniedMcpServers patterns with a *:// scheme wildcard not matching mixed-case hostnames

変更後

管理者が設定したMCPサーバーの制限ポリシーの信頼性が向上し、組織のセキュリティが強化されます。

関連ドキュメント

v2.1.85(1件)

Fixed
deniedMcpServers設定がclaude.ai上のMCPサーバーを正しくブロックできていなかった問題を修正
英語原文を表示
Fixed deniedMcpServers setting not blocking claude.ai MCP servers

変更後

利用したくないツールやセキュリティ上の懸念がある外部サーバーを、確実にセッションから排除できる安心感が得られます。

関連ドキュメント

v2.1.83(1件)

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

変更後

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

関連ドキュメント