PayPal工具包

PayPal 模型上下文协议

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

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

npx -y @paypal/mcp --tools=all PAYPAL_ACCESS_TOKEN="YOUR_ACCESS_TOKEN" PAYPAL_ENVIRONMENT="SANDBOX"

请将 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 Desktop
2. 导航到设置
3. 找到开发者或高级设置部分
4. 定位到外部工具或连接器配置区域
5. 将以下 PayPal 连接器配置添加到 ~/Claude/claude_desktop_config.json 中：

{
   "mcpServers": {
     "paypal": {
       "command": "npx",
       "args": [
         "-y",
         "@paypal/mcp",
         "--tools=all"
       ],
       "env": {
         "PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN",
         "PAYPAL_ENVIRONMENT": "SANDBOX"
       }
     }
   }
}

确保将 YOUR_PAYPAL_ACCESS_TOKEN 替换为您实际的 PayPal 访问令牌。或者，您可以将 PAYPAL_ACCESS_TOKEN 设置为环境变量。您还可以通过在 "args" 中使用 --access-token 参数传递它。
设置 PAYPAL_ENVIRONMENT 的值为 SANDBOX 用于阶段测试，或设置为 PRODUCTION 用于生产环境。

1. 保存您的配置更改

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: 检索订单的详细信息
• capture_order: 为授权订单捕获付款

争议

• list_disputes: 检索所有未决争议的摘要
• get_dispute: 检索特定争议的详细信息
• accept_dispute_claim: 接受争议索赔

发货

• create_shipment: 创建一个发货跟踪记录
• 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. 访问您的凭据：

   • 在开发者仪表板中，点击菜单中的 Apps & Credentials
   • 根据需要在 Sandbox 和 Live 模式之间切换

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

   • 要创建新的应用程序，请点击 Create App
   • 为您的应用命名并选择与之关联的商业账户
   • 对于现有应用，点击应用名称以查看详细信息

4. 检索凭据：

   • 一旦创建或选择了您的应用，您将看到包含以下内容的屏幕：
     • Client ID: 您应用的公共标识符
     • Client Secret: 私钥（单击“显示”后可见）
   • 安全地保存这些凭据，因为它们是生成访问令牌所必需的

生成访问令牌

使用 cURL

curl -v https://api-m.sandbox.paypal.com/v1/oauth2/token \\
  -H \"Accept: application/json\" \\
  -H \"Accept-Language: en_US\" \\
  -u \"CLIENT_ID:CLIENT_SECRET\" \\
  -d \"grant_type=client_credentials\"

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

使用 Postman

1. 创建一个新的请求到 https://api-m.sandbox.paypal.com/v1/oauth2/token
2. 将方法设置为 POST
3. 在 Authorization 下，选择 Basic Auth 并输入您的 Client ID 和 Client Secret
4. 在 Body 下，选择 x-www-form-urlencoded 并添加键 grant_type 且值为 client_credentials
5. 发送请求

响应

成功的响应如下所示：

{
  "scope": "...",
  "access_token": "Your Access Token",
  "token_type": "Bearer",
  "app_id": "APP-80W284485P519543T",
  "expires_in": 32400,
  "nonce": "..."
}

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

令牌详细信息

• 沙盒令牌：有效期为3-8小时
• 生产令牌：有效期为8小时
• 建议在令牌过期前实现令牌刷新逻辑

在 Claude Desktop 中使用令牌

一旦您获得了访问令牌，请在您的 Claude Desktop 连接器配置中更新 PAYPAL_ACCESS_TOKEN 的值：

{
  "env": {
    "PAYPAL_ACCESS_TOKEN": "YOUR_NEW_ACCESS_TOKEN",
    "PAYPAL_ENVIRONMENT": "SANDBOX"
  }
}

最佳实践

1. 安全地存储客户端ID和客户端密钥
2. 实现令牌刷新逻辑以处理令牌到期问题
3. 使用特定于环境的令牌（测试时使用沙盒，真实交易时使用生产）
4. 避免在应用程序代码中硬编码令牌

免责声明

@paypal/mcp 提供可能不准确或不完整的AI生成内容。用户有责任在依赖之前独立验证任何信息。PayPal 不保证输出准确性，并且不对因使用它而做出的任何决定、行动或后果负责。