AI가 "Tool이 비활성"이라고 함 (TOOL_DISABLED, TOOL_NOT_YET_ENABLED) | 계정 정책상 해당 기능을 지금 사용할 수 없음 | "내 계정에서 쓸 수 있는 기능 알려줘"로 확인(get_mcp_policy). 다른 Tool로 몰래 우회하지 않는 것이 정상 동작입니다. |
크레딧 부족 (INSUFFICIENT_CREDIT) | 잔액이 예상 비용보다 적음 | 잔액 확인 후 충전하거나 수량·옵션을 줄여 다시 요청 |
지출 한도 초과 (SPENDING_LIMIT_EXCEEDED) | 요청당/일/월 MCP 지출 한도 도달 | 한도는 get_mcp_policy에서 확인. 한도를 피하려고 작업을 쪼개지 않습니다. |
인증 만료 (AUTH_REQUIRED, TOKEN_EXPIRED, AUTH_INVALID) | MCP 연결 로그인 만료 | AI 앱의 커넥터 설정에서 NEXAGEN을 다시 연결 |
권한 없음 (SCOPE_DENIED) | 연결 시 해당 권한을 허용하지 않음 | 커넥터를 다시 연결하며 권한 허용 |
| 업로드 불가 | 이 앱이 MCP 밖 HTTP PUT을 실행할 수 없음 | NEXAGEN 웹에서 업로드 후 라이브러리에서 선택, 또는 터미널 사용 가능한 앱(Claude Code·Cursor·Codex) 사용 |
업로드 슬롯 오류 (UPLOAD_INVALID) | 슬롯 만료/형식·크기 불일치(png·jpeg·webp·gif·mp4·webm, 최대 100MB) | 새 업로드 슬롯으로 다시 시도 |
옵션 오류 (INVALID_CAPABILITY) | 엔진이 해당 길이·해상도·비율·레퍼런스를 지원하지 않음 | AI가 보여주는 지원 값 중에서 선택 |
| 생성이 오래 걸림 | 작업이 아직 처리 중 | AI가 남긴 job_id로 "이 작업 상태 확인해줘"라고 요청. 다시 제출하지 마세요. |
너무 빠른 조회 (POLL_TOO_FAST) | 서버가 허용하는 간격보다 빠르게 상태를 조회함 | 정상적으로는 Skill이 간격을 지킵니다. 잠시 후 다시 확인 |
혼잡 (RATE_LIMITED, QUEUE_BUSY, CONCURRENCY_LIMIT) | 요청이 몰림 | 안내된 시간 후 다시 시도. 유료 요청은 기존 작업이 생겼는지 먼저 확인 |
| Skill이 동작하지 않음 | 설치 위치/형식 오류 | 플랫폼별 설치 문서 확인: Claude, Cursor, Codex, ChatGPT, 기타 |