settings.json

managedMcpServers

型object[]記述場所管理者設定のみ

すべてのユーザーに強制適用される、MCP(Model Context Protocol)サーバーの設定を指定します。

記述例

{
  "managedMcpServers": {
    "search": {
      "type": "http",
      "url": "https://search.example.com/mcp"
    }
  }
}

使い方・用途

  • 組織全体で共通して利用させたいMCPサーバー(データベース接続や社内ツール等)を管理者が一括設定する際に使用します。
  • 各エントリでトランスポート方式(http, sse, stdio)やツール利用ポリシーを設定可能です。
  • 現在、サードパーティ製のデスクトップ版デプロイメントでのみ利用可能です。
英語原文(公式ドキュメントより)

(Managed settings, third-party Desktop deployments only) MCP server configurations pushed to all users. Each entry specifies the transport and connection details, plus an optional toolPolicy map. Delivered through the managed settings file or MDM. See https://code.claude.com/docs/en/desktop#enterprise-configuration

関連ドキュメント

関連する変更履歴

v2.1.281(1件)

Changed
Claude apps gateway を変更した。managedMcpServers エントリの envHelper パスが 
??
 や /??/ で始まる場合、現在の Claude Desktop が実行を拒否するパス形式であるため起動を拒否する
英語原文を表示
Changed Claude apps gateway to refuse to start when a managedMcpServers entry's envHelper path starts with \??\ or /??/, a path form current Claude Desktop refuses to run

変更後

Claude Desktop が実行しない envHelper のパス形式を含む設定でも、接続中のすべてのデスクトップに問題が波及する前に、ゲートウェイの起動時にエラーとして検知できるようになる。

関連ドキュメント

v2.1.260(1件)

Changed
Claude アプリゲートウェイを変更し、desktop ポリシーで managedMcpServers または orgPluginSettings エントリのネストされたオブジェクト内のフィールド名に誤字がある場合にも、起動を拒否して該当フィールド名を報告するようにした
英語原文を表示
Changed Claude apps gateway to also refuse to start, naming the field, when a desktop policy misspells a field in a nested object of a managedMcpServers or orgPluginSettings entry

変更後

desktop ポリシーの managedMcpServers や orgPluginSettings のネストされたオブジェクト内でフィールド名を誤記しても、設定ミスが接続された各デスクトップにまで波及する前にゲートウェイの起動時にエラーで検知でき、どのフィールドが誤っているかもエラーメッセージで確認できる。

関連ドキュメント

v2.1.259(1件)

Added
managedMcpServers の管理設定を追加。組織は全ユーザーに HTTP/SSE MCP サーバーを提供できる(.mcp.json と同じエントリ形式)。実行コマンドを指定するエントリはスキップされる
英語原文を表示
Added managedMcpServers managed setting: organizations can provide HTTP/SSE MCP servers to every user (same entry shape as .mcp.json); entries that name a command to run are skipped

変更後

組織の管理者が管理設定を使って、全ユーザーに HTTP/SSE の MCP サーバーを一括提供できるようになる。ユーザーが自分で追加したサーバーはそのまま残り、組織が提供したサーバーは編集・削除できないため、個人と組織のサーバーを両立しながら一元的に配布できる。

関連ドキュメント