Skip to main content
Glama

LexQ CLI

엔지니어링 팀을 위한 의사결정 플랫폼. LexQ를 위한 CLI 및 MCP 서버 — 배포 파이프라인에서 비즈니스 규칙을 분리하고, 시뮬레이션을 통해 모든 변경 사항을 검증하며, git push 없이 배포하세요.

웹사이트 · 문서 · 콘솔

npm 라이선스


왜 LexQ인가?

가격 책정, 프로모션, 수수료 로직, 자격 확인 등 비즈니스 규칙은 자주 변경됩니다. 하지만 모든 변경 사항은 핵심 애플리케이션 코드와 동일한 PR → 리뷰 → 스테이징 → 배포 주기를 거칩니다. 한 줄짜리 할인 규칙을 적용하는 데 2주가 걸리기도 합니다.

이것은 프로세스 문제가 아니라 아키텍처 문제입니다. 매주 변경되는 비즈니스 로직이 분기별로 배포되는 코드 안에 있어서는 안 됩니다.

LexQ는 이 둘을 분리합니다. 규칙은 애플리케이션 외부에 존재합니다. 시각적 콘솔이나 이 CLI를 통해 규칙을 변경할 수 있습니다. 실제 실행 데이터를 기반으로 한 배치 시뮬레이션을 통해 모든 변경 사항을 검증합니다. 코드베이스를 건드리지 않고도 배포할 수 있습니다.

모든 의사결정은 전체 감사 추적을 남깁니다.

설치

npm install -g @lexq/cli

또는 설치 없이 실행:

npx @lexq/cli

Node.js 18+ 버전이 필요합니다.

빠른 시작

# 1. Authenticate
lexq auth login
# Enter your API key (create one at console.lexq.io → Management → API Keys)

# 2. Verify
lexq auth whoami

# 3. Create a policy group
lexq groups create --json '{"name":"my-policy","priority":0}'

# 4. Create a draft version
lexq versions create --group-id <GROUP_ID> --json '{"commitMessage":"v1"}'

# 5. Add a rule
lexq rules create --group-id <GROUP_ID> --version-id <VERSION_ID> --json '{
  "name": "VIP Discount",
  "priority": 0,
  "condition": {
    "type": "SINGLE",
    "field": "customer_tier",
    "operator": "EQUALS",
    "value": "VIP",
    "valueType": "STRING"
  },
  "actions": [{
    "type": "DISCOUNT",
    "parameters": {"method":"PERCENTAGE","rate":10,"refVar":"payment_amount"}
  }]
}'

# 6. Test against your data before shipping
lexq analytics dry-run --version-id <VERSION_ID> --debug --mock \
  --json '{"facts":{"customer_tier":"VIP","payment_amount":100000}}'

# 7. Deploy
lexq deploy publish --group-id <GROUP_ID> --version-id <VERSION_ID> --memo "v1"
lexq deploy live --group-id <GROUP_ID> --version-id <VERSION_ID> --memo "Initial deploy"

AI 에이전트를 위한 63개의 MCP 도구

LexQ는 AI 네이티브로 설계되었습니다. 63개의 모든 도구를 포함한 전체 정책 엔진 API는 Model Context Protocol을 통해 노출됩니다. Claude, Cursor 및 기타 MCP 호환 에이전트는 프로덕션 적용 전 사람의 승인을 거쳐 자율적으로 규칙을 생성, 시뮬레이션 및 배포할 수 있습니다.

Claude.ai (클라우드 — 설치 불필요)

  1. 설정(Settings) → 커넥터(Connectors) → 사용자 지정 통합 추가(Add Custom Integration)

  2. 입력: https://mcp.lexq.io

  3. LexQ 계정으로 로그인하고 API 키를 선택합니다.

  4. 완료 — 모든 대화에서 63개의 도구를 사용할 수 있습니다.

원격 (스트리밍 가능한 HTTP)

원격 서버를 지원하는 모든 MCP 클라이언트의 경우:

