API & 실행
429 Too Many Requests
429 Too Many Requests
ENTITY_NOT_FOUND 오류
ENTITY_NOT_FOUND 오류
리소스 ID가 존재하지 않거나 다른 테넌트에 속합니다. 해당
list 명령어로 ID를 확인하세요. UUID는 대소문자를 구분합니다.CANNOT_MODIFY 오류
CANNOT_MODIFY 오류
DRAFT가 아닌 버전을 수정하려고 합니다. 발행된 버전은 잠겨 있습니다.
lexq versions clone으로 새 DRAFT를 생성하세요.EMPTY_RULES 발행 오류
EMPTY_RULES 발행 오류
발행 전에 최소 하나의 규칙이 필요합니다.
lexq rules create로 규칙을 추가하세요.규칙이 기대한 입력과 매칭되지 않음
규칙이 기대한 입력과 매칭되지 않음
lexq analytics requirements로 버전이 기대하는 fact를 확인하세요. --debug 플래그로 드라이런을 실행하여 실행 트레이스를 점검하세요.A/B 테스트가 진행 중인데 테스트 버전에 트래픽이 없음
A/B 테스트가 진행 중인데 테스트 버전에 트래픽이 없음
분배는 실행 요청마다 담기는 배치 호출은 개별 요청의
context.trafficKey 값으로 정해집니다. 요청이 이 값을 싣지 않거나 context가 아니라 facts에 담으면 어떤 요청도 테스트 버전에 배정되지 않습니다. 그래도 테스트는 진행 중으로 보고되고 로그도 계속 쌓이므로 응답만 봐서는 문제가 드러나지 않습니다.해당 요청마다 서버 로그에 경고가 남습니다.context가 아니라 sharedContext.trafficKey를 읽습니다. 트래픽 식별 키를 참조하세요.POLICY_GROUP_DISABLED 오류
POLICY_GROUP_DISABLED 오류
정책 그룹이
DISABLED 상태입니다. 그룹은 보통 잘못된 결정을 멈추려고 일부러 비활성으로 바꾸므로, 원인이 고쳐졌는지 먼저 확인하세요. 그다음 콘솔의 그룹 화면 배너에서 다시 활성화를 누르거나, 그룹 설정에서 상태를 활성으로 저장하거나, lexq groups update --id <gid> --json '{"status": "ACTIVE"}'를 사용하세요.전에 저장되던 규칙이 P-051로 거절됨
전에 저장되던 규칙이 P-051로 거절됨
조건이 비교하는 fact에 값 제약이 새로 생겼거나 좁아졌고, 그 조건이 제약 밖의 값을 씁니다. 값 제약을 바꾸는 fact 수정은 이런 규칙을 알려 줍니다. 콘솔은 창으로, CLI는 stderr로, MCP는 도구 결과 끝에 붙여서 알립니다. 새 제약 밖의 값을 쓰는 규칙을 참고하세요.조건을 고치거나 지우세요. 아니면 fact 정의에서 값 제약을 넓히세요. 허용 값으로 바꿔 넣기 전에 그 조건이 무엇을 위한 것이었는지 보세요.
NOT_EQUALS 같은 부정 조건은 값을 바꾸면 뜻이 달라집니다.CLI
'lexq: command not found'
'lexq: command not found'
CLI가 전역 설치되지 않았습니다.
npm install -g @lexq/cli를 실행하거나 npx @lexq/cli를 사용하세요.'API key not found'
'API key not found'
lexq auth login을 실행하여 API 키를 저장하세요. ~/.lexq/config.json에 저장됩니다.MCP 서버 — 클라우드 (Claude.ai)
인증 중 'Failed to create API key'
인증 중 'Failed to create API key'
계정의 API Key 개수 제한에 도달했을 수 있습니다. 콘솔 → 관리 → API Keys에서 사용하지 않는 키를 삭제한 후 다시 시도하세요.
도구는 표시되지만 호출 시 에러 발생
도구는 표시되지만 호출 시 에러 발생
API Key가 폐기되었거나 계정이 비활성화되었을 수 있습니다. 커넥터를 제거하고 유효한 키로 다시 인증하세요.
MCP 서버 — 로컬 (stdio)
MCP 서버가 시작되지만 도구가 보이지 않음
MCP 서버가 시작되지만 도구가 보이지 않음
MCP 설정 추가 후 AI 클라이언트(Claude Desktop, VS Code 등)를 재시작하세요. 일부 클라이언트는 시작 시 도구 목록을 캐시합니다.
'npx: command not found'
'npx: command not found'
Node.js 22+ 설치를 확인하세요.
node --version으로 확인합니다.연결 타임아웃 또는 전송 오류
연결 타임아웃 또는 전송 오류
로컬 MCP 서버는 stdio 전송을 사용합니다. 네트워크 포트를 열지 않습니다. AI 클라이언트가 HTTP/SSE만 지원하면 클라우드 방식을 사용하세요.