支付宝支付 MCP 服务

智能体开发者现在可以通过支付宝支付 MCP Server 轻松接入收单支付服务。目前已在移动及网站场景下提供了支付服务、支付查询、退款及退款查询等功能。

作为国内首家支持 MCP 协议的支付机构，当前的 MCP Server 仅是我们 AI 支付服务的第一步，后续支付宝将持续发布更多面向智能体的产品，我们期待与开发者一起探索 AI 支付的无限可能，共同打造更智能、更便捷的支付体验。

注意事项

为了对密钥的安全有效管理，请妥善保管你的私钥，您可在本地部署 MCP Server 时进行配置，请勿将私钥托管给三方平台。
我们建议您为 AI 智能体研发申请独立的开放平台应用，以实现智能体与非 Agent 研发业务系统的安全隔离。
商户订单号作为支付系统中商户交易的唯一标识，开发者需要确保其有效性（例如从真实的商户订单系统中获取），并在支付流程中正确传递。
本文档提供的例子经过简化，在生产场景中，您需要合理使用 Agent 服务，防范 prompt injection 等风险。
本服务工具支持配置使用，默认均允许调用，建议您根据使用场景仅开放必要工具供 Agent 调用，详见快速开始章节 AP_SELECT_TOOLS 说明。
由于 Agent 的行为是非确定性的，我们建议您进行充分的测试，以确保服务的可靠性和安全性。
本服务支持沙箱环境，建议先通过沙箱进行调试，可降低您的测试成本。

能力介绍

创建支付
- 开发者可以根据Agent所处环境，灵活选择创建手机支付或网页支付订单。
- 输入:
  - outTradeNo*创建订单参数-商户订单号。
  - totalAmount*该订单的支付金额，以元为单位。
  - orderTitle*该订单的订单标题。
- 输出：支付链接。
查询支付
- 通过接收商户订单系统查询指令，返回交易支付状态信息。
- 输入:
  - outTradeNo*商户订单号。
- 输出：支付宝交易号、交易状态、交易金额。
发起退款
- 通过接收商户订单系统退款指令，对交易进行退款操作。
- 输入:
  - outTradeNo*商户订单号。
  - refundAmount*退款金额。
  - outRequestNo*退款请求号。
  - refundReason退款原因。
- 输出：支付宝交易号、退款结果。
查询退款信息
- 通过接收商户订单系统退款查询指令，返回该笔交易退款操作基础信息。
- 输入：
  - outRequestNo*退款请求号。
  - outTradeNo*商户订单号。
- 输出：支付宝交易号、退款金额、退款状态。

使用准备

快速开始

任意支持 MCP 协议的平台（如：Cline、Claude、Cursor）都可简单接入支付 MCP Server，下文为 Cline 接入指南。

说明：目前支持 Node.js。

通过Node.js接入

安装 node.js

下载适用于操作系统的 Node.js 应用程序。

在Cline中配置

安装 Cline。
配置 MCP Server。
打开 cline_mcp_settings.json 文件，进行以下配置。

{

  "mcpServers": {

    "mcp-server-alipay": {

      "command": "npx",

      "args": [

        "-y",

        "@alipay/mcp-server-alipay"

      ],

      "env": {

        "AP_APP_ID": "2021xxxxxxxx8009",

        "AP_APP_KEY": "MIIEvw.....kO71sA==",

        "AP_PUB_KEY": "MIIBIjA......AQAB"

      },

      "disabled": false,

      "autoApprove": []

    }

  }

}

完整环境变量说明如下，开发者可按需设置：

变量KEY	变量含义	是否可选	示例值
AP_APP_ID	商户在开放平台申请的 APPID。	必填	2021xxxxxxxx8009
AP_APP_KEY	商户在开放平台设置的私钥。	必填	MIIEvw…..kO71sA==
AP_PUB_KEY	商户在开放平台的支付宝服务端公钥。	必填	MIIBIjA……AQAB
AP_ENCRYPTION_ALGO	商户在开放平台配置的接口加签方式，默认 RSA2 无需设置，如使用 RSA，则需设置为 RSA。	可选	RSA2
AP_RETURN_URL	支付完成后的同步返回地址。	可选	https://returnxx.com
AP_NOTIFY_URL	支付完成后的异步通知地址。	可选	https://notifyxx.com
AP_CURRENT_ENV	默认为正式环境，如果需要沙箱调试，请设置为 sandbox，注意修改环境后，AP_APP_ID、AP_APP_ID、AP_PUB_KEY 也需要适配为对应环境配置。	可选	prod
AP_SELECT_TOOLS	允许使用的工具，默认为 all，可按需配置。mobilePay：创建手机支付，手机端直接支付。webPagePay：创建网页支付，支持扫码或登录账号支付。queryPay：查询支付。refundPay：发起退款。refundQuery：查询退款信息。	可选	“mobilePay,queryPay”
AP_LOG_ENABLED	在~/mcp-server-alipay.log 中打印日志，默认为 true，如无需打印日志可设置为 false。	可选	true

配置后确保工作状态为正常可用。

支付MCP使用

以下是一个简单的诗词创作收费服务示例。

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