控制組織的 MCP 伺服器存取

• 選擇符合您需要的控制程度的模式
• 使用 managed-mcp.json 部署固定伺服器集合，包括如何完全停用 MCP
• 透過受管設定提供伺服器，同時使用者保留自己的伺服器
• 使用允許清單和拒絕清單控制伺服器
• 告知使用者限制阻止伺服器時的預期情況
• 監控組織實際使用的伺服器

​

選擇一個模式

​

使用 managed-mcp.json 進行獨佔控制

• 該檔案定義的伺服器
• 您透過 managedMcpServers 提供的伺服器
• 啟動工作階段的應用程式註冊的同處理程序伺服器，例如 VS Code 擴充功能自己的伺服器或桌面應用程式提供的連接器
• 內建的Chrome 中的 Claude 伺服器，如果您允許它與受管集合並存

​

部署 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 提供的任何伺服器。兩個其他結果表示出現問題：
   • 如果使用者自己的伺服器仍然出現，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 拒絕純 http:// URL，包括指向 localhost 的 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 中為自己關閉提供的伺服器，該頁面在受管 MCPs 下列出提供的伺服器。

​

managedMcpServers 適用的位置

​

提供的伺服器何時連接

• 在具有快取設定的機器上，Claude Code 會保留此金鑰的快取副本，直到伺服器確認工作階段的設定，並在確認前等待該確認才載入 MCP 伺服器。如果確認失敗，工作階段會在沒有提供的伺服器的情況下繼續，/status 會說它們被保留。
• 在機器的首次啟動時，還沒有快取任何內容，在設定到達前啟動的互動式工作階段會在設定到達時立即連接提供的伺服器，而已經啟動的 claude -p 執行可以在沒有它們的情況下完成。

• 新增伺服器：Claude Code 在更新的設定到達時連接它，無需重新啟動。
• 變更伺服器的項目：這些工作階段使用新定義重新連接到它。
• 移除伺服器：執行中的互動式工作階段在讀取變更的設定後會將其中斷連接。非互動式 (-p) 執行會保留它直到結束。

​

使用允許清單和拒絕清單進行基於政策的控制

​

按 URL、命令或名稱比對伺服器

​

serverName 項目如何比對

• 在 deniedMcpServers 中，serverName 接受任何非空字串，不含前導或尾隨空白，因此您可以按其顯示名稱阻止 claude.ai 連接器。例如，{ "serverName": "claude.ai Slack" } 會阻止 Slack 連接器。當您需要拒絕對重新命名具有魯棒性時，或當連接器名稱衝突並獲得 (N) 尾碼時，偏好使用 serverUrl 項目。
• 在 allowedMcpServers 中，serverName 限制為字母、數字、連字號和底線。使用 serverUrl 來允許列出 Claude Code 自行擷取的 claude.ai 連接器；對於雲端主機提供給自託管工作階段的連接器，請改用連接器流量離開您的網路下列出的項目。

​

serverCommand 項目如何比對

• 命令精確比對。 每個引數，按順序。["npx", "-y", "server"] 不比對 ["npx", "server"] 或 ["npx", "-y", "server", "--flag"]。
• 不比較 env 區塊。 ["node", "server.js"] 會比對以任何 env 值執行該命令的伺服器。某些環境變數會變更 node 在啟動時載入的內容。若要自行設定 env 值，請在 managed-mcp.json 中定義伺服器。

​

serverUrl 項目如何比對

​

serverCommand 和 serverUrl 項目中的環境變數

• 伺服器的已設定值：從即時程序環境展開，就像 .mcp.json 的其餘部分一樣
• 政策項目：從固定環境展開，因此由專案或使用者設定檔設定的變數無法變更允許清單項目的含義

​

伺服器如何被評估

1. 合併清單。 來自每個設定範圍的允許清單和拒絕清單項目合併為一個允許清單和一個拒絕清單。當 allowManagedMcpServersOnly 為 true 時，僅保留受管允許清單；拒絕清單始終從每個範圍合併。當存在多個受管來源時，從每個管理員來源讀取的鍵說明其中哪些提供受管範圍的清單。
2. 檢查拒絕清單。 與任何拒絕清單項目比對的伺服器（按 URL、命令或名稱）會被阻止。沒有任何東西會覆寫拒絕清單比對。
3. 檢查允許清單。 某些伺服器會跳過此檢查。如果 allowedMcpServers 未在任何地方設定，每個通過拒絕清單的伺服器都會載入。如果已設定，伺服器必須比對的內容取決於其類型，如下表所示。

​

跳過允許清單檢查的伺服器

• 組織自己的伺服器：每個 managedMcpServers 項目，以及任何 managed-mcp.json 項目，其值不使用 ${VAR} 展開。
• 內建伺服器，例如 Chrome 中的 Claude、Claude Code 在執行中的 VS Code 或 JetBrains IDE 中連接的 ide 伺服器，以及 CLI 本身設定的伺服器。
• Claude Tag 工作階段的 Slack 工具：它用來讀取執行緒和發佈回覆的伺服器會在沒有允許清單項目的情況下載入。

​

範例設定

{
  "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、座位管理和推出劇本