組織の MCP サーバーアクセスを制御する

• 必要な制御量に合致するパターンを選択する
• managed-mcp.json で固定サーバーセットをデプロイする（MCP 全体を無効化する 方法を含む）
• 管理対象設定を通じてサーバーを提供する（ユーザーが独自のサーバーを保持する場合）
• 許可リストと拒否リストでサーバーを制御する
• 制限がサーバーをブロックするときにユーザーが何を期待するかを伝える
• 組織が実際に使用するサーバーを監視する

​

パターンを選択する

​

managed-mcp.json による排他的制御

• ファイルで定義されたサーバー
• 「managedMcpServers を通じて提供するサーバー」
• セッションを開始したアプリが登録するインプロセスサーバー（VS Code 拡張機能独自のサーバーやデスクトップアプリが提供するコネクタなど）
• 「Claude in Chrome」の組み込みサーバー（マネージドセットと共にそれを許可する場合）

​

managed-mcp.json をデプロイする

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    },
    "company-internal": {
      "type": "stdio",
      "command": "/usr/local/bin/company-mcp-server",
      "args": ["--config", "/etc/company/mcp-config.json"],
      "env": {
        "COMPANY_API_URL": "https://internal.example.com"
      }
    }
  }
}

​

ユーザーごとの認証情報で認証する

• 「${VAR} 展開」を使用して、各ユーザーの環境からシークレットを読み込む。
• 「OAuth またはユーザーごとのヘッダー」を使用して、各ユーザーが自分自身として認証する。
• 「headersHelper」を使用して、接続時に認証情報を生成する。

​

--mcp-config または --strict-mcp-config で渡されたサーバー

• ワークステーション上では、Claude Code は You cannot dynamically configure MCP servers when an enterprise MCP config is present というメッセージで起動時に終了します。
• ファイルがデプロイされているホスト上の「クラウドセッション」（「セルフホストランナー」など）では、Claude Code はマネージドサーバーのみで起動し、claude.ai コネクタおよびクラウドホストが --mcp-config を通じて配信するその他のサーバーをスキップします。セッション内のどのサーバーが除外されたかをユーザーに伝えるものはありません。Claude Code はそれらを stderr の警告で名前を付けます。これはセルフホストランナーが debug ログレベルで記録します。

​

許可リストと拒否リストがマネージドセットに適用される方法

• deniedMcpServers はマネージドサーバーにも適用されるため、エントリに一致するマネージドサーバーは読み込まれません。
• ユーザー独自の deniedMcpServers は設定からマージされるため、ユーザーはマネージドサーバーを自分自身でブロックできます。

​

構成を検証する

1. claude mcp list は managed-mcp.json 内のサーバーのみを表示します。managedMcpServers を通じて提供するサーバーも表示されます。2 つの他の結果は何かが間違っていることを意味します。
   • ユーザー独自のサーバーがまだ表示される場合、Claude Code はファイルを読み込んでいません。そのパスと親ディレクトリの権限を確認してください。
   • ファイルのサーバーが表示されず、MCP config diagnostics セクションがエンタープライズ構成の解析失敗をマークしている場合、Claude Code はファイルを読み込むか解析できません。そのセクションが名前を付けるエラーを修正してから、ユーザーに Claude Code を再起動させてください。
2. claude mcp add --transport http test https://example.com/mcp は Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers で失敗します。ポリシーチェックが何かに接続される前にコマンドを拒否するため、URL は実際のサーバーである必要はありません。

​

MCP を完全に無効にする

{
  "mcpServers": {}
}

​

マネージドセットと共に claude.ai コネクタを許可する

​

マネージドセットと共に Claude in Chrome を許可する

​

マネージド設定を通じてサーバーを提供する

{
  "managedMcpServers": {
    "search": {
      "type": "http",
      "url": "https://search.example.com/mcp"
    },
    "records": {
      "type": "http",
      "url": "https://records.example.com/mcp",
      "headers": {
        "X-Records-Key": "key-issued-for-all-claude-code-users"
      }
    }
  }
}

​

エントリに含めることができるもの

• type は http または sse です。.mcp.json と同様に、streamable-http は http のエイリアスとして受け入れられます。
• url は https:// URL です。Claude Code は localhost を指すものを含む、プレーンな http:// URL を拒否します。
• エントリに command、args、env、または headersHelper メンバーがないため、マネージド設定ドキュメントはユーザーのマシン上で実行するプログラムを指定しません。
• 値に ${VAR} 参照が含まれていません。Claude Code はこれらのエントリ内の環境変数を展開しないため、リテラル値を記述してください。
• サーバー名には文字、数字、ハイフン、アンダースコアのみが含まれ、キーまたは値に制御文字や非表示の書式文字が含まれていません。

