메인 콘텐츠로 건너뛰기

MCP란?

**Model Context Protocol (MCP)**은 AI 어시스턴트를 외부 도구에 연결하는 개방형 표준입니다. LexQ CLI는 전체 API를 53개 도구로 노출하는 내장 MCP 서버를 포함합니다.

빠른 시작

  1. Node.js 18+ 설치
  2. lexq auth login으로 API 키 저장
  3. 서버 시작: lexq serve --mcp

설정 가이드

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "lexq": {
      "command": "npx",
      "args": ["-y", "@lexq/cli", "serve", "--mcp"]
    }
  }
}

Claude.ai (웹)

설정 → MCP 서버 → 추가 → Command: npx, Args: -y @lexq/cli serve --mcp

VS Code / Cursor

.vscode/mcp.json (또는 .cursor/mcp.json):
{
  "servers": {
    "lexq": {
      "command": "npx",
      "args": ["-y", "@lexq/cli", "serve", "--mcp"]
    }
  }
}

사용 가능한 도구 — 53개

도메인도구 수설명
Status1인증 확인
Groups8CRUD + A/B 테스트
Versions6CRUD + 복제
Rules7CRUD + 순서 변경 + 토글
Facts4CRUD
Deploy7발행, 배포, 롤백 등
Analytics8드라이런, 비교, 시뮬레이션
History3목록, 조회, 통계
Integrations5목록, 조회, 저장, 삭제, 스펙
Logs4목록, 조회, 액션, 일괄

에이전트 모범 사례

  1. 스킬 먼저 읽기. skills/lexq-shared/SKILL.md
  2. 표준 워크플로우 준수.
  3. 발행 전 항상 드라이런.
  4. 응답 envelope: result === "SUCCESS" 확인 — success === true아닙니다.

문제 해결

증상해결
API key not foundlexq auth login 실행
npx 명령어 없음Node.js 18+ 설치 확인
도구가 보이지 않음AI 클라이언트 재시작

다음 단계

명령어 레퍼런스

전체 CLI 명령어 목록.

정책 규칙

조건 구문과 액션 타입.