Skip to main content
Busque el síntoma que coincida con su problema. Cada entrada indica la causa probable y la solución.

​
Solución de problemas en Claude Code

​
Solución de problemas generales

​
Error de límite de tasa

Una llamada a una herramienta devuelve un error de límite de tasa que incluye un valor retryAfterSeconds.
  • Causa: La llamada superó el límite por herramienta del servidor MCP para su usuario, o el límite de la puerta de enlace de la Automation API para la integración MCP.
  • Solución: Espere el número de segundos indicado en retryAfterSeconds y, después, vuelva a intentar la llamada. Para trabajos masivos, agrupe sus solicitudes en lotes o limite la velocidad del bucle para mantenerse por debajo de los límites.

​
El puerto 35535 ya está en uso

Si la autenticación falla con un error EADDRINUSE, otro proceso ya escucha en el puerto de devolución de llamada de OAuth.
  • Causa: Un proceso mcp-remote obsoleto sigue activo desde un intento de autenticación anterior.
  • Solución: Detenga el proceso obsoleto que usa el puerto 35535 y, después, vuelva a ejecutar el comando de OAuth.

​
El servidor MCP no aparece en el chat de Codex

Codex podría no recargar en caliente los servidores MCP recién añadidos en un hilo que ya está en ejecución.
  • Solución: Actualice Codex o inicie una sesión nueva después de actualizar config.toml.

​
El flujo del navegador no se completa

Si la ventana de OAuth del navegador se abre pero la autorización no termina:
  • Confirme que hizo clic en el botón Authorize de la página de inicio de sesión de Kameleoon.
  • Compruebe que la configuración de su navegador o del sistema no bloquea las devoluciones de llamada a localhost.
  • Abra manualmente la URL de devolución de llamada si su navegador no la abre automáticamente.

​
Una herramienta devuelve BLOCKED en lugar de realizar el cambio

Las herramientas que cambian el tráfico real devuelven una vista previa con el estado BLOCKED hasta que confirme. Ese estado no significa un error.
  • Solución: Revise la vista previa y, si es el cambio que quiere, pida a su asistente de IA que repita la llamada con confirm establecido en true. Para segment_delete y trigger_delete, use force en su lugar.

​
La comprobación de salud devuelve DOWNSTREAM_ERROR

experiment_health_check_get falla en un experimento que usa un objetivo de ratio cuyo objetivo del numerador no está asociado al experimento.
  • Solución: Asocie el objetivo que falta en la aplicación, o ejecute la comprobación en otro experimento.

​
El análisis de impacto de objetivos no devuelve filas

goal_experiment_impacts_list puede no devolver filas mientras los datos todavía se están preparando.
  • Solución: Revise el campo readiness (PREPARING o PARTIAL) y vuelva a hacer la consulta después de retryAfterSeconds.

​
Los resultados de un solo día difieren del desglose diario

Una ventana de un solo día sigue la zona horaria de su organización. Los grupos diarios siguen la zona horaria del sitio, así que ambos pueden cubrir 24 horas distintas.

​
La mejora es 0 o no aparece en una variación

No hay una línea base con la que comparar cuando la original recibe el 0 % del tráfico.

​
Una página, un tamaño de página o un límite de 0 devuelve el valor predeterminado

En takeaway_list y goal_experiment_impacts_list, 0 como página, tamaño de página o límite significa « usar el valor predeterminado ».

​
Faltan herramientas nuevas después de una versión

Los clientes conservan la lista de herramientas anterior hasta que vuelva a conectarse.
  • Solución: Después de una versión, vuelva a conectar el conector MCP de Kameleoon.

​
Los agentes sin interfaz o remotos no se autentican

Los agentes remotos o sin interfaz (como Codex alojado en la nube) no pueden completar el paso de autorización en el navegador.
  • Solución: Use en su lugar una versión de escritorio de su herramienta.

​
No se encuentra el comando del ejecutor de paquetes

Si el comando falla con un error « not found », asegúrese de que npx esté disponible en la ruta del sistema. Node.js 8.2 y versiones posteriores incluyen npx de forma predeterminada.