1

MCP no Claude Code: como ligar um servidor, onde fica a configuração e por que mcp__* no allow não libera nada

Estou estudando MCP no Claude Code, e a sigla aparece em todo lugar sem que quase ninguém explique o básico: o que é, como ligar um servidor e o que muda na segurança. Este é o resumo do que tirei da documentação oficial, com o olhar de quem usa o Claude Code dentro dos containers do homelab.

O que é

MCP (Model Context Protocol) é um padrão aberto para ligar ferramentas de IA a outros sistemas. Um servidor MCP dá ao Claude Code ferramentas, bancos e APIs que ele não tem por padrão. A documentação dá uma regra prática boa: vale ligar um servidor quando você se pega copiando dados de outra ferramenta para colar no chat.

Como ligar

Para um servidor remoto, http é o recomendado (o sse está obsoleto):

claude mcp add --transport http meu-servico https://exemplo.com/mcp

Para um servidor local (stdio), o comando do servidor vem depois de um --:

claude mcp add --transport stdio arquivos \
  -- npx -y @modelcontextprotocol/server-filesystem --read-only /srv/docs

O -- separa as opções do Claude Code das opções do servidor. Sem ele, o Claude Code tentaria ler o --read-only como opção dele. Esse servidor de arquivos é o de referência do projeto MCP: só acessa as pastas passadas na linha de comando, e com o --read-only nem oferece as ferramentas de escrita. É um bom primeiro teste.

Onde a configuração fica

EscopoVale emVai para o git?
local (padrão)Projeto atualNão (~/.claude.json)
projectProjeto atualSim (.mcp.json)
userTodos os seus projetosNão (~/.claude.json)

Servidor vindo de um .mcp.json do repositório pede aprovação antes de rodar. E o .mcp.json aceita variáveis, o que deixa o segredo fora do git:

{
  "mcpServers": {
    "minha-api": {
      "type": "http",
      "url": "https://api.exemplo.com/mcp",
      "headers": { "Authorization": "Bearer ${API_KEY}" }
    }
  }
}

Permissões

As ferramentas MCP passam pelo mesmo sistema de permissões, com o nome mcp__<servidor>__<ferramenta>:

  • mcp__arquivos__* cobre todas as ferramentas do servidor arquivos;
  • num deny, mcp__* bloqueia todas as ferramentas MCP de todos os servidores;
  • num allow, esse curinga sem nome de servidor é ignorado. Para liberar, é preciso nomear o servidor.

Esse último ponto é um bom desenho: não dá para liberar "qualquer MCP" sem querer.

O risco que importa

A documentação é direta: confira se confia em cada servidor antes de ligar. Servidor que busca conteúdo de fora (páginas, e-mails, issues) pode trazer texto feito para enganar a IA, a tal injeção de prompt. Antes de instalar, eu olharia quem mantém o servidor, se existe modo só leitura e quanto conteúdo externo ele lê. Também começaria sem allow, liberando ferramenta por ferramenta.

E lembre que servidor stdio é um processo com o mesmo usuário do Claude Code: ele enxerga o que esse usuário enxerga. É mais um motivo para o Claude Code ficar nos containers, e não no host.

Vocês já usam algum servidor MCP no dia a dia? Qual resolveu um problema de verdade, e não só curiosidade?

O post completo está no meu blog: https://blog.brumarino.com/mcp-claude-code/?de=tabnews

Carregando publicação patrocinada...
1

O detalhe sobre mcp__ genérico ser ignorado no allow confirma que a segurança depende de explicitar o servidor, mudando a arquitetura de confiança. No caso de stdio, o servidor executa com o mesmo UID do agente, herdando o ambiente do sistema operacional e o acesso a sockets ou volumes montados. Restrições no JSON não isolam isso; a fuga de dados acontece no nível do kernel, contornando a camada de aplicação.

Para mitigar isso em containers, a isolação com usuário de baixa privilégio e restrição de sockets críticos é mais eficiente que mTLS para stdio. Já para HTTP, o mTLS se torna essencial quando o servidor está em outra máquina.

0
1

Respondendo à pergunta do fim: o que mais uso de verdade é um servidor do Google Search Console, em escopo project (no .mcp.json). Resolveu exatamente o caso do "copiar do painel e colar no chat": perguntar impressões por página ou o estado de indexação de uma URL direto na conversa.

Uma lição que tirei dele: leia a lista de ferramentas antes de confiar no nome do servidor. Esse, que parece só de consulta, vem com delete_site, delete_sitemap e submit_sitemap.

Por isso a defesa em que mais confio não é o allow/deny, é a credencial. A conta de serviço que ele usa só tem permissão de leitura na propriedade. Se uma injeção de prompt convencer o modelo a apagar alguma coisa, quem recusa é a API do Google, não o Claude Code. O deny nas ferramentas destrutivas fica como segunda camada.

Regra prática que sigo: o servidor recebe a menor credencial que resolve o problema, e as permissões do Claude Code entram por cima, nunca no lugar dela.

0