リカバリー
トラブルシューティング
オンボーディングが失敗する場合、原因は通常セッション状態、MCP 設定パス、またはサーバー URL の誤りです。この順序で確認してください。
選択された IDE
Cursor
.cursor/mcp.json
Swylink はドキュメント全体で --ide cursor と正しい MCP 設定パスを表示し、この IDE 向けのブリッジを明示的に保ちます。
セクション
アクティブな CLI セッションがない
セットアップトークンの生成や交換が失敗する場合、ローカル認証状態が見つからないか期限切れの可能性があります。
- npx @swylink/cli auth whoami --api-base-url https://api.swylink.com を実行してください
- セッションがないと報告された場合は、npx @swylink/cli auth login --api-base-url https://api.swylink.com を再度実行してください
- ログインは成功するがセットアップトークンの生成やブリッジの開始がブロックされる場合は、ダッシュボードでアカウントにアクティブなサブスクリプションがあることを確認してください
セクション
IDE がオフラインのまま
IDE がオフラインのままになるのは、通常、設定が間違ったファイルを指しているか、コマンドが本番バックエンドではなく localhost に解決されている場合です。
- ファイルパスが選択した IDE の .cursor/mcp.json と一致することを確認してください
- 設定に --ide cursor が含まれていることを確認してください
- 本番環境を使用する場合は、生成された設定に --server wss://api.swylink.com/ws を明示的に含めてください
- npx @swylink/cli doctor --ide cursor を実行して設定の競合を確認してください
最小限のデバッグループ
まずターミナルで正確な start コマンドを手動で実行してください。そこで接続できれば、残りの問題はほぼ確実に IDE の設定ファイルまたはプロセス環境です。
セクション
言語とローカライゼーション
CLI は出力メッセージに複数の言語をサポートしています。自動検出が正しくない場合は、言語を明示的に設定してください。
- 検出された言語をオーバーライドするには --lang pt（または en、es、fr、de、zh）を使用してください
- SWYLINK_LANG 環境変数を設定することもできます
続ける
認証から IDE 接続までの CLI パス全体を進むか、新しいユーザーのオンボーディングを記録する場合は最初に戻ります。