설치 또는 실행 실패
공식 센터에서 운영체제와 아키텍처를 맞추고 재시도 전에 오류를 기록하세요. Linux는 배포판 형식에 맞는 패키지를 고르세요. macOS의 오래된 Intel 설치 파일이 현재도 지원된다고 가정하지 마세요.
로그인 또는 네트워크 오류
공식 웹사이트에 로그인되는지 확인하세요. 시각과 오류 코드를 기록하고 프록시, VPN, 조직 정책을 점검하세요. 계정과 로컬 문제를 구분하기 전에는 재설치를 반복하지 마세요.
모델 사용 불가 또는 토큰 한도 도달
요금제, 잔여량, 선택기를 확인하고 짧은 새 대화를 시험하세요. 소진된 한도는 재설치로 복구되지 않습니다. 추가 지출 전에 가격과 사용량 제어를 확인하세요.
MCP 서버가 시작되지 않음
JSON, 실행 파일 접근, 서버 로그를 확인하세요. npx가 작동하는 셸과 데스크톱 앱의 PATH가 다를 수 있습니다. MCP 가이드의 단계별 점검을 따르세요.
확장 기능 또는 인덱싱 문제
작은 프로젝트에서 의심되는 확장 기능을 잠시 꺼서 원인을 구분하세요. 공간 크기와 생성 파일 제외를 확인하세요. 초기화 전에 설정을 백업하고 지원팀에 보낼 최소 재현 사례를 준비하세요.
지원 요청에 포함할 내용
버전, 운영체제, 아키텍처, 지역, 요금제, 최소 재현, 민감 정보를 제거한 로그를 포함하세요. 공유 내용을 검토하지 않고 토큰, 환경 파일, 비공개 코드를 첨부하지 마세요.