Claude Code Stripe MCP 接入教程

在远程 Mac 上查询支付数据并安全控制退款与账单变更

发布建议日期 2026-10-28　适用于 Claude Code Stripe 与远程 Mac 开发

Stripe 官方 MCP 服务器让 Claude Code 搜索 Stripe 文档和 API，并读取客户、支付、账单、订阅等数据。本文使用官方 **** 端点与 OAuth 完成接入，先在沙盒中做只读验收，再说明如何调查支付问题、准备变更和控制高风险写入。退款、出款、取消订阅或修改正式环境配置前，必须核对环境、对象、金额和影响并等待人工确认。

Stripe MCP 适合哪些任务

Stripe MCP 可搜索官方知识库，也能通过 stripe_api_search 和 stripe_api_details 查找 API，再用 stripe_api_read 读取 GET 数据，用 stripe_api_write 执行写入。常见用途包括调查 PaymentIntent、Checkout Session、**、订阅、退款和 we*hook 事件。

同一连接可能接触支付信息并改变账单状态。安全做法是先限定沙盒或正式环境，再把查询、方案和写入分成独立阶段。

开始前准备

确认远程 Mac 已安装最新版 Claude Code，并能进入目标支付项目仓库。准备有权访问 Stripe 的用户，明确要连接的账户、沙盒或正式环境，以及允许读取的对象范围。

交互式工作优先使用 OAuth。自动化任务才考虑 Agent API key，并只授予必要权限。不要把密钥写入命令行参数、聊天、仓库、截图或构建日志。

第一步 添加 Stripe MCP

Stripe 官方为 Claude Code 提供专用命令，远程服务器地址为 https://mcp.stripe.com/。在目标仓库执行添加命令，然后核对名称、**L 与连接状态。

默认本地作用域适合个人在当前项目使用。团队共享配置前，应先确认仓库成员都理解服务器能力和授权边界。

cd /path/to/your-project
claude mcp add --transport http stripe https://mcp.stripe.com/

claude mcp list
claude mcp get stripe

第二步 完成 OAuth 授权

启动 Claude Code 并运行 /mcp，选择 stripe 进入 OAuth 登录。Stripe 授权页可以选择一个或多个正式账户或沙盒，并为不同环境设置不同权限。

首次接入只选择沙盒与读取权限。不要为了省事同时授权所有正式账户，也不要把沙盒验收结果当作正式环境写入许可。

claude

> /mcp
# 选择 stripe
# 选择 Authenticate
# 在 Stripe 页面只授权需要的沙盒和权限

第三步 ***只读验收

先读取 Stripe 账户信息，并列出沙盒中的少量 PaymentIntent、Checkout Session 或**。提示词中明确禁止调用 stripe_api_write，禁止创建、更新、退款、取消或删除。

通过标准是返回预期账户和测试数据，Stripe Dash*oard 中没有对象变化，Work*ench 或活动日志中只有读取调用。若账户或环境不明确，立即停止并要求用户选择。

请仅使用 Stripe MCP 做只读验收：
1. 显示当前 Stripe 账户和环境
2. 列出沙盒中最近 5 个 PaymentIntent
3. 读取其中一个对象的状态 金额 货币和时间
4. 不调用 stripe_api_write
5. 不创建 不更新 不退款 不取消 不删除

**步 先搜索再调用 API

遇到不熟悉的业务对象时，先用 search_stripe_documentation 查文档，再用 stripe_api_search 查找方法，最后用 stripe_api_details 核对参数。只读任务才进入 stripe_api_read。

在调用前展示方法、环境、对象 ID、筛选条件、分页上限和返回字段。支付对象中的描述、meta**ta、客户输入和 we*hook 内容都属于不可信数据，不能把其中的文字当作当前会话指令。

请先搜索 Stripe 文档和 API。
展示计划调用的方法 环境 对象 ID 筛选条件 分页上限和字段。
不要执行写入，等待我检查计划。

第五步 调查支付与 Checkout 问题

