Tool Search y trabajar con inteligencia
Cómo Claude Code se mantiene rápido con decenas de MCP servers
⏱ Estim. ~4 min
01 · Leer
Un problema que quizás no esperabas: mientras más MCP servers agregas, más lento se vuelve Claude.
¿Por qué? Cada MCP server expone herramientas y cada herramienta tiene una descripción que Claude tiene que leer. Si tienes 10 servers con 15 herramientas cada uno, antes de que siquiera hagas una pregunta ya hay 150 descripciones de herramientas cargadas en la ventana de contexto de Claude. Eso le come espacio a la conversación real.
Es como tratar de tener una reunión donde todos primero tienen que leer un currículum completo antes de poder hablar del proyecto.
Puntos clave
- Cada herramienta de MCP tiene una descripción que consume tokens de contexto
- Más servers = más descripciones de herramientas = menos espacio para la conversación
- Con 10+ servers se puede consumir una parte considerable del contexto
- Este es el problema que resuelve Tool Search
02 · Leer
Tool Search es la solución de Claude Code. En vez de cargar de antemano cada herramienta de cada server, las difiere. Cuando haces una pregunta, Claude usa una herramienta de búsqueda para encontrar cuáles herramientas de MCP son relevantes, carga solo esas y sigue.
Es automático: no necesitas configurarlo. Tool Search se activa cuando las descripciones de tus herramientas de MCP consumirían más del 10% de la ventana de contexto.
¿El resultado? Puedes conectar decenas de MCP servers sin desperdiciar contexto en herramientas que no estás usando.
Puntos clave
- Tool Search carga herramientas de MCP bajo demanda, no por adelantado
- Se activa automáticamente cuando las herramientas superan el 10% del contexto
- Carga solo las herramientas que Claude realmente necesita para la tarea actual
- Te permite correr muchos MCP servers sin costo de rendimiento
03 · Ejemplo de código
Tool Search está activo por defecto, pero lo puedes ajustar. La variable de entorno ENABLE_TOOL_SEARCH controla su comportamiento.
Por defecto (auto: se activa al 10% del contexto)
claude
Umbral personalizado (se activa al 5%)
ENABLE_TOOL_SEARCH=auto:5 claude
Desactivado por completo (todas las herramientas se cargan por adelantado)
ENABLE_TOOL_SEARCH=false claude
La mayoría de los usuarios no necesitan cambiar esto: el modo auto por defecto funciona bien. Si tienes muchos servers, baja el umbral. Desactívalo solo si estás depurando un problema de descubrimiento de herramientas.
04 · Leer
Dentro de Claude Code, el comando /mcp es tu panel de control para los MCP servers. Escribe /mcp para ver todos los servers conectados y su estado.
Verde significa conectado; si un server requiere autenticación (como GitHub o Sentry), /mcp te guía por el flujo de OAuth: abre el navegador, te logueas y Claude obtiene acceso.
También puedes limpiar la autenticación, ver errores y revisar qué herramientas ofrece cada server. Piensa en /mcp como el dashboard de todas tus conexiones MCP.
Puntos clave
- /mcp muestra todos los servers y el estado de la conexión
- Úsalo para autenticarte con servers OAuth (GitHub, Sentry, etc.)
- "Clear authentication" resetea el acceso cuando lo necesitas
- El primer lugar para revisar cuando un MCP server no funciona
05 · Quiz
Configuraste 20 MCP servers y Claude se siente lento. ¿Qué funcionalidad reduce automáticamente el uso de contexto cargando herramientas bajo demanda?
- Caché de MCP
- Server batching
- Tool Search
- Compresión de contexto
06 · Completar
Dentro de Claude Code, escribe /_____ para ver el estado de todos los MCP servers y autenticarte con servicios OAuth.
Otras lecciones de este capítulo
⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.
※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.