Tool Search e lavorare in modo intelligente
Come Claude Code rimane veloce anche con decine di server MCP
⏱ Stima ~4 min
01 · Leggi
Il problema che non ti aspetti: più server MCP aggiungi, più Claude rallenta.
Perché? Ogni server MCP espone strumenti — e ogni strumento ha una descrizione che Claude deve leggere. Se hai 10 server con 15 strumenti ciascuno, prima ancora di fare una domanda vengono caricate 150 descrizioni di strumenti nella context window di Claude. Questo mangia lo spazio per la conversazione vera.
È come cercare di fare una riunione dove tutti devono leggere il curriculum completo di ognuno prima di poter parlare del progetto.
Punti chiave
- Ogni strumento MCP ha una descrizione che consuma token di contesto
- Più server = più descrizioni di strumenti = meno spazio per la conversazione
- Con 10+ server puoi consumare una parte significativa del contesto
- È esattamente il problema che Tool Search risolve
02 · Leggi
Tool Search è la soluzione di Claude Code. Invece di caricare in anticipo ogni strumento di ogni server, li carica in modo differito. Quando fai una domanda, Claude usa uno strumento di ricerca per trovare quali strumenti MCP sono rilevanti, carica solo quelli e va avanti.
È automatico — non devi configurare niente. Tool Search si attiva quando le descrizioni dei tuoi strumenti MCP consumerebbero più del 10% della context window.
Il risultato? Puoi collegare decine di server MCP senza sprecare contesto su strumenti che non ti servono.
Punti chiave
- Tool Search carica gli strumenti MCP on demand, non in anticipo
- Si attiva automaticamente quando gli strumenti superano il 10% del contesto
- Carica solo gli strumenti davvero necessari per il task attuale di Claude
- Ti permette di usare molti server MCP senza penalità di performance
03 · Esempio di codice
Tool Search è attivo di default, ma puoi regolarlo. La variabile d'ambiente ENABLE_TOOL_SEARCH ne controlla il comportamento.
Predefinito (auto — si attiva quando il contesto è usato al 10%)
claude
Soglia personalizzata (si attiva al 5%)
ENABLE_TOOL_SEARCH=auto:5 claude
Completamente disattivato (tutti gli strumenti caricati in anticipo)
ENABLE_TOOL_SEARCH=false claude
La maggior parte degli utenti non ha bisogno di cambiarlo — la modalità auto predefinita funziona bene. Se hai molti server abbassa la soglia. Disattivalo solo quando fai debug e noti problemi con il rilevamento degli strumenti.
04 · Leggi
In Claude Code, il comando /mcp è la tua console per i server MCP. Digita /mcp per vedere tutti i server collegati e il loro stato.
Il verde indica connessione attiva; se un server richiede autenticazione (come GitHub o Sentry), /mcp ti guida nel login OAuth — apre il browser, accedi, e Claude ottiene l'accesso.
Puoi anche cancellare l'autenticazione, vedere gli errori e vedere quali strumenti espone ogni server. Pensa a /mcp come alla dashboard di tutte le connessioni MCP.
Punti chiave
- /mcp mostra tutti i server e lo stato delle connessioni
- Usalo per autenticarsi con server OAuth (GitHub, Sentry, ecc.)
- "Clear authentication" ripristina l'accesso quando necessario
- Il primo posto dove guardare quando un server MCP non funziona
05 · Quiz
Hai configurato 20 server MCP e Claude sembra lento. Quale funzionalità riduce automaticamente l'uso del contesto caricando gli strumenti on demand?
- Cache MCP
- Server batching
- Tool Search
- Compressione del contesto
06 · Completa
In Claude Code, digita /_____ per vedere lo stato di tutti i server MCP e autenticarti con i servizi OAuth.
Altre lezioni di questo capitolo
⚠ L'esperienza interattiva completa richiede JavaScript. Attivalo e ricarica la pagina.
※ Questo è un progetto educativo indipendente — non è un prodotto ufficiale di Anthropic. Claude™ è un marchio di Anthropic, PBC.