> ## Documentation Index > Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt > Use this file to discover all available pages before exploring further. # Solución de problemas de MCP > Diagnostique y solucione los problemas habituales de conexión, autenticación y errores de herramientas del servidor MCP. 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 | Síntoma | Causa | Solución | | - | - | - | | El navegador no se abre. | El inicio automático falló. | Copie la URL de la terminal y ábrala manualmente. | | Conexión rechazada en el puerto 35535. | El puerto está en uso. | En macOS o Linux, ejecute `lsof -i :35535`; en Windows, ejecute `netstat -ano \| findstr :35535`. Detenga el proceso y vuelva a intentarlo. | | Error de conexión después de OAuth. | El token no se guardó. | Vuelva a ejecutar el [comando del Paso 2](https://docs.kameleoon.com/es/mcp/set-up-clients.md#paso-2-completar-la-autenticación-oauth) para renovar su token. | | No se ven las herramientas en Claude. | La sesión se inició antes de añadir el servidor. | Inicie una conversación nueva en Claude Code. | | Falta en la lista de herramientas una herramienta más reciente, como `experiment_update` o `trigger_list`. | El cliente conserva la lista de herramientas que cargó antes de que Kameleoon publicara estas herramientas. | Vuelva a conectar el servidor. En Claude.ai, vaya a **Customize** > **Connectors** y vuelva a conectar Kameleoon. En Claude Code, ejecute `/mcp` y elija **Reconnect**. | | Se rechaza la clave `mcpServers` en `settings.json`. | Archivo incorrecto; Claude Code no usa esa clave. | Use en su lugar el comando `claude mcp add`. | | Error de autenticación después de un tiempo prolongado. | El token OAuth caducó. | Vuelva a ejecutar el [comando del Paso 2](https://docs.kameleoon.com/es/mcp/set-up-clients.md#paso-2-completar-la-autenticación-oauth). | ## 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.