Quantos servidores MCP vale deixar ligados no Claude Code ao mesmo tempo?

Conectar mais um servidor MCP é fácil demais, e é exatamente por isso que a sua lista cresceu sem você perceber

A pergunta que importa aqui não é quantos servidores MCP existem por aí

É quantos merecem estar ligados AGORA, nesta sessão, neste projeto

Porque antes de você digitar a primeira mensagem, o Claude Code já carregou um monte de coisa: CLAUDE.md, memória automática, nomes das ferramentas MCP e descrições das skills

Ou seja, você começa a conversa já pagando por tudo que deixou conectado, mesmo sem usar nada disso hoje 🙂

O que cada servidor MCP conectado custa no contexto

O custo vem em duas camadas, e misturar as duas é o que confunde geral

A primeira camada: o que entra antes de você digitar

Aquela lista ali de cima é o piso da sua sessão

CLAUDE.md, memória automática, nomes das ferramentas MCP e descrições das skills entram antes da sua primeira palavra

Então a janela não começa vazia, ela começa com o que você acumulou de configuração

A segunda camada: o que o tool search resolve (e o que ele não resolve)

No Claude Code o tool search fica ativado por padrão: ele segura as definições de ferramentas fora do contexto e carrega só as que o Claude precisa em cada turno

Muito massa, né? Só que tem um detalhe que muita gente ignora

Mesmo com o tool search, cada servidor conectado AINDA ocupa espaço, porque os nomes das ferramentas e as instruções do servidor carregam em toda sessão

As definições completas ficam adiadas, o nome e a instrução não ficam

Se você já mexeu com lazy loading de imagem, é a mesma ideia: a imagem só baixa quando precisa, mas o espaço reservado dela já está lá no documento desde o começo

E tem número nisso? Tem, mas presta atenção de onde ele vem

Antes de qualquer número, o aviso que evita a confusão mais comum: <code>defer_loading: true</code> é configuração da Claude Developer Platform, dentro da Tool Search Tool, não é comando do Claude Code

E é justamente de lá que vêm os números a seguir: eles são da Anthropic sobre a Tool Search Tool da Developer Platform, não são medição do tool search que roda por padrão no Claude Code

No material de uso avançado de ferramentas, a Anthropic aponta redução de 85% no uso de tokens com a Tool Search Tool, mantendo acesso à biblioteca completa de ferramentas

Em tarefas complexas de pesquisa, o uso médio caiu de 43.588 para 27.297 tokens, uma queda de 37%

Só que a parte mais interessante nem é a economia

Em testes internos com bibliotecas grandes de ferramentas, a acurácia em avaliações de MCP subiu com a Tool Search Tool ligada: Opus 4 foi de 49% para 74% e Opus 4.5 foi de 79,5% para 88,1%

Leia isso como ordem de grandeza da ideia de adiar a definição da ferramenta, não como promessa do número que a sua sessão do Claude Code vai marcar

Ainda assim a leitura é direta: se adiar a definição melhora TANTO a acurácia, biblioteca grande demais atrapalha a escolha da ferramenta, não só o orçamento de tokens

São produtos diferentes, e o que vale num não vira flag no outro

Se você ainda está na dúvida sobre quando um servidor MCP compensa, vale resolver isso antes de encher a lista

Sinais de que você tem MCPs demais ligados

Os sintomas que aparecem no dia a dia

• o modelo chama a ferramenta errada entre dois servidores que fazem coisas parecidas
• a sessão já começa com pouca janela sobrando, antes de qualquer trabalho de verdade
• aparece o aviso de que a saída de uma ferramenta MCP passou de 10.000 tokens
• e quando a saída passa de 25.000 tokens, ela é salva em arquivo e o resultado da ferramenta é substituído por uma mensagem apontando o caminho, pro agente ler em partes

Esse último não é bug, é proteção do próprio Claude Code

Mas se ele vira rotina na sua sessão, é sinal de que você está puxando volume demais de ferramenta pra dentro da conversa

A causa

Mais servidores conectados significa duas coisas ao mesmo tempo

Mais nome e mais instrução fixos ocupando contexto desde o turno zero

E mais candidatos ambíguos na hora de escolher qual ferramenta usar

Quando o modelo insiste no caminho errado, nem sempre a culpa é do MCP: às vezes é o ciclo de Claude Code repetindo o mesmo erro, que é outro problema e tem outra saída

A solução: medir antes de opinar

Dentro da sessão, <code>/context</code> mostra o que ocupa a janela separado por categoria (system prompt, system tools, MCP tools, subagentes, arquivos de memória, skills e mensagens da conversa), com sugestões de otimização

Olha a fatia de MCP tools primeiro, é ela que responde a pergunta do post

Depois, <code>/mcp</code> serve pra checar e gerenciar os servidores já adicionados naquela sessão

E fora da sessão, no terminal:

claude mcp list

Isso lista os servidores MCP configurados

Pra prevenir, o hábito é simples: revisar a lista quando você troca de projeto, em vez de acumular por inércia

Servidor MCP não é decoração, se ele não trabalha nesta semana, ele não precisa estar de plantão

Sempre ligado, sob demanda ou fora: como classificar cada servidor

Três faixas, e cada servidor cai em uma delas

Duas observações que evitam dor de cabeça

Colocar o servidor em <code>disabledMcpjsonServers</code> bloqueia ele em todos os modos de permissão, e essa chave (junto com <code>enabledMcpjsonServers</code>) controla a aprovação dos servidores definidos no <code>.mcp.json</code> do projeto

