Errores comunes

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

Conexión

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

Casi siempre es la URL. Revisá 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

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

”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: cerrá esa pestaña y reiniciá la conexión desde Claude (Configuración → Conectores) para generar una solicitud nueva. Completá el login dentro de los 30 min.

”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, conectá con una API key MCP desde Claude Desktop.

”Email o contraseña incorrectos” en el consent

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

Autenticación y permisos

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: reconectá y elegí Completo en el consent.
• API key: generá 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”

Verificá 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.

Uso de herramientas

”Pedí un cambio y no pasó nada”

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, confirmáselo.

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). Editá siempre el borrador (actualizar_config_bot), revisá con ver_config_bot, y publicá solo cuando esté todo. Ver Conceptos.

Cambié el bot pero responde igual

• 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: iniciá una conversación nueva para descartar cache de una sesión vieja.

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. Verificá el nivel de acceso y, si corresponde, el plan.

¿Sigue sin andar?

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