O que são servidores MCP no Claude Code e quando eles valem a pena?

O Claude Code conhece o seu repositório de cor, e não sabe absolutamente nada do resto do seu mundo

O ticket que está no board, o schema que vive no Postgres, a thread do Slack onde alguém decidiu mudar o contrato da API, a doc que atualizou ontem: nada disso está no código, então nada disso chega até o agente sozinho

MCP é a resposta padronizada pra esse problema

E já aviso o final: este post termina em veredito, e o veredito não é "liga tudo". Nem todo servidor MCP merece estar ligado na sua máquina 🙂

O que é o Model Context Protocol (e por que ele existe)

O Model Context Protocol é um padrão aberto pra conectar assistentes de IA aos sistemas onde os dados realmente vivem: repositórios de conteúdo, ferramentas de negócio, ambientes de desenvolvimento

Foi anunciado pela Anthropic em novembro de 2024, e o problema declarado no anúncio é bem específico: o modelo fica isolado em silos de informação, e cada nova fonte de dados exige uma implementação customizada

Ou seja, era N integrações pra N ferramentas, cada uma do seu jeito

A analogia oficial da documentação é a porta USB-C pra aplicações de IA

Um plugue padronizado: em vez de inventar um cabo novo pra cada aparelho, você usa o mesmo encaixe

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 120 aulas
• 4 projetos
• 9h 45min

Conhecer formação

Servidor e cliente: quem expõe e quem consome

Essa parte confunde muita gente no começo, então vamos separar

• Servidor MCP: quem EXPÕE dados e ferramentas (o GitHub, o Postgres, uma doc, um navegador)
• Cliente MCP: a aplicação que CONSOME isso e conversa com o servidor (o Claude Code, por exemplo)

Quando você lê "vou adicionar um servidor MCP", entenda: você está plugando uma fonte externa no agente, e o agente é o cliente

E isso pegou mesmo?

Pegou

No anúncio da doação do projeto pra Agentic AI Foundation, em dezembro de 2025, os números divulgados foram: mais de 97 milhões de downloads mensais dos SDKs e mais de 10.000 servidores ativos

Com suporte de primeira classe em clientes como ChatGPT, Claude, Cursor, Gemini, Microsoft Copilot e Visual Studio Code

E aqui entra o ponto que mais importa pra quem decide onde investir tempo: o MCP deixou de ser um projeto sob controle exclusivo da Anthropic

Ele é projeto fundador da Agentic AI Foundation, um fundo dirigido dentro da Linux Foundation, cofundada por Anthropic, Block e OpenAI, com apoio de Google, Microsoft, AWS, Cloudflare e Bloomberg

O board decide investimento, orçamento e novos projetos, mas a direção técnica continua com os mesmos mantenedores e com o processo SEP de input da comunidade

Tradução: é padrão de indústria, não feature de fornecedor

A especificação atual

A versão atual da spec é a 2026-07-28, a maior revisão do protocolo desde o lançamento

A mudança principal é um núcleo stateless na camada de transporte: saíram as sessões em nível de protocolo e o header Mcp-Session-Id, pra que o MCP escale em infraestrutura HTTP comum

A mesma revisão trouxe a primeira política formal de depreciação, com o ciclo Active > Deprecated > Removed e janela mínima de 12 meses

Isso é sinal de maturidade, e não de instabilidade: protocolo que promete janela de depreciação está pensando em quem depende dele em produção

Como um servidor MCP aparece dentro do Claude Code

Na prática, servidor registrado vira ferramenta disponível pro agente

Mas disponível não significa liberada

As ferramentas de servidores MCP exigem permissão explícita antes de o Claude poder usá-las. Sem permissão concedida, ele ENXERGA que a ferramenta existe e simplesmente não consegue chamar

Se você já tem prática em aprovar ou negar comandos do Claude Code, o modelo mental é o mesmo aqui

Os dois transportes: stdio e HTTP

• stdio: o servidor roda como subprocesso local e troca mensagens por entrada e saída padrão. Indicado quando o servidor está na mesma máquina
• HTTP: a opção recomendada pra servidores remotos, e o transporte mais suportado em serviços na nuvem

Um detalhe que confunde na hora de escrever o JSON: no campo type, o valor streamable-http funciona como alias de http, porque a especificação usa esse nome pro transporte

