Saltar al contenido
Volver al blog
IADevOpsHomelab

Codex CLI 0.152.0 pone límites a las salidas MCP

La nueva configuración de Codex ayuda a evitar que los logs de herramientas MCP se coman el contexto del agente.

Ismael Catala3 min de lectura

El problema no es MCP, son sus respuestas

Conectar Codex a un proyecto Laravel, a Docker o a un homelab mediante MCP es útil hasta que una herramienta devuelve más texto del que el agente necesita. Un comando de logs, una traza de error o una respuesta mal filtrada pueden ocupar una parte relevante del contexto sin aportar demasiado a la tarea. El resultado es una conversación más ruidosa y un agente con menos espacio para el código, las instrucciones y los datos que sí importan.

Codex CLI 0.152.0 incorpora límites de salida por herramienta MCP. La opción se define dentro de la configuración de una herramienta concreta del servidor MCP mediante mcp_servers.<id>.tools.<tool>.output_token_limit. El valor debe ser positivo y permite acotar cuánto contenido de esa respuesta se conserva para el contexto de la conversación.

Limitar donde realmente se genera el ruido

Esto tiene sentido sobre todo en herramientas que consultan registros, listados amplios o diagnósticos de infraestructura. En un MCP para Laravel podría aplicarse a una herramienta que recupera errores de aplicación, y en uno para Docker a la que inspecciona la salida de contenedores. En el homelab ocurre lo mismo con servicios que devuelven estados detallados, eventos o inventarios completos.

La clave es configurarlo por herramienta y no tratar todo el servidor MCP igual. Una consulta corta a una base de datos puede necesitar su respuesta completa, mientras que una herramienta de logs casi siempre debería entregar solo una parte controlada. Antes de fijar el límite, conviene revisar qué devuelve cada herramienta y decidir si necesita resumir o filtrar información antes de responder.

La planificación pasa a ser opcional

También cambia el comportamiento de update_plan. La herramienta de planificación queda desactivada por defecto, así que los flujos que dependan de ella deben habilitarla de forma explícita. La configuración correspondiente es esta:

[tools.update_plan]
enabled = true

No es un cambio grave si nunca has usado planes visibles durante la ejecución. Pero si tienes instrucciones de proyecto, automatizaciones o hábitos de trabajo que esperan actualizaciones de planificación, merece la pena comprobarlo tras actualizar. De lo contrario, el agente no tendrá esa herramienta disponible aunque tus indicaciones la mencionen.

La letra pequeña

output_token_limit no convierte una herramienta MCP en segura ni sustituye sus permisos. Para limitar qué herramientas se exponen siguen siendo relevantes opciones como enabled_tools y disabled_tools, y para controlar acciones hay configuraciones de aprobación por servidor o por herramienta. Reducir la salida evita llenar el contexto, pero no arregla una herramienta que devuelve secretos, ejecuta acciones peligrosas o consulta más datos de los necesarios.

Tampoco es una solución para perder información importante. Si necesitas investigar un error concreto, un límite demasiado bajo puede dejar fuera la línea útil del log o el detalle que explica el fallo. En esos casos prefiero mejorar la herramienta MCP para que acepte filtros, paginación o una búsqueda específica, antes que pedirle al agente que procese un volcado completo.

Un ajuste pequeño para agentes conectados a infraestructura

Para agentes que trabajan con Laravel, Docker y servicios autoalojados, este cambio es práctico porque obliga a pensar en la forma de las respuestas. Un MCP no debería ser una tubería directa para enviar toda la salida de un sistema al modelo. Debería ofrecer resultados acotados, útiles y con el nivel de acceso mínimo necesario para cada tarea.


Fuente: changelog de Codex CLI Documentación oficial: referencia de configuración de Codex