PayPal

PayPal 模型上下文协议

PayPal模型上下文协议服务器允许您通过函数调用与 PayPal API 集成。该协议支持各种工具与不同的 PayPal 服务进行交互。

要使用 npx 运行 PayPal MCP 服务器，请使用以下命令：

将YOUR_ACCESS_TOKEN替换为您的 PayPal 访问令牌。请参阅此文，了解如何生成 PayPal 访问令牌。或者，您也可以在环境变量中设置 PAYPAL_ACCESS_TOKEN。

与 MCP 主机（Claude Desktop/Cline/Cursor/GitHub Copilot）一起使用

本指南介绍如何将 PayPal 连接器与 Claude Desktop 集成。

先决条件

• 已安装 Claude Desktop 应用程序

• 本地安装 Node.js

安装步骤

1. 安装 Node.js

PayPal 连接器需要 Node.js 才能运行：

1. 访问Node.js官方网站，下载并安装。

2. 要求：Node 18+

2. 使用 MCP 主机 (Claude 桌面/Cursor/Cline) 配置 PayPal 连接器

我们将演示如何与 Claude 桌面集成。您可以使用您喜欢的 MCP 主机。

1. 打开 Claude 桌面

2. 导航至“设置”

3. 找到开发人员或高级设置部分

4. 找到外部工具或连接器配置区域

5. 将以下 PayPal 连接器配置添加到此 ~/Claude/claude_desktop_config.json 中：

请务必将YOUR_PAYPAL_ACCESS_TOKEN替换为您的实际 PayPal 访问令牌。或者，您可以将 PAYPAL_ACCESS_TOKEN 设置为环境变量。您也可以在“args”中使用 --access-token 将其作为参数传递。将PAYPAL_ENVIRONMENT值设置为SANDBOX （用于阶段测试）或PRODUCTION （用于生产环境）。

6. 保存配置更改

3. 测试集成

1. 退出并重新启动 Claude Desktop 以应用更改

2. 通过要求 Claude 执行与 PayPal 相关的任务来测试连接

   • 例如：“列出我的 PayPal 发票”

可用工具

发票

• create_invoice ：在 PayPal 系统中创建新发票

• list_invoices ：列出发票，并可选分页和过滤

• get_invoice ：检索特定发票的详细信息

• send_invoice ：向收件人发送发票

• send_invoice_reminder ：发送现有发票的提醒

• cancel_sent_invoice ：取消已发送的发票

• generate_invoice_qr_code ：为发票生成二维码

付款

• create_order ：根据提供的详细信息在 PayPal 系统中创建订单

• get_order ：检索订单的详细信息

• pay_order ：处理授权订单的付款

争议管理

• list_disputes ：检索所有未决争议的摘要

• get_dispute ：检索特定争议的详细信息

• accept_dispute_claim ：接受争议索赔

货运追踪

• create_shipment_tracking ：创建货运跟踪记录

• get_shipment_tracking ：检索货运追踪信息

目录管理

• create_product ：在 PayPal 目录中创建新产品

• list_products ：列出具有可选分页和过滤功能的产品

• show_product_details ：检索特定产品的详细信息

• update_product ：更新现有产品

订阅管理

• create_subscription_plan ：创建新的订阅计划

• list_subscription_plans ：列出订阅计划

• show_subscription_plan_details ：检索特定订阅计划的详细信息

• create_subscription ：创建新订阅

• show_subscription_details ：检索特定订阅的详细信息

• cancel_subscription ：取消有效订阅

报告和见解

• list_transactions ：列出交易，并可选分页和过滤

环境变量

可以使用以下环境变量：

• PAYPAL_ACCESS_TOKEN ：您的 PayPal 访问令牌

• PAYPAL_ENVIRONMENT ：设置为SANDBOX表示沙盒模式，设置为PRODUCTION表示生产模式（默认为SANDBOX模式）

本指南介绍如何为 PayPal API 集成生成访问令牌，包括如何查找您的客户端 ID 和客户端密钥。

先决条件

• PayPal 开发者账户（用于沙盒）

• PayPal 商业账户（用于生产）

查找您的客户端 ID 和客户端密钥

1. 创建 PayPal 开发者帐户：

   • 前往PayPal 开发者仪表板

   • 使用您的 PayPal 凭证注册或登录

2. 访问您的凭证：

   • 在开发者仪表板中，单击菜单中的**“应用和凭据”**

   • 根据需要在沙盒和实时模式之间切换

3. 创建或查看应用程序：

   • 要创建新应用程序，请单击创建应用程序

   • 为您的应用命名并选择与之关联的企业帐户

   • 对于现有应用，点击应用名称即可查看详情

4. 检索凭证：

   • 创建或选择应用程序后，您将看到一个屏幕，其中包含：

     • 客户端 ID ：您的应用程序的公共标识符

     • 客户端密钥：私钥（点击“显示”后显示）

   • 安全保存这些凭证，因为它们是生成访问令牌所必需的

生成访问令牌

使用 cURL

将CLIENT_ID和CLIENT_SECRET替换为您的实际凭证。对于生产环境，请使用https://api-m.paypal.com代替沙盒 URL。

使用 Postman

1. 向https://api-m.sandbox.paypal.com/v1/oauth2/token创建新请求

2. 将方法设置为POST

3. 在授权下，选择基本授权并输入您的客户端 ID 和客户端密钥

4. 在Body下，选择x-www-form-urlencoded并添加一个键grant_type ，其值为client_credentials

5. 发送请求

回复

成功的响应将如下所示：

复制access_token值以用于 Claude Desktop 集成。

代币详情

• 沙盒代币：有效期为 3-8 小时

• 生产代币：有效期为8小时

• 建议在到期前实现令牌刷新逻辑

在 Claude Desktop 中使用令牌

获得访问令牌后，请在 Claude Desktop 连接器配置中更新PAYPAL_ACCESS_TOKEN值：

最佳实践

1. 安全地存储客户端 ID 和客户端密钥

2. 实现令牌刷新逻辑来处理令牌过期

3. 使用特定于环境的令牌（用于测试的沙盒，用于实际交易的生产）

4. 避免在应用程序代码中对令牌进行硬编码

免责声明

@paypal/mcp提供对 AI 生成内容的访问权限，这些内容可能不准确或不完整。用户有责任在依赖任何信息之前独立验证其准确性。PayPal 不保证其输出的准确性，也不对因使用该信息而导致的任何决定、行动或后果承担责任。