Skip to main content
Glama

PayPal

Official
by paypal
Apache 2.0
134
129
  • Linux
  • Apple

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 桌面
  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 :检索订单的详细信息
  • 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 开发者帐户
  2. 访问您的凭证
    • 在开发者仪表板中,单击菜单中的**“应用和凭据”**
    • 根据需要在沙盒实时模式之间切换
  3. 创建或查看应用程序
    • 要创建新应用程序,请单击创建应用程序
    • 为您的应用命名并选择与之关联的企业帐户
    • 对于现有应用,点击应用名称即可查看详情
  4. 检索凭证
    • 创建或选择应用程序后,您将看到一个屏幕,其中包含:
      • 客户端 ID :您的应用程序的公共标识符
      • 客户端密钥:私钥(点击“显示”后显示)
    • 安全保存这些凭证,因为它们是生成访问令牌所必需的

生成访问令牌

使用 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_IDCLIENT_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. 发送请求

回复

成功的响应将如下所示:

{ "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 不保证其输出的准确性,也不对因使用该信息而导致的任何决定、行动或后果承担责任。

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

  1. 与 MCP 主机(Claude Desktop/Cline/Cursor/GitHub Copilot)一起使用
    1. 先决条件
      1. 安装步骤
        1. 1. 安装 Node.js
        2. 2. 使用 MCP 主机 (Claude 桌面/Cursor/Cline) 配置 PayPal 连接器
        3. 3. 测试集成
      2. 可用工具
        1. 环境变量
          1. 先决条件
            1. 查找您的客户端 ID 和客户端密钥
              1. 生成访问令牌
                1. 使用 cURL
                2. 使用 Postman
                3. 回复
              2. 代币详情
                1. 在 Claude Desktop 中使用令牌
                  1. 最佳实践
                    1. 免责声明

                      Related MCP Servers

                      • -
                        security
                        F
                        license
                        -
                        quality
                        A server implementing the Model Context Protocol to make and query payments through Worldpay APIs, enabling payment processing, payment queries, and checkout form generation.
                        Last updated -
                        TypeScript
                      • -
                        security
                        A
                        license
                        -
                        quality
                        A Model Context Protocol server that provides comprehensive integration with PayPal's APIs, enabling seamless interaction with payment processing, invoicing, subscription management, and business operations through a standardized interface.
                        Last updated -
                        6
                        TypeScript
                        Apache 2.0
                      • -
                        security
                        A
                        license
                        -
                        quality
                        Model Context Protocol server for interacting with the HaloPSA API, enabling AI assistants like Claude to manage tickets, users, and assets in HaloPSA through natural language.
                        Last updated -
                        74
                        JavaScript
                        MIT License
                        • Apple
                        • Linux
                      • A
                        security
                        A
                        license
                        A
                        quality
                        A Model Context Protocol server that provides tools for interacting with the Paddle Billing API, enabling users to manage products, prices, customers, transactions, subscriptions, and create custom financial reports.
                        Last updated -
                        8
                        53
                        24
                        TypeScript
                        Apache 2.0

                      View all related MCP servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/paypal/agent-toolkit'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server