@35m/mcp

基于 Model Context Protocol 的 stdio server。装上之后，Claude Desktop / Cursor / Zed 等 MCP 客户端可以在对话里直接创建支付、查会话、发起退款，无需切到终端。

MCP 适合你在 IDE / 桌面 AI 助手里"边对话边操作 35pay"。如果你用的是Claude Code 这种自带 shell 的 agent，直接装 @35m/cli 通常更顺手。

配置

MCP server 不需要安装到全局，npx 拉起即可。在你 MCP 客户端的配置文件里加一段：

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或%APPDATA%\Claude\claude_desktop_config.json（Windows）：

claude_desktop_config.json

{
  "mcpServers": {
    "35pay": {
      "command": "npx",
      "args": ["-y", "@35m/mcp"],
      "env": {
        "PAY_KEY": "sk_test_xxx"
      }
    }
  }
}

Cursor

Settings → MCP → Add new MCP server，填一样的命令。或者直接编辑~/.cursor/mcp.json。

Zed

在 settings.json 的 context_servers 段加同样配置。

重启客户端后才会生效。如果列不到 35pay 工具，先看客户端的 MCP 日志（Claude Desktop 在 ~/Library/Logs/Claude/）。

环境变量

所有变量从客户端配置的 env 段传入：

PAY_KEY（必填）— sk_test_xxx 或 sk_live_xxx。强烈建议先用 test key 试，跑通了再换 live。
PAY_BASE_URL（选填）— 自部署时覆盖默认 https://pay.35team.com。

在 IDE / 桌面 AI 助手里挂 sk_live_xxx 意味着 AI 一句话就能真扣款。建议日常工作用 sk_test_xxx，确认安全再切。 Server 启动时会在 stderr 打印当前模式（LIVE / TEST）方便确认。

提供的 Tools

装好后 AI 会自动看到三个工具，名字风格和 SDK 一致：

create_checkout — 创建支付会话，返回托管收银台 URL。工具描述里会实时标注当前 key 是 LIVE 还是 TEST。
get_session — 查会话状态（pending / processing / paid / failed / canceled / expired）+ 关联的 PaymentRecord。
refund — 对一笔已支付的交易发起全额或部分退款。工具描述会强调 "live 模式真退钱"，避免 AI 误调。

Prompts（工作流模板）

除了工具，server 还注册了两个 prompt 模板，让你一句话触发常见流程：

send_payment_link — "帮某人发付款链接"。参数：金额、说明。会让 AI 调 create_checkout 拿 URL，并建议怎么发（短信 / 微信 / 邮件）。
reconcile_recent — "查最近 N 天收款情况"。参数：天数。生成简洁报表。

Resources

35pay://docs/integration — 浓缩版的接入指南（TypeScript / Python / Go + Webhook 验签 + Test 模式说明）。AI 在写代码时会自动读，避免凭记忆瞎写。

在对话里怎么用

装好后直接说人话即可：

"用 35pay 给客户 A 发一个 99 元的咨询费链接，发给 +86 138-xxxx-xxxx"
"查 sess_abc123 这个会话付了没"
"把 rec_xyz789 这笔订单全额退了，原因是客户 reschedule"
"看下我过去 7 天 35pay 收了多少钱"

AI 会自动调对应的工具，并把结果说人话回给你。如果操作可能有副作用（创建支付 / 退款），客户端通常会先弹窗确认。

和 CLI / Skill 的区别

@35m/cli — shell 命令，给脚本和带 shell 的 agent（Claude Code / Aider / 自动化）。
@35m/mcp（本页） — IDE / 桌面 AI 助手在对话里直接调，运行时操作。
@35m/skill — Claude Code 的 skill 文件，让 AI 在写新项目时知道该如何接入 35pay。