Errors & Troubleshooting
Errores comunes al instalar o usar FreeTicket MCP en clientes compatibles.
Esta guía cubre problemas comunes al instalar, autorizar o usar FreeTicket MCP.
Checklist rápido
- Confirma que la URL termine en
/api/mcp. - Vuelve a iniciar sesión si el cliente dice que no está autorizado.
- Acepta
mcp:readpara funciones de usuario. - Usa
staffsolo para funciones internas. - Usa fechas ISO 8601 parseables en
fromyto.
Errores de autorización
| Error | Causa probable | Solución |
|---|---|---|
401 Unauthorized | El cliente no terminó la autorización | Desconecta y vuelve a conectar FreeTicket MCP |
Invalid or expired token | La sesión expiró | Autoriza de nuevo desde tu cliente |
Unauthenticated | El cliente intentó usar el MCP sin sesión activa | Vuelve a iniciar sesión |
Missing required scope: mcp:read | No aceptaste permiso de lectura | Reconecta y acepta mcp:read |
Missing required scope: staff | No tienes permiso staff | Usa una cuenta interna autorizada |
El permiso staff solo funciona si FreeTicket autorizó tu cuenta como interna.
Errores de input
| Caso | Mensaje típico | Solución |
|---|---|---|
| Fecha inválida | Invalid 'from' date o Invalid 'to' date | Envía fechas ISO 8601, por ejemplo 2026-04-01 |
| Rango invertido | 'from' must be <= 'to' | Asegura que from sea anterior o igual a to |
| Límite fuera de rango | Error de validación | Pide menos resultados |
| Ciudad inválida | Error de enum | Usa bogota, medellin, cali, cdmx o guadalajara |
Sin resultados
Algunas tools devuelven texto en lugar de error cuando no encuentran datos:
No hay shows próximos disponibles.
No tienes tickets para shows próximos.
No se encontraron eventos con esos filtros.Esto significa que la conexión funciona. Prueba con una ciudad, fecha o búsqueda más amplia.
Problemas por cliente
| Cliente | Qué revisar |
|---|---|
| Claude Web | Que el conector esté activo en la conversación |
| Claude Desktop | Que reiniciaste Claude después de editar el config |
| ChatGPT | Que tu plan tenga Connectors/MCP habilitado |
| Cursor | Que tu versión soporte MCP remoto |
Prompt de prueba
¿Qué shows próximos hay en Bogotá?Si este prompt funciona, el MCP quedó instalado correctamente.