tech

MCP 和 x402：天生一对

有人使用 Claude 报税，通过 x402 支付了 $3.80 的 USDC，并将报税表通过实体邮件寄给了 IRS——全程无需触碰任何表格。

MCP 和 x402：天生一对
一键发币： x402兼容 | Aptos | X Layer | SUI | SOL | BNB | ETH | BASE | ARB | OP | Polygon | Avalanche

有人使用 Claude 报税，通过 x402 支付了 $3.80 的 USDC，并将报税表通过实体邮件寄给了 IRS——全程无需触碰任何表格。

随后的一句评价是："base + x402 + claude = 不可阻挡的技术栈。"

这不是一个演示。它已经在生产环境中运行。本文将介绍当你将 Claude Code、MCP 和 x402 结合在一起时会发生什么，以及为什么这代表了 API 商业化方式的结构性转变。

预览图片

1、为什么 MCP 和 x402 天生一对

MCP（Model Context Protocol，模型上下文协议）由 Anthropic 开发，是 AI 代理调用外部工具的标准。Claude Code 使用 MCP 服务器来访问数据库、API 和外部服务。

x402 是构建在 HTTP 之上的支付层。服务器返回带有价格的 HTTP 402 状态码，代理用 USDC 支付，然后重试。无需表单、无需 API 密钥、无需订阅。

将它们结合起来，流程如下：

Claude calls a tool via MCP
  ↓
MCP server sends HTTP request to paid API
  ↓
API returns 402 Payment Required ($0.01 USDC)
  ↓
MCP server pays automatically from wallet
  ↓
API returns 200 OK + data
  ↓
Claude continues the task

任何步骤都不需要人类批准。只要钱包有余额且支出在预算策略范围内，Claude 就会端到端地处理一切。

报税示例使用了 PostalForm——在发布时就与 MPP/x402 集成的服务之一。Claude 起草了报税表，通过 x402 支付了邮寄服务费用，PostalForm 通过 USPS 将其寄给了 IRS。人类的角色仅仅是：输入指令。

2、架构

Coinbase 的官方文档包含一个可运行的 MCP + x402 示例。结构非常简单。

Claude Desktop / Claude Code
      ↓ tool call
MCP Server (x402 client)
      ↓ HTTP request
Paid API (x402-enabled endpoint)
      ↓ 402 Payment Required
MCP Server pays automatically in USDC
      ↓ 200 OK + data
Result returned to Claude

客户端实现非常简洁：

import { wrapAxiosWithPayment } from "@x402/axios";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
const client = new x402Client();
registerExactEvmScheme(client, { signer: evmSigner });
// Every axios request now handles x402 automatically
const httpClient = wrapAxiosWithPayment(axios.create(), client);
// Write normal HTTP requests — 402 responses are handled transparently
const data = await httpClient.get("https://api.example.com/paid-endpoint");

服务端同样简洁：

// Hono example — x402-enabled endpoint
import { paymentMiddleware } from "x402-hono";
app.use(
  paymentMiddleware(
    process.env.WALLET_ADDRESS,
    {
      "/api/data": {
        price: "$0.01",
        network: "base-sepolia",
      },
    },
    { url: "https://x402.org/facilitator" }
  )
);
app.get("/api/data", (c) => {
  return c.json({ result: "paid content" });
});

3、Claude Code 设置提示词

将以下内容粘贴到 Claude Code 中，即可搭建一个支持 x402 的 MCP 服务器：

