JinDaGe - paypal MCP Details

article

README

🚀 PayPal代理与Claude桌面集成指南

本指南详细介绍了PayPal代理的安装配置、Claude桌面集成的操作步骤，以及访问令牌管理和相关安全注意事项，帮助你顺利实现PayPal相关功能的集成与使用。

🚀 快速开始

PayPal代理快速入门

创建与注册应用：访问PayPal开发者控制台，点击创建新应用并填写必要信息。
获取API密钥：进入所选或新建的应用详情页，找到并记录下：
- Client ID：应用的公开标识符
- Client Secret：应用的私有密钥（点击“显示”以查看）

Claude桌面集成快速入门

环境变量配置：更新Claude Desktop的环境变量以支持PayPal集成。
连接器配置：在Claude Desktop中添加或编辑特定的连接器配置。
功能测试：通过向Claude提出任务，如“列出我的PayPal发票”，验证集成是否成功。

📦 安装指南

安装与配置PayPal代理

请参考以下步骤安装和配置PayPal代理：

# 下载并解压PayPal代理
wget https://github.com/paypal/agent/releases/download/v2.0.0/paypal-agent-2.0.0-linux-x64.tar.gz
tar -xzvf paypal-agent-2.0.0-linux-x64.tar.gz

# 配置环境变量
export PATH=$PATH:/path/to/unzip/folder

Claude桌面集成环境变量配置

更新Claude Desktop的环境变量以支持PayPal集成：

export PAYPAL_ACCESS_TOKEN="YOUR_PAYPAL_ACCESS_TOKEN"
export PAYPAL_ENVIRONMENT="SANDBOX"  # 或 PRODUCTION

Claude桌面集成连接器配置

在Claude Desktop中添加或编辑以下连接器配置：

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

💻 使用示例

PayPal代理基础用法

创建与注册应用

访问PayPal开发者控制台，点击创建新应用并填写必要信息。

获取API密钥

进入所选或新建的应用详情页，找到并记录下：

Client ID：应用的公开标识符
Client Secret：应用的私有密钥（点击“显示”以查看）

PayPal代理高级用法

OAuth 2.0认证

获取访问令牌

使用以下cURL命令获取PayPal API的访问令牌：

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。

刷新访问令牌

当访问令牌即将过期时，使用相同的cURL命令刷新令牌，无需更改任何参数。

Webhooks集成

注册并配置Webhooks以接收PayPal的实时通知：

curl -v -X POST https://api-m.sandbox.paypal.com/v1/notifications/webhooks \
-H "Content-Type: application/json" \
-u "CLIENT_ID:CLIENT_SECRET" \
-d '{"webhook_url":"https://your-server.example.com/paypal-webhook"}'

🔧 技术细节

访问令牌管理

获取步骤

创建应用：在PayPal开发者控制台创建新应用。
获取凭证：进入应用详情页，点击“显示”以获取Client Secret。
调用API：使用cURL或Postman发送请求以换取访问令牌。

刷新策略

刷新间隔：建议设置为令牌过期前15分钟进行刷新。
自动重试：集成幂等操作，防止重复请求导致的错误。

⚠️ 注意事项

权限管理：确保API调用具备必要的权限（如payments.read）。
日志记录：详细记录所有API请求与响应，便于排查问题。
性能优化：合理控制并发请求量，避免触发PayPal的速率限制。

🔒 安全提示

加密传输：确保所有敏感信息通过HTTPS传输。
最小权限原则：仅授予必要的API访问权限。
定期审计：定期审查和更新API密钥及令牌策略。

paypal