> ## 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.

# CLI 개요

> LexQ 의사결정 운영 플랫폼의 커맨드라인 인터페이스. 터미널에서 정책을 관리하고, 변경 영향 시뮬레이션을 실행하고, 배포합니다. 사람과 AI 에이전트를 위해 설계되었습니다.

## LexQ CLI란?

LexQ CLI (`@lexq/cli`)는 정책 그룹 생성부터 버전 배포까지 전체 정책 생명주기를 관리하는 커맨드라인 도구입니다. 콘솔의 모든 기능을 지원하며, AI 에이전트 연동을 위한 **MCP 서버** 모드도 내장되어 있습니다.

```bash theme={null}
npm install -g @lexq/cli
```

## 주요 기능

<CardGroup cols={2}>
  <Card title="전체 정책 생명주기" icon="arrows-spin">
    터미널에서 정책 생성, 테스트, 발행, 배포까지 모두 수행.
  </Card>

  <Card title="AI 에이전트 지원" icon="robot">
    에이전트 스킬, 스키마, MCP 서버 모드 내장.
  </Card>

  <Card title="드라이런 & 변경 영향 시뮬레이션" icon="flask-vial">
    드라이런(단일 입력) 또는 변경 영향 시뮬레이션(과거 데이터)으로 룰을 검증한 뒤 배포합니다.
  </Card>

  <Card title="JSON & 테이블 출력" icon="table-columns">
    기계 판독 가능한 JSON (기본) 또는 사람이 읽기 쉬운 테이블 형식.
  </Card>
</CardGroup>

## 아키텍처

CLI는 API Key 인증을 통해 LexQ API를 호출합니다.

```
LexQ CLI ──► api.lexq.io (API Key 인증)
                 │
                 ▼
          LexQ Policy Engine
```

## 두 가지 모드

### 1. CLI 모드

```bash theme={null}
lexq groups list --format table
lexq analytics dry-run --version-id <vid> --debug --mock \
  --json '{"facts": {"payment_amount": 100000}}'
```

### 2. MCP 서버 모드

AI 에이전트를 LexQ에 연결합니다. 두 가지 방법이 있습니다:

**클라우드 (Claude.ai)** — 설치 불필요. Claude.ai 설정에서 `https://mcp.lexq.io`를 Custom Integration으로 추가합니다. OAuth가 인증을 자동으로 처리합니다.

**로컬 (stdio)** — Claude Desktop, VS Code, Cursor 등 데스크톱 도구용:

```bash theme={null}
lexq serve --mcp
```

두 방법 모두 동일한 **전체 도구 모음**을 제공합니다. → [MCP 서버 설정 가이드](/ko/cli/mcp-server)

## AI 에이전트 개발자용

npm 패키지에 에이전트가 읽을 수 있는 문서가 포함되어 있습니다:

```
node_modules/@lexq/cli/
├── skills/              # 6개 스킬 파일
├── AGENTS.md            # 범용 에이전트 온보딩 가이드
├── CONTEXT.md           # 플랫폼 아키텍처 & 용어집
└── schemas/             # JSON 스키마
```

## 다음 단계

<CardGroup cols={2}>
  <Card title="설치" icon="download" href="/ko/cli/installation">
    CLI를 설치하고 인증을 설정합니다.
  </Card>

  <Card title="명령어 레퍼런스" icon="terminal" href="/ko/cli/commands">
    전체 명령어 목록.
  </Card>

  <Card title="MCP 서버" icon="plug" href="/ko/cli/mcp-server">
    Claude.ai, VS Code 등 AI 도구를 연결합니다.
  </Card>
</CardGroup>