Conecta
Captura
Entiende
Actúa
Mide y prevé
Conoce los agentes de StellanKnowledge Agent, AI SDR, Briefer, Deal Monitor y CRM Copilot.Ver los agentes →DesarrolladoresMCPResolver problemas de MCP
Resolver problemas de MCP
Diagnóstico rápido para instalación, OAuth, callback, scopes, catálogo y llamadas de herramientas.
Checklist de dos minutos
- Confirma que el servidor configurado sea exactamente https://mcp.aivyro.io/mcp.
- Actualiza la entrada con npx @aivyro/mcp@latest setup y recarga el cliente.
- Inicia sesión en Aivyro en el navegador y confirma la organización activa antes de autorizar.
- Solicita tools/list o aivyro.getting_started; no valides la conexión solo por el estado visual del cliente.
Errores comunes
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| No grantable scopes | La conexión solicitó permisos que la cuenta, el rol o la política actual no puede conceder. | Confirma la organización y el rol; desconecta el grant anterior; actualiza el cliente y autoriza de nuevo. Si persiste, un administrador debe revisar los permisos de la cuenta. |
| El navegador termina, pero el cliente sigue desconectado | El callback local expiró, fue bloqueado o pertenece a otro intento. | Cierra el intento, inicia una nueva conexión en el cliente y completa solo la URL más reciente. No reutilices enlaces de callback. |
| 401 o solicitud de login repetida | El token falta, expiró o fue revocado. | Desconecta Aivyro en el cliente, elimina la autorización anterior y vuelve a conectar. |
| No aparece la herramienta esperada | El scope, el rol, la política, la licencia o la salud del servicio no admite la herramienta. | Actualiza tools/list, verifica la organización y los permisos y no uses una lista de herramientas en caché. |
| La acción solicita confirmación y no avanza | El cliente no completó o no admite la solicitud de confirmación. | Aprueba o rechaza en el cliente. Si no tiene interfaz de confirmación, usa un cliente compatible; Aivyro no ejecutará la acción en silencio. |
| La herramienta devuelve 403 | La autenticación funcionó, pero la acción no está permitida para ese usuario o recurso. | No reintentes con IDs diferentes. Verifica el rol y solicita el permiso correcto a un administrador. |
| La herramienta devuelve 429 | Se alcanzó el límite de llamadas. | Espera el tiempo indicado, reduce la repetición o paginación agresiva e intenta de nuevo. |
Rehacer la configuración
Sustituye codex por el identificador de tu cliente. Luego recarga el cliente y completa una nueva autorización. Eliminar la configuración local por sí sola no revoca un token ya concedido.
Qué enviar a soporte
- Nombre y versión del cliente y del paquete @aivyro/mcp.
- Hora aproximada, organización afectada y nombre de la herramienta.
- Código público del error y traceId, cuando aparezca.
- El paso que falló: discovery, navegador, callback, tools/list o tools/call.