支付宝推出国内首个 MCP 支付

lencx2025年04月15日约 5 分钟

如果还不了解 MCP 是什么，可以查看我之前写的几篇文章（浅谈 Agent、MCP、OpenAI Responses API、深度解析：Anthropic MCP 协议，除了 MCP 协议外，还有个 A2A 协议 Google A2A：多智能体通信协议）。

MCP 是一种开放协议，它标准化了应用程序如何向 LLMs 提供上下文。可以将 MCP 视为 AI 应用的 USB-C 接口。正如 USB-C 为设备连接各种外设和配件提供了标准化方式，MCP 也为 AI 模型连接不同数据源和工具提供了标准化途径。

支付宝 MCP

@alipay/mcp-server-alipay^[1]（一个 NPM 包）是支付宝开放平台提供的 MCP Server，让你可以轻松将支付宝开放平台提供的交易创建、查询、退款等能力集成到你的 LLM 应用中，并进一步创建具备支付能力的智能工具。

为了方便理解，文档中虚构了一个场景来解释其能力：

一位插画师希望通过提供定制的原创插画服务谋取收入。传统方式下，他/她需要和每位客户反复沟通需求、确定价格，并发送支付链接，然后再人工确认支付情况，这个过程繁琐且费时。

现在，插画师利用支付宝 MCP Server 与智能 Agent 工具，通过 Agent 搭建平台，开发了一个智能聊天应用（网页或小程序）。客户只需在应用中描述自己的绘画需求（如风格偏好、插画用途、交付时间等），AI 就会自动分析需求，快速生成准确且合理的定制报价，并通过工具即时创建出专用的支付宝支付链接。

客户点击并支付后，创作者立即收到通知，进入创作环节。无需人工往返对话确认交易状态或支付情况，整个流程不仅便捷顺畅，还能显著提高交易效率和客户满意度，让插画师更专注于自己的创作本身，实现更轻松的个性化服务商业模式。

     最终用户设备                      Agent 运行环境
+---------------------+        +--------------------------+      +-------------------+
|                     |  交流  |    支付宝 MCP Server +     |      |                   |
|    小程序/WebApp     |<------>|   其他 MCP Server +       |<---->|     支付服务       |
|                     |  支付  |    Agent 开发工具          |      |   交易/退款/查询    |
+---------------------+        +--------------------------+      +-------------------+
     创作服务买家                        智能工具开发者                   支付宝开放平台
      (最终用户)                           (创作者)

想了解更多，可查看支付宝 MCP 文档^[2]

如何使用

要使用工具的支付能力，需先成为支付宝开放平台的收款商户，并获取商户私钥。之后可直接在主流的 MCP Client（Cursor、Cline 等）上使用支付宝 MCP Server。

在 .cursor/mcp.json 或 cline_mcp_settings.json 中的配置如下，其他客户端类似：

{
"mcpServers":{
"mcp-server-alipay":{
"command":"npx",
"args":["-y","@alipay/mcp-server-alipay"],
"env":{
"AP_APP_ID":"2014...222",
"AP_APP_KEY":"MIIE...DZdM=",
"AP_PUB_KEY":"MIIB...DAQAB",
"AP_RETURN_URL":"https://success-page",
"AP_NOTIFY_URL":"https://your-own-server",
"...其他参数":"...其他值"
}
},
"其他工具":{
"...":"..."
}
  }
}

参数详解：

# 支付宝开放平台配置

AP_APP_ID=2014...222                    # 商户在开放平台申请的应用 ID（APPID）。必需。
AP_APP_KEY=MIIE...DZdM=                 # 商户在开放平台申请的应用私钥。必需。
AP_PUB_KEY=MIIB...DAQAB                 # 用于验证支付宝服务端数据签名的支付宝公钥，在开放平台获取。必需。
AP_RETURN_URL=https://success-page      # 网页支付完成后对付款用户展示的「同步结果返回地址」。
AP_NOTIFY_URL=https://your-own-server   # 支付完成后，用于告知开发者支付结果的「异步结果通知地址」。
AP_ENCRYPTION_ALGO=RSA2                 # 商户在开放平台配置的参数签名方式。可选值为 "RSA2" 或 "RSA"。缺省值为 "RSA2"。
AP_CURRENT_ENV=prod                     # 连接的支付宝开放平台环境。可选值为 "prod"（线上环境）或 "sandbox"（沙箱环境）。缺省值为 "prod"。

# MCP Server 配置

AP_SELECT_TOOLS=all                      # 允许使用的工具。可选值为 "all" 或逗号分隔的工具名称列表。工具名称包括 `mobilePay`, `webPagePay`, `queryPay`, `refundPay`, `refundQuery`。缺省值为 "all"。
AP_LOG_ENABLED=true# 是否在 $HOME/mcp-server-alipay.log 中记录日志。默认值为 true。

以下表格列出了所有可用的支付工具能力：

支付方式选择

在开发过程中，为了让 LLM 能更准确地选择合适的支付方式，建议在 Prompt 中清晰说明你的产品使用场景：

扫码支付（webPagePay）：适用于用户在电脑屏幕上看到支付界面的场景。如果您的应用或网站主要运行在桌面端（PC），你可以在 Prompt 中说明："我的应用是桌面软件/PC 网站，需要在电脑上展示支付二维码"。
手机支付（mobilePay）：适用于用户在手机浏览器内发起支付的场景。如果你的应用是手机 H5 页面或移动端网站，你可以在 Prompt 中说明："我的页面是手机网页，需要直接在手机上唤起支付宝支付"。

未来会提供更多适合 AI 应用的支付方式。

官方案例

文档链接：https://opendocs.alipay.com/open/0go80l#%E4%BD%BF%E7%94%A8

在支付宝文档中，有一个跑通的测试流程截图（基于 Cline 测试），基本实现业务闭环。

需求

你是一个诗词创作者并以此谋生，可以根据用户给定的主题创作诗词；你可以为此收取费用，收取的方式是让用户先充值 1 元及以上，而后每次诗词创作扣除 0.01 元，如果用户希望不再使用服务，可以申请退回剩余的费用，注意，已经扣除的金额不做退回；你可以提供 1 次免费的创作，而后用户必须充值才能享受创作服务，注意，必须确保用户充值成功后再提供创作内容，你要尽量让用户愿意付费，也要说明清楚收费机制，一旦用户同意充值，请立刻为其生成支付链接（订单号是结合情境与时间生成，金额在 1 元 - 5 元之间，订单标题按照情境生成即可），渲染给用户，并引导其完成付款，付款后再提供创作内容；记得以亲切温柔的语气与用户交流。