Errores y soluciones
Qué significan los avisos que devuelve el MCP y qué hacer con cada uno.
Cuando algo no se puede hacer, la herramienta responde con un código y un mensaje. El chatbot te lo explica en lenguaje simple; esta tabla sirve si quieres el detalle.
Plan y permisos#
| Código | Qué pasó | Qué hacer |
|---|---|---|
plan_limit_reached | Tu plan llegó al máximo de agentes, herramientas, servidores MCP, conocimiento o suites | Archiva lo que no uses o cambia de plan. El aviso dice qué plan te alcanzaría |
insufficient_scope | Tu plan solo permite consultar desde el chatbot | Cambia a un plan con acceso completo |
credits_exhausted | No quedan créditos para correr la evaluación | Recarga créditos en la consola |
entitlements_unavailable | No se pudo leer tu plan en este momento | Intenta de nuevo en unos minutos |
rate_limited | Demasiadas peticiones seguidas | Espera unos segundos |
Agentes y versiones#
| Código | Qué pasó | Qué hacer |
|---|---|---|
invalid_agent_draft | El borrador tiene errores y no se puede guardar | Pide validate_agent_draft para ver cada error |
draft_unchanged | El borrador es igual a la última versión | No hace falta guardar: esa versión ya existe |
draft_revision_conflict | Alguien guardó el borrador al mismo tiempo | Pide el cambio de nuevo |
quality_gate_not_met | La versión no aprobó la suite de la puerta de calidad | Corre la evaluación y corrige lo que falló |
agent_not_found | El agente no existe en este espacio de trabajo | Revisa que conectaste el espacio correcto |
Componentes#
| Código | Qué pasó | Qué hacer |
|---|---|---|
mcp_connection_failed | No se pudo conectar al servidor MCP | Revisa la URL y que el servidor esté en línea |
mcp_not_tested | La conexión nunca se probó | Pide test_mcp_connection |
outbound_host_blocked | La dirección apunta a una red privada | Usa una dirección pública |
invalid_eval_suite | La suite usa equals y hay casos sin respuesta esperada | Agrega las respuestas esperadas o usa otro evaluador |
document_not_reviewed | Un documento convertido espera revisión | Revísalo en la consola y vuelve a indexar |
La conexión#
| Síntoma | Qué pasó | Qué hacer |
|---|---|---|
| El chatbot pide conectar de nuevo | Se desconectó desde Ajustes → Chatbots, dejaste de ser administrador o la sesión venció tras 30 días sin uso | Vuelve a conectar y aprobar |
| "Necesitas ser administrador" | Tu rol es manager o viewer | Pide a un administrador que conecte o que te dé el rol |
| "Esta solicitud ya no es válida" | Pasaron más de 10 minutos o ya se respondió | Inicia la conexión de nuevo desde el chatbot |