Já <code>allowedMcpServers</code> e <code>deniedMcpServers</code> filtram servidores MCP valendo inclusive pra servidores gerenciados, e a denylist tem precedência sobre a allowlist

Ou seja: se o mesmo servidor aparecer nas duas listas, ele fica de fora, não adianta discutir 😀

Três configurações de MCP que fazem sentido no dia a dia

Projeto único, rotina fixa

Você passa o dia no mesmo repositório e usa sempre as mesmas duas ou três integrações

Aqui o caminho é o mais preguiçoso possível (e isso é bom): poucos servidores no escopo local, que é o padrão do <code>claude mcp add</code>, ou no <code>–scope project</code> se o time também usa, e nada além disso

O que fica ligado: só o que a rotina usa

O que entra sob demanda: nada, porque não tem nada sobrando

Você alterna entre muitos repositórios

Esse é o cenário onde a lista incha mais rápido, porque a tentação de jogar tudo no escopo user é enorme

A divisão que funciona: o essencial mesmo em <code>–scope user</code>, registrado uma vez pra todos os projetos, e o resto registrado por projeto

Assim você para de arrastar a integração de UM projeto pra dentro de TODA pasta que abre

O que fica ligado sempre: o que você usaria em qualquer repo

O que fica ligado só num repo: o que é específico daquele produto, registrado no projeto onde ele trabalha

O que entra sob demanda: o que nem por projeto se justifica, esse vai pro arquivo de <code>–mcp-config</code> e só aparece na sessão que chamar por ele

Time compartilhando o mesmo .mcp.json

Aqui a decisão deixa de ser sua e vira acordo coletivo

Os servidores do time vão pro <code>–scope project</code>, e o controle de quem é aprovado passa por <code>enabledMcpjsonServers</code> e <code>disabledMcpjsonServers</code>

E quando alguém precisa de uma tarefa pontual com uma ferramenta que não é do combo padrão, essa sessão nasce isolada com <code>–strict-mcp-config</code>

O que fica ligado: o combo que o time inteiro usa

O que entra sob demanda: a exceção, na sessão da exceção

Como enxugar seus servidores MCP em 5 passos

Passo 1: faça o inventário

claude mcp list

O erro comum deste passo: confiar na memória e listar de cabeça

Sempre tem um servidor que você adicionou há três meses e esqueceu completamente que existia

Passo 2: meça dentro da sessão com /context

Abre o Claude Code no projeto e roda <code>/context</code>

Olha a categoria MCP tools e lê as sugestões de otimização que ele mostra

O erro comum deste passo: medir depois de uma conversa gigante e culpar o MCP pelo que na verdade é histórico de mensagem

Mede no começo da sessão, aí o número é honesto

Passo 3: classifique cada servidor nas três faixas

Sempre ligado, sob demanda ou fora, item por item, sem dó

O erro comum deste passo: colocar tudo em "sempre ligado" porque "vai que eu preciso"

Se é "vai que", é sob demanda

Passo 4: execute a decisão

Pra quem fica: escolhe o escopo na hora de adicionar, lembrando que o padrão do <code>claude mcp add</code> é o local (privado pra você e ativo só no projeto atual)

claude mcp add <nome> --scope user
claude mcp add <nome> --scope project

Pra quem é sob demanda no VS Code: digita <code>/mcp</code> e usa o diálogo de gerenciamento, que permite ativar ou desativar servidores, reconectar a um servidor e cuidar da autenticação OAuth

Pra quem sai de vez:

claude mcp remove claude-code-docs --scope local

O comando responde confirmando a remoção e mostra o arquivo que atualizou, então dá pra conferir na hora

E se o servidor vem do <code>.mcp.json</code> do projeto ou é gerenciado, o bloqueio é por <code>disabledMcpjsonServers</code> ou <code>deniedMcpServers</code>

O erro comum deste passo: remover no escopo errado e achar que sumiu

Se o servidor estava registrado em user e você removeu em local, ele continua vivo, aparecendo alegremente no próximo projeto que você abrir

Passo 5: crie a sessão enxuta de exceção

claude --strict-mcp-config --mcp-config <arquivo>

Com <code>–strict-mcp-config</code> o Claude Code usa apenas os servidores passados via <code>–mcp-config</code> e ignora os demais

É a sua sessão limpa pra tarefa específica

E se algum servidor realmente precisa estar pronto no primeiro turno, com schema completo, aí sim vale marcar <code>alwaysLoad: true</code> na configuração dele

O erro comum deste passo: confundir configuração da Claude Developer Platform com opção do Claude Code

<code>defer_loading</code> é de lá, <code>alwaysLoad</code> e <code>–strict-mcp-config</code> são daqui, não misture os dois no mesmo arquivo

Conclusão

A regra de bolso é essa: contexto é orçamento, e cada servidor conectado é uma assinatura mensal desse orçamento

Não existe número mágico de servidores MCP no Claude Code, existe a sua janela e o que você escolheu colocar dentro dela antes de começar a trabalhar

O tool search já economiza muito por padrão, mas nome e instrução continuam entrando, e biblioteca grande demais piora a escolha da ferramenta

Próximo passo, hoje mesmo: abre uma sessão, roda <code>/context</code>, roda <code>/mcp</code> e corta o primeiro servidor que você não usa há semanas

Se ainda tem tarefa que precisa dele de vez em quando, joga num arquivo de <code>–mcp-config</code> e chama só quando for a hora

Depois roda <code>/context</code> de novo e compara, é o tipo de faxina que dá gosto de ver o número cair 😀

até o próximo post!