​

提供されたサーバーがどのように読み込まれるか

• 提供されたサーバーは、ローカル、プロジェクト、またはユーザースコープ内の同じ名前のサーバーよりも優先され、同じ URL を指すプラグインサーバーまたは claude.ai コネクタよりも優先されます。
• managed-mcp.json もデプロイする場合、Claude Code はそのサーバーと提供されたサーバーを一緒に読み込み、両方が名前を定義する場合はファイルのエントリが優先されます。
• strictPluginOnlyCustomization が mcp サーフェスをロックしても、提供されたサーバーは引き続き読み込まれます。
• deniedMcpServers はユーザー自身の設定からのエントリを含む提供されたサーバーに適用されるため、ユーザーは自分自身のためにそれをブロックできます。提供されたサーバーは allowedMcpServers エントリを必要としません。

• ユーザーが同じ名前で --mcp-config で渡すサーバーは、その実行のために提供されたサーバーを置き換え、allowedMcpServers に対してチェックされます。
• --strict-mcp-config は、提供されたサーバーを他のすべての設定されたサーバーと一緒に除外します。

​

ユーザーが見ることができ、変更できるもの

• claude mcp remove は、サーバーが組織によって提供されていることを報告します。
• managed-mcp.json もデプロイしていない場合、ユーザーが同じ名前で追加するエントリは保存されますが、あなたのサーバーが存在する間は使用されません。
• ユーザーは /mcp で提供されたサーバーを自分自身のためにオフにすることができます。これは Managed MCPs の下に提供されたサーバーをリストします。

​

managedMcpServers が適用される場所

​

提供されたサーバーが接続するとき

• キャッシュされた設定を持つマシンでは、Claude Code はこのキーのキャッシュされたコピーを、サーバーがセッションの設定を確認するまで保留し、その確認を待ってから MCP サーバーを読み込みます。確認が失敗した場合、セッションは提供されたサーバーなしで続行され、/status はそれらが保留されていることを示します。
• マシンの最初の起動時に、まだキャッシュされたものがない場合、設定が到着する前に開始される対話型セッションは、提供されたサーバーが到着するとすぐに接続し、既に開始されている claude -p 実行はそれらなしで完了できます。

• サーバーを追加する：Claude Code は更新された設定が到着したときにそれを接続し、再起動は不要です。
• サーバーのエントリを変更する：これらのセッションは新しい定義で再接続します。
• サーバーを削除する：実行中の対話型セッションは、変更された設定を読み取ると、それを切断します。非対話型（-p）実行はそれが終了するまでそれを保持します。

​

allowlist と denylist を使用したポリシーベースの制御

​

URL、コマンド、または名前でサーバーをマッチさせる

• deniedMcpServers では、serverName は先頭または末尾に空白がない空でない任意の文字列を受け入れるため、claude.ai コネクタを表示名でブロックできます。たとえば、{ "serverName": "claude.ai Slack" } は Slack コネクタをブロックします。deny が名前変更に対して堅牢である必要がある場合、またはコネクタ名が衝突して (N) サフィックスを取得する場合は、serverUrl エントリを優先します。
• allowedMcpServers では、serverName は文字、数字、ハイフン、アンダースコアに限定されます。Claude Code が自身でフェッチする claude.ai コネクタを allowlist に追加するには serverUrl を使用します。クラウドホストが自己ホスト型セッションに配信するコネクタの場合は、代わりにコネクタトラフィックがネットワークを離れるの下にリストされているエントリを使用します。

​

サーバーの評価方法

1. リストをマージします。 すべての設定スコープからの allowlist と denylist エントリが 1 つの allowlist と 1 つの denylist に結合されます。allowManagedMcpServersOnly が true の場合、管理 allowlist のみが保持されます。denylist は常にすべてのスコープからマージされます。複数の管理ソースが存在する場合、すべての管理ソースから読み取られるキーは、管理スコープのリストを提供するソースを示しています。
2. denylist をチェックします。 URL、コマンド、または名前で denylist エントリにマッチするサーバーはブロックされます。denylist マッチをオーバーライドするものはありません。
3. allowlist をチェックします。 allowedMcpServers がどこにも設定されていない場合、denylist を通過したすべてのサーバーがロードされます。設定されている場合、サーバーがマッチする必要があるものはそのタイプに依存し、以下の表に示されています。 3 つのサーバーグループはこのチェックをスキップします。
   • 組織自身のサーバー：すべての managedMcpServers エントリ、および ${VAR} 展開を使用しない値を持つ managed-mcp.json エントリ。
   • Chrome の Claude、Claude Code が実行中の VS Code または JetBrains IDE に接続する ide サーバー、CLI 自身が設定するサーバーなどの組み込みサーバー。
   • Claude Tag セッションの Slack ツール：スレッドを読み取り、返信を投稿するために使用するサーバーは allowlist エントリなしでロードされます。
   コマンド、引数、env、URL、またはヘッダーで ${VAR} 展開を使用する managed-mcp.json サーバーはまだチェックされます。ユーザー、プラグイン、claude.ai が追加するすべてのサーバー、および --mcp-config でユーザーが渡すすべてのサーバーも同様です。

