MCP 服务计费的三种方案与重试陷阱
文章对比自建 API 密钥和余额系统、通过 x402 按请求链上支付、接入第三方计费网关三种方案,并讨论调用方识别、工具定价、执行前验资和重试去重。作者参与开发了其中提到的一款网关。
AI 深度解读
一个 MCP 工具每次调用只花几分钱,Agent 掉进循环,午饭前就可能打 400 次。Nischal 拆了三种收费方案:自己维护预付余额、用 x402 逐请求链上支付,或者把鉴权和结算交给 Nexus402 这类网关。
三条路都要回答同一组工程问题:执行前能否确认钱够,重试会不会重复扣费,失败算谁的。对写前端和 Node 的人来说,最值得读的是这些边界怎么落进数据库、HTTP 接口和流式响应里。
自建预付费,怎样扛住并发扣款和重试
作者建议默认用预付费。月底出账的做法实现起来简单,但工具已经消耗了 LLM token、GPU 时间或第三方 API 额度,几周后才知道能否收回钱。预付费把检查放到执行之前。服务端先用 API key 识别账户,再按工具查出价格,余额不足就返回 402 Payment Required。API key 只存哈希,金额用 BIGINT 存整数微美元,20000 代表 $0.02。Postgres 还能用 CHECK (balance_micro >= 0) 给余额加一道约束。
下面的 Go 函数把收费记录和余额扣减放进同一个事务,处理重复请求和并发扣款。
var ErrInsufficientFunds = errors.New("insufficient funds")
// Debit charges an account once per idempotency key. A retry with the same
// key is a no-op that reports success without charging again.
func Debit(ctx context.Context, db *sql.DB, accountID int64, key, tool string, price int64) error {
tx, err := db.BeginTx(ctx, nil)
if err != nil {
return err
}
defer tx.Rollback()
res, err := tx.ExecContext(ctx, `
INSERT INTO charges (account_id, idempotency_key, tool, amount_micro)
VALUES ($1, $2, $3, $4)
ON CONFLICT (account_id, idempotency_key) DO NOTHING`,
accountID, key, tool, price)
if err != nil {
return err
}
if n, _ := res.RowsAffected(); n == 0 {
return tx.Commit() // already charged for this key: replay, don't double-charge
}
res, err = tx.ExecContext(ctx, `
UPDATE accounts SET balance_micro = balance_micro - $2
WHERE id = $1 AND balance_micro >= $2`,
accountID, price)
if err != nil {
return err
}
if n, _ := res.RowsAffected(); n == 0 {
return ErrInsufficientFunds // rollback undoes the charge row too
}
return tx.Commit()
}
关键的一行是 WHERE id = $1 AND balance_micro >= $2。并发请求竞争同一账户时,Postgres 会锁住这行,后到的更新会按扣过款的余额重新判断。余额不足时,事务回滚,刚插入的收费记录也一起撤销。
(account_id, idempotency_key) 能保证同一个 Idempotency-Key 只扣一次,但原文的 handler 收到重复请求后仍会调用 runTool。对昂贵工具,作者建议把结果和幂等键一起保存,重试时返回已有结果。若两次请求同时抵达,还需要定义第二次遇到「执行中」时怎么响应。原文在工具执行失败时调用 refund,数据库不可用时返回 503 并停止执行,退款如何可靠完成则没有展开。
作者估计,这段核心逻辑大约只占自建工作的 20%。其余还包括 Stripe Checkout 充值、重复 webhook 去重、密钥发放和轮换、按 key 设置每日限额、退款争议、税务、收据、消费明细和账本对账。给循环中的 Agent 设 $5 上限,才有机会在它花到 $500 前停下来。
x402 和结算网关分别省掉哪部分工作
x402 把付款放进 HTTP 往返。按作者描述,服务端收到未付款请求后,先用 402 Payment Required 告知接受什么付款。Agent 签署一笔稳定币付款,通常是 USDC,再把付款附在重试请求里。验证和结算由 facilitator 负责,工具服务随后执行。只要钱包有钱,双方第一次接触就能交易,工具方省去了自己的用户账户和 API key。代价是双方都得处理钱包,逐次链上结算也带来手续费和延迟。工具调用便宜到不足一美分时,这两项开销更影响选择。原文没有给出费用或延迟的实测数据。
Nexus402 走的是共享预付余额的路线。开发者充一个钱包,用一把 key 调用网络内的多个工具。网关处理鉴权、余额、限额和收费,工具作者维护 HTTPS 端点,验证转发请求,再通过 Stripe Connect 提现。原文描述的是上线时的设计。首次在某个域名发布时,要在 /.well-known/nexus402-challenge/ 下提供验证文件。工具名可以是 acme/text/word_count。发布后的版本固定价格、端点和描述,涨价要发 @v2,固定在 @v1 的调用方继续用旧价。原文还说,大幅涨价会对未锁版本的调用方延后一周生效。
网关只向公开 IP 上的 HTTPS 443 端口发 POST,且不跟随重定向。initialize、ping 和 tools/list 由网关处理,端点只收 tools/call。响应头要在 5 秒内返回,流式输出间隔至多 5 秒,整次调用限 120 秒,响应上限为 10 MiB。已有 MCP SDK 服务可以在前面接开源的 verify-proxy。
为什么工具回了 200,网关还要检查证明
网关用 Ed25519 签名覆盖六项内容:HTTP 方法、已登记的 host、原样收到的路径与查询串、时间戳、X-Correlation-ID 和原始请求体的 SHA-256 小写十六进制摘要。六项用单个 \n 连接,末尾没有换行。验签要用配置里的 host,时间戳与本机时间的差值不能超过正负 60 秒,并支持已发布公钥集合中的任一把钥匙,便于轮换。
下面这段 Node 代码验证转发请求,并生成响应要带回的 X-Nexus-Proof。
import { createHash, createPublicKey, timingSafeEqual, verify, type KeyObject } from 'node:crypto'
const SPKI_PREFIX = Buffer.from('302a300506032b6570032100', 'hex')
const REGISTERED_HOST = process.env.NEXUS_REGISTERED_HOST!
const CREATOR_KEY = process.env.NEXUS_CREATOR_KEY!
const PUBLIC_KEYS: KeyObject[] = process.env.NEXUS_PUBLIC_KEY!.split(',').map((k) =>
createPublicKey({ key: Buffer.concat([SPKI_PREFIX, Buffer.from(k.trim(), 'base64')]), format: 'der', type: 'spki' }),
)
const sha256 = (data: string | Buffer) => createHash('sha256').update(data).digest()
/** Returns the X-Nexus-Proof value for a genuine request, or null. */
export function verifyNexus(
method: string,
rawTarget: string, // path + query exactly as received, e.g. req.originalUrl
headers: Record<string, string | undefined>,
body: Buffer,
): string | null {
const sigHeader = headers['x-nexus-signature'] ?? ''
const ts = headers['x-nexus-timestamp'] ?? ''
const corr = headers['x-correlation-id'] ?? ''
if (body.length > 0 && !timingSafeEqual(sha256(headers['x-nexus-creator-key'] ?? ''), sha256(CREATOR_KEY))) return null
if (!/^\d+$/.test(ts) || Math.abs(Date.now() / 1000 - Number(ts)) > 60) return null
if (!sigHeader.startsWith('ed25519:')) return null
const sig = Buffer.from(sigHeader.slice('ed25519:'.length), 'base64')
if (sig.length !== 64) return null
const canonical = [method, REGISTERED_HOST, rawTarget, ts, corr, sha256(body).toString('hex')].join('\n')
if (!PUBLIC_KEYS.some((key) => verify(null, Buffer.from(canonical), key, sig))) return null
return 'sha256:' + sha256(`nexus-endpoint-proof-v1\n${corr}\n${ts}\n${sigHeader}`).toString('base64url')
}
最容易踩坑的是拼接 canonical 的那一行。Express 要在 express.json() 改变请求体形态之前拿到原始 Buffer,路径和查询串也要保留原编码。示例把 32 字节公钥加上 12 字节 DER 前缀转为 SPKI,并要求签名解码后为 64 字节。函数只返回证明,调用方还要在发送响应头之前写入 X-Nexus-Proof,包括通过验签后返回的参数错误。
网关用证明判断端点有没有实际拿到这次请求。负载均衡器也可能回 200,所以只有带有效证明的 2xx 才扣费,即使 MCP 响应里是 isError: true。4xx 和 5xx 都退款,有证明的 4xx 不算创作者故障,5xx 算。首字节前遇到超时、无响应或 TLS 失败,调用作废。流式响应一旦开始,客户端中途断开仍收费。连续故障会让版本下架,直到作者重新发布,原文没有给出触发次数。
我的判断
自建部分最扎实的是数据库约束和事务,它们解释了为什么并发条件下不会透支。拿这段代码上线前,还得把扣款、工具执行和结果保存各自失败时的状态补齐。尤其是退款:示例沿用 r.Context(),客户端断开后这个上下文可能已取消,退款需要有独立的重试路径。已经有账户、充值和对账系统的团队,可以复用现有账本。只有一两个大客户且合同本身需要定制价格时,自建也更容易表达这些规则。
Nischal 是 Nexus402 的共建者。文中给的是接入示例、预定收费规则和选型经验,没有三种方案的同负载对照,也没有公开上线后的结算数据。比如按调用成本的第 95 百分位定价,平均 token 成本 $0.004、长输入 $0.012 是举例。按默认 10% 平台费,标价字符串 "20000" 对应收入 18000 微美元,原文称费率会随累计销售额下降。是否划算还要看用户能否充值、所在地区能否提现,以及长请求实际占多少。原文只说提现首批覆盖部分国家,新创作者有等待期。
能拿来做什么
- 给 Node 工具客户端的每次逻辑调用生成一个
Idempotency-Key,网络超时重试时复用它。服务端用账户和键定位记录,并核对工具与参数是否一致,再决定返回已有结果还是提示仍在执行。 - 在前端分别处理
402和503。遇到402时展示工具价格和充值入口,暂停自动重试。遇到503时允许稍后用原键重试,并在消费明细里区分扣款与退款。 - 接网关时,拿带 URL 编码的查询串和保留空白的 JSON 请求体做验签测试,再覆盖首字节前超时和流式传到一半断开两种情况,核对响应行为和账单。
- 给
word_count这类按次计费的工具定价时,先量实际调用成本,再算平台费和每日消费上限。用 Nexus402 的免费档做试用时,按工具配置周期,每日、每周或每月最多可给 1,000 次。