Claude Code con MCP: cómo liberar contexto sin perder la tarea
Empieza por /context all: si la carga aparece al conectar herramientas, revisa su descubrimiento; si llega con una respuesta enorme, reduce la consulta; si se acumula tras varios intentos, conserva el estado antes de compactar.
En esta página

Si Claude Code se queda sin espacio de contexto al trabajar con MCP, localiza cuándo entra la carga antes de desactivar servidores. Abre /context all con la tarea aún en marcha: compara lo que había al empezar, lo que añadió la llamada problemática y lo que se acumuló durante los intentos anteriores. Después cambia esa parte concreta y comprueba que todavía puedes obtener el dato que necesitabas.
No hay una cantidad de servidores que sirva para todos. Para investigar un fallo de despliegue, por ejemplo, necesitas encontrar la excepción que lo causó y relacionarla con una versión. Tener menos herramientas o recibir menos texto solo ayuda si sigues pudiendo demostrar esa relación. Esta guía utiliza ese caso para recorrer el diagnóstico, la limpieza y el diseño de una respuesta útil.
Primero distingue contexto lleno de una herramienta que no funciona
Una sesión lenta no demuestra que MCP haya llenado la ventana. Si falta una herramienta, comprueba conexión, autorización y estado en /mcp.
| Lo que observas | Comprobación útil | Siguiente paso |
|---|---|---|
| La carga ya es alta antes de consultar datos | Mira las categorías de /context all y qué servidores necesitas hoy | Comprueba el descubrimiento de herramientas y desactiva temporalmente las ajenas a la tarea |
| El contexto crece mucho tras una llamada | Identifica esa respuesta: registros, filas, documento o imágenes | Repite una consulta delimitada que conserve la prueba necesaria |
| Las respuestas se repiten y el hilo pierde el objetivo | Revisa decisiones pendientes, lecturas repetidas y errores ya descartados | Guarda el estado de trabajo y compacta; evita volver a pedir la misma salida completa |
| Falta una herramienta, pero el contexto tiene margen | Comprueba conexión, autorización y disponibilidad | Resuelve ese estado; reducir texto no concede acceso |
Recibes 529 y overloaded_error de la API | Busca el estado HTTP, error.type y el identificador de petición | Trata la sobrecarga del servicio como un problema distinto |
El 529 overloaded_error de la API de Anthropic señala sobrecarga temporal del servicio; no diagnostica una ventana de contexto llena por MCP. Una pasarela puede mostrar otro mensaje, así que conserva el error real antes de decidir. Errores de la API de Claude.
/context all amplía los detalles que la vista de contexto puede contraer. La capacidad depende del modelo y la ruta: no presupongas una ventana fija. Las instrucciones, los archivos cargados y las respuestas también cuentan. Comandos de Claude Code y ventana de contexto.
Si lo que falla es una instrucción persistente o el acceso a documentación con Context7, la siguiente comprobación es distinguir contexto, memoria y MCP en Claude Code. Aquí seguimos con una integración existente que necesita menos carga para completar su tarea.