• コマンドは完全にマッチします。 すべての引数、順番に。["npx", "-y", "server"] は ["npx", "server"] または ["npx", "-y", "server", "--flag"] にマッチしません。
• serverCommand と serverUrl の値はマッチング前に展開されます。 ポリシーエントリとサーバーの設定値の両方が ${VAR} と ${VAR:-default} 展開を通過するため、["${HOME}/bin/server"] として書かれたエントリは、同じ参照または展開されたパスのいずれかを使用するサーバー設定にマッチします。Windows では、${HOME} の代わりに ${USERPROFILE} など、そこで設定されている環境変数を参照します。serverName の値は文字通りマッチし、展開されません。両側は異なる環境を読みます。ポリシーエントリの展開方法は、どちらであるか、および allowlist と denylist エントリがどのように異なるかについて説明しています。
• URL は * ワイルドカードをパターン内の任意の場所（スキームを含む）でサポートします。ホスト名マッチングは大文字と小文字を区別せず、末尾の FQDN ドットを無視するため、https://Mcp.Example.com/* は https://mcp.example.com/api にマッチします。パスは大文字と小文字を区別したままです。

​

ポリシーエントリの展開方法

​

設定例

{
  "allowedMcpServers": [
    { "serverUrl": "https://api.githubcopilot.com/*" },
    { "serverUrl": "https://mcp.sentry.dev/*" },
    { "serverCommand": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "."] },
    { "serverCommand": ["python", "/usr/local/bin/approved-server.py"] },
    { "serverUrl": "https://mcp.example.com/*" },
    { "serverUrl": "https://*.internal.example.com/*" }
  ],
  "deniedMcpServers": [
    { "serverName": "dangerous-server" },
    { "serverCommand": ["npx", "-y", "unapproved-package"] },
    { "serverUrl": "https://*.untrusted.example.com/*" }
  ]
}

• 3 行目: 最初の serverUrl エントリ。1 つ存在すると、すべてのリモートサーバーは URL パターンにマッチする必要があるため、ユーザーは許可された名前を与えることでリストされていないリモートサーバーを取得できません。
• 5 行目: 最初の serverCommand エントリ。stdio サーバーでも同じ効果があるため、すべてのローカルサーバーはリストされたコマンドに完全にマッチする必要があります。
• 11 行目: denylist の serverName エントリ。denylist エントリは常に適用されるため、dangerous-server という名前のサーバーは URL またはコマンドに関係なくブロックされます。

{
  "allowedMcpServers": [
    { "serverUrl": "https://mcp.example.com/*" },
    { "serverUrl": "https://*.internal.example.com/*" }
  ]
}

{
  "allowedMcpServers": [
    { "serverCommand": ["npx", "-y", "approved-package"] }
  ]
}

{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverCommand": ["npx", "-y", "approved-package"] }
  ]
}

{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverName": "internal-tool" }
  ]
}

{
  "allowedMcpServers": [
    { "serverUrl": "https://*.example.com/*" }
  ],
  "deniedMcpServers": [
    { "serverUrl": "https://staging.example.com/*" }
  ]
}

​

allowlist を管理設定のみに制限する

{
  "allowManagedMcpServersOnly": true,
  "allowedMcpServers": [
    { "serverUrl": "https://api.githubcopilot.com/*" },
    { "serverUrl": "https://*.internal.example.com/*" }
  ]
}

​

制限がユーザーに表示される方法

​

MCP 使用状況を監視する

​

設定の概要

​

関連リソース

• 実施する内容を決定する：MCP 制限と権限ルール、サンドボックス化、および他の管理制御
• MCP 経由で Claude Code をツールに接続する：トランスポート、スコープ、認証を含む完全な MCP リファレンス
• 設定：設定階層と管理設定がどのように優先されるか
• サーバー管理設定：Claude.ai 管理コンソールから allowedMcpServers と deniedMcpServers を配信します
• セキュリティ：これらの制御が防御する脅威モデル
• Claude Enterprise Administrator Guide：SSO、SCIM、シート管理、およびロールアウトプレイブック