x402 全工程デプロイチュートリアル：AI Agent が USDC を使ってあなたのデータに支払いを行う方法

〇、この一式は何なのか

2層のプロトコルであり、どちらも必須です：MCP AI Agent がツールを発見し、インターフェース経由で呼び出せるようにする（発見層）；x402 Agent がデータを取得する前に支払いを行う仕組み（決済層、Base メインネット USDC）。購入者のウォレットには USDC のみ必要です。ETH は不要です――gas は facilitator が代行支払い（EIP-3009 による gas フリーアウソライゼーション）。アカウント登録、API Key、Coinbase アカウントは一切不要で、受取が可能です。

① 準備

• Pythonを実行可能なサーバー1台（当サイトはTencent Cloudの2コア4GB、Ubuntu 24.04上で稼働）
• 一つ Baseメインネット USDC 受取アドレス（ご自身が秘密鍵を管理するもの）
• ドメイン名1つ＋HTTPS（Agentの検出およびx402の両方でHTTPSが必須）
• オプション：検証用に少量のBaseメインネットUSDCを充填したテスト購入者ウォレット

依存関係のインストール

python3 -m venv venv && source venv/bin/activate
pip install "mcp<2" "x402==2.25.0" web3 httpx

② サーバーサイド server.py の作成（コア骨格）

import os
from mcp.server.fastmcp import FastMCP
from x402 import x402ResourceServer
from x402.http import FacilitatorConfig, HTTPFacilitatorClient
from x402.mechanisms.evm.exact import ExactEvmServerScheme
from x402.mcp import create_payment_wrapper
from x402.schemas.config import ResourceConfig

# 1. 链および facilitator：Baseメインネット + PayAI（免登録，支持 x402 v2 主网）
NETWORK = os.environ.get("X402_NETWORK", "eip155:8453")
FACILITATOR_URL = os.environ.get("X402_FACILITATOR",
                                 "https://facilitator.payai.network")

# 2. 收款地址：换成你自己の Baseメインネット地址！别抄示例。
PAY_TO = os.environ.get("PAY_TO") or "0x你の收款地址"

# 3. 定价（按回，USD）
PRICE = {"my_data_tool": "$0.05"}

facilitator = HTTPFacilitatorClient(FacilitatorConfig(url=FACILITATOR_URL))
resource_server = x402ResourceServer(facilitator)
resource_server.register(NETWORK, ExactEvmServerScheme())
resource_server.initialize()
mcp = FastMCP("my-data-service")

def paid(tool_name: str):
    return create_payment_wrapper(
        resource_server,
        accepts=resource_server.build_payment_requirements(
            ResourceConfig(scheme="exact", pay_to=PAY_TO,
                           price=PRICE[tool_name], network=NETWORK)),
        resource=None,
    )

@mcp.tool(name="list_items")          # 無料ツール：让 Agent 先看见你有货
def list_items() -> str:
    return '[{"name": "item-a"}]'

@mcp.tool(name="my_data_tool")        # 付费ツール
@paid("my_data_tool")
def my_data_tool(item: str) -> str:
    return '{"item": "%s", "price": 1.24}' % item

if __name__ == "__main__":
    mcp.run(transport="streamable-http", host="127.0.0.1", port=8797)

③ systemd による常駐化

# /etc/systemd/system/x402.service
[Unit]
Description=My x402 paid MCP server
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/my-x402
Environment=X402_NETWORK=eip155:8453
Environment=X402_FACILITATOR=https://facilitator.payai.network
Environment=PORT=8797
ExecStart=/opt/my-x402/venv/bin/python server.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
# systemctl daemon-reload && systemctl enable --now x402

④ nginx による /mcp のリバースプロキシ

location ^~ /mcp {
    proxy_pass http://127.0.0.1:8797;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_buffering off;   # streamable-http 走 SSE，必须关缓冲
    proxy_cache off;
    proxy_read_timeout 300s;
}

⑤ ゼロコスト検証（実際の資金を使わず説得力を得る）

# 零コスト验证（不花真钱）：不付款直接调付费ツール，应返回 402 支付挑战
curl -s https://你の域名/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"1"}}}'
# 然后において带 session id の状況下调 tools/call（不带 X-PAYMENT），
# 响应の accepts 里应看到：network=eip155:8453、asset=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913、
# payTo=你の地址、amount=50000（=$0.05）

⑥ 実資金検証（USDC 入金＋ブロックチェーン上での照合）

# 真钱验证：给测试买家钱包充 USDC，跑客户端，然后查链上 USDC Transfer 事件
# （不要看余额差值，RPC 同步延迟会读出假差额；只信 Transfer 事件）
from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://base-rpc.publicnode.com"))  # mainnet.base.org 会 429
USDC = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
topic = w3.keccak(text="Transfer(address,address,uint256)").hex()
logs = w3.eth.get_logs({
    "fromBlock": w3.eth.block_number - 3000,
    "toBlock": "latest",
    "address": USDC,
    "topics": [topic,
               "0x" + "0"*24 + buyer[2:].lower(),
               "0x" + "0"*24 + seller[2:].lower()],
})
for lg in logs:
    print(int(lg["data"].hex(), 16) / 1e6, "USDC 已到账")

⑦ 他者があなたを発見できるようにする（ディスカバリ層）

• /.well-known/mcp.json および /.well-known/x402.json：機械読み取り可能なツール一覧および料金表をサイトのルートディレクトリに配置
• MCP 公式 Registry：GitHub Releasesから配布されているmcp-publisherバイナリ（npm上の同名パッケージとは異なります、それは偽物です）、ドメイン検証はHTTPファイル方式（「/.well-known/mcp-registry-auth」に「v=MCPv1」という1行のレコードを書き込む）で行い、DNS設定は変更不要です
• llms.txt：MCPエンドポイントおよび課金方法を宣言します。AIクローラーがこれを収集します。

私たちが実際に経験した7つの落とし穴（他サイトでは紹介されていない内容）

本稿で実証済みの実際の事例（ブロックチェーン上で照合可能）

よくある質問