settings.json

allowManagedMcpServersOnly

型boolean記述場所管理者設定のみ

(管理設定のみ) true の場合、管理設定の allowedMcpServers のみが尊重され、ユーザー設定・プロジェクト設定・ローカル設定で定義された MCP サーバーは無視される。deniedMcpServers は引き続きすべてのソースからマージされる。See https://code.claude.com/docs/en/managed-mcp

既定値: false であり、すべての設定スコープの許可リストがマージされる。

記述例

{
  "allowManagedMcpServersOnly": true,
  "allowedMcpServers": [
    { "serverName": "github" }
  ]
}

使い方・用途

  • ユーザーが自身の user・project・local 設定で許可リストにサーバーを追加して、組織が定めた allowedMcpServers の範囲を広げることを防ぎたい管理者が使う
  • 組織が承認したサーバーのカタログを公開し、ユーザーはその中から好きなサーバーを追加でき、それ以外はブロックするという運用パターン(Approved catalog)を実現したいときに使う
  • 企業の managed settings で管理された MCP の許可リストだけを唯一の適用対象とし、他の設定ファイルの許可リストを無視したいときに使う
英語原文(公式ドキュメントより)

(Managed settings only) When true, only allowedMcpServers from managed settings are respected; MCP servers defined in user, project, or local settings are ignored. deniedMcpServers still merges from all sources. See https://code.claude.com/docs/en/managed-mcp

関連ドキュメント

関連する変更履歴

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

関連ドキュメント