TokenEconomizer restringe MCP em sidecalls do Claude Code

A alteração é pontual, mas importante para quem conecta ferramentas ao agente. O próprio repositório explica que a opção anterior removia ferramentas nativas do Claude Code, mas não removia os servidores MCP da sessão. O patch tenta limitar a chamada auxiliar ao que ela realmente precisa.

TokenEconomizer usa sidecalls do Claude Code para tarefas auxiliares

O TokenEconomizer é um plugin da Microsoft para reduzir desperdício em sessões de agentes de programação. O README oficial lista Claude Code, Codex, GitHub Copilot CLI e Pi como integrações, além de suporte experimental ao OpenCode. O projeto aprende com sessões anteriores no mesmo repositório e tenta cortar trabalho repetido.

Uma sidecall é uma chamada auxiliar feita pelo plugin para tarefas como propor uma micro habilidade, avaliar se o agente ficou preso em um ciclo ou redigir uma sugestão para tentar outro caminho. Ela não é a sessão principal do desenvolvedor e, em geral, só precisa ler o prompt e devolver texto.

A imagem do repositório oficial do TokenEconomizer resume três mecanismos: micro skills para reutilizar contexto do projeto, poda de ferramentas que nunca são usadas e intervenção quando o agente repete uma falha. O PR recente trata de limitar as ferramentas disponíveis a uma chamada auxiliar do Claude Code.

O PR #89 mudou a configuração MCP das chamadas auxiliares

Antes da correção, a chamada do Claude Code usava --tools "" para remover as ferramentas nativas. O comentário de código do projeto diz que isso não removia os servidores MCP já associados à sessão. Os respectivos esquemas de ferramentas ainda podiam ser incluídos no contexto da sidecall.

O PR #89 acrescenta uma verificação da ajuda do Claude Code para saber se a opção --strict-mcp-config está disponível. Quando está, o TokenEconomizer cria um arquivo temporário de configuração com a lista mcpServers vazia e passa esse arquivo junto da opção restrita.

O código mantém as chamadas de catálogo fora dessa regra, porque elas precisam consultar as ferramentas MCP para descobrir o que está disponível. A mudança, portanto, não desliga os servidores da sessão normal do usuário. Ela busca evitar que sejam anexados a um pedido auxiliar que não precisa chamá-los.

A alteração também inclui um teste de regressão para conferir que uma sidecall não herda os servidores MCP pessoais. O teste preserva separadamente as consultas de catálogo, que precisam continuar enxergando as ferramentas.

503 ferramentas podem ampliar o contexto da sidecall

O código publicado pelo projeto descreve um cenário específico com Claude Code 2.1.301, 31 servidores e 503 ferramentas. Nesse teste, uma chamada de uma linha ao modelo Haiku chegava a cerca de 570 mil tokens efetivos quando os servidores estavam anexados, contra cerca de 14 mil sem eles.

Esses números aparecem como exemplo no comentário da implementação, não como um benchmark independente nem como média de uso. O resultado depende da quantidade e do tamanho das descrições de ferramentas em cada ambiente. Ele ajuda a entender por que uma chamada curta ainda pode levar consigo um contexto muito maior do que o texto enviado.

A diferença não significa que o Claude Code tenha processado 570 mil tokens de resposta. O problema apontado é o contexto efetivo associado às ferramentas disponíveis para aquela chamada. Em um agente que faz várias chamadas auxiliares ao longo de uma sessão, esse tipo de configuração pode multiplicar o trabalho repetido.

Para uma visão geral de como servidores MCP são configurados e conectados a um editor, veja também o guia de MCP no VS Code já publicado no blog. A correção do TokenEconomizer é mais estreita: ela altera o conjunto de servidores fornecido a uma chamada interna do plugin.

A correção depende das opções disponíveis no Claude Code

O código só acrescenta a configuração vazia quando encontra --strict-mcp-config na saída de claude --help. Portanto, o comportamento depende das opções oferecidas pela instalação local. A descrição do PR não afirma que a mesma restrição funciona em toda versão do CLI.

O teste do projeto cobre o caso em que as opções restritas existem e verifica que o arquivo temporário não inclui servidores do usuário. Quem usa uma versão diferente deve confirmar o comportamento na ajuda do CLI e conferir a versão do TokenEconomizer instalada, em vez de assumir que todos os ambientes mudaram da mesma forma.

Também é importante separar a chamada secundária da sessão principal. O patch não remove MCP do Claude Code normal nem altera servidores usados pelas consultas de catálogo do plugin. Ele limita um caminho interno específico, e não constitui uma auditoria independente de segurança do TokenEconomizer ou dos servidores conectados.

A atualização não anuncia um novo modelo, uma mudança no protocolo MCP nem um resultado de desempenho novo. É uma correção no código de integração do TokenEconomizer, registrada no PR #89 da Microsoft, com teste correspondente no repositório.

Como verificar a atualização do TokenEconomizer hoje

Leia o PR e a implementação fundida para identificar se a versão que você usa contém a detecção de --strict-mcp-config. Confirme também se a ajuda do seu Claude Code lista essa opção e se a configuração temporária do plugin deixa mcpServers vazio para sidecalls.

A equipe também publica os testes de regressão no repositório. Eles ajudam a entender o comportamento que o patch pretende garantir, mas não substituem a validação da sua instalação nem provam que outros agentes ou plugins tenham a mesma proteção.

Quem está organizando um fluxo de trabalho com agentes pode complementar essa leitura com o guia de revisão de tarefas delegadas a agentes de código. O ponto comum é limitar o contexto e revisar o que cada agente recebe antes de ampliar as permissões.