文档索引

在此处获取完整文档索引：https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面，然后再进一步探索。

为你的组织控制 MCP 服务器访问

使用托管配置文件、允许列表和拒绝列表限制用户可以添加或连接的 MCP 服务器。

默认情况下，任何运行 Claude Code 的人都可以连接他们选择的任何 MCP 服务器。Anthropic 在将连接器添加到 Anthropic 目录之前会根据其列表标准进行审查，但不会安全审计或管理任何 MCP 服务器。作为管理员，你可以限制组织中运行的服务器，从部署固定的批准集合到完全禁用 MCP。

本页涵盖如何：

• 选择模式以匹配你需要的控制程度
• 使用 managed-mcp.json 部署固定服务器集合，包括如何完全禁用 MCP
• 使用允许列表和拒绝列表控制服务器
• 告诉用户预期什么当限制阻止服务器时
• 监控组织实际使用的服务器

选择模式

Claude Code 支持一系列限制级别。每个模式使用下面涵盖的一个或两个机制：managed-mcp.json 用于部署固定集合，allowedMcpServers/deniedMcpServers 用于过滤用户配置的内容。

使用 managed-mcp.json 进行独占控制

如果你部署 managed-mcp.json 文件，Claude Code 仅加载该文件定义的服务器。用户无法添加、修改或使用任何其他 MCP 服务器，包括插件提供的服务器。该文件还会抑制 claude.ai 连接器，除非你在托管集合旁边允许它们。

另外两个设置可以进一步过滤托管集合：

• allowedMcpServers 和 deniedMcpServers 也适用于托管服务器，因此未通过它们的托管服务器不会加载。
• 用户自己的 deniedMcpServers 从他们的设置中合并，因此用户可以为自己阻止托管服务器。

参见服务器如何被评估了解完整的检查顺序。

managed-mcp.json 是独立文件，因此无法通过服务器管理设置交付。任何可以以管理员权限写入系统路径的进程都可以部署它。大规模部署通常通过设备管理工具，如 macOS 上的 Jamf 或配置文件、Windows 上的组策略或 Intune，或 Linux 上你选择的车队管理。Claude Code 在以下路径之一查找该文件：

该文件使用与项目 .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"
      }
    }
  }
}

使用每用户凭据进行身份验证

机器上的任何用户都可以读取此文件，因此不要在 env 块中存储 API 密钥或其他凭据。改为使用以下方式传递每用户凭据：

• {{CONTENT}}amp;#123;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

部署包含空服务器映射的 managed-mcp.json 以阻止每个 MCP 服务器：

{
  "mcpServers": {}
}

用户在 /mcp 中看不到 MCP 服务器，claude mcp add 失败并显示上述企业策略错误。用户之前配置的服务器在下次启动会话时停止加载，没有警告说明策略是原因。

在托管集合旁边允许 claude.ai 连接器

部署 managed-mcp.json 默认会抑制 claude.ai 连接器，包括管理员在 claude.ai 管理控制台中为组织配置的连接器。要在 managed-mcp.json 中的服务器旁边加载这些连接器，在托管设置源中设置 "allowAllClaudeAiMcps": true。需要 Claude Code v2.1.149 或更高版本。

启用该设置后，Claude Code 加载与未部署 managed-mcp.json 时相同的 claude.ai 连接器。允许列表和拒绝列表仍然适用于这些连接器，因此你可以使用 deniedMcpServers 阻止特定连接器。该设置仅影响 claude.ai 连接器；插件提供的服务器保持抑制状态。

Claude Code 仅从管理员控制的策略层读取此设置：服务器管理设置、MDM 部署的 plist 或 HKLM 注册表项，或系统 managed-settings.json 文件。将其放在用户或项目设置中无效，因此用户无法重新启用独占控制抑制的连接器。

使用允许列表和拒绝列表进行策略控制

允许列表和拒绝列表过滤允许加载哪些已配置的服务器。它们不是注册表：服务器仍需由用户、插件或 managed-mcp.json 添加后，允许列表或拒绝列表才对其适用。要向用户部署服务器，使用 managed-mcp.json。

要使允许列表具有权威性，在托管设置源（如服务器管理设置或已部署的 managed-settings.json 文件）中同时设置 allowedMcpServers 和 allowManagedMcpServersOnly: true。将允许列表限制为仅托管设置显示配置。没有 allowManagedMcpServersOnly 时，来自每个设置源的允许列表会合并，包括用户自己的 ~/.claude/settings.json，因此用户可以扩大你的允许列表允许的内容。拒绝列表始终从每个源合并。

按 URL、命令或名称匹配服务器

allowedMcpServers 和 deniedMcpServers 是条目列表。每个条目是一个具有单个键的对象，通过 URL、命令或名称标识服务器：

将 allowedMcpServers 保持未设置与设置为空数组不同：

服务器如何被评估

在加载服务器之前（包括来自 managed-mcp.json 的服务器），Claude Code 按顺序运行三项检查：

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 或命令如何都会被阻止。

此允许列表中的 serverName 条目永远不会匹配任何内容，因为两种传输类型已经有更严格的条目。

下面的手风琴展示了服务器如何针对其他允许列表和拒绝列表组合进行评估。

{
  "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：

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

当 allowManagedMcpServersOnly 为 true 时，来自用户、项目和本地设置的允许列表被忽略。拒绝列表仍然从所有源合并，因此用户始终可以为自己阻止服务器。

限制对用户的表现形式

当限制阻止服务器时，用户会看到 claude mcp add 的错误或服务器静默停止加载。使用此表识别这些报告，并在推出更改之前告诉用户预期什么：

在最后一种情况下，用户没有信号表明策略是服务器消失的原因，因此在推出新限制时告诉受影响的用户哪些服务器被阻止。

监控 MCP 使用情况

当配置了 OpenTelemetry 导出时，Claude Code 可以记录用户调用哪些 MCP 服务器和工具。设置 OTEL_LOG_TOOL_DETAILS=1 以在工具事件中包含 MCP 服务器和工具名称，然后在收集器中聚合它们以查看用户实际连接了哪些服务器。参见监控了解设置导出器和完整事件模式。

配置摘要

本页涵盖的每个文件和设置，它们控制什么，以及如何交付：

相关资源

• 决定执行什么：MCP 限制与权限规则、沙盒和其他管理控制
• 通过 MCP 将 Claude Code 连接到工具：完整的 MCP 参考，包括传输、范围和身份验证
• 设置：设置层次结构和托管设置如何优先
• 服务器管理设置：从 Claude.ai 管理控制台交付 allowedMcpServers 和 deniedMcpServers
• 安全：这些控制防御的威胁模型
• Claude 企业管理员指南：SSO、SCIM、席位管理和推出手册