基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
技术实践2026-11-22 18:30

实测智能体付款的 x402 与 MCP 接口

dev.to · AI#智能体支付#x402#MCP
Editor brief · 编辑速览

作者实测了 Sendclap 的两个入口并审阅服务端代码。x402 支持在 Base 上用 USDC 直接付款,费率为 1%,MCP 则用于查商品、生成供人使用的结账链接和读取创作者自己的账本。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

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 映射成当前创作者支持的支付选项,避免把 HTTP 200 直接显示成结账成功。
  • 用 Node 或 TypeScript 接自动付款时,可以按原文采用 @x402/fetch、@x402/evm 和 viem,把 spendControls.maxAmountPerPayment 设低。会员界面用 active_until 显示到期日,并根据 renews: false 标明这是一次预付。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
Inkling 2 Mini 以层循环增加推理计算
下一篇
给编程智能体加一个本地部署入口

资讯速览

dev.to · AI · 2026-11-22 18:30

AI 评分 8.0 / 10

相关标签

#智能体支付#x402#MCP

继续阅读

  • 邮件引用重复让模型输入膨胀十倍
  • Inkling 2 Mini 以层循环增加推理计算
  • 给编程智能体加一个本地部署入口
  • 桌面助手如何区分停止播报与取消任务
  • Gemini API 预览工具按需检索能力