mcpField
C
codex-gateway

codex-gateway

github.com/codex-dataデータ・データベース0367 回インストール2 週間前に更新
リポジトリ

codex-gateway について

codex-gatewayは、Supergraph APIが402を返した際にCodexのMachine Payment Protocolを使うエージェントスキルです。APIキーなしでGraphQLクエリごとに支払う手順を案内します。

主な機能

  1. 01402チャレンジ応答フロー
  2. 02APIキー不要のクエリ単位決済
  3. 03決済レシートの処理
  4. 04GraphQLクエリ専用モード

活用シーン

  1. 01402応答後にクエリを再試行
  2. 02APIキー認証なしでCodexデータにアクセス

MCP 対応

Codex GraphQL APIへの決済アクセスを扱うスキルであり、MCP機能についての記述はありません。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/codex-data/skills --skill codex-gateway

インストール後、Claude Code で/codex-gatewayを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
gotchas.md
mpp-flow.md
rules/
wallets.md

詳細

Codex Machine Payment Protocol (MPP)

Codex Supergraph が 402 Payment Required レスポンスを返した場合に、このスキルを使用します。MPP のチャレンジフローを使うと、API キーなしでクエリごとに支払いができます。より大量に利用する場合は、dashboard.codex.io/signup で API キーを取得してください（初回の有効化に $1 が必要です。エントリープランに継続費用はかかりません）。詳細は docs.codex.io をご覧ください。

HTTP エンドポイントhttps://graph.codex.io/graphql
認証情報ヘッダーAuthorization: Payment <base64url-credential>

仕組み

  1. GraphQL クエリを送信します（認証情報なし）。
  2. サーバーは WWW-Authenticate: Payment ... チャレンジを含む 402 Payment Required を返します。
  3. クライアントはチャレンジを 1 つ解決し、Authorization: Payment <credential> を付けて再試行します。
  4. サーバーは GraphQL データと Payment-Receipt ヘッダーを返します。

制約

  • クエリのみです。 MPP モードでは、ミューテーションとサブスクリプションは 403 を返します。
  • 有効な API キーまたはベアラートークンも指定されている場合は、API 認証が優先されます。

ルール

  • 認証情報をそのまま出力しないでください。
  • MPP は query 操作にのみ使用してください。
  • **クエリを作成する前に、**正しい GraphQL スキーマについて、以下の references/query-templates.md を読んでください。クエリ名やフィールド名を推測しないでください。

参照

ファイル目的
../codex-supergraph/references/query-templates.mdGraphQL クエリのスキーマと例 — クエリを作成する前に読んでください
../codex-supergraph/references/gotchas.mdクエリでよくある失敗要因
references/gotchas.mdMPP 固有の失敗要因
rules/wallets.mdウォレットの設定：tempo wallet/request（Tempo）
references/mpp-flow.md認証マトリクス、チャレンジの詳細、エラーコード

リンク

コメント

Markdown 対応