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
| Escopo | Vale em | Vai para o git? |
|---|---|---|
local (padrão) | Projeto atual | Não (~/.claude.json) |
project | Projeto atual | Sim (.mcp.json) |
user | Todos os seus projetos | Nã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 servidorarquivos;- 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