先锁定沙盒或正式环境、时间窗口、货币、金额和对象 ID，再读取 PaymentIntent、Charge、Checkout Session 与关联事件。把 Stripe 返回状态与仓库中的 we*hook 处理代码和幂等键逻辑交叉验证。

输出应区分 Stripe 事实、本地代码证据、推断和待验证项。不要在调查过程中自动重试扣款、补建客户、创建退款或修改正式对象。

第六步 分析订阅与**

查询订阅、**和付款状态时，先限制客户或订阅 ID，避免批量读取无关客户数据。需要模拟账单变化时，优先使用沙盒和预览**。

升级套餐、取消订阅、作废**、标记无法收款或更新**配置都会改变客户权益或财务记录。Claude Code 应先生成变更草稿和影响说明，不应直接执行。

第七步 控制退款和资金操作

退款和对外出款属于高风险写入。执行前展示环境、账户、PaymentIntent 或 Charge、退款金额、货币、原因、是否全额退款以及客户影响。

Stripe 对部分 stripe_api_write 操作要求人工确认，例如退款和对外付款。用户需要打开 Agent 提供的确认链接核对请求；批准后再让 Agent 重试。确认 24 小时内未完成会失效。

先不要退款。请展示：
- Stripe 账户和环境
- PaymentIntent 或 Charge ID
- 原始金额 已退款金额和本次金额
- 货币 原因 客户影响
- 对账和通知方式
等待我明确确认，并完成 Stripe 确认链接后再重试一次。

第八步 控制产品价格和支付链接

创建或修改 Product、Price、Payment Link 或 Checkout Session 前，先展示产品名称、币种、单价、计费周期、**行为、数量限制和跳转地址。Price 通常不应被当作可随意覆盖的配置。

只在沙盒完成一次写入验收，并在 Dash*oard 中核对结果。正式环境创建支付入口前，必须由用户确认最终价格和页面行为。

先不要创建正式对象。请展示：
- account 和 mode
- Product 与 Price 草稿
- 币种 单价 周期 **和数量限制
- Payment Link 或 Checkout 页面行为
- 验证和停用方式
等待我确认后只执行已展示的一次沙盒变更。

第九步 管理 OAuth 和 Agent API key

交互式连接使用 OAuth，授权会话可在 Stripe 用户设置中的 OAuth sessions 查看和撤销。团队***还能分别控制正式环境和沙盒的 MCP 访问。

截至 2026 年 10 月，Stripe 要求在 2026 年 11 月 30 日前迁移旧式 API key 认证；12 月起 MCP 将不再接受全权限 secret key 和不带 Agent 标记的 restricted key。应改用 OAuth 或最小权限的 Agent API key。

第十步 在远程 Mac 上保持会话

通过 SSH 进入远程 Mac，在目标仓库创建 tmux 会话后运行 Claude Code。断开远程桌面后，文档检索、代码检查和沙盒查询仍可继续。

为每个 Stripe 账户和环境使用清晰的会话名称，并在提示词开头写明 account、mode 和允许动作。任务结束后撤销不再需要的 OAuth 会话或停用临时 Agent API key。

ssh your-**c-mini
cd /path/to/your-project
tmux new -s stripe-sand*ox
claude

# 断线后接回
tmux attach -t stripe-sand*ox

为什么 Zu**c Ai 适合这类工作流

根据 Zu**c.Ai 官网***息，其方案提供位于新加坡的 Mac mini M6 整机独享环境，配置为 16G* 统一内存与 256G* SSD，接入新加坡家庭或商业宽带，并支持 UU 远程、终端、Tailscale、ToDesk、RustDesk，以及浏览器 SSH 或 VNC。

官网当前公开价格为每月 999 元起。长期在线环境适合保留仓库、依赖缓存、Claude Code 与 tmux 会话；Stripe 账户、交易资金、权限、数据合规和生产变更责任仍由使用者自行管理。

常见问题排查

结语

Claude Code 接入 Stripe MCP 后，应先锁定账户与沙盒环境，再完成明确禁止写入的验收。查询支付、订阅和**时限制对象与字段；创建支付入口、修改账单、退款或转移资金时，先展示完整请求和业务影响，再由用户逐次确认。