Stripe MCP Server (Official)已精选

什么是 Stripe MCP Server (Official)？

Stripe MCP Server (Official) 是 Stripe 官方托管的 stripe mcp 端点，地址为 https://mcp.stripe.com。它让 AI 智能体可以通过 OAuth 或智能体 API 密钥调用 Stripe API、查询账户数据，并搜索 Stripe 文档和支持文章。

服务器由 Stripe 自己运行，因此无需安装任何东西。它用一小组通用工具（stripe_api_read、stripe_api_write 以及 API 搜索工具）访问一长串受支持的 Stripe API 方法，而不会占满模型的上下文。Stripe 还提供智能体插件和技能，可以自动为你完成配置。

如何使用 Stripe MCP Server (Official)？

前提条件：一个 Stripe 账户（live mode 或 sandbox），以及支持远程服务器的 MCP 客户端。

Stripe 推荐的最快方式是通过 Stripe CLI 进行插件设置。它会检测你使用的智能体，配置 Stripe MCP 服务器并安装 Stripe 的技能：

npm install -g @stripe/cli@latest
stripe agent setup

如需手动设置，把客户端指向 https://mcp.stripe.com 即可。

Claude Code

claude mcp add --transport http stripe https://mcp.stripe.com/

启动 Claude Code 并运行 /mcp，通过 OAuth 登录。如果想改用智能体 API 密钥，把服务器加入项目的 .mcp.json，并从环境变量读取密钥：

{
  "mcpServers": {
    "stripe": {
      "type": "http",
      "url": "https://mcp.stripe.com",
      "headers": {
        "Authorization": "Bearer ${AGENT_API_KEY}"
      }
    }
  }
}

Claude Desktop

从 Claude 目录安装官方 Stripe 连接器，在 OAuth 窗口中登录 Stripe，然后在对话中的 Connectors 里启用 Stripe。在 Team 和 Enterprise 套餐中，需要由所有者先把连接器添加到工作区。

Cursor

使用 Stripe 文档中的 "Install in Cursor" 按钮，或把以下内容加入 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "stripe": {
      "url": "https://mcp.stripe.com"
    }
  }
}

VS Code

把以下内容加入工作区的 .vscode/mcp.json：

{
  "servers": {
    "stripe": {
      "type": "http",
      "url": "https://mcp.stripe.com"
    }
  }
}

Codex

codex mcp add stripe --url https://mcp.stripe.com

ChatGPT 桌面应用、Codex CLI 和 Codex IDE 扩展共享这份配置。如需使用智能体 API 密钥，在 Codex 配置的 [mcp_servers.stripe] 下设置 bearer_token_env_var = "AGENT_API_KEY"。

认证

• OAuth 适用于交互式客户端。授权页面允许你为一个或多个 live mode 账户或 sandbox 授权，并为每个环境设置不同的权限。
• 智能体 API 密钥 适用于自主运行的客户端。创建一个只包含智能体所需权限的密钥，并在 Authorization 请求头中以 bearer 令牌形式发送。Stripe 表示从 2026 年 12 月起，服务器将不再接受完全访问权限的 secret key 和没有 Agent 标记的受限密钥，因此请在 2026 年 11 月 30 日前完成迁移。

Stripe MCP Server (Official) 的主要功能

• 官方出品，由 Stripe 托管；无需维护本地进程或软件包
• 通用读写工具覆盖一长串受支持的 API 方法：客户、支付、退款、发票、订阅、产品、价格、支付链接、争议、webhook、税务等
• 搜索 Stripe 文档和支持文章
• 支持按环境设置权限的 OAuth，或限定权限的智能体 API 密钥
• 对退款、对外付款等敏感的 stripe_api_write 操作要求人工确认
• 支持 Connect：通过 Stripe-Account 请求头代表关联账户操作（仅限智能体 API 密钥）
• 管理员可以按环境开启或关闭 MCP 访问，并撤销 OAuth 会话

Stripe MCP Server (Official) 工具

• API 工具： stripe_api_search 按关键词查找 API 方法，stripe_api_details 返回某个方法的参数，stripe_api_read 执行 GET 方法，stripe_api_write 执行 POST、PATCH、PUT 和 DELETE 方法。
• 账户与分析： get_stripe_account_info 获取账户信息；stripe_analytics（预览）查询指标和财务报表，启用 Sigma 后还能根据自然语言生成 SQL。
• Treasury（公开预览）： get_balance_summary、convert_currency、send_money、setup_recipient 和 transfer_money。
• 指导类： search_stripe_documentation、用于规划集成的 stripe_implementation_planner、用于 Stripe Atlas 的 atlas_company_formation，以及 send_stripe_feedback。

Stripe MCP Server (Official) 的使用场景

• 客户支持："找到客户 jane@example.com，并显示她最近三笔扣款。"
• 账单运营："为 Pro 产品创建一个每月 $20 的价格，并为它生成支付链接。"
• 带安全确认的退款：请求退款，然后在 Stripe 返回的确认 URL 中批准。
• 收入问题：通过 stripe_analytics 询问"我们上个月的 MRR 是多少？"
• 集成规划："带免费试用的订阅应该怎么设置？"由 Stripe 文档给出答案。
• Connect 平台：排查某个特定关联账户上的支付问题。

Stripe MCP Server (Official) 与替代方案对比

托管服务器是官方选项，Stripe 的 stripe/ai 仓库在 MCP 部分也指向它。mcp.so 上的一些社区 Stripe MCP 服务器，例如这个 Stripe MCP Server，在本地运行，并通过环境变量使用你自己的 Stripe secret key。它们不由 Stripe 维护，也不提供托管服务器的 OAuth 登录或对敏感写操作的人工确认。如果使用其他支付服务商，PayPal 维护着自己的 PayPal MCP Server。

Stripe MCP Server (Official) 常见问题排查

• 返回 401 并附带 OAuth 质询： 服务器已不再接受你的密钥类型。请改用 OAuth 重新连接，或创建智能体 API 密钥。
• 在工作电脑上无法连接： 受管网络可能会屏蔽外部 MCP 服务器。请让 IT 部门放行 mcp.stripe.com。
• 团队已禁用 MCP： 管理员可以在 Dashboard 设置中为 live mode 和 sandbox 开启 MCP 访问。
• 写操作处于等待状态： 部分写操作需要人工批准。打开智能体给出的 URL，点击 Approve，然后让智能体重试。批准在 24 小时后过期。
• 使用 OAuth 时关联账户调用失败： Connect 需要智能体 API 密钥加上 Stripe-Account 请求头。