Solución de problemas

Si algo no funciona, empieza por aquí. La mayoría de los problemas encajan en uno de los patrones de abajo.

Configuración y conexión

“Claude Desktop no ve verxion”

• Abre Settings → Connectors y confirma que aparece el conector remoto de verxion
• Pulsa Connect de nuevo y completa OAuth en el navegador
• Habilita verxion desde Search and tools en una conversación nueva
• No configures este conector remoto en claude_desktop_config.json

“ChatGPT carga la App pero las tools nunca se ejecutan”

• Abre una conversación nueva; las tools se recogen solo al inicio
• Si ves un prompt de permiso y lo cancelas, las tools quedan bloqueadas para esa conversación
• Elimina y vuelve a crear la app personalizada con la URL de la página de setup

“El login OAuth entra en bucle”

• Cierra sesión desde la página de setup, cierra la pestaña y vuelve a empezar con un snippet limpio
• Comprueba que tu navegador no esté bloqueando cookies de terceros para el dominio de verxion — OAuth las necesita
• Prueba un navegador distinto o una ventana de incógnito para descartar extensiones

Durante el uso

“Cada llamada devuelve 401”

• Token expirado. Regenera el snippet desde la página de setup.
• Si cerraste sesión desde otro dispositivo/pestaña, tu token se invalidó globalmente.

“Mi llamada a tool devuelve 403 — permiso denegado”

• La acción requiere un scope que tu token no lleva. Ver Scopes OAuth.
• El token por defecto cubre los cinco grupos de recursos al nivel write pero no destructive. Eliminar requiere subir el scope.

“El agente dice que una tool no existe”

• Probablemente estés en Code Mode (el default). El agente solo ve execute_code. Escribirá código que internamente llama a la operación que pediste. Ver Perfiles MCP.
• Si estás en modo Full y falta una operación específica, contacta con soporte — quizá la hayamos movido.

“ChatGPT dice: esta app está en el límite de tools”

• Tienes un snippet viejo, anterior a Code Mode. Recopia el snippet de la página de setup; el nuevo usa Code Mode UI y queda muy por debajo del límite.

Datos y estado

“He registrado una serie pero no aparece”

• La sesión tiene que estar iniciada antes de que los set logs se vinculen a ella. Pregunta al agente “¿está activa mi sesión?” — si no, “empieza el entreno de hoy” primero.
• Si el agente confirmó la serie pero no la encuentras, pregunta “enséñame mis últimos 5 set logs” — a veces el listado en tu cliente está cacheado y una consulta directa lo resuelve.

“He eliminado algo sin querer”

• Las eliminaciones son permanentes en producción. Contacta con soporte de inmediato indicando hora aproximada y qué se eliminó — quizá podamos restaurar desde backups dependiendo del tiempo transcurrido.

“La eliminación de cuenta me dejó atascado con la sesión abierta”

• Cierra sesión desde tu cliente. Tu cookie de sesión antigua quedó invalidada en el servidor pero tu cliente aún la mantiene.
• Limpia las cookies del dominio de verxion en tu navegador si entraste por web.

Reportar un problema

Si nada de lo anterior encaja, envía lo que tengas a [email protected]:

1. Qué cliente (ChatGPT / Claude Desktop / Claude Code) y versión
2. Qué le pediste al agente
3. El mensaje de error o comportamiento inesperado
4. Hora aproximada, para que podamos correlacionar con logs

No necesitamos (ni queremos) tu historial de prompts ni PII — solo la forma del fallo.