Dépannage
Quand l’onboarding échoue, le problème est généralement l’état de la session, le chemin de la config MCP ou une mauvaise URL serveur. Vérifiez dans cet ordre.
Pas de session CLI active
Si la génération ou l’échange du token de configuration échoue, votre état d’authentification local est peut-être manquant ou expiré.
- Exécutez npx @swylink/cli auth whoami --api-base-url https://api.swylink.com
- S’il n’indique aucune session, exécutez npx @swylink/cli auth login --api-base-url https://api.swylink.com à nouveau
- Si la connexion fonctionne mais que la génération du token ou le démarrage du bridge est bloqué, vérifiez que le compte a un abonnement actif dans le tableau de bord
L’IDE reste hors ligne
L’IDE reste généralement hors ligne quand la config pointe vers le mauvais fichier ou que la commande résout encore vers localhost au lieu de votre backend de production.
- Confirmez que le chemin du fichier correspond à .cursor/mcp.json pour l’IDE sélectionné
- Confirmez que la config inclut --ide cursor
- Si vous visez la production, gardez --server wss://api.swylink.com/ws explicite dans la config générée
- Exécutez npx @swylink/cli doctor --ide cursor pour vérifier les conflits de configuration
Exécutez d’abord la commande de démarrage exacte manuellement dans un terminal. Si elle se connecte là, le problème restant est presque toujours le fichier de config IDE ou l’environnement du processus.
Langue et localisation
Le CLI supporte plusieurs langues pour les messages de sortie. Définissez la langue explicitement si la détection automatique est incorrecte.
- Utilisez --lang pt (ou en, es, fr, de, zh) pour remplacer la langue détectée
- Vous pouvez aussi définir la variable d’environnement SWYLINK_LANG