복구
문제 해결
온보딩이 실패하면 원인은 대개 세션 상태, 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를 실행하여 설정 충돌을 확인하세요
최소 디버그 루프
터미널에서 정확한 시작 명령을 먼저 수동으로 실행하세요. 거기서 연결되면 나머지 문제는 거의 항상 IDE 설정 파일이나 프로세스 환경입니다.
섹션
언어 및 현지화
CLI는 출력 메시지에 대해 여러 언어를 지원합니다. 자동 감지가 올바르지 않으면 언어를 명시적으로 설정하세요.
- --lang pt (또는 en, es, fr, de, zh)를 사용하여 감지된 언어를 재정의하세요
- SWYLINK_LANG 환경 변수를 설정할 수도 있습니다
계속
인증부터 IDE 연결까지 전체 CLI 과정을 진행하거나, 새 사용자의 온보딩을 문서화하는 경우 처음으로 돌아갈 수 있습니다.