Controle o acesso ao servidor MCP para sua organização

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.

• Escolher um padrão que corresponda ao nível de controle necessário
• Implantar um conjunto de servidor fixo com managed-mcp.json, incluindo como desabilitar MCP completamente
• Controlar servidores com listas de permissão e listas de bloqueio
• Informar aos usuários o que esperar quando uma restrição bloqueia um servidor
• Monitorar quais servidores sua organização realmente usa

​

Escolher um padrão

​

Controle exclusivo com managed-mcp.json

• allowedMcpServers e deniedMcpServers também se aplicam a servidores gerenciados, portanto um servidor gerenciado que não passar por eles não será carregado.
• O próprio deniedMcpServers de um usuário é mesclado a partir de suas configurações, portanto os usuários podem bloquear um servidor gerenciado para si mesmos.

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

​

Autenticar com credenciais por usuário

• Expansão ${VAR} para ler segredos do ambiente de cada usuário.
• OAuth ou cabeçalhos por usuário para que cada usuário se autentique como si mesmo.
• headersHelper para gerar credenciais no momento da conexão.

​

Validar a configuração

1. claude mcp list mostra apenas os servidores em managed-mcp.json. Se os próprios servidores de um usuário ainda aparecerem, o arquivo não está sendo lido; verifique o caminho e as permissões.
2. claude mcp add --transport http test https://example.com/mcp falha com Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers. A URL não precisa ser um servidor real, pois a verificação de política rejeita o comando antes de qualquer coisa ser contatada.

​

Desabilitar MCP completamente

{
  "mcpServers": {}
}

​

Controle baseado em política com listas de permissão e listas de bloqueio

​

Corresponder servidores por URL, comando ou nome

​

Como um servidor é avaliado

1. Mesclar as listas. Entradas de lista de permissão e lista de bloqueio de todas as fontes de configurações se combinam em uma lista de permissão e uma lista de bloqueio. Quando allowManagedMcpServersOnly é true, apenas a lista de permissão gerenciada é mantida; a lista de bloqueio sempre é mesclada de todas as fontes.
2. Verificar a lista de bloqueio. Um servidor que corresponde a qualquer entrada da lista de bloqueio, por URL, comando ou nome, é bloqueado. Nada substitui uma correspondência da lista de bloqueio.
3. Verificar a lista de permissão. Se allowedMcpServers não estiver definido em lugar nenhum, todos os servidores que passaram na lista de bloqueio são carregados. Se estiver definido, o que o servidor deve corresponder depende de seu tipo, mostrado na tabela abaixo.

• Comandos correspondem exatamente. Cada argumento, em ordem. ["npx", "-y", "server"] não corresponde a ["npx", "server"] ou ["npx", "-y", "server", "--flag"].
• URLs suportam curingas * em qualquer lugar do padrão, incluindo o esquema. A correspondência de nome de host não diferencia maiúsculas de minúsculas e ignora um ponto FQDN à direita, portanto https://Mcp.Example.com/* corresponde a https://mcp.example.com/api. Os caminhos permanecem sensíveis a maiúsculas e minúsculas.

​

Configuração de exemplo

{
  "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/*" }
  ]
}

• Linha 3: a primeira entrada serverUrl. Uma vez que existe uma, cada servidor remoto deve corresponder a um padrão de URL, portanto um usuário não pode obter um servidor remoto não listado dando-lhe um nome permitido.
• Linha 5: a primeira entrada serverCommand. Mesmo efeito para servidores stdio, portanto cada servidor local deve corresponder a um comando listado exatamente.
• Linha 11: uma entrada serverName na lista de bloqueio. Entradas da lista de bloqueio sempre se aplicam, portanto qualquer servidor nomeado dangerous-server é bloqueado independentemente de sua URL ou comando.

{
  "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/*" }
  ]
}

​

Restringir a lista de permissão apenas a configurações gerenciadas

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

​

Como as restrições aparecem para os usuários

​

Monitorar o uso de MCP

​

Resumo de configuração

​

Recursos relacionados

• Decidir o que aplicar: restrições de MCP junto com regras de permissão, sandboxing e os outros controles de administrador
• Conectar Claude Code a ferramentas via MCP: a referência completa de MCP, incluindo transportes, escopos e autenticação
• Configurações: a hierarquia de configurações e como as configurações gerenciadas têm precedência
• Configurações gerenciadas pelo servidor: entregar allowedMcpServers e deniedMcpServers do console de administrador do Claude.ai
• Segurança: o modelo de ameaça que esses controles defendem
• Guia do Administrador Empresarial Claude: SSO, SCIM, gerenciamento de assentos e playbook de implementação