控制组织的 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 企业管理员指南：SSO、SCIM、座位管理和推出剧本