GUIDE ／実務ガイド

AI ツールから EXIPRA を使う

このガイドについて

EXIPRA の全機能は API として提供され、チャット AI や開発エージェントから MCP（Model Context Protocol）で操作できます。接続方法は2系統です——チャット AI（Claude・ChatGPT）は OAuth でログインするだけ、開発環境（Claude Code・Codex CLI などの MCP クライアント）は接続キーを設定します。どの経路でも、検索・プレビューは認証なしで使えます。

1. Claude（claude.ai）から使う

Claude の設定 → コネクタ → 「カスタムコネクタを追加」を開きます。
URL に https://exipra.com/api/mcp/mcp を入力して追加します（Client ID / Secret は空欄のまま）。
EXIPRA のログイン画面が開くので、ログインして接続を承認します。
チャットで「EXIPRA で ◯◯ を探して」のように話しかければ、検索から購入・自分の出品管理まで使えます。

2. ChatGPT から使う

ChatGPT の開発者モード（Plus 以上のプランで利用可）でコネクタを追加します。

設定 → コネクタ → 詳細 → 開発者モードを有効化。
「作成」から、URL に https://exipra.com/api/mcp/mcp を入力（OAuth の ID / Secret は空欄=自動登録）。
EXIPRA のログイン・承認画面を通れば完了です。

EXIPRA 側でツールが追加・更新されても、接続済みのコネクタには自動反映されないことがあります（接続時のツール一覧が残るため）。一覧に新しいツールが見えないときは、コネクタを更新するか、いったん削除して再追加してください。Claude のコネクタも同様です。

3. 開発環境（MCP クライアント）から使う

Claude Code・Codex CLI など、stdio の MCP クライアントで使う場合は接続キーを使います。

マイページの「接続キー」（/me/keys）でキーを発行します。キーは発行時に一度だけ表示され、あなた本人として操作できる権限そのものです。漏らさず、不要になったら失効させてください。
クライアントに EXIPRA サーバーを登録します。

Claude Code（プロジェクトの .mcp.json）:

{
  "mcpServers": {
    "exipra": {
      "command": "npx",
      "args": ["-y", "@exipra/mcp"],
      "env": {"EXIPRA_CONNECTION_KEY": "exipra_ck_..."}
    }
  }
}

Codex CLI（~/.codex/config.toml）:

[mcp_servers.exipra]
command = "npx"
args = ["-y", "@exipra/mcp"]
env = { EXIPRA_CONNECTION_KEY = "exipra_ck_..." }
# 非対話実行（codex exec）で使う場合のみ:
# default_tools_approval_mode = "approve"

Codex の VS Code 拡張・Codex アプリのセッションでは、EXIPRA へは ChatGPT コネクタ（§2 と同じホスト版）経由で到達します（ローカルの stdio ツールはモデルに表示されません——2026-07-19 実測）。この経路でも判定つき出品はできます: ホスト版の exipra_publish が短命の出品ブリッジキーと publish-run コマンド（§5）を返し、エージェントがそれをあなたのマシン上で実行します。隔離判定が売り手のマシン上でのみ実行される点は、どの経路でも同じです。

4. できること（ツール一覧）

ツール	認証	内容
exipra_search	不要	キーワード・カテゴリ・タグで設計を検索
exipra_preview	不要	公開プレビュー・非公開見出しの一覧・「購入で得られるもの」・価格・支払い手段
exipra_purchase	キー	購入希望。stripe / paypal は決済 URL、手動レールは支払い案内が返る
exipra_load	キー	購入一覧の確認・グラント済み文書の取り込み
exipra_status	キー	自分の出品と着信取引
exipra_update	キー	出品情報・「購入で得られるもの」の更新
exipra_withdraw	キー	出品の取り下げ（既存買い手のアクセスは維持）
exipra_publish	キー	再現実装可能性チェックつきの段階出品（下記）

5. 判定つき出品（exipra_publish）

文書を機械にどこまで見せても実装資産が再現されないかを、あなたのマシン上の隔離判定で確かめてから出品するフローです。

前提: 判定は手元の claude CLI をヘッドレス起動して行います（あなたの Claude サブスクリプションの利用枠を消費。従量課金ではありません）。
流れ: analyze（構成とマニフェスト候補・実行見積り）→ judge（隔離判定。実行数の目安は宣言資産数×3＋1）→ preview（公開される本文の確認）→ commit（出品作成・判定記録・公開）。エージェントが各段であなたの確認を取りながら進めます。
stdio ツールが表示されないホスト（Codex VS Code 拡張・Codex アプリ等）では、exipra_publish が出品ブリッジキー（publish 操作限定・2時間有効）と、同じ4段フローを実行する publish-run コマンドを返します。エージェントがそれを手元で実行すれば、確認の取り方もバッジの条件も同一です。ブリッジキーは /me/keys で確認・失効できます。
公開した開示が判定ラインと一致している間、出品ページに隔離判定済みバッジが表示されます。判定は判定時点のモデルによるスナップショットです。

6. 買い方（エージェント経由）

検索・プレビューで内容と価格を確認します（公開部と「何が守られているか」の一覧が見えます）。
purchase を実行します。stripe / paypal のレールなら決済 URL が返り、ブラウザで支払います。手動レール（銀行振込等）なら売り手の支払い案内が返るので、案内に従って支払い、取引ページで支払いを宣言します。
売り手が開示（グラント）すると、load で文書全文をエージェントのコンテキストに取り込めます。グラント前の load は拒否されます。

支払いは常に買い手から売り手への直接支払いです。EXIPRA は資金を預かりません。