Comprueba Tool Search antes de reorganizar servidores
En ENABLE_TOOL_SEARCH, sin configurar se difieren las definiciones MCP, pero se cargan nombres e instrucciones. auto usa el 10 %; auto:N, 0–100; false, carga inicial; true, aplazamiento compatible. alwaysLoad lo evita por servidor o herramienta. Configuración y excepciones de Tool Search.
Ejemplo para una sesión compatible: ENABLE_TOOL_SEARCH=true claude.
Comprueba el ajuste que realmente está aplicado antes de cambiarlo. Anota el valor anterior para poder recuperarlo si la nueva sesión no permite completar la tarea.
El proveedor importa. Un ANTHROPIC_BASE_URL externo a Anthropic la desactiva; forzar true exige tool_reference. Google Agent Platform 4.5+ la habilita desde v2.1.221; generaciones anteriores y ciertos servidores Azure de Foundry no permiten forzarla. Políticas y betas desactivadas pueden impedirla. Compatibilidad de Tool Search.
La decisión práctica es esta:
- Ruta compatible: comprueba qué herramientas necesitas invocar y si puedes descubrirlas sin cargar todas sus definiciones de entrada.
- Pasarela o ruta personalizada: confirma que admite las referencias requeridas antes de forzar la opción. Si rechaza la petición, vuelve al ajuste anterior y trabaja con un conjunto de servidores apropiado para la tarea.
- Servidor imprescindible con carga inmediata: conserva su acceso y revisa lo que devuelve. Aplazar otros servidores no reducirá esa respuesta.
Las herramientas recién conectadas pueden aparecer en solicitudes posteriores. /mcp deshabilita servidores por proyecto sin borrar su configuración. Disponibilidad y desactivación temporal.
Para probar una limpieza reversible, anota qué servidor vas a desactivar y por qué no interviene en la tarea. Desactiva uno, comprueba el resultado y vuelve a habilitarlo si falta un acceso necesario. No elimines la configuración solo para hacer una comparación. Si tanto el repositorio como los registros son necesarios para investigar el despliegue, conserva ambos: el objetivo es llegar a la causa, no alcanzar un inventario mínimo.
Una respuesta enorme necesita una consulta mejor delimitada
Tool Search no decide cuántos registros devuelve una llamada. Para el fallo de despliegue, pedir «todos los logs de hoy» obliga a inspeccionar muchos mensajes ajenos al incidente. Prueba una petición que especifique servicio, versión, intervalo y dato esperado:
Busca los errores de
checkout-apientre las 14:05 y las 14:15 UTC de la versiónrelease-184. Agrúpalos por excepción. Devuelve el total por grupo y un registro representativo con fecha, identificador y mensaje completo. Si hay más grupos, indica cómo obtenerlos. No incluyas comprobaciones de salud.
Es una petición de ejemplo, no una sintaxis universal de MCP. Si la herramienta no admite alguno de esos filtros, usa los que sí expone o solicita al responsable del servidor una consulta más precisa. No des por hecho que escribir «resumen» hace que el cliente procese los datos antes de enviarlos al modelo.
Aviso: 10.000 tokens; máximo predeterminado: 25.000. El texto satisfactorio sin imágenes que supera ese máximo o 50.000 caracteres se guarda con referencia a archivo. Los textos de error largos conservan unos 5.000 caracteres de cada extremo; las imágenes siguen limitadas por tokens. Límites de salida MCP.
Una referencia a archivo no significa que los datos hayan desaparecido. Cuando necesites una excepción completa, pide el fragmento que la contiene o la lectura precisa que permita comprobarla. Volcar de nuevo todo el archivo en la conversación devuelve el problema al punto de partida. Si recibiste un error o contenido con imágenes, no apliques automáticamente la explicación del texto satisfactorio.
No aumentes el límite para reducir la carga
MAX_MCP_OUTPUT_TOKENS cambia el máximo; no reduce la salida. Antes de hacerlo, decide qué prueba falta: ¿el principio de la excepción, el final de la traza, otro grupo de errores o un registro concreto?
Hay tres formas de perder información que conviene distinguir:
| Respuesta | Lo que todavía necesitas saber |
|---|---|
| «Hay 48 errores» | Qué excepción es relevante y dónde está el registro que lo demuestra |
| «Aquí tienes los primeros 20» | Cómo se ordenaron, cuántos quedaron fuera y cómo continuar |
| «El resultado está en este archivo» | Cómo acceder al fragmento necesario con los permisos disponibles |
Una salida pequeña sin esa información no completa el diagnóstico. La mejora consiste en obtener primero una visión suficiente para elegir, después la evidencia concreta y, si hace falta, otra página. Caracteres, bytes UTF-8 y tokens son unidades diferentes: una cuenta de caracteres sirve para limitar texto, no para afirmar cuánto contexto ha consumido el modelo.
Si mantienes el servidor, define qué debe devolver cada consulta
El servidor puede evitar que datos irrelevantes lleguen a la conversación. La propuesta de Anthropic sobre ejecución de código con MCP separa el descubrimiento de herramientas del procesamiento de resultados: filtrar antes de cargar los datos en el modelo puede reducir la carga. Implementarlo mediante ejecución de código exige además infraestructura y controles; no basta con cambiar una respuesta por un nombre de archivo. Diseño de ejecución de código con MCP.
Para el caso del despliegue, una herramienta search_release_errors podría devolver esta respuesta de diseño, con datos ficticios:
{
"release": "release-184",
"service": "checkout-api",
"timeRangeUtc": ["2026-10-06T14:05:00Z", "2026-10-06T14:15:00Z"],
"matchedRecords": 48,
"groups": [
{
"exception": "PaymentTimeout",
"count": 41,
"sampleId": "log-732",
"sampleMessage": "PaymentTimeout: provider response exceeded 3000 ms"
}
],
"returnedGroups": 1,
"totalGroups": 3,
"nextCursor": "group-page-2"
}Con esa respuesta puedes identificar la hipótesis principal y pedir log-732 para comprobar la traza. También sabes que quedan otros dos grupos. El siguiente paso no tiene que ser «leerlo todo»: puede ser obtener la página restante para comprobar si existe otra causa relevante.
Este diseño impone responsabilidades concretas al servidor:
- Filtrar antes de resumir. El recuento debe corresponder al servicio, la versión y el intervalo indicados. Si un filtro no se aplicó, dilo en la respuesta.
- Explicar el recuento.
matchedRecordscuenta registros ytotalGroupscuenta grupos; no son dos nombres para la misma cifra. - Conservar una prueba recuperable. El identificador del ejemplo debe permitir obtener el registro completo mediante una herramienta disponible y autorizada.
- Ofrecer continuidad. El cursor debe continuar la misma consulta, con un orden estable. Si cambia el conjunto de datos, utiliza una instantánea o explica esa limitación.
- Evitar la duplicación innecesaria. Una vista estructurada y otra textual idéntica pueden transportar dos veces el contenido sin aportar otra forma útil de leerlo.
En MCP 2025-11-25, las herramientas admiten outputSchema, structuredContent y enlaces a recursos, entre otras formas de contenido. Los campos de arriba son nuestra propuesta, no campos obligatorios del protocolo. La paginación de tools/list enumera herramientas; no pagina automáticamente las filas de una llamada. Un recurso debe ser accesible para el cliente previsto: una ruta file:// del servidor no garantiza acceso remoto. Especificación de herramientas MCP.
JSON ayuda a identificar campos, pero no garantiza menor tamaño ni mejores respuestas. Decide qué necesita el lector del resultado y transporta esa información una vez, con una vía clara para profundizar. Las descripciones de herramientas también deben ayudar a elegir: «busca errores de una versión» permite anticipar el resultado mejor que «consulta el sistema».