Pra servidores remotos, o Claude Code tem suporte nativo a OAuth: você autentica uma vez no servidor e não precisa gerenciar chaves de API nem armazenar credencial na mão

Escopos: quem enxerga esse servidor?

O escopo define em quais projetos o servidor carrega e se a configuração é compartilhada com o time

• Local: privado pra você e ativo só no projeto atual (fica em ~/.claude.json, sob o caminho daquele projeto)
• User (--scope user): registra uma vez e vale pra todos os seus projetos
• Project (--scope project): grava um .mcp.json no diretório atual pra compartilhar via controle de versão. O Claude Code lê esse arquivo na inicialização

Escolher escopo é decisão de time, não detalhe técnico

Servidor que só você usa em um projeto não tem por que virar arquivo versionado pra todo mundo carregar

E na empresa, dá pra controlar?

Dá

O administrador pode restringir quais servidores MCP rodam na organização, desde implantar um conjunto fixo aprovado até desabilitar MCP por completo

Também é possível definir oauth.scopes pra fixar os escopos que o Claude Code pede no fluxo de autorização, restringindo o servidor a um subconjunto aprovado

Como adicionar um servidor MCP no Claude Code

Bora ver na prática?

O caminho mais curto tem cinco passos, e cada um tem um erro clássico junto

1. Registre o servidor pelo terminal, FORA da sessão do Claude

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

O nome do servidor (aqui, claude-code-docs) é escolhido por você. O comando grava os dados do servidor em um arquivo de configuração

Erro comum deste passo: tentar rodar claude mcp add DENTRO da sessão do Claude Code. Ele é comando de terminal, não comando de sessão

2. Ou configure via JSON, se preferir

Existe o claude mcp add-json pra configuração em JSON, e existe o caminho de escrever o .mcp.json na raiz do projeto direto:

