x402 Conformance について
x402 Conformanceは、決済対応サーバーをテストする開発者やエージェント向けのx402決済チェックを提供します。CLIやCI連携と同じチェックとレポートを使い、支払いや署名、メインネットへのアクセスは行いません。
主な機能
- 01未払い時の402応答を検証
- 02サーバーの決済安全性を検査
- 03組み込みデモでチェックを実行
- 04チェック項目と失敗理由を説明
- 05匿名の失敗事例を準備
活用シーン
- 01有料エンドポイントの402応答を確認
- 02決済完了前に内容が配信されないか検証
- 03デモサーバーでチェックを再現
MCP 対応
MCPサーバーはx402適合性チェックと関連機能をツールとして公開します。ファシリテーターのダブルとリソースサーバーの検査ツールはMCP専用です。支払いや署名は行いません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
7掲載時のツール一覧 · 4 日前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| url | string | はい | 有料 URL(http または https) |
詳細
x402-conformance-mcp
MCP クライアント(Claude、Cursor、VS Code、Windsurf など)、Vercel AI SDK、LangChain 向けの、x402 の適合性チェックと安全性チェックをツールとして提供します。オープンソースの x402-conformance スイートへの軽量なエントリーポイントです。CLI、GitHub Action、テストマッチャーと同じチェック、チェック ID、レポートを使用します。支払い、署名、メインネットへのアクセスは一切行いません。
MCP
{ "mcpServers": { "x402-conformance": { "command": "npx", "args": ["-y", "x402-conformance-mcp"] } } }
| ツール | 機能 |
|---|---|
x402_check_payment_required | 有料 URL に対して未払いの GET リクエストを 1 回送信し、その 402 応答をチェックします(P1-P7) |
x402_demo | 組み込みのデモサーバーに対してスイート全体を実行します。ウォレットもセットアップも不要です。fault: serve_on_any_settle で失敗を確認できます |
x402_start_facilitator_double | ループバック上でファシリテーターのダブルを起動します。サーバーをその URL に向けてください |
x402_probe_resource_server | ループバック上のサーバーに対して R0-R10 を実行します。タイムアウト、壊れた応答、settlement_pending、失敗、重複が発生した場合、コンテンツは返しません |
x402_stop_facilitator_double | ダブルを停止します |
x402_explain_check | チェックの内容と失敗時の修正方法を説明します |
x402_share_case | 匿名化されたコーパス事例と、事前入力済みの課題リンクを用意します。何も送信されないため、ユーザーが判断できます |
次のように尋ねてみてください:「x402 のデモを実行して」「http://127.0.0.1:4020/paid の 402 応答をチェックして」、または「ファシリテーターのダブルを起動して。サーバーを接続するので、その後 http://127.0.0.1:4020/paid をプローブして」。
Vercel AI SDK
import { generateText } from "ai";
import { x402ConformanceTools } from "x402-conformance-mcp/ai-sdk";
await generateText({ model, tools: x402ConformanceTools(), prompt: "Is the 402 answer at https://api.example.com/paid valid x402?" });
LangChain と LangGraph
import { createReactAgent } from "@langchain/langgraph/prebuilt";
import { x402ConformanceTools } from "x402-conformance-mcp/langchain";
const agent = createReactAgent({ llm, tools: x402ConformanceTools() });
AI SDK と LangChain のアダプターは、エージェントに 4 つの読み取り専用ツール(チェック、デモ、説明、共有)を提供します。ダブルとプローブのツールは、ユーザーが操作する MCP に残ります。
コーパス
失敗レポートは、公開されている
x402 の実際の障害事例コーパスの匿名化された事例にできます。
x402_share_case が事例を準備してリンクを返します。ユーザーは内容を確認して送信するか、送信しないかを選べます。各レポートには、生成元のエントリーポイント(via: mcp、ai-sdk、langchain)がレポートと User-Agent に記載されます。それ以外の識別情報はなく、テレメトリーもありません。
Apache-2.0。Ryan Gillespie、Optitransfer。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。