Solución de problemas de MCP
Resolvé problemas de conexión, autorización, permisos y consultas.
API v2ActualRevisá primero la disponibilidad, la autorización y el cupo de la cuenta. Para comprobar el acceso usá el listado de herramientas; no hace falta ejecutar una consulta vehicular.
Recuperá la conexión
La solicitud venció o no vuelve al asistente
Iniciá la conexión otra vez desde el asistente. No reutilices enlaces de consentimiento o códigos anteriores. Si desarrollás el cliente, verificá el retorno registrado, state, PKCE y el resource de la solicitud.
Me pide una API key o un client secret
Ese flujo no corresponde a esta conexión MCP. Usá OAuth con cliente público y PKCE. Si la aplicación no admite ese método, no está verificada para esta integración; no pegues tu API key como alternativa.
Revisá por qué falla una consulta
No puedo ejecutar una consulta
- Revisá que MCP y tu cuenta estén habilitados y que la autorización no esté revocada.
- Comprobá el permiso OAuth de la herramienta, el módulo habilitado y el cupo disponible.
- Si el token venció, dejá que el cliente lo renueve. Si no puede renovarlo, autorizá otra vez.
- Si alcanzaste el límite de solicitudes, esperá antes de reintentar. No inicies otra operación para seguir una que está en curso.
- Si el servicio está temporalmente indisponible, volvé a intentarlo más tarde.
El consumo no aparece en mi panel
Comprobá que estés viendo la misma cuenta que autorizaste en OAuth y actualizá el estado. El consumo corresponde a esa cuenta; un listado de herramientas no aumenta las unidades de consulta.
Interpretá los errores del cliente
Distinguí errores HTTP de autenticación, errores OAuth y errores de herramientas. Un HTTP 200 no significa necesariamente que una consulta haya tenido éxito.
| Respuesta | Cómo actuar |
|---|---|
HTTP 401 / invalid_token en MCP | Falta un token válido, venció o fue revocado. Renovalo si corresponde o volvé a autorizar. |
| HTTP 403 en MCP | Revisá acceso de cuenta, bloqueos u origen del cliente. Cambiar de token no amplía el plan. |
| HTTP 429 | Se alcanzó un límite de solicitudes. Reducí la frecuencia y esperá antes de reintentar. |
HTTP 503 / mcp_disabled o temporarily_unavailable | El servicio no está disponible. Revisá el estado de MCP en tu cuenta y volvé a intentarlo más tarde. |
OAuth invalid_grant | Código o refresh token no válido, vencido, ya utilizado o perteneciente a otro cliente. Reiniciá la autorización si no puede recuperarse. |
OAuth invalid_scope, invalid_request o invalid_client_metadata | Corregí scopes, parámetros, recurso o registro; no reintentes el mismo pedido sin cambios. |
Resultado de herramienta con isError: true | Leé error.code en el JSON del bloque de texto: puede indicar permisos, módulo deshabilitado, cupo agotado u otro error de la consulta. |
Pedí ayuda
Si el problema continúa, indicá qué cliente y versión usás, en qué paso falla y el código de error si aparece. No envíes contraseñas, tokens ni resultados con datos personales.