{
  "mcpServers": {
    "claude-code-docs": {
      "type": "http",
      "url": "https://code.claude.com/docs/mcp"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

Repara nos dois formatos convivendo: um remoto por HTTP e um local rodando via npx

Erro comum deste passo: colocar segredo dentro do .mcp.json de projeto. Esse arquivo existe pra ser versionado e compartilhado com o time, então tudo que entra ali vai junto pro repositório. Tome cuidado!

3. Escolha o escopo conforme quem precisa do servidor

Só você, naquele projeto? Local

Só você, em todos os projetos? --scope user

O time inteiro, naquele repositório? --scope project

Erro comum deste passo: registrar no escopo user aquilo que era específico de um projeto, e aí o servidor passa a carregar em TODA sessão sua, cobrando contexto onde ele não serve pra nada

4. Abra a sessão e confira com /mcp

/mcp

Esse é o comando de sessão do Claude Code pra verificar e gerenciar os servidores já configurados

5. Conceda permissão às ferramentas

Erro comum deste passo (e o mais frequente de todos): achar que servidor aparecendo na lista já significa ferramenta liberada. Não significa. Enquanto a permissão não é concedida, o Claude vê e não usa

Quando um servidor MCP resolve um problema real

No lançamento, a Anthropic publicou servidores prontos pra sistemas populares: Google Drive, Slack, GitHub, Git, Postgres e Puppeteer

Essa lista já desenha bem os casos que valem a pena

• Contexto que não está no repositório: a decisão está no Drive ou na thread do Slack, e o código só mostra o resultado. O servidor traz a origem da decisão pro agente
• Dado de banco em vez de chute: com um servidor de Postgres plugado, o agente consulta o schema real em vez de adivinhar nome de coluna. Quem já viu IA inventar tabela sabe o tamanho da diferença
• Documentação atualizada do produto: é exatamente o caso do exemplo oficial por HTTP, com a doc do próprio Claude Code exposta como servidor. O agente consulta a versão de hoje, não a versão que ele decorou no treino
• Dirigir o navegador: com Puppeteer ou Playwright, o agente abre a página e verifica comportamento em vez de afirmar que "deve funcionar"
• Fluxo de repositório: GitHub e Git como servidores colocam issue, PR e histórico dentro do alcance do agente

O critério pra reconhecer o caso bom é simples, e cabe em uma pergunta

O agente precisa de um dado ou de uma ação VIVA, de forma RECORRENTE, que hoje você copia e cola na mão?

Se a resposta é sim nas três palavras (viva, recorrente, manual), o servidor MCP ganhou o lugar dele

Se é uma consulta que você fez uma vez esse mês, colar o texto na sessão é mais barato e mais rápido

Vale a pena ou só adiciona complexidade? Tabela de decisão

Aqui a comparação é de CRITÉRIO, não de benchmark

Repara no padrão: quase toda linha vira a mesma pergunta, que é RECORRÊNCIA vezes CONTEXTO VIVO

Os dois custos escondidos: contexto inflado e conteúdo externo

MCP não é grátis. Ele cobra em dois lugares, e os dois só aparecem depois que você já ligou meia dúzia de servidores

Sintoma 1: a sessão fica pesada e o contexto acaba rápido

A causa é direta: as definições das ferramentas são carregadas antecipadamente

Cada servidor traz o catálogo dele inteiro pro contexto, use você ou não

A Anthropic publicou uma abordagem de code execution com MCP exatamente por causa disso: no material de engenharia, um fluxo complexo que consumia mais de 150.000 tokens só em definições de ferramentas cai pra cerca de 2.000 tokens quando os servidores MCP são apresentados como APIs de código em vez de chamadas diretas de ferramenta

A ideia é carregar só as ferramentas necessárias e processar os dados no ambiente de execução antes de devolver ao modelo

Existe também um mecanismo oficial de tool search: ferramentas marcadas com defer_loading: true não entram no contexto inicial e são descobertas sob demanda

ATENÇÃO neste ponto, porque é onde muito post erra: defer_loading e a variável ENABLE_TOOL_SEARCH (com modos como auto:5, que liga o tool search quando as definições adiáveis atingem uma porcentagem do contexto) estão documentados no Agent SDK, na opção env do query()

Não é menu do CLI do Claude Code, e eu não vou te ensinar um passo que não confirmei

A solução prática pro dia a dia continua sendo a chata e eficaz: reduzir a superfície ligada

E se você anda esbarrando nos limites de uso do Pro e do Max, vale olhar quantos servidores estão pendurados em toda sessão antes de culpar o plano

Sintoma 2: o servidor traz texto que você não escreveu

A documentação oficial do Claude Code é explícita: servidores MCP que buscam conteúdo externo expõem o usuário a risco de prompt injection

Faz sentido, né? Se o servidor puxa uma página, uma issue ou um documento, o que vem de lá é texto não confiável entrando na mesma conversa em que o agente tem ferramentas na mão

Como reduzir o risco:

• permissão explícita por ferramenta, sem liberar em bloco por preguiça
• preferir servidores conhecidos e mantidos
• usar o registro oficial em registry.modelcontextprotocol.io, lançado em 8 de setembro de 2025 como release em preview (com aviso da própria equipe de que mudanças quebradoras ou resets de dados podem acontecer antes do GA)
• em empresa, usar o controle administrativo: conjunto aprovado, MCP desabilitado ou oauth.scopes travado

Veredito: MCP vale a pena, servidor demais não

O padrão está consolidado

Governança na Agentic AI Foundation dentro da Linux Foundation, adoção de primeira classe em clientes concorrentes, spec 2026-07-28 com política formal de depreciação

Aprender MCP é investimento seguro, e essa parte é fácil de defender

O que NÃO vale é o reflexo de ligar tudo que aparece no timeline

Cada servidor cobra contexto antes mesmo de ser usado, e cada servidor que busca conteúdo externo amplia a superfície de risco

A régua de bolso que eu deixaria:

• comece com ZERO servidor ligado
• adicione um por dor concreta, e uma dor de cada vez
• mantenha no escopo certo (local, user ou project, conforme quem precisa)
• remova o que você não usou na semana

Servidor MCP é ferramenta na bancada, não coleção

Próximo passo

Escolhe a dor mais repetida da sua rotina com o Claude Code

Aquela coisa que você copia e cola na mão toda vez: o schema, a doc, a issue, o resultado de uma consulta

Registra UM servidor pra ela com claude mcp add, no escopo adequado, confere com /mcp, concede a permissão e usa por uma semana

Se em sete dias ele não foi útil, tira

Se foi, aí sim você tem critério pra escolher o segundo 😀

até o próximo post!