Claix

Claix MCP サーバー

Claix 用のホステッド MCP サーバーです。SQL データベースと AI エージェントの間に位置するセキュリティレイヤーです。

Cursor、Claude、Windsurf、n8n、Make、その他の MCP クライアントを、Streamable HTTP（およびレガシー SSE）経由で Claix に接続できます。このサーバーの主要製品は、Claix Retrieve（制御された読み取り）と Claix Guard（提案された書き込みに対する許可／拒否）です。Claix Ingest（ドキュメント → JSON／Markdown）は副次的な機能です。

• レジストリ： dev.claix/claix
• エンドポイント： https://www.claix.dev/mcp
• トランスポート： Streamable HTTP およびレガシー SSE
• MCP バージョン： 1.14.0
• ツール： 33
• ドキュメント： https://www.claix.dev/documentation/mcp
• サーバーカード： https://www.claix.dev/.well-known/mcp/server-card.json
• Smithery： https://smithery.ai/server/info-f4xz/claix

Claix とは

Claix は、AI エージェントと SQL データベース（PostgreSQL、MySQL、MariaDB、Supabase などの Postgres 互換ホスト）の間に位置します。

製品	役割	MCP
Retrieve	制御された読み取り：ルートでテーブル／列をホワイトリストに登録し、エージェントはその許可リスト内だけで回答します	claix.routes.*、claix.agents.*、claix.retrieve.ask
Guard	アプリが INSERT ／ UPDATE ／ DELETE を実行する前に、Claix が理由とともに 許可 または 拒否 を回答します。Claix がステートメントを実行することはありません	claix.guard.check → POST /check-sql
Ingest（副次的）	ドキュメント → スキーマ検証済みの JSON または Markdown。複数ドキュメントの Q&A にも対応します	claix.schemas.*、claix.extract.*、claix.agent.*、claix.markdown.*、claix.multi_document.ask

従量課金制です。x-api-key で認証します。

できること

Claix Retrieve

ルートとエージェントを作成してから、質問します。エージェントはルートで指定されたテーブルと列のみを読み取り、生の行（bruto）または型付きの回答（razonada）を返します。すべての質問は追跡されます（log_id）。

claix.routes.create
        ↓
claix.agents.create
        ↓
claix.retrieve.ask
        ↓
Typed answers from the live database

Claix Guard

エージェントが書き込みを提案します。実行側はまず Guard を呼び出します。Claix が判断し、allowed が true の場合に限り、コードが SQL を実行します。拒否された場合も HTTP 200 が返されるため、必ず allowed を確認してください。

Agent proposes INSERT / UPDATE / DELETE
        ↓
claix.guard.check   (sql, params?, connection_id?)
        ↓
{ allowed, reason, decision_id, … }
        ↓
Your app executes only if allowed === true

Claix Ingest（副次的）

スキーマを一覧表示または作成してから、ファイルを JSON に抽出したり、Markdown に変換したり、最大 10 個のファイルに対して最大 5 件の型付き質問をしたりできます。スキーマで「Save Data」が有効な場合（window_context）、マッピングされた行を接続先のデータベースに挿入でき、応答に row_id を含めることもできます。

claix.schemas.list
        ↓
claix.extract.pdf
        ↓
Structured JSON, and row_id when Save Data is on

クイックスタート

1. API キーを取得する

claix.dev でアカウントを作成し、API キーを生成します。

x-api-key: YOUR_CLAIX_API_KEY

重要

API キーを公開リポジトリ、スクリーンショット、ブラウザーコード、コミット履歴に含めないでください。

2. Cursor から接続する

Cursor → Settings → MCP を開き、次を追加します。

{
  "mcpServers": {
    "claix": {
      "url": "https://www.claix.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_CLAIX_API_KEY"
      }
    }
  }
}

または、公式 MCP Registry から dev.claix/claix としてインストールします（リモート URL https://www.claix.dev/mcp、ヘッダー x-api-key）。

3. Retrieve エージェントに質問する

ルートとエージェントを作成した後（ダッシュボードまたは MCP ツールを使用）、claix.retrieve.ask を呼び出します。

{
  "agent_name": "restaurant-ops",
  "questions": [
    {
      "question": "How many tables are reserved this Saturday between 20:00 and 22:00?",
      "format": "int"
    }
  ]
}

エージェントの response_mode が razonada の場合、format は必須です。モードが bruto の場合は省略できます。形式：string、int、boolean、timestamp、timestamptz、date、json、array:string、array:int。1 回の呼び出しにつき最大 5 件の質問が可能です。

これは POST /retrieve/{agent_name} です。

4. Guard で書き込みをチェックする

アプリで変更を実行する前に：

{
  "sql": "INSERT INTO shop.orders (customer_id, total) VALUES ($1, $2)",
  "params": ["c-1042", 6200],
  "connection_id": "8f14e45f-ceea-4e6f-8b23-1e2d3c4b5a6f"
}

claix.guard.check を呼び出します。allowed、reason、decision_id を読み取ります。Claix は SQL を実行しません。

5. PDF を抽出する（任意の Ingest）

claix.schemas.list を呼び出してから、schema_id とファイルを指定して claix.extract.pdf を呼び出します：

{
  "schema_id": "YOUR_SCHEMA_ID",
  "file_base64": "JVBERi0xLjQK..."
}

Smithery でインストールする

npx -y @smithery/cli run info-f4xz/claix

{
  "mcpUrl": "https://www.claix.dev/mcp",
  "headers": {
    "x-api-key": "YOUR_CLAIX_API_KEY"
  }
}

