문제 해결 - LexQ Docs

API & 실행

429 Too Many Requests

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

ENTITY_NOT_FOUND 오류

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

CANNOT_MODIFY 오류

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

EMPTY_RULES 발행 오류

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

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

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

POLICY_GROUP_DISABLED 오류

정책 그룹이 DISABLED 상태입니다. 콘솔의 그룹 설정에서 다시 활성화하거나, lexq groups update --id <gid> --json '{"status": "ACTIVE"}'를 사용하세요.

'lexq: command not found'

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

'API key not found'

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

'Authorization with the MCP server failed'

설정 → 커넥터에서 LexQ 커넥터를 제거한 후 https://mcp.lexq.io를 다시 추가하세요. 로그인 단계와 API Key 선택/생성 단계를 모두 완료한 후 Authorize를 클릭해야 합니다.

인증 중 'Failed to create API key'

계정의 API Key 개수 제한에 도달했을 수 있습니다. 콘솔 → 관리 → API Keys에서 사용하지 않는 키를 삭제한 후 다시 시도하세요.

도구는 표시되지만 호출 시 에러 발생

API Key가 폐기되었거나 계정이 비활성화되었을 수 있습니다. 커넥터를 제거하고 유효한 키로 다시 인증하세요.

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

MCP 설정 추가 후 AI 클라이언트(Claude Desktop, VS Code 등)를 재시작하세요. 일부 클라이언트는 시작 시 도구 목록을 캐시합니다.

'npx: command not found'

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

연결 타임아웃 또는 전송 오류

로컬 MCP 서버는 stdio 전송을 사용합니다. 네트워크 포트를 열지 않습니다. AI 클라이언트가 HTTP/SSE만 지원하면 클라우드 방식을 사용하세요.

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