MCP no Claude Code é a forma de conectar o agente a ferramentas externas, como navegador, banco de dados e APIs. Você adiciona um servidor com claude mcp add, escolhe o escopo (local, projeto ou usuário) e confere com /mcp.
O MCP no Claude Code é o que tira o agente de dentro da pasta do projeto. Sem ele, o Claude lê arquivo, roda comando e busca na web. Com ele, consulta o seu banco, abre uma página num navegador de verdade, lê uma issue do GitHub ou puxa relatório de uma API. Este guia segue a documentação oficial de MCP do Claude Code, consultada em 14 de outubro de 2026. Os comandos abaixo foram copiados dela e dos repositórios oficiais de cada servidor citado.
O que é MCP?
MCP é a sigla de Model Context Protocol, um protocolo aberto para ligar modelos de IA a ferramentas e dados. Funciona como uma tomada padrão: quem constrói um serviço publica um servidor MCP, e qualquer cliente compatível, como o Claude Code, se conecta a ele sem integração sob medida.
Um servidor MCP pode oferecer três coisas:
- Ferramentas que o Claude chama sozinho quando a tarefa pede, como "rodar consulta" ou "tirar print da página".
- Recursos que você cita com
@no prompt, no formato@servidor:protocolo://caminho. - Prompts que viram comandos no menu
/, listados como/servidor:prompt (MCP).
A documentação dá exemplos do que isso permite: implementar uma funcionalidade a partir de uma issue do Jira, consultar um banco PostgreSQL, atualizar um modelo de e-mail a partir de um design do Figma ou criar rascunhos no Gmail.
Como adicionar um servidor MCP no Claude Code
Tudo começa no comando claude mcp add, rodado no terminal, fora da sessão. A forma muda conforme o tipo de servidor.
Servidor remoto por HTTP (o recomendado)
claude mcp add --transport http <nome> <url>
# exemplo da documentação
claude mcp add --transport http notion https://mcp.notion.com/mcp
Se o servidor pede token fixo, passe um cabeçalho com --header "Authorization: Bearer seu-token". Se ele usa login OAuth, rode /mcp dentro do Claude Code e conclua o login no navegador.
Servidor local por stdio
claude mcp add [opções] <nome> -- <comando> [argumentos...]
# exemplo da documentação, com variável de ambiente
claude mcp add --env AIRTABLE_API_KEY=SUA_CHAVE --transport stdio airtable \
-- npx -y airtable-mcp-server
O -- separa as opções do Claude Code do comando que inicia o servidor. Tudo depois dele é o programa que vai rodar na sua máquina.
Gerenciar o que já está instalado
claude mcp list # lista os servidores e o status de cada um
claude mcp get notion # detalhes de um servidor
claude mcp remove notion # remove
Dentro da sessão, o comando /mcp mostra o status, faz a autenticação e deixa desligar um servidor sem apagar a configuração. No claude mcp list, os status mais comuns são ✔ Connected, ! Needs authentication e ✘ Failed to connect.
Escopos do MCP: local, projeto e usuário
A flag --scope decide quem enxerga o servidor:
| Escopo | Vale em | Compartilhado | Onde fica salvo |
|---|---|---|---|
local (padrão) | Só no projeto atual | Não | ~/.claude.json |
project | Só no projeto atual | Sim, pelo Git | .mcp.json na raiz do projeto |
user | Todos os seus projetos | Não | ~/.claude.json |
claude mcp add --transport http shared-server --scope project https://example.com/mcp
O arquivo .mcp.json de projeto tem este formato, e aceita variável de ambiente com ${VAR} para a chave não ir para o Git:
{
"mcpServers": {
"api-server": {
"type": "http",
"url": "${API_BASE_URL:-https://api.example.com}/mcp",
"headers": {
"Authorization": "Bearer ${API_KEY}"
}
}
}
}
Se o mesmo nome existe em mais de um lugar, vence o local, depois o de projeto, depois o de usuário. Servidor que vem de .mcp.json precisa da sua aprovação na primeira sessão interativa; até lá aparece como ⏸ Pending approval.
Tipos de transporte do MCP
| Transporte | Como adicionar | Quando usar | Situação |
|---|---|---|---|
| HTTP | --transport http | Servidor remoto, hospedado pelo próprio serviço | Recomendado |
| SSE | --transport sse | Servidor remoto antigo que ainda não oferece HTTP | Obsoleto segundo a documentação |
| stdio | --transport stdio e o comando depois de -- | Servidor que roda como processo na sua máquina (npx, pipx, binário) | Padrão para servidor local |
| WebSocket | claude mcp add-json com "type":"ws" | Servidor que só fala WebSocket | Não aceito em --transport |
Quem já tem a configuração em JSON, copiada da instrução de outro cliente, pode usar claude mcp add-json nome '{...}' direto.
Exemplos de MCP úteis no Claude Code
Estes servidores existem, têm instrução pública e foram conferidos na fonte em 14/10/2026. Antes de instalar, leia o repositório de cada um.
Navegador: Playwright MCP
Deixa o Claude abrir páginas, clicar, preencher formulário e tirar print. Útil para testar um site depois do deploy ou olhar a página de um concorrente. O comando do repositório oficial da Microsoft:
claude mcp add playwright npx @playwright/mcp@latest
O próprio README avisa que o Playwright MCP não é uma barreira de segurança e que a ferramenta que executa JavaScript arbitrário deve ficar desligada se você não precisa dela.
Banco de dados: PostgreSQL e Supabase
A documentação do Claude Code usa o DBHub como exemplo e recomenda conectar com um usuário só de leitura:
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
--dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"
Para Supabase, a documentação da Supabase indica o servidor remoto e oferece o parâmetro ?read_only=true para rodar tudo como usuário de leitura e ?project_ref= para limitar a um projeto:
claude mcp add --scope project --transport http supabase "https://mcp.supabase.com/mcp"
Google Ads
O repositório googleads/google-ads-mcp traz um servidor que consulta a API do Google Ads. As ferramentas listadas lá são de leitura e relatório (search, get_resource_metadata e list_accessible_customers), e a instalação exige projeto no Google Cloud com a API ativa, credenciais e um developer token aprovado. Serve para perguntar sobre campanhas em linguagem natural. Para criar ou pausar campanha, não conte com ele.
GitHub, Notion, Stripe e outros
A documentação lista servidores remotos de GitHub, Notion, Sentry, Stripe e HubSpot, e aponta o diretório da Anthropic para achar conectores revisados. Qualquer servidor remoto de lá pode ser adicionado com claude mcp add.
Segurança: o que conferir antes de instalar um MCP
Servidor MCP é código de terceiro com acesso ao que você der para ele. A documentação é direta: confirme que confia em cada servidor antes de conectar, porque servidores que buscam conteúdo externo podem expor você a prompt injection (texto escondido numa página ou num documento que tenta dar ordens ao Claude).
- Instale só servidor de quem mantém o serviço ou de repositório que você leu. Desconfie de pacote com nome parecido com o oficial.
- Servidor stdio roda como programa na sua máquina, com as suas permissões. Trate como qualquer software que você instala.
- Dê o menor acesso possível: usuário de banco só de leitura, token com escopo limitado, projeto isolado em vez da conta inteira.
- Nunca conecte em produção sem necessidade. A própria Supabase recomenda modo de leitura e escopo por projeto para dado real.
- Guarde chave em variável de ambiente, não dentro do
.mcp.jsonque vai para o Git. - Repositório clonado não aprova os próprios servidores: o Claude Code pede a sua aprovação. Leia antes de aceitar.
- Mantenha a aprovação manual de ferramenta ligada em trabalho interativo e revise o que o servidor devolve antes de agir.
MCP pesa no contexto e no limite de uso?
Menos do que pesava. Hoje a busca de ferramentas vem ligada por padrão: no começo da sessão entram só os nomes das ferramentas e as instruções do servidor, e a definição completa carrega quando o Claude vai usar. A saída também tem teto: o Claude Code avisa quando uma resposta passa de 10 mil tokens e corta em 25 mil por padrão, ajustável pela variável MAX_MCP_OUTPUT_TOKENS. Mesmo assim, a página de custos do Claude Code recomenda preferir ferramenta de linha de comando (como gh ou gcloud) quando ela existe e desligar no /mcp o servidor parado. Quem está de olho no limite do plano encontra mais dicas no guia de preço do Claude Code.
MCP também não substitui as outras peças. Processo repetível vira skill do Claude Code, regra obrigatória vira hook, e o MCP entra quando o dado mora fora da pasta. Se você está começando agora, veja antes como usar o Claude Code do zero.
No kntriaOS isso já vem montado
O kntriaOS não depende de servidor MCP para entregar. As peças dele são comandos, hooks, um agente revisor e scripts de apoio. Como o kntriaOS é uma pasta comum do Claude Code, qualquer servidor deste guia entra por cima, no escopo de projeto, sem conflito. Custa R$ 29,90 por mês e roda com a sua assinatura do Claude Pro ou Max. Se a sua empresa precisa de integração sob medida com banco, CRM ou WhatsApp, a kntrIA faz automação com IA para empresas.
Perguntas frequentes
O que é MCP no Claude Code?
MCP (Model Context Protocol) é um protocolo aberto que liga o Claude Code a ferramentas externas. Cada servidor MCP expõe ferramentas, como consultar um banco ou abrir uma página, que o Claude pode chamar durante a sessão.
Como adicionar um servidor MCP no Claude Code?
Use claude mcp add no terminal. Para servidor remoto: claude mcp add --transport http nome url. Para servidor local: claude mcp add nome -- comando. Depois confira com /mcp dentro do Claude Code.
Onde fica a configuração do MCP?
Nos escopos local e de usuário, em ~/.claude.json. No escopo de projeto, no arquivo .mcp.json na raiz do repositório, que pode ir para o Git.
MCP deixa o Claude Code mais lento ou mais caro?
Pouco, na configuração padrão. A busca de ferramentas carrega só os nomes no começo da sessão e as definições completas quando o Claude precisa. Mesmo assim, desligue no /mcp o servidor que você não está usando.
É seguro instalar qualquer servidor MCP?
Não. A documentação manda confirmar que você confia em cada servidor antes de conectar. Servidor que busca conteúdo externo abre risco de prompt injection, e servidor local roda código na sua máquina.
SSE ainda funciona no Claude Code?
Funciona, mas a documentação marca o transporte SSE como obsoleto e recomenda HTTP sempre que o servidor oferecer.
Continue no assunto
Antes de conectar ferramenta, monte o sistema.
O kntriaOS entrega o Claude Code com comandos de marketing, DNA por cliente, hooks e revisor prontos. Os servidores MCP que você quiser entram por cima, na mesma pasta.