Claude Desktop に接続する

Claude Desktop は mcp-remote 経由で接続できます：

{
  "mcpServers": {
    "claix": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.claix.dev/mcp",
        "--header",
        "x-api-key:YOUR_CLAIX_API_KEY"
      ]
    }
  }
}

その他の MCP クライアント

リモート MCP サーバーにカスタムヘッダーを送信できるクライアントであれば、次の設定を使用できます：

{
  "url": "https://www.claix.dev/mcp",
  "headers": {
    "x-api-key": "YOUR_CLAIX_API_KEY"
  }
}

これには、Cursor、Claude Desktop、Claude Code、Windsurf、Cline、Continue、Zed、n8n、Make、および Streamable HTTP または SSE に対応する LangChain や LangGraph のクライアントが含まれます。

クライアントからヘッダーを送信できない場合、ツールでは任意の api_key 引数も使用できます。ヘッダーの使用を推奨します。

認証

POST /mcp HTTP/1.1
Host: www.claix.dev
Content-Type: application/json
Accept: application/json, text/event-stream
x-api-key: YOUR_CLAIX_API_KEY

トランスポート

モード	一般的な用途	接続
Streamable HTTP	Cursor、Smithery、n8n、Make、現在の MCP クライアント	POST https://www.claix.dev/mcp
Legacy SSE	mcp-remote 経由の Claude Desktop、旧式のセッションクライアント	GET /mcp、その後 POST /mcp/message?sessionId=...

どちらのモードも同じベース URL を使用します。claix.dev は www.claix.dev にリダイレクトされます。

ツール

カテゴリ	ツール	用途
取得	claix.retrieve.ask	エージェントに質問します。POST /retrieve/{agent_name}
ルート	claix.routes.create、claix.routes.edit、claix.routes.delete	テーブル／列とルートルールをホワイトリストに登録します
エージェント	claix.agents.create、claix.agents.edit、claix.agents.pause	エージェントを作成／編集するか、paused ／ active を設定します
Guard	claix.guard.check	書き込み案を許可／拒否します。POST /check-sql。SQL は実行しません
スキーマ（Ingest）	claix.schemas.list、get、create、update、delete	Save Data（window_context）を含む抽出スキーマ
抽出（Ingest）	claix.extract.excel、pdf、doc、image、text、audio	ファイルまたはテキスト → スキーマ検証済み JSON
エージェントモード（Ingest）	claix.agent.excel、pdf、doc、image、text、audio	エージェントモードがオンになっているスキーマで同じ入力を処理します
Markdown（Ingest）	claix.markdown.excel、pdf、doc、image、text、audio	ファイル → Markdown。save=true を指定すると row_id を返すことがあります
複数ドキュメント	claix.multi_document.ask	最大 10 個のファイルと 5 個の型指定された質問。POST /multi-document
変換	claix.convert.json_to_excel	JSON → .xlsx

schema_id、route_id、agent_id、connection_id を推測で指定しないでください。最初に一覧表示するか、作成してください。

Retrieve、Guard チェック、抽出、エージェントモード、複数ドキュメントでは、トレース用フィールド（該当する場合は log_id ／ decision_id）が返されます。

ワークフロー

データベースに質問する（Retrieve）

claix.routes.create
→ claix.agents.create
→ claix.retrieve.ask

エージェントがすでにダッシュボードに存在する場合は、最初の 2 つを省略し、そのスラッグを指定して claix.retrieve.ask を呼び出すこともできます。

書き込みをチェックする（Guard）

claix.guard.check
→ read allowed / reason
→ your executor runs SQL only if allowed

PDF を抽出する（Ingest、補助）

claix.schemas.list
→ claix.extract.pdf

複数のファイルについて質問する

claix.multi_document.ask

プロンプト

prompts/list には、次の項目が含まれます：

• workflow.retrieve-ask
• workflow.guard-check
• workflow.discover-and-extract
• workflow.agent-document-analysis
• workflow.invoice-pdf
• workflow.markdown-save
• workflow.multi-document-ask

リソース

• MCP のドキュメント：claix://docs/mcp
• OpenAPI 仕様：claix://docs/openapi
• ツールカタログ：claix://docs/tools
• サーバーカード：https://www.claix.dev/.well-known/mcp/server-card.json
• 製品ガイド：https://github.com/claix-dev/claix-for-devs
• ドキュメント全文：https://www.claix.dev/documentation/mcp

セキュリティ

• API キーは、クライアントのシークレットストレージまたは環境変数に保存してください。
• ツールごとの api_key 引数より、x-api-key ヘッダーを優先してください。
• claix.schemas.delete、claix.routes.delete、エージェントの一時停止は、アカウントに変更を加えます。呼び出す前に確認してください。
• Retrieve は、接続した読み取り専用のデータベースロールを使用します。
• Guard がチェックするのは、提案された書き込みのみです。実行環境は書き込み用の認証情報を保持し、allowed を遵守する必要があります。

公式レジストリ

MCP Registry に dev.claix/claix として公開されています。

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=dev.claix/claix"

リンク

• ウェブサイト：https://www.claix.dev
• MCP ドキュメント：https://www.claix.dev/documentation/mcp
• Retrieve：https://www.claix.dev/documentation/call-an-agent
• Guard：https://www.claix.dev/documentation/check-sql
• サーバーカード：https://www.claix.dev/.well-known/mcp/server-card.json
• Smithery：https://smithery.ai/server/info-f4xz/claix
• このリポジトリ：https://github.com/claix-dev/claix-mcp