Skip to main content

​
API & 실행

429와 C-007 코드를 내는 경우는 둘입니다.플랜의 TPS 한도 초과. 관리 → 결제에서 현재 플랜을 확인하고 상위 플랜을 검토하세요. 플랜별 표는 속도 제한을 참고하세요. 배치로 묶는 방법도 있습니다. 배치와 복합 호출은 TPS에 대해 1건으로 계산됩니다.엣지 보호. 단일 IP에서 요청이 극단적으로 몰리면 API에 닿기 전에 차단됩니다. 플랜과 무관하므로 업그레이드해도 이 한도는 올라가지 않고, 정상적인 애플리케이션 트래픽은 여기에 닿지 않습니다. 반복해서 겪는다면 지원팀에 문의하세요.
리소스 ID가 존재하지 않거나 다른 테넌트에 속합니다. 해당 list 명령어로 ID를 확인하세요. UUID는 대소문자를 구분합니다.
DRAFT가 아닌 버전을 수정하려고 합니다. 발행된 버전은 잠겨 있습니다. lexq versions clone으로 새 DRAFT를 생성하세요.
발행 전에 최소 하나의 규칙이 필요합니다. lexq rules create로 규칙을 추가하세요.
lexq analytics requirements로 버전이 기대하는 fact를 확인하세요. --debug 플래그로 드라이런을 실행하여 실행 트레이스를 점검하세요.
분배는 실행 요청마다 담기는 context.trafficKey 값으로 정해집니다. 요청이 이 값을 싣지 않거나 context가 아니라 facts에 담으면 어떤 요청도 테스트 버전에 배정되지 않습니다. 그래도 테스트는 진행 중으로 보고되고 로그도 계속 쌓이므로 응답만 봐서는 문제가 드러나지 않습니다.해당 요청마다 서버 로그에 경고가 남습니다.
배치 호출은 개별 요청의 context가 아니라 sharedContext.trafficKey를 읽습니다. 트래픽 식별 키를 참조하세요.
정책 그룹이 DISABLED 상태입니다. 콘솔의 그룹 설정에서 다시 활성화하거나, lexq groups update --id <gid> --json '{"status": "ACTIVE"}'를 사용하세요.

​
CLI

CLI가 전역 설치되지 않았습니다. npm install -g @lexq/cli를 실행하거나 npx @lexq/cli를 사용하세요.
lexq auth login을 실행하여 API 키를 저장하세요. ~/.lexq/config.json에 저장됩니다.

​
MCP 서버 — 클라우드 (Claude.ai)

설정 → 커넥터에서 LexQ 커넥터를 제거한 후 https://mcp.lexq.io를 다시 추가하세요. 로그인 단계와 API Key 선택/생성 단계를 모두 완료한 후 Authorize를 클릭해야 합니다.
계정의 API Key 개수 제한에 도달했을 수 있습니다. 콘솔 → 관리 → API Keys에서 사용하지 않는 키를 삭제한 후 다시 시도하세요.
API Key가 폐기되었거나 계정이 비활성화되었을 수 있습니다. 커넥터를 제거하고 유효한 키로 다시 인증하세요.

​
MCP 서버 — 로컬 (stdio)

MCP 설정 추가 후 AI 클라이언트(Claude Desktop, VS Code 등)를 재시작하세요. 일부 클라이언트는 시작 시 도구 목록을 캐시합니다.
Node.js 18+ 설치를 확인하세요. node --version으로 확인합니다.
로컬 MCP 서버는 stdio 전송을 사용합니다. 네트워크 포트를 열지 않습니다. AI 클라이언트가 HTTP/SSE만 지원하면 클라우드 방식을 사용하세요.

​
아직 해결되지 않나요?

지원을 통해 LexQ 팀에 연락하세요.