> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lexq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 문제 해결

> 일반적인 문제와 해결 방법입니다.

## API & 실행

<AccordionGroup>
  <Accordion title="429 Too Many Requests">
    플랜의 TPS 한도를 초과했습니다. **관리 → 결제**에서 현재 플랜을 확인하세요. Free = 10 TPS, Growth = 100 TPS, Pro = 500 TPS, Enterprise = Custom.
  </Accordion>

  <Accordion title="ENTITY_NOT_FOUND 오류">
    리소스 ID가 존재하지 않거나 다른 테넌트에 속합니다. 해당 `list` 명령어로 ID를 확인하세요. UUID는 대소문자를 구분합니다.
  </Accordion>

  <Accordion title="CANNOT_MODIFY 오류">
    DRAFT가 아닌 버전을 수정하려고 합니다. 발행된 버전은 잠겨 있습니다. `lexq versions clone`으로 새 DRAFT를 생성하세요.
  </Accordion>

  <Accordion title="EMPTY_RULES 발행 오류">
    발행 전에 최소 하나의 규칙이 필요합니다. `lexq rules create`로 규칙을 추가하세요.
  </Accordion>

  <Accordion title="규칙이 기대한 입력과 매칭되지 않음">
    `lexq analytics requirements`로 버전이 기대하는 팩트를 확인하세요. `--debug` 플래그로 드라이런을 실행하여 실행 트레이스를 점검하세요.
  </Accordion>

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

## CLI

<AccordionGroup>
  <Accordion title="'lexq: command not found'">
    CLI가 전역 설치되지 않았습니다. `npm install -g @lexq/cli`를 실행하거나 `npx @lexq/cli`를 사용하세요.
  </Accordion>

  <Accordion title="'API key not found'">
    `lexq auth login`을 실행하여 API 키를 저장하세요. `~/.lexq/config.json`에 저장됩니다.
  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="'Authorization with the MCP server failed'">
    **설정 → 커넥터**에서 LexQ 커넥터를 제거한 후 `https://mcp.lexq.io`를 다시 추가하세요. 로그인 단계와 API Key 선택/생성 단계를 모두 완료한 후 Authorize를 클릭해야 합니다.
  </Accordion>

  <Accordion title="인증 중 'Failed to create API key'">
    계정의 API Key 개수 제한에 도달했을 수 있습니다. **콘솔 → 관리 → API Keys**에서 사용하지 않는 키를 삭제한 후 다시 시도하세요.
  </Accordion>

  <Accordion title="도구는 표시되지만 호출 시 에러 발생">
    API Key가 폐기되었거나 계정이 비활성화되었을 수 있습니다. 커넥터를 제거하고 유효한 키로 다시 인증하세요.
  </Accordion>
</AccordionGroup>

## MCP 서버 — 로컬 (stdio)

<AccordionGroup>
  <Accordion title="MCP 서버가 시작되지만 도구가 보이지 않음">
    MCP 설정 추가 후 AI 클라이언트(Claude Desktop, VS Code 등)를 재시작하세요. 일부 클라이언트는 시작 시 도구 목록을 캐시합니다.
  </Accordion>

  <Accordion title="'npx: command not found'">
    Node.js 18+ 설치를 확인하세요. `node --version`으로 확인합니다.
  </Accordion>

  <Accordion title="연결 타임아웃 또는 전송 오류">
    로컬 MCP 서버는 **stdio 전송**을 사용합니다. 네트워크 포트를 열지 않습니다. AI 클라이언트가 HTTP/SSE만 지원하면 [클라우드 방식](/ko/cli/mcp-server#클라우드--claudeai-custom-integration)을 사용하세요.
  </Accordion>
</AccordionGroup>

## 아직 해결되지 않나요?

[지원](/ko/help/support)을 통해 LexQ 팀에 연락하세요.