Solución de problemas
Cuando el onboarding falla, el problema suele ser el estado de la sesión, la ruta de configuración MCP o una URL de servidor incorrecta. Verifica estos en orden.
Sin sesión activa del CLI
Si la generación o el intercambio del token de configuración falla, tu estado de autenticación local puede estar ausente o expirado.
- Ejecuta npx @swylink/cli auth whoami --api-base-url https://api.swylink.com
- Si reporta que no hay sesión, ejecuta npx @swylink/cli auth login --api-base-url https://api.swylink.com de nuevo
- Si el login funciona pero la generación del token o el inicio del puente está bloqueado, verifica que la cuenta tenga una suscripción activa en el dashboard
El IDE no se conecta
El IDE generalmente no se conecta cuando la configuración apunta al archivo incorrecto o el comando aún resuelve a localhost en lugar de tu backend de producción.
- Confirma que la ruta del archivo coincida con .cursor/mcp.json para el IDE seleccionado
- Confirma que la configuración incluya --ide cursor
- Si esperas producción, mantén --server wss://api.swylink.com/ws explícito en la configuración generada
- Ejecuta npx @swylink/cli doctor --ide cursor para verificar conflictos de configuración
Ejecuta el comando start exacto manualmente en una terminal primero. Si se conecta ahí, el problema restante casi siempre es el archivo de configuración del IDE o el entorno del proceso.
Idioma y localización
El CLI soporta múltiples idiomas para los mensajes de salida. Establece el idioma explícitamente si la autodetección es incorrecta.
- Usa --lang pt (o en, es, fr, de, zh) para anular el idioma detectado
- También puedes establecer la variable de entorno SWYLINK_LANG