x402 支払い

Minara で一回払い、事前承認、有料 MCP の x402 支払いを利用します。

x402 は HTTP 402 Payment Required を使うオープンな支払いプロトコルです。サービスはアカウントや API Key の代わりに価格とオンチェーン支払い条件を提示し、Minara は管理ウォレットで支払って元のリクエストを再試行できます。

基本概念

用語	意味
支払い要件	サーバーが指定する受取人、金額、資産、ネットワーク、方式、リソース。
Exact	固定額の標準方式。EVM と Solana の登録済み支払い資産に対応し、残高が十分な候補を優先します。同条件なら USDC が最優先です。
支払い署名	取得済みチャレンジ専用の証明で、再利用可能な API 認証情報ではありません。
決済応答	サービスまたは Facilitator が証明を受理した結果。
事前承認	Provider、ドメイン、加盟店に限定した反復支払い予算。

チャレンジはユーザー、元のリクエスト、加盟店、金額、資産、ネットワーク、有効期限に結び付けられ、モデルが変更することはできません。

一回だけ支払う

Minara のデータツール、有料 API、または MCP ツールを呼び出します。
payment_required が返ったら、Provider、リソース、資産と金額、ネットワーク、受取先を確認します。
支払いを承認します。
Minara は x402 証明を作成し、同一の元の呼び出しを一度だけ再試行します。
リソース結果と決済・取引状態を確認します。

標準方式と旧方式

x402 v2 exact は EVM の EIP-3009/EIP-712 または Solana のトークン転送トランザクションを使い、PAYMENT-REQUIRED、PAYMENT-SIGNATURE、PAYMENT-RESPONSE ヘッダーでデータを渡します。

旧式サービスが transaction-hash proof と、それを受け取る HTTP ヘッダーを明示する場合があります。Minara は retry_supported と表示されたチャレンジだけを続行し、金額、受取先、資産、ネットワークを照合してから取引ハッシュを結び付け、一度だけ再試行します。安全な証明ヘッダーが宣言されていない場合は送金せず、リソースを解除できるとは案内しません。一般的な HTTP 402 ではこの経路を使いません。

反復支払いの事前承認

Provider またはドメインの範囲、1 回の上限、USDC 総予算、有効期限、加盟店アドレス、任意のチェーン制限を設定します。/x402 preauth で一覧表示と取り消しができます。狭く短い予算を優先してください。

有料カスタム MCP

Connectors → Add connectors → Add MCP server から MCP サーバーを追加します。ウォレット鍵や支払い証明を MCP 設定に保存しないでください。MCP ツールは JSON-RPC で x402 チャレンジを返せ、直接リモート接続は HTTP 402 も利用できます。JSON-RPC はローカル stdio でも利用でき、HTTP 支払いヘッダーには直接リモート接続またはそのまま転送する Broker が必要です。

対応範囲とトラブルシューティング

x402 exact と信頼済み支払い資産レジストリに対応します。対象には対応 EVM/Solana ネットワークの正規 USDC と X Layer の USD₮0 が含まれます。加盟店の受付資産と現在の保有残高を照合し、署名前に残高を再確認し、同条件なら USDC を優先します。upto、Permit2、aggr_deferred、未登録トークンには対応しません。残高不足は指定ネットワークへ入金し、期限切れは新しいリクエストを作成します。結果が不明な場合は状態を確認し、重複して支払わないでください。

カスタム MCPとConnector のトラブルシューティングも参照してください。