Fehlerbehebung
Wenn das Onboarding fehlschlägt, liegt das Problem meist am Sitzungsstatus, dem MCP-Konfigurationspfad oder einer falschen Server-URL. Prüfe diese in dieser Reihenfolge.
Keine aktive CLI-Sitzung
Wenn die Setup-Token-Generierung oder der Austausch fehlschlägt, fehlt möglicherweise dein lokaler Authentifizierungsstatus oder er ist abgelaufen.
- Führe npx @swylink/cli auth whoami --api-base-url https://api.swylink.com aus
- Wenn keine Sitzung gemeldet wird, führe npx @swylink/cli auth login --api-base-url https://api.swylink.com erneut aus
- Wenn die Anmeldung funktioniert, aber die Setup-Token-Generierung oder der Bridge-Start blockiert ist, prüfe im Dashboard, ob das Konto ein aktives Abonnement hat
IDE bleibt offline
Die IDE bleibt meist offline, wenn die Konfiguration auf die falsche Datei zeigt oder der Befehl noch auf localhost statt auf dein Produktions-Backend auflöst.
- Bestätige, dass der Dateipfad .cursor/mcp.json für die ausgewählte IDE übereinstimmt
- Bestätige, dass die Konfiguration --ide cursor enthält
- Wenn du Produktion erwartest, halte --server wss://api.swylink.com/ws explizit in der generierten Konfiguration
- Führe npx @swylink/cli doctor --ide cursor aus, um Konfigurationskonflikte zu prüfen
Führe den exakten Start-Befehl zuerst manuell in einem Terminal aus. Wenn er dort verbindet, liegt das verbleibende Problem fast immer an der IDE-Konfigurationsdatei oder der Prozessumgebung.
Sprache und Lokalisierung
Die CLI unterstützt mehrere Sprachen für Ausgabemeldungen. Setze die Sprache explizit, wenn die automatische Erkennung falsch ist.
- Verwende --lang pt (oder en, es, fr, de, zh), um die erkannte Sprache zu überschreiben
- Du kannst auch die Umgebungsvariable SWYLINK_LANG setzen