实测智能体付款的 x402 与 MCP 接口
作者实测了 Sendclap 的两个入口并审阅服务端代码。x402 支持在 Base 上用 USDC 直接付款,费率为 1%,MCP 则用于查商品、生成供人使用的结账链接和读取创作者自己的账本。
AI 深度解读
Sendclap 给 AI Agent 提供了两条支付路径。MCP 用来查创作者卖什么、生成给人付款的链接,x402 让 Agent 用 Base 上的 USDC 直接付款。两条路径都无需付款人注册。走 Base 主网时,Agent 签一份转账授权,由 Sendclap 提交交易并承担 Gas,平台费固定为 1%。
作者在 2026-11-22 实测了公开接口、付款报价、拒绝路径和链上分账地址。文章最有参考价值的是这些接口如何衔接,以及客户端能从错误里拿到什么。至于扣款成功、发许可证和会员续期,证据来自源码和测试文件。
Agent 怎么找到商品,把付款交给人?
POST /mcp 用 HTTP 传输 JSON-RPC 2.0。服务端不保存会话,每次 POST 独立处理。GET /mcp 返回 405 Method Not Allowed,并带上 Allow: POST。像 notifications/initialized 这样没有 id 的通知,返回 202 Accepted 和空响应体。
这条命令可以直接检查客户端拿到的协议版本和工具能力。
curl -sS -X POST https://sendclap.com/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl-test","version":"1.0"}}}'
看最后一行的 protocolVersion。服务端回显 2025-03-26,省略时默认用 2025-06-18,返回的服务端版本是 sendclap v1.0.0。初始化和 tools/list 的应用处理耗时分别为 0.20 ms 和 0.32 ms,它们测的是服务端应用时间。
tools/list 无需密钥就会列出全部 9 个工具,其中 3 个公开,6 个需要创作者的 Authorization: Bearer sc_…。Agent 可以先用 get_creator 查支付方式和商品。demo 开了 crypto 和 x402,关了 card 和 ton,提供 $5 打赏、两个会员档位和 $29 的 Pro 许可证。borodutch 则开放了 card、crypto 和 x402。需要人接手时,create_checkout 可以生成结账链接。公开的 get_checkout 会移除付款人邮箱,因为加密货币订单 ID 可以从链上看到。
写客户端时要分两层处理错误。协议错误看 error.data.code,例如未知工具是 -32602(not_found),无效 JSON 是 HTTP 400 加 -32700(bad_request),单批超过 20 条是 HTTP 400 加 -32600。作者也测了 ping 和查询 @demo 的双请求批处理,得到了 HTTP 200 和两个结果,查询时会去掉开头的 @。工具执行失败也可能返回 HTTP 200,此时要读 isError 和 structuredContent.code。作者测到了缺密钥的 invalid_api_key、查无创作者的 not_found,以及对 demo 指定 method: "card" 时的 method_unavailable。
一次 HTTP 402 怎么变成一笔 USDC 转账?
Sendclap 在 Base 上实现了 x402 v2 的 exact 方案。打赏、商品和会员三类路由都支持 GET 和 POST。Agent 先请求资源,收到 HTTP 402 Payment Required 后读报价,再把签好的授权放进 Base64 编码的 PAYMENT-SIGNATURE,重发请求。
作者请求 /x402/demo/tip?amount=5,在 0.79 ms 的应用处理时间内拿到报价。条款同时出现在 Base64 编码的 PAYMENT-REQUIRED 和 JSON 响应体里。x402Version 为 2,network 为 eip155:8453,amount 为字符串 "5000000",maxTimeoutSeconds 为 120。这里的金额是 USDC 的最小单位,6 位小数,所以 $29 的 /x402/demo/products/1?email=agent@example.com 报价为 "29000000"。
/x402/{handle}/tip 允许 $1 到 $10,000,省略 amount 时用创作者推荐值,还可以带 message。/x402/{handle}/products/{id} 和 /x402/{handle}/memberships/{id} 都要求 email。会员的可选参数 period 必须匹配档位。作者给月付档位传了 period=year,以及给打赏传了 amount=0 和 amount=10001,都拿到了 HTTP 400,商品缺邮箱也是 400。
Base 主网默认留空 X402_FACILITATOR,由 Sendclap 的 settleOurselves() 负责结算。Base Sepolia 默认使用 x402 的 facilitator。Agent 签的是 EIP-3009 transferWithAuthorization,EIP-712 域使用 USD Coin 和版本 2。这份签名绑定付款人、收款地址、金额、有效期和 nonce。Sendclap 的提交服务可以代付 Gas,签名里的收款地址和金额仍由签名约束。按作者给出的设计理由,$1 起付让 1% 的费用至少有 1 美分,用来覆盖结算成本。
作者发了 8 个有问题的付款头。前 6 项在内存中校验,服务端以自己重新生成的条款核对 accepted 和 authorization,还给 validBefore 留出 6 秒缓冲,约 1 毫秒就能拒绝。字段通过后才用 simulateContract 模拟转账。模拟回退时,服务端再查 balanceOf(from)。空钱包返回 insufficient_funds,耗时 23.06 ms,持有超过 5 USDC 的销毁地址返回 invalid_exact_evm_payload_signature,耗时 35.90 ms。这两个错误对应的处理动作不同,客户端可以分别提示补余额和检查签名。
钱先到哪里,付款后能拿到什么?
报价里的 payTo 是为创作者预先算出的分账地址。作者在 Base 区块 60,757,165 对 demo 和 borodutch 的分账地址调用 eth_getCode,结果都是 0x。随后用 SendclapSplitFactory.addressOf() 传入 demo 的创作者钱包,得到的地址和报价一致。工厂通过 CREATE2 计算 EIP-1167 最小代理地址,首次分账时才部署 45 字节的代理。链上 feeBps() 和 MAX_FEE_BPS() 都返回 100,对应 1%。
按提交 8432e113 的源码,付款结算后,服务端在后台调 releaseSplit(creatorWallet),Agent 可以先拿到 HTTP 200。release(creator) 把 99% 给创作者、1% 给 Sendclap。调用失败时,releaseWaiting 会扫过去 24 小时内收到 x402 付款、分账地址余额至少有 1 USDC 的创作者。任何人也可以直接在链上调用 release(creator)。
同一提交里的 x402Pay 和测试文件还描述了三类成功响应。打赏返回 paid: true,交易哈希也会出现在 Base64 编码的 PAYMENT-RESPONSE 里。数字商品记录 x402:<txHash> 以实现重试幂等,配置后会返回 license_key 和 download_url。会员一次预付一个月或一年,返回 active_until 和 renews: false,含许可证的档位还会返回 license_key。提前再付一次,会从现有到期日继续延长。
我的判断
把商品发现、人类结账和 Agent 付款分开,客户端更容易控制授权。只查商品时用公开 MCP 工具,需要人付款时发结账链接,确定要让 Agent 自己付时再接钱包。对于现有的人工确认流程,结账链接是改动较小的接法。x402 的收益出现在调用方需要以程序化方式完成签名、付款和读取交付结果时。
这篇实测足以说明公开接口怎么响应、报价怎么读、几类错误怎么区分。作者没有可用的 Base 资金和创作者密钥,没有发出真实 USDC 交易、调用 6 个鉴权工具或用 create_checkout 创建待支付订单,也没有在本地运行 bun test。因此,真实结算耗时、分账失败后的恢复、发证和续期仍缺少端到端实测。文章也没给 Gas 成本或其他结账方式的对照数据,1 美分能覆盖结算成本是作者转述的设计依据,实际覆盖情况没有数据。
能拿来做什么
- 在 Claude Code、Cursor 或自己的 HTTP MCP 客户端里,只查商品时省略
headers。先用get_creator读取payment_methods,再根据返回值决定是否提供卡支付入口或使用 x402。 - 给前端或 Node 封装 MCP 请求时,同时处理协议错误和
isError。把method_unavailable映射成当前创作者支持的支付选项,避免把 HTTP200直接显示成结账成功。 - 用 Node 或 TypeScript 接自动付款时,可以按原文采用
@x402/fetch、@x402/evm和viem,把spendControls.maxAmountPerPayment设低。会员界面用active_until显示到期日,并根据renews: false标明这是一次预付。