Tool Search e trabalho inteligente
Como o Claude Code se mantém rápido com dezenas de MCP servers
⏱ Estim. ~4 min
01 · Ler
O problema que você não imagina: quanto mais MCP servers você adiciona, mais lento o Claude fica.
Por quê? Cada MCP server expõe ferramentas — e cada ferramenta tem uma descrição que o Claude precisa ler. Se você tem 10 servers, cada um com 15 ferramentas, são 150 descrições de ferramenta carregadas no context window do Claude antes mesmo de você perguntar qualquer coisa. Isso come o espaço para a conversa de verdade.
É como tentar fazer uma reunião onde todo mundo precisa ler o currículo completo de cada um antes de poder discutir o projeto.
Pontos-chave
- Cada ferramenta MCP tem uma descrição que consome tokens de contexto
- Mais servers = mais descrições de ferramenta = menos espaço para conversa
- 10+ servers podem consumir uma parcela significativa do contexto
- É exatamente isso que o Tool Search resolve
02 · Ler
Tool Search é a solução do Claude Code. Em vez de pré-carregar todas as ferramentas de todos os servers, ele adia. Quando você faz uma pergunta, o Claude usa uma ferramenta de busca para descobrir quais ferramentas MCP são relevantes, carrega só essas e continua.
Automático — você não precisa configurar. O Tool Search é ativado quando as descrições das suas ferramentas MCP passariam de 10% do context window.
Resultado? Você pode conectar dezenas de MCP servers sem gastar contexto com ferramentas que não vai usar.
Pontos-chave
- Tool Search carrega ferramentas MCP sob demanda, não antecipadamente
- Ativa automaticamente quando ferramentas passam de 10% do contexto
- Só carrega as ferramentas que o Claude precisa de fato para a tarefa atual
- Permite rodar muitos MCP servers sem custo de performance
03 · Exemplo de código
O Tool Search vem ligado por padrão, mas você pode ajustar. A variável de ambiente ENABLE_TOOL_SEARCH controla o comportamento dele.
Padrão (auto — ativa em 10% do contexto)
claude
Limiar customizado (ativa em 5%)
ENABLE_TOOL_SEARCH=auto:5 claude
Desativado de vez (todas as ferramentas pré-carregadas)
ENABLE_TOOL_SEARCH=false claude
A maioria dos usuários não precisa mexer aqui — o modo auto padrão funciona bem. Diminua o limiar se você tem muitos servers. Só desative se estiver depurando um problema com a descoberta de ferramentas.
04 · Ler
Dentro do Claude Code, o comando /mcp é o painel de controle dos seus MCP servers. Digite /mcp para ver todos os servers conectados e seus status.
Verde quer dizer conectado; se um server precisa de autenticação (como GitHub ou Sentry), o /mcp te guia pelo login OAuth — abre o navegador, você faz login e o Claude recebe o acesso.
Você também pode limpar autenticação, ver erros e checar quais ferramentas cada server oferece. Pense no /mcp como o dashboard de todas as suas conexões MCP.
Pontos-chave
- /mcp mostra todos os servers e o status da conexão
- Use para autenticar com servers OAuth (GitHub, Sentry etc.)
- "Clear authentication" recupera o acesso quando precisa
- Primeiro lugar para checar quando um MCP server não está funcionando
05 · Quiz
Você configurou 20 MCP servers e o Claude parece lento. Qual recurso reduz o uso de contexto automaticamente, carregando ferramentas sob demanda?
- Cache de MCP
- Server batching
- Tool Search
- Compressão de contexto
06 · Preencher
Dentro do Claude Code, digite /_____ para ver o status de todos os MCP servers e autenticar com serviços OAuth.
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.