# Set up an x402-enabled MCP server
## Goal
Build an MCP server that can access paid APIs using the x402 protocol.
When Claude calls an MCP tool, payment should be handled automatically
via x402 — no human intervention at payment time.
## Stack
- TypeScript
- @x402/axios (client-side payment automation)
- @x402/evm (Base/EVM support)
- @modelcontextprotocol/sdk (MCP server)
## Steps
### 1. Install dependencies
npm install @x402/axios @x402/core @x402/evm @modelcontextprotocol/sdk axios viem
### 2. Environment variables (.env)
EVM_PRIVATE_KEY=0x...     # Private key of wallet holding USDC on Base
RESOURCE_SERVER_URL=https://api.example.com
ENDPOINT_PATH=/paid-endpoint
### 3. Implement the MCP server
Spec:
- Tool name: get_paid_data
- Description: Fetch data from an x402-priced API
- Payment is handled automatically by @x402/axios
- Use EVM wallet on Base mainnet with USDC
- On 402 response: auto-pay and retry
### 4. Register with Claude Desktop
Add to claude_desktop_config.json:
{
  "mcpServers": {
    "x402-demo": {
      "command": "node",
      "args": ["./dist/mcp-server.js"],
      "env": {
        "EVM_PRIVATE_KEY": "<your-private-key>",
        "RESOURCE_SERVER_URL": "<api-url>"
      }
    }
  }
}
### 5. Test
Ask Claude: "Use the get_paid_data tool to fetch data."
Check the X-Payment-Settled header to confirm the transaction amount.
## Reference
- Official example: https://github.com/coinbase/x402/tree/main/examples/typescript/clients/mcp
- Docs: https://docs.cdp.coinbase.com/x402/mcp-server

4、被消除的体验摩擦

传统的 API 访问流程：

  1. 注册账户
  2. 添加信用卡
  3. 生成 API 密钥
  4. 选择定价方案
  5. 管理月度账单

整个流程是为使用浏览器的人类设计的。自主代理无法填写表单、无法选择方案、无法管理仪表盘。

x402 × MCP 消除了这一切。代理调用 API → 返回 402 → 发送支付 → 收到数据。无需注册、无需 API 密钥、无需管理订阅。

关于范围的澄清：x402 不处理订阅、开票、客户管理、税务合规或退款争议。它是一个协议级别的按请求支付原语。这是一个深思熟虑的设计决策——面向人类的管理留在 Stripe 上，自主的按请求支付运行在 x402 上。

5、你现在可以构建什么

自主研究 给 Claude 一个研究任务。它通过 MCP 调用多个数据 API，通过 x402 每次调用支付几分钱，并返回一份完整的报告。无需预先注册每个 API 提供商。

无需订阅即可访问付费内容 按使用次数访问付费内容或专业数据源。Claude 支付并获取——无需人类先设置订阅。

物理世界操作（PostalForm 示例）支持 x402 的服务可以触发物理操作——打印、邮寄、订购——这些操作可以像其他 API 一样从 Claude 调用。"起草这个并邮寄出去"变成了一条完全执行的单一指令。

6、预算控制

自主支出引发了一个显而易见的担忧。答案在于 upto 方案和策略引擎。

upto 方案：代理预先签署一个 $5.00 的上限。服务器只收取实际消费的金额。Permit2 合约使过度收费在技术上不可能实现。

策略引擎（Coinbase CDP）：

{
  maxAmountPerTransaction: "1.00",  // $1 per call max
  dailyLimit: "10.00",              // $10 per day total
  allowedRecipients: [
    "0xAbCd...1234"                 // only this address
  ]
}

没有余额 → 代理停止。超出策略 → 代理停止。这就是预算约束自主代理的架构。

7、客观评估

兼容 x402 的 API 仍然有限。目前支持 x402 的日语服务基本为零。LangChain、CrewAI 和 Claude 的 MCP 生态系统已将 x402 适配器作为标准配置，但供应端——接受 x402 的 API——仍处于早期阶段。

结构性正在发生变化的是：随着 Claude Code 的成熟和 MCP 工具使用的增长，API 提供商面临一个新问题。你是想让 AI 代理能够访问你的服务，还是仅限于拥有计费账户的人类？x402 是实现前者的最简路径。

报税故事只是规模化后的一个缩影。一个能够处理完整工作流——起草、支付、发送——而无需在每个步骤进行人工干预的代理。实现这一切的基础设施今天已经存在。

原文链接: Claude Code × x402: Why MCP and x402 Belong Together

DefiPlot翻译整理，转载请标明出处

免责声明：本站资源仅用于学习目的，也不应被视为投资建议，读者在采取任何行动之前应自行研究并对自己的决定承担全部责任。

Read next