MCP 문제 해결
연결 문제가 발생했을 때 필요한 조치를 안내합니다.
호스팅형 클라이언트가 연결되지 않을 때
설정된 URL이 https://mcp.altifigence.com/cloud-mcp인지, 클라이언트가 OAuth를 사용하는 Streamable HTTP를 지원하는지 확인하세요. 연결 안내와 현재 검증 상태를 따르세요. 서버 상태 페이지와 OAuth 메타데이터만으로 특정 클라이언트의 권한 부여 완료가 입증되지는 않습니다.
결과 | 다음 단계 |
|---|---|
HTTP 401 | 인증이 만료되거나 철회되면 Altifigence Cloud를 다시 연결하고 클라이언트 인증 절차를 완료하세요 |
HTTP 403 | 동의한 조직, 현재 프로젝트 접근 권한과 도구 정책을 확인하세요. 조직에서 도구를 허용한 뒤 필요한 권한으로 다시 연결하세요 |
도구 목록이 비어 있거나 일부 도구가 없음 | 출시된 카탈로그, 도구별 명시적 조직 허용과 새 동의를 확인하세요. 이전 토큰 갱신으로 도구가 추가되지는 않습니다 |
작업공간 조회 불가 | Cloud에서 작업공간 상태와 권한을 확인하고 준비된 뒤 다시 시도하세요 |
실행 도구가 없음 | 새 |
쓰기 도구가 없음 | 새 |
파일 변경 충돌 | Manifest와 파일을 다시 읽고 동시 변경을 검토한 뒤 현재 revision으로 의도한 변경을 제출하세요 |
프로젝트 생성 또는 Git 변경이 확인되지 않음 | 재시도 전에 프로젝트 목록·저장소·원격 상태를 확인하세요. 생성·커밋·push를 반복하면 의도하지 않은 결과가 생길 수 있습니다 |
프로젝트 삭제 접수 | 정리가 끝날 때까지 프로젝트·작업공간 상태를 확인하세요. 접수는 완료를 뜻하지 않습니다 |
Git 공급자 전송 거부 | 선택한 저장소·브랜치·현재 공급자 연결을 확인하세요. 도구가 공급자 권한을 우회할 수는 없습니다 |
런타임 작업이 확인되지 않음 | 런타임 상태를 읽고 operation ID를 유지하세요. 재개에는 중지된 런타임의 operation ID를 사용합니다 |
프로젝트 generation, 파일 버전 또는 정책 변경 | 새 견적을 받고 선택한 offer와 사용 정책을 검토하세요 |
제출이 확인되지 않음 | 같은 job ID를 조회하고, 동일한 인자와 같은 ID로만 재시도하세요 |
결과가 아직 준비되지 않음 | 결과를 다시 요청하기 전에 작업 상태를 조회하세요 |
크레딧 부족 | Cloud에서 조직의 결제 상태를 확인하세요 |
HTTP 413 | 검색된 도구 schema에 정의된 인자만 포함하도록 요청을 줄이세요 |
로컬 도구의 HTTP 501 | 설치된 런타임은 이 작업을 구현하지 않습니다. 검색 목록만으로 지원이 입증되지는 않습니다 |
HTTP 503 | 설정된 엔드포인트를 유지하고 서비스 복구를 기다리세요 |
조회 요청은 프로젝트를 시작하거나 재시작하지 않습니다. 알 수 없거나 허용되지 않은 도구 이름으로 편집·실행을 활성화할 수 없습니다. 재시도 전에 연결이나 접근 조건을 바로잡고, 인자로 다른 자격 증명을 전달하지 마세요.
요청 횟수가 제한된 경우
HTTP 429 응답을 받았다면 Retry-After에 안내된 시간이 지난 뒤 다시 시도하세요. 등록이나 로그인을 반복해서 요청하지 마세요.
지원 문의
Altifigence 지원에 클라이언트 이름과 버전, 발생 시각, 민감 정보를 제거한 오류 메시지를 알려 주세요. 인증 정보, 쿠키, 프로젝트 내용은 포함하지 마세요.
중복 작업 없이 복구
실패 위치 | 재시도 전 확인 |
|---|---|
사용자 확인·도구 검색 | 클라이언트 버전·주소·로그인/세션·동의한 도구 목록 |
파일 이어 읽기 | 파일·매니페스트 버전, 스냅샷 변경 시 처음부터 읽기 |
파일 쓰기·커밋·push | 현재 저장 파일·저장소·원격 상태 |
작업 제출 | 기존 작업 ID·상태, 원래 식별 정보 유지 |
터미널 입력·AI 요청 | 현재 세션·출력, 입력 자동 재전송 금지 |
프로젝트 자료를 자리표시자로 바꾼 최소 재현 요청을 기록하세요. 오류 코드·HTTP 상태·표시된 요청 식별자·시각은 보관하고, 진단을 공유하기 전에 토큰·소스 내용을 제거합니다.