Contexto MCP no Claude Code: manter a ferramenta ou usar um comando?
Um procedimento reversível para avaliar o efeito de um servidor MCP no contexto do Claude Code sem prometer economia fixa de tokens.
Conteúdo
Contexto MCP no Claude Code: manter a ferramenta ou usar um comando?
Um servidor MCP ajuda quando o Claude Code precisa acessar algo fora do diretório de trabalho: tickets, uma API interna, banco de dados ou dados de observabilidade. Ele também leva para a sessão nomes de ferramentas, descrições, schemas de entrada e ações possíveis. A decisão deve ser tomada por tarefa: este trabalho exige acesso externo repetido ou uma ação local curta resolve?
Não desligue todos os servidores por causa de uma resposta longa. Escolha uma tarefa curta, repetível e sem efeito externo, meça o estado atual e limite somente um servidor. Número de turnos, chamadas realmente necessárias e resultado verificável são evidências melhores que a impressão de que o contexto ficou grande.
Se você testa um workflow de API separado para Claude Code, abra o guia atual da BetterToken, execute duas vezes o mesmo prompt com o mesmo modelo e compare logo no Dashboard horário, modelo, status, tokens de input/output/cache e consumo exibido. Assim, a suspeita de contexto excedente vira um teste A/B verificável. Comece com uma tarefa read-only e não salve a chave de API no repositório.
De onde vem o contexto adicional
A documentação MCP do Claude Code descreve servidores como conexões com ferramentas e dados externos. Para o modelo, não existe apenas o resultado de uma chamada: antes dela, propósito, parâmetros e limites das ferramentas já fazem parte da interface disponível. Um servidor amplo, com muitas ferramentas sem filtro, aumenta a quantidade de opções a considerar.
Isso não cria um “custo MCP” fixo. A medição depende do servidor, das ferramentas ativadas, do prompt, do modelo, do histórico da sessão e dos resultados retornados. Separe pelo menos estes casos:
- muitos schemas são anunciados mesmo quando nenhuma ferramenta é necessária;
- uma chamada devolve um resultado grande que os próximos turnos precisam interpretar;
- um resultado amplo demais provoca buscas ou leituras repetidas;
- ao remover uma ferramenta, perde-se uma validação externa e o agente passa a supor.
Nenhum item explica sozinho todos os tokens. Tamanho do repositório e histórico também alteram a comparação.
Escolher a menor interface útil
| Situação | Comece com | Motivo |
|---|---|---|
| Ler e atualizar tickets repetidamente | MCP estreito do rastreador | A tarefa precisa de um modelo externo de objetos reutilizável. |
| Verificar uma vez um status local | comando local ou arquivo de status | O fato já existe no workspace. |
| Ler uma API interna em muitas tarefas | ferramentas MCP read-only com escopo pequeno | O acesso fica repetível e revisável. |
| Abrir um documento do repositório | busca e leitura de arquivo | Não é necessário um catálogo externo de ferramentas. |
| Alterar estado externo | checagem manual ou read-only primeiro | Autorização, idempotência e verificação continuam necessárias. |
Frequência e limite dos dados importam mais que a popularidade de um servidor. Para um único status do Git, um comando costuma ser menor. Um comando, porém, não substitui uma interface segura quando há várias operações relacionadas sobre dados externos com schema definido.
Medir uma tarefa comparável
Escolha uma tarefa sem efeito externo: localizar o responsável por um arquivo alterado, verificar status local ou ler itens abertos em um projeto de teste. Não compare tarefas diferentes nem conclua algo geral a partir de uma sessão excepcionalmente longa.
- Registre prompt, diretório de trabalho e resultado esperado. Exemplo: “mostre os arquivos alterados e sugira um próximo passo sem mudar o repositório”.
- Execute com o perfil MCP atual. Guarde somente observações seguras: turnos, ferramentas usadas, resultado e horário. Não coloque API key,
.envou saída sensível completa na anotação. - Desative exatamente um servidor em
/mcp. A configuração é preservada e o servidor fica marcado como disabled. Feche a sessão, abra uma sessão nova, confira em/mcpque ele continua listado sem conexão e repita o mesmo prompt. - Compare primeiro o fato obtido. O agente encontrou o mesmo dado necessário ou trocou uma chamada útil por uma suposição?
- Reative o servidor em
/mcp, abra outra sessão nova e verifique o status. Restaure-o se sua ausência exigir cópia manual ou remover validação importante. Mantenha a configuração menor se ela preservar o resultado e reduzir chamadas inúteis.
A sessão nova é importante porque a anterior já contém resultados de ferramentas. O teste não mede desempenho universal do Claude Code; ele apoia uma decisão para seu fluxo de trabalho.
Um comando realmente equivalente
Não substitua MCP por qualquer comando. Para o mesmo fato local, este comando read-only pode ser comparável:
git status --shortNas duas variantes, peça apenas a lista de arquivos alterados e um próximo passo sem escrita. Prompt e lista esperada precisam ser iguais. Verifique primeiro a lista, depois turnos, chamadas e tokens. Se o MCP trouxe um fato externo ausente em git status, não há equivalência: mantenha um MCP read-only estreito ou documente um comando para o mesmo sistema.
Reduzir superfície e risco antes de remover
Um servidor pode expor muitos comandos mesmo que o projeto use um ou dois regularmente. Reduza primeiro a superfície:
- ative somente ferramentas read-only no primeiro teste;
- desative integrações que este repositório não usa;
- separe perfis de desenvolvimento, suporte e administração;
- não coloque secrets, logs longos ou histórico de conversa na descrição de uma ferramenta;
- documente operações raras como um comando curto com resultado esperado.
MCP pode ler dados externos ou iniciar ações; sua configuração não substitui a checagem de scope nem a revisão do resultado. Uma resposta do modelo não prova que uma operação externa terminou corretamente.
Comparar uso e custo sem inventar dados
Em um teste de API, configure o Claude Code com sua própria chave BetterToken conforme o guia do Claude Code. BetterToken é acesso API separado, não uma assinatura Claude. A chave é criada e administrada na conta do usuário; não deve entrar no repositório, handoff ou registro do experimento.
O Dashboard BetterToken mostra horário, modelo, status e tokens de input, output e cache com o consumo correspondente. Em cada execução, registre model, data e hora, input, output, cache, custo exibido e turnos. Use o mesmo modelo e o mesmo prompt nos dois casos.
Se o Dashboard mostrar custo, calcule diferença observada = custo com MCP − custo sem MCP. Se só houver tokens, abra antes a página de preços atual, anote data, modelo e regras de cache e use custo = input/1.000.000 × Pinput + output/1.000.000 × Poutput + cache/1.000.000 × Pcache apenas se cache tiver preço separado. Campo vazio ou incerto não é zero; não reutilize preço antigo. A diferença é a observação de duas execuções, não uma tarifa fixa de MCP.
Verificar a decisão na ordem certa
- Fato externo obrigatório. O substituto precisa obter ticket, status, registro de API ou documento necessário, e não adivinhá-lo.
- Correção e limite de acesso. Compare o resultado esperado e mantenha o teste read-only, sem novo secret nem scope mais amplo.
- Validação preservada. Confirme que o substituto não eliminou uma checagem feita pela ferramenta; resposta de modelo não é prova externa.
- Só então custo. Compare turnos, chamadas, tokens input/output/cache e custo do Dashboard com o mesmo prompt em sessão nova.
Se um dos três primeiros itens falhar, menor uso não melhora o fluxo: as tarefas deixaram de ser iguais ou uma pessoa assumiu a validação perdida.
Quando reavaliar a escolha
Restaure o servidor se removê-lo impedir um fato externo necessário, gerar sugestões não verificadas ou obrigar alguém a copiar os mesmos dados em cada prompt. Mantenha o perfil menor se o resultado obrigatório continuar validado com menos chamadas desnecessárias. Um bom perfil MCP costuma ser discreto: cada ferramenta ativa tem uma tarefa recorrente; para o restante há um comando curto, documento ou checagem manual.