Conserva el estado antes de compactar o empezar de nuevo
Si el crecimiento procede del historial, acotar la próxima llamada no retira las salidas anteriores. Antes de compactar, guarda un punto de continuidad que puedas revisar. Para nuestro incidente podría ser:
Objetivo: determinar por qué falló release-184 en checkout-api.
Confirmado: hay 48 registros de error entre 14:05 y 14:15 UTC.
Hipótesis: PaymentTimeout aparece en 41; falta revisar la traza de log-732.
Pendiente: leer los otros dos grupos y contrastar la versión desplegada.
Acceso necesario: registros y repositorio; no hacen falta herramientas de despliegue.
Prueba conservada: identificadores de registros y referencia al diff de la versión.
Próxima acción: recuperar log-732, después continuar por group-page-2./compact resume la conversación actual; puedes darle instrucciones para conservar el objetivo y las pruebas. /clear inicia un contexto vacío y mantiene la memoria del proyecto. Un resumen no garantiza conservar cada detalle: revisa el punto de continuidad antes de seguir. Comandos y gestión del contexto.
Tras la limpieza, confirma primero que sigue disponible la herramienta necesaria. Después recupera el registro pendiente, no el conjunto completo que ya produjo la carga. Si eliges /clear, introduce el punto de continuidad revisado para que el trabajo no empiece otra vez desde una pregunta genérica.
Los subagentes tienen contexto separado y pueden devolver un resumen de una exploración extensa; no eliminan el contenido ya acumulado en la conversación principal. Úsalos cuando haya una investigación delimitada que puedan resolver, y pide conclusiones con referencias a las pruebas necesarias. Contexto de Claude Code.
Si además sospechas un problema de configuración, ten presente que /doctor es actualmente una habilidad que puede proponer cambios y pedir confirmación. claude doctor imprime diagnósticos de instalación sin iniciar una sesión. No trates ambas entradas como una operación idéntica y siempre de lectura. Diagnóstico de Claude Code.
Comprueba la mejora con la misma tarea
Vuelve al fallo de release-184. El resultado útil es poder explicar la excepción, relacionarla con el despliegue y localizar el registro que lo demuestra. Guarda una comparación breve:
| Comprobación | Antes del cambio | Después del cambio |
|---|---|---|
| Momento en que crece la carga | Al conectar, tras una llamada o durante los reintentos | El mismo momento observado con /context all |
| Acceso necesario | Servidores y herramientas del incidente | Sigue disponible; las herramientas ajenas pueden estar desactivadas |
| Evidencia | Registro, traza o referencia que necesitas | Puedes obtenerla y comprobarla |
| Continuidad | Qué falta por resolver | Puedes dar el siguiente paso sin repetir la lectura completa |
No atribuyas una mejora al descubrimiento si cambiaste también la consulta, el modelo y el historial. Modifica primero la causa identificada y compara condiciones semejantes. Un menor consumo observado puede ser útil, pero no demuestra por sí solo más velocidad, mejor calidad o menor factura.
Cuando puedas responder al incidente y volver a sus pruebas, la limpieza ha servido. Si la salida disminuye pero ya no permite encontrar la excepción, ajusta el contrato de respuesta. Si falla la conexión o aparece un error del proveedor, vuelve a esa rama del diagnóstico: seguir recortando contexto no resolverá un acceso que falta.
Fuentes7
Páginas externas que cita esta guía, en el orden en que aparecen. Última actualización: 7 oct 2026.
Fuentes7
Páginas externas que cita esta guía, en el orden en que aparecen. Última actualización: 7 oct 2026.
- 1.Errores de la API de Claudeplatform.claude.com/docs/en/api/errors
- 2.Comandos de Claude Codecode.claude.com/docs/en/commands
- 3.ventana de contextocode.claude.com/docs/en/context-window
- 4.Configuración y excepciones de Tool Searchcode.claude.com/docs/en/mcp
- 5.Diseño de ejecución de código con MCPanthropic.com/engineering/code-execution-with-mcp
- 6.Especificación de herramientas MCPmodelcontextprotocol.io/specification/2025-11-25/server/tools
- 7.Diagnóstico de Claude Codecode.claude.com/docs/en/troubleshooting





