mcp-stripe-acp

@codespar/mcp-stripe-acp

Stripe ACP 的 MCP 服务——面向 AI Agent 结账、支付委托和商品管理的 Agentic Commerce Protocol

什么是 Stripe ACP？

Agentic Commerce Protocol（ACP） 是由 Stripe 和 OpenAI 联合开发的开放标准。它让 AI Agent 能够代表用户完成购买——Agent 负责结账体验，卖家负责库存、定价和支付处理。

此 MCP 服务涵盖 ACP 协议操作（结账会话、支付委托）和 标准 Stripe API 操作（客户、商品、发票、订阅）。

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "stripe-acp": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe-acp"],
      "env": {
        "STRIPE_API_KEY": "sk_test_...",
        "STRIPE_ACP_BASE": "https://seller.example.com/acp"
      }
    }
  }
}

Claude Code

claude mcp add stripe-acp -- npx @codespar/mcp-stripe-acp

Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "stripe-acp": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe-acp"],
      "env": {
        "STRIPE_API_KEY": "sk_test_...",
        "STRIPE_ACP_BASE": "https://seller.example.com/acp"
      }
    }
  }
}

工具（24 个）

工具	用途
create_checkout	与卖家创建 ACP 结账会话。
get_checkout	获取 ACP 结账会话的当前状态，包括状态、定价和可用支付方式...
update_checkout	更新 ACP 结账会话——修改数量、配送地址或履约选项
complete_checkout	提交支付令牌以完成 ACP 结账。
cancel_checkout	取消 ACP 结账会话。
create_customer	创建 Stripe 客户
list_customers	列出 Stripe 客户，可选筛选条件
create_payment_link	为某个价格创建可分享的 Stripe Payment Link
list_payment_intents	列出 Stripe 支付意向，可选筛选条件
create_refund	为 Stripe 支付意向或扣款退款
get_balance	获取 Stripe 账户余额
list_products	列出 Stripe 商品目录中的商品
create_product	在 Stripe 中创建新商品
list_prices	列出 Stripe 商品的价格
create_invoice	为客户创建草稿发票
list_subscriptions	列出有效的 Stripe 订阅
create_subscription	使用周期性价格为客户创建订阅
cancel_subscription	立即取消 Stripe 订阅或在周期结束时取消
create_invoice_item	向即将生成或指定的发票添加一个明细项
finalize_invoice	定稿草稿发票，使其可以付款
create_coupon	创建折扣券
list_disputes	列出支付争议（拒付）
create_checkout_session	创建 Stripe Checkout Session（托管支付页面）
get_account	获取已验证账户的 Stripe 账户信息

身份验证

Stripe 使用秘密 API 密钥（或用于生产环境的受限密钥）。开发时请使用测试模式密钥（sk_test_...）。

获取凭据

1. 前往 Stripe Dashboard
2. 复制秘密密钥（或创建具有特定权限的受限密钥）
3. 对于 ACP：配置卖家的 ACP 端点 URL
4. 设置环境变量

环境变量

变量	必填	描述
STRIPE_API_KEY	是	Stripe 秘密 API 密钥或受限 API 密钥
STRIPE_ACP_BASE	否	卖家的 ACP 端点基础 URL（ACP 工具必需）

ACP 结账流程

1. Agent calls create_checkout → sends items + buyer info
2. Seller returns pricing, shipping options, payment handlers
3. Agent calls update_checkout → selects shipping, updates address
4. Checkout reaches "ready_for_payment" status
5. Agent calls complete_checkout → submits payment token
6. Seller processes payment → order confirmed

路线图

v0.2（计划中）

• search_products — 按查询词搜索商品目录
• create_checkout_link — 生成 ACP 结账 URL
• get_order_status — 跟踪结账后的订单
• list_payment_handlers — 查找可用的支付方式

v0.3（计划中）

• SharedPaymentToken 的创建与管理
• 支持通过 Webhook 更新结账状态
• 多卖家的结账流程编排

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

链接

• ACP 规范
• ACP GitHub
• Stripe Agent Toolkit
• Stripe API 文档
• MCP Dev LATAM
• 落地页

企业版

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

许可证

MIT