mcp-ap2

@codespar/mcp-ap2

已弃用：没有可用的端点。 2026-09-27 测试结果：ap2.googleapis.com 对所有路径均返回 Google 的通用 Error 404 (Not Found) 页面；而 sandbox.ap2.googleapis.com（与 AP2_SANDBOX=true 配合使用）TLS 握手失败，因为该处提供的证书覆盖 *.googleapis.com，但不覆盖额外的标签。AP2 是一项开放规范，并非 Google 托管的 API。此服务中的工具均无法连接到服务。该软件包已在 npm 上弃用，仅保留在此代码库中供参考。如果你有可用的端点，请通过 AP2_BASE_URL 将服务指向该端点。若要恢复此软件包，请在 mcp-dev-latam 中提交 issue，并附上提供方文档中的基础 URL。

Alpha 版本 — 使用 npm 的 alpha dist-tag 发布。在 0.x.x-alpha 期间请锁定精确版本。使用 npm install <pkg>@alpha 安装。

用于 AP2 的 MCP 服务 — Google 的 Agent-to-Agent Payment Protocol（用于智能体支付的授权、审计和信任）

什么是 AP2？

AP2（Agent-to-Agent Payment Protocol）是 Google 推出的开放框架，旨在为智能体支付提供授权、审计和信任。它回答了几个关键问题：谁授权了这笔付款？适用哪些限额？完整的审计记录是什么？

该规范发布于 ap2-protocol.org。

快速开始

Claude Desktop

将以下内容添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "ap2": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-ap2"],
      "env": {
        "AP2_API_KEY": "your-key",
        "AP2_AGENT_ID": "your-agent-id"
      }
    }
  }
}

Claude Code

claude mcp add ap2 -- npx @codespar/mcp-ap2

Cursor / VS Code

将以下内容添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "ap2": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-ap2"],
      "env": {
        "AP2_API_KEY": "your-key",
        "AP2_AGENT_ID": "your-agent-id"
      }
    }
  }
}

工具（22）

工具	用途
register_agent	在 AP2 网络中将 AI Agent 注册为可信付款方。
get_agent	获取 Agent 的注册详情、信任状态和当前支出用量
list_agents	列出已注册的 Agent，可选筛选条件
revoke_agent	撤销 Agent 的付款授权。
authorize_payment	请求带范围限制的付款授权。
get_authorization	获取授权详情，包括状态、限额和到期时间
list_authorizations	列出付款授权，可选筛选条件
execute_payment	执行已授权的付款。
get_audit_trail	获取交易的完整审计跟踪记录——每次授权、审批、执行和结算等..
list_audit_events	列出所有交易的审计事件，并应用筛选条件
list_payment_methods	列出 AP2 合作伙伴网络提供的付款方式
get_transaction	获取完整的交易详情，包括授权、执行和结算状态
list_transactions	列出交易，可选筛选条件
create_intent_mandate	创建 AP2 意图委托——一种可验证凭证，表达用户委托交易的意图..
create_cart_mandate	创建 AP2 购物车委托——由商家签署并锁定购物车的承诺，将商品明细、总额等绑定..
create_payment_mandate	创建 AP2 付款委托——最终的可验证凭证，用于授权依据购物车委托进行结算。
verify_credential	验证可验证凭证（意图、购物车或付款委托）。
create_presentation	创建可验证呈现，将一个或多个凭证打包在一起（例如
verify_presentation	验证可验证呈现及其所有内嵌凭证，包括持有者绑定和质询随机数。
resolve_did	通过 AP2 通用解析器将去中心化标识符（DID）解析为其 DID 文档。
create_receipt	为已结算的付款创建签名收据——一份防篡改记录，用于关联交易、委托等..
verify_receipt	验证收据的签名、发行方，以及其与源委托之间的关联链。

身份验证

服务器会在每个请求中将 AP2_API_KEY 作为 Authorization: Bearer 标头发送，并将 AP2_AGENT_ID 作为 X-Agent-Id 标头发送（src/index.ts:69-73）。

目前没有门户会签发这些凭据。本 README 之前链接的开发者门户 developers.google.com/ap2 返回 HTTP 404，所指向的 ap2-spec 仓库也同样如此。已发布的规范位于 ap2-protocol.org。

环境变量

变量	必需	描述
AP2_API_KEY	是	作为 Authorization: Bearer 发送
AP2_AGENT_ID	是	作为 X-Agent-Id 标头发送
AP2_SANDBOX	否	true 会将 BASE_URL 切换为 https://sandbox.ap2.googleapis.com/v1，但该地址 TLS 连接失败

使用场景

• 已授权的 Agent 付款 — Agent 请求支出授权，获得带限额的审批，然后执行付款
• 多 Agent 商务 — Agent A 授权 Agent B 代表其付款，并设定范围限制
• 合规与审计 — 完整记录每次授权、审批、执行和结算的审计跟踪
• 跨支付渠道付款 — AP2 打通银行卡付款、银行转账、钱包和 x402 小额付款

路线图

v0.2（计划中）

• create_policy — 定义可重复使用的授权策略
• delegate_authority — 允许 Agent 之间委托授权
• get_spend_report — 获取支出分析和报告
• OAuth 2.0 身份验证流程

v0.3（计划中）

• 支持用于实时授权事件的 Webhook
• 支持自动外汇兑换的多币种功能
• 集成 x402 作为付款方式

想要贡献？提交 PR 或申请工具。

链接

• AP2 规范
• MCP Dev LATAM
• 落地页

企业版

需要为 Agent 付款设置治理、预算限制和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、付款路由和合规模板。

许可证

MIT