문제 해결 - LexQ Docs

API & 실행

429 Too Many Requests

플랜의 TPS 한도를 초과했습니다. 관리 → 결제에서 현재 플랜을 확인하세요. Free = 5 TPS, Growth = 50 TPS, Pro = 200 TPS.

ENTITY_NOT_FOUND 오류

리소스 ID가 존재하지 않거나 다른 테넌트에 속합니다. 해당 list 명령어로 ID를 확인하세요. UUID는 대소문자를 구분합니다.

CANNOT_MODIFY 오류

DRAFT가 아닌 버전을 수정하려고 합니다. 발행된 버전은 잠겨 있습니다. lexq versions clone으로 새 DRAFT를 생성하세요.

EMPTY_RULES 발행 오류

발행 전에 최소 하나의 규칙이 필요합니다. lexq rules create로 규칙을 추가하세요.

규칙이 기대한 입력과 매칭되지 않음

lexq analytics requirements로 버전이 기대하는 팩트를 확인하세요. --debug 플래그로 드라이런을 실행하여 실행 트레이스를 점검하세요.

'lexq: command not found'

CLI가 전역 설치되지 않았습니다. npm install -g @lexq/cli를 실행하거나 npx @lexq/cli를 사용하세요.

'API key not found'

lexq auth login을 실행하여 API 키를 저장하세요. ~/.lexq/config.json에 저장됩니다.

MCP 서버가 시작되지만 도구가 보이지 않음

MCP 설정 추가 후 AI 클라이언트(Claude Desktop, VS Code 등)를 재시작하세요.

'npx: command not found'

Node.js 18+ 설치를 확인하세요. node --version으로 확인합니다.

연결 타임아웃

LexQ MCP 서버는 stdio 전송을 사용합니다. 네트워크 포트를 열지 않습니다. AI 클라이언트가 HTTP/SSE만 지원하면 호환되지 않습니다.

해결되지 않으면 지원을 통해 LexQ 팀에 연락하세요.