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

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

• パターンを選択する。必要な制御レベルに合わせたパターンを選択します
• managed-mcp.json で固定サーバーセットをデプロイする。MCP 全体を無効にする方法も含まれます
• 許可リストとブロックリストでサーバーを制御する
• 制限がサーバーをブロックするときにユーザーに何が起こるかを伝える
• 組織が実際に使用するサーバーを監視する

​

パターンを選択する

​

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

• allowedMcpServers と deniedMcpServers は管理対象サーバーにも適用されるため、管理対象サーバーがそれらを通過しない場合は読み込まれません。
• ユーザー独自の deniedMcpServers は設定からマージされるため、ユーザーは管理対象サーバーを自分自身でブロックできます。

{
  "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。接続時に認証情報を生成します。

​

設定を検証する

1. claude mcp list は managed-mcp.json 内のサーバーのみを表示します。ユーザー独自のサーバーがまだ表示される場合、ファイルが読み込まれていません。パスと権限を確認してください。
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": {}
}

​

許可リストとブロックリストによるポリシーベースの制御

​

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

​

サーバーの評価方法

1. リストをマージします。 すべての設定ソースからの許可リストとブロックリストエントリが 1 つの許可リストと 1 つのブロックリストに結合されます。allowManagedMcpServersOnly が true の場合、管理対象許可リストのみが保持されます。ブロックリストは常にすべてのソースからマージされます。
2. ブロックリストをチェックします。 URL、コマンド、または名前でブロックリストエントリと一致するサーバーはブロックされます。ブロックリスト一致をオーバーライドするものはありません。
3. 許可リストをチェックします。 allowedMcpServers がどこにも設定されていない場合、ブロックリストを通過したすべてのサーバーが読み込まれます。設定されている場合、サーバーが一致する必要があるものは、その種類に依存し、以下の表に示されています。

• コマンドは正確に一致します。 すべての引数、順序通り。["npx", "-y", "server"] は ["npx", "server"] または ["npx", "-y", "server", "--flag"] と一致しません。
• 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 行目：ブロックリスト内の serverName エントリ。ブロックリストエントリは常に適用されるため、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/*" }
  ]
}

​

許可リストを管理設定のみに制限する

{
  "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、シート管理、およびロールアウトプレイブック