LexQ — the Decision Operations Platform for engineering teams

LexQ CLI

エンジニアリングチームのための意思決定オペレーションプラットフォームです。 LexQ の CLI および MCP サーバーです。ビジネスルールをデプロイパイプラインから切り離し、Impact Simulation ですべての変更を検証して、git push なしでリリースできます。

ウェブサイト · ドキュメント · コンソール · MCP レジストリ

---

LexQ を使う理由

価格設定、プロモーション、手数料ロジック、適格性チェックなどのビジネスルールは、頻繁に変更されます。しかし、変更のたびにアプリケーションの中核コードと同じ PR → レビュー → ステージング → デプロイのサイクルを経るため、小さな変更であっても次のリリースまで待つことになります。

LexQ を使えば、こうしたルールをコードから切り離せます。 サービスは LexQ API を呼び出してルールを評価します。ビジュアルコンソールまたはこの CLI でルールを変更し、過去の実行履歴やアップロードしたデータセットを使って Impact Simulation で各変更をテストした後、アプリケーションをリリースせずにデプロイできます。

すべての意思決定は、完全な監査証跡として記録されます。

インストール

npm install -g @lexq/cli

インストールせずに実行することもできます。

npx @lexq/cli

Node.js 22 以降が必要です。

クイックスタート

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

# 2. Verify
lexq auth whoami

# 3. Start from a domain template — provisions facts, sample rules, and a policy group
lexq domain-templates list
lexq domain-templates apply --template ECOMMERCE
# Returns: policyGroupId, policyVersionId, factsCreated, rulesCreated

# 4. Test a rule against your data before shipping
lexq analytics dry-run --version-id <VERSION_ID> --debug \
  --json '{"facts":{"loyaltyTier":"PLATINUM","purchaseSubtotalUsd":150}}'

# 5. 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 エージェント向け

Claude、Cursor、その他の MCP 対応エージェントは、Model Context Protocol を使ってポリシーグループ、バージョン、ルール、ファクトを管理し、シミュレーションやリプレイを実行し、バージョンをデプロイして、実行履歴を読み取ることができます。

承認は MCP クライアントで行われ、どのツール呼び出しを確認するかはクライアントが判断します。デプロイ、ロールバック、デプロイ解除の各ツールには破壊的操作のマークが付いているため、クライアントは実行前に確認を求めることができます。

Claude.ai（クラウド、インストール不要）

1. カスタマイズ → コネクタ → + 追加 → カスタムコネクタを追加
2. 名前を入力し、https://mcp.lexq.io を指定して、今すぐサインインを選択します
3. 開いた LexQ ページでサインインし、MCP 用の新しい API キーを生成するか、すでに API キーを持っていますを選択して既存のキーを貼り付けます
4. これで、すべての会話でツールを利用できます

リモート（Streamable 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 auth login を一度実行して ~/.lexq/config.json に API キーを保存するか、クライアントの環境ブロックに LEXQ_API_KEY を設定しておく必要があります。

レジストリ

このサーバーは公式 MCP Registry に io.lexq/lexq として登録されています。レジストリを参照できるクライアントは、npm パッケージとホストされたエンドポイントの両方を同じエントリで見つけられます。

プロトコルのサポート

ローカルの stdio サーバーとホストされた Streamable HTTP エンドポイントは、同じツール定義から 2 つの MCP リビジョンを提供するため、どちらの方法でもクライアントが利用できるツールは同じです。

リビジョン	クライアントからの接続方法
2026-07-28	リクエストごとの _meta エンベロープ。ハンドシェイクは不要です。
2025-11-25	initialize ハンドシェイク。

設定は不要です。サーバーは最初のメッセージで使用されたリビジョンに応答するため、クライアントはそれぞれのタイミングで 2026-07-28 に移行でき、まだ移行していないクライアントも引き続き動作します。

AI エージェントスキル

LexQ CLI には、各ツールの使い方をエージェントに伝える構造化ドキュメント、AI Agent Skills が付属しています。

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, Impact Simulation, compare
├── lexq-execution/SKILL.md    History, stats, failure logs, provenance, replay, latency profile
└── 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 | reorder
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 | unregistered
lexq domain-templates      list | preview | apply
lexq deploy                publish | live | rollback | undeploy | history | detail | overview | deployable | diff | schedule | unschedule | schedules
lexq analytics             dry-run | dry-run-compare | requirements
lexq analytics simulation  start | status | list | cancel | export
lexq analytics dataset     upload | template
lexq profile               <groupId> — per-rule latency profile
lexq history               list | get | stats
lexq replay                decision | start | list | get | cancel
lexq logs                  list | get | action | bulk-action
lexq provenance            get | reveal-audits
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"
}

このファイルには API キーがプレーンテキストで保存されています。0700 ディレクトリ内にモード 0600 で保存されるため、所有者のみが読み取れます。以前のバージョンでより緩い権限で作成されている場合、CLI は次回ファイルを保存するときに権限をより厳しく設定します。

環境変数

これらは MCP サーバー（lexq serve --mcp）によって読み込まれ、保存済みの設定より優先されます。これにより、エディターや CI は ~/.lexq/config.json に書き込まずに、クライアント独自の設定ブロックを通じて環境を指定できます。CLI コマンドでは、代わりに --api-key と --base-url を使用します。

変数	上書き対象
LEXQ_API_KEY	apiKey
PARTNER_BASE_URL	baseUrl

開発

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
pnpm build                      # Bundle to dist/

記述された事実が、それを管理するものと一致しているかを確認するチェックです。いずれも CI で実行されます。

pnpm enums:check                # Generated enums match the engine contract
pnpm prose:check                # Numbers and code tables in prose match the contract
pnpm ab-key:check               # Tool descriptions still name the A/B traffic key
pnpm surface:check              # Nothing internal reached a public file
pnpm registry:check             # server.json agrees with package.json and src/mcp/server-info.json
pnpm schemas:check              # tools/list matches the recorded snapshot (needs a build)
pnpm test:fact-key              # Fact key grammar
pnpm test:decimals              # Metric precision display
pnpm test:export-format         # Export byte fidelity
pnpm protocol:check             # README matches the revisions the server serves

セキュリティ

脆弱性はGitHub の非公開報告フォームから報告してください。対象範囲を含むポリシーについては、SECURITY.mdをご覧ください。

ライセンス

Apache-2.0