local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Integrates with PayPal APIs to manage invoices, offering tools to create new invoices and list existing ones through function calling.
PayPal 模型上下文协议
PayPal模型上下文协议服务器允许您通过函数调用与 PayPal API 集成。该协议支持各种工具与不同的 PayPal 服务进行交互。
要使用 npx 运行 PayPal MCP 服务器，请使用以下命令：
将YOUR_ACCESS_TOKEN替换为您的 PayPal 访问令牌。请参阅此文，了解如何生成 PayPal 访问令牌。或者，您也可以在环境变量中设置 PAYPAL_ACCESS_TOKEN。
与 MCP 主机（Claude Desktop/Cline/Cursor/Github Co-Pilot）一起使用
本指南介绍如何将 PayPal 连接器与 Claude Desktop 集成。
先决条件
- 已安装 Claude Desktop 应用程序
- 本地安装 Node.js
安装步骤
1. 安装 Node.js
PayPal 连接器需要 Node.js 才能运行：
- 访问Node.js官方网站，下载并安装。
- 要求：Node 18+
2. 使用 MCP 主机 (Claude 桌面/Cursor/Cline) 配置 PayPal 连接器
我们将演示如何与 Claude 桌面集成。您可以使用您喜欢的 MCP 主机。
- 打开 Claude 桌面
- 导航至“设置”
- 找到开发人员或高级设置部分
- 找到外部工具或连接器配置区域
- 将以下 PayPal 连接器配置添加到此 ~/Claude/claude_desktop_config.json 中：
请务必将YOUR_PAYPAL_ACCESS_TOKEN替换为您的实际 PayPal 访问令牌。或者，您可以将 PAYPAL_ACCESS_TOKEN 设置为环境变量。您也可以在“args”中使用 --access-token 将其作为参数传递。将PAYPAL_ENVIRONMENT值设置为SANDBOX （用于阶段测试）或PRODUCTION （用于生产环境）。
- 保存配置更改
3. 测试集成
- 退出并重新启动 Claude Desktop 以应用更改
- 通过要求 Claude 执行与 PayPal 相关的任务来测试连接
- 例如：“列出我的 PayPal 发票”
可用工具
| 工具 | 描述 |
|---|---|
invoices.create | 创建新发票 |
invoices.list | 列出发票 |
环境变量
可以使用以下环境变量：
PAYPAL_ACCESS_TOKEN：您的 PayPal 访问令牌PAYPAL_ENVIRONMENT：设置为SANDBOX表示沙盒模式，设置为PRODUCTION表示生产模式（默认为SANDBOX模式）
本指南介绍如何为 PayPal API 集成生成访问令牌，包括如何查找您的客户端 ID 和客户端密钥。
先决条件
- PayPal 开发者账户（用于沙盒）
- PayPal 商业账户（用于生产）
查找您的客户端 ID 和客户端密钥
- 创建 PayPal 开发者帐户：
- 前往PayPal 开发者仪表板
- 使用您的 PayPal 凭证注册或登录
- 访问您的凭证：
- 在开发者仪表板中，单击菜单中的**“应用和凭据”**
- 根据需要在沙盒和实时模式之间切换
- 创建或查看应用程序：
- 要创建新应用程序，请单击创建应用程序
- 为您的应用命名并选择与之关联的企业帐户
- 对于现有应用，点击应用名称即可查看详情
- 检索凭证：
- 创建或选择应用程序后，您将看到一个屏幕，其中包含：
- 客户端 ID ：您的应用程序的公共标识符
- 客户端密钥：私钥（点击“显示”后显示）
- 安全保存这些凭证，因为它们是生成访问令牌所必需的
- 创建或选择应用程序后，您将看到一个屏幕，其中包含：
生成访问令牌
使用 cURL
将CLIENT_ID和CLIENT_SECRET替换为您的实际凭证。对于生产环境，请使用https://api-m.paypal.com代替沙盒 URL。
使用 Postman
- 向
https://api-m.sandbox.paypal.com/v1/oauth2/token创建新请求 - 将方法设置为POST
- 在授权下，选择基本授权并输入您的客户端 ID 和客户端密钥
- 在Body下，选择x-www-form-urlencoded并添加一个键
grant_type，其值为client_credentials - 发送请求
回复
成功的响应将如下所示：
复制access_token值以用于 Claude Desktop 集成。
代币详情
- 沙盒代币：有效期为 3-8 小时
- 生产代币：有效期为8小时
- 建议在到期前实现令牌刷新逻辑
在 Claude Desktop 中使用令牌
获得访问令牌后，请在 Claude Desktop 连接器配置中更新PAYPAL_ACCESS_TOKEN值：
最佳实践
- 安全地存储客户端 ID 和客户端密钥
- 实现令牌刷新逻辑来处理令牌过期
- 使用特定于环境的令牌（用于测试的沙盒，用于实际交易的生产）
- 避免在应用程序代码中对令牌进行硬编码
免责声明
@paypal/mcp提供对 AI 生成内容的访问权限，这些内容可能不准确或不完整。用户有责任在依赖任何信息之前独立验证其准确性。PayPal 不保证其输出的准确性，也不对因使用该信息而导致的任何决定、行动或后果承担责任。
This server cannot be installed
PayPal 模型上下文协议服务器允许您通过函数调用与 PayPal API 集成。该协议支持各种工具与不同的 PayPal 服务进行交互。