{
  "mcpServers": {
    "lexq": {
      "url": "https://mcp.lexq.io"
    }
  }
}

OAuth 2.1 인증은 클라이언트에서 자동으로 처리됩니다.

로컬 (stdio)

LexQ CLI를 로컬 MCP 서버로 실행:

lexq serve --mcp

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "lexq": {
      "command": "npx",
      "args": [
        "-y",
        "@lexq/cli",
        "serve",
        "--mcp"
      ]
    }
  }
}

VS Code / Cursor

.vscode/mcp.json:

{
  "servers": {
    "lexq": {
      "command": "npx",
      "args": [
        "-y",
        "@lexq/cli",
        "serve",
        "--mcp"
      ]
    }
  }
}

전제 조건: ~/.lexq/config.json에 API 키를 저장하려면 lexq auth login을 한 번 실행해야 합니다.

AI 에이전트 스킬

LexQ CLI는 AI 에이전트 스킬과 함께 제공됩니다. 이는 에이전트가 도구의 '무엇'인지뿐만 아니라 '어떻게' 사용하는지 이해할 수 있도록 구조화된 문서입니다.

skills/
├── lexq-shared/SKILL.md       Core concepts, auth, workflow
├── lexq-groups/SKILL.md       Policy groups, conflict resolution, A/B testing
├── lexq-rules/SKILL.md        Condition syntax, action types, mutex
├── lexq-simulation/SKILL.md   Dry run, batch simulation, compare
├── lexq-execution/SKILL.md    Execution history, stats, failure logs
└── lexq-recipes/SKILL.md      End-to-end recipes

.claude/CLAUDE.md              Claude Code project context
AGENTS.md                      Universal agent guide (Cursor, Windsurf, Gemini CLI, Cline)
CONTEXT.md                     Platform architecture & glossary

@lexq/cli를 설치한 후, 에이전트는 다음 위치에서 스킬을 읽을 수 있습니다:

node_modules/@lexq/cli/skills/
node_modules/@lexq/cli/AGENTS.md
node_modules/@lexq/cli/CONTEXT.md

명령어

lexq auth                  login | logout | whoami
lexq status                API health check
lexq serve                 Run as MCP stdio server (--mcp)
lexq groups                list | get | create | update | delete
lexq groups ab-test        start | stop | adjust
lexq versions              list | get | create | update | delete | clone
lexq rules                 list | get | create | update | delete | reorder | toggle
lexq facts                 list | create | update | delete | action-metadata
lexq deploy                publish | live | rollback | undeploy | history | detail | overview | deployable | diff
lexq analytics             dry-run | dry-run-compare | requirements
lexq analytics simulation  start | status | list | cancel | export
lexq analytics dataset     upload | template
lexq history               list | get | stats
lexq integrations          list | get | save | delete | config-spec
lexq logs                  list | get | action | bulk-action
lexq webhook-subscriptions list | get | save | delete | test

전역 옵션

플래그

설명

--format <json|table>

출력 형식 (기본값: json)

--api-key <key>

저장된 API 키 재정의

--base-url <url>

API 기본 URL 재정의

--dry-run

실행하지 않고 HTTP 요청 미리보기

--verbose

요청/응답 세부 정보 표시

--no-color

색상 출력 비활성화

구성

설정은 ~/.lexq/config.json에 저장됩니다:

{
  "apiKey": "YOUR_API_KEY",
  "baseUrl": "https://api.lexq.io/api/v1/partners",
  "format": "json"
}

개발

git clone https://github.com/lexq-io/lexq-cli.git
cd lexq-cli
pnpm install
pnpm build
pnpm start -- groups list
pnpm typecheck                  # Type check
pnpm lint                       # ESLint
bash tests/e2e.sh               # CLI E2E tests (requires API key)
bash tests/test-engine-api.sh   # Engine API integration tests

라이선스

Apache-2.0

A
license - permissive license
-
quality - not tested
C
maintenance

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lexq-io/lexq-cli'

If you have feedback or need assistance with the MCP directory API, please join our Discord server