Ir al contenido

Errores comunes

Los problemas más frecuentes y cómo resolverlos, de conexión hacia adentro.

”Couldn’t reach the MCP server” / no conecta el conector

Sección titulada «”Couldn’t reach the MCP server” / no conecta el conector»

Casi siempre es la URL. Revisa que sea exactamente:

https://api.overtaker.online/mcp
  • Sin barra final (/mcp, no /mcp/).
  • Sin .well-known, sin /token, sin nada más — el cliente descubre el resto solo.
  • Client ID / Client Secret vacíos (el registro es automático por DCR).

”No se pudo registrar” al agregar el conector en claude.ai

Sección titulada «”No se pudo registrar” al agregar el conector en claude.ai»

El registro dinámico (DCR) del cliente falló. Suele ser transitorio: reintenta. Si persiste, verifica que estés usando la URL exacta de arriba y vuelve a agregar el conector desde cero.

Sección titulada «”Solicitud inválida o expirada” en la pantalla de consent»

El enlace de conexión (txn) caducó — dura 30 minutos por seguridad. Pasa si:

  • Dejaste la pantalla abierta mucho rato antes de aprobar.
  • Estás reusando una pestaña vieja de un intento anterior.

Solución: cierra esa pestaña y reinicia la conexión desde Claude (Configuración → Conectores) para generar una solicitud nueva. Completa el login dentro de los 30 min.

”Tu cuenta tiene verificación en dos pasos”

Sección titulada «”Tu cuenta tiene verificación en dos pasos”»

El consent de OAuth no bypassea 2FA a propósito (un login de solo contraseña sería más débil que tu panel). Si tu cuenta tiene 2FA, conecta con una API key MCP desde Claude Desktop.

Sección titulada «”Email o contraseña incorrectos” en el consent»

Son las credenciales de tu cuenta del panel de Overtaker (la misma con la que entras a administrar el tenant), no otra. Deben ser de un usuario OWNER o MANAGER y con la cuenta activa.

Una herramienta de escritura devuelve error de permiso

Sección titulada «Una herramienta de escritura devuelve error de permiso»

Tu credencial es de solo lectura (read). Las escrituras (configurar, cargar, borrar) requieren acceso Completo (full):

  • OAuth: reconecta y elige Completo en el consent.
  • API key: genera una nueva key mcp con access="full" (el nivel se fija al crearla; no se puede subir después).

La API key no funciona / “kind equivocado”

Sección titulada «La API key no funciona / “kind equivocado”»

Verifica que sea una key kind=mcp, no una del Canal API (kind=channel). Son cupos y usos separados: la del Canal API mueve mensajes; la MCP configura el tenant. Una no sirve para lo de la otra.

Las operaciones destructivas o de escritura tienen un gate de confirmación: la primera llamada devuelve un preview y no aplica nada. Hay que repetir con confirmar=true. Si Claude te mostró un preview y esperaba tu OK, confírmaselo.

Publiqué el Prompt Builder y el bot “perdió” configuración

Sección titulada «Publiqué el Prompt Builder y el bot “perdió” configuración»

publicar_config_bot hace un rebuild completo del prompt desde el wizard y puede pisar contenido cargado por otras vías (onboarding). Edita siempre el borrador (actualizar_config_bot), revisa con ver_config_bot, y publica solo cuando esté todo. Ver Conceptos.

  • Si tocaste el rol en vez del Prompt Builder, puede no ser lo que esperabas (ver las dos capas).
  • El cambio de config puede tardar en propagarse: inicia una conversación nueva para descartar cache de una sesión vieja.

Una tool no aparece o devuelve “sin acceso”

Sección titulada «Una tool no aparece o devuelve “sin acceso”»

Puede ser una tool de escritura con credencial read, o una capacidad que el plan del tenant no tiene habilitada. Verifica el nivel de acceso y, si corresponde, el plan.

Confirma lo básico en orden: URL exacta → credencial correcta (kind + nivel) → conexión fresca. Si el problema es de OAuth (web), prueba el camino sin OAuth con API key desde Desktop para aislar si es tu cuenta/consent o el conector.