控制組織的 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. 合併清單。 來自每個設定來源的允許清單和拒絕清單條目合併為一個允許清單和一個拒絕清單。當 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 條目。一旦存在，每個遠端伺服器必須匹配 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、座位管理和推出劇本