Paypal

🚀 PayPal代理とClaudeデスクトップ統合ガイド

このドキュメントは、PayPal代理のインストールと設定、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

アプリケーションの作成と登録

PayPal開発者コンソールにアクセスし、「新しいアプリケーションを作成」をクリックして必要な情報を入力します。

APIキーの取得

選択または新規作成したアプリケーションの詳細ページに移動し、以下の情報を見つけて記録します。

• Client ID: アプリケーションの公開識別子
• Client Secret: アプリケーションの秘密鍵（「表示」をクリックして表示）

📦 インストール

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

💻 使用例

基本的な使用法

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を使用してください。

OAuth 2.0認証 - アクセストークンの更新

アクセストークンが期限切れに近づいたときは、同じcURLコマンドを使用してトークンを更新します。パラメータは変更する必要はありません。

Webhooksの統合

PayPalからのリアルタイム通知を受け取るために、Webhooksを登録して設定します。

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"}'

高度な使用法

ClaudeデスクトップへのPayPalの統合

環境変数の設定

Claude Desktopの環境変数を更新して、PayPalの統合をサポートします。

export PAYPAL_ACCESS_TOKEN="YOUR_PAYPAL_ACCESS_TOKEN"
export PAYPAL_ENVIRONMENT="SANDBOX"  # または PRODUCTION

コネクタの設定

Claude Desktopで以下のコネクタ設定を追加または編集します。

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

機能テスト

Claudeに「私のPayPal請求書をリストアップする」などのタスクを依頼して、統合が成功したことを確認します。

📚 ドキュメント

アクセストークンの取得手順

1. PayPal開発者コンソールで新しいアプリケーションを作成します。
2. アプリケーションの詳細ページに移動し、「表示」をクリックしてClient Secretを取得します。
3. cURLまたはPostmanを使用してリクエストを送信し、アクセストークンを交換します。

アクセストークンの更新ポリシー

• 更新間隔: トークンの有効期限の15分前に更新することをお勧めします。
• 自動リトライ: 冪等操作を統合して、重複リクエストによるエラーを防止します。

🔧 技術詳細

注意事項

• 権限管理: API呼び出しに必要な権限（例: payments.read）があることを確認してください。
• ログ記録: すべてのAPIリクエストとレスポンスを詳細に記録して、問題のトラブルシューティングを容易にします。
• パフォーマンス最適化: 並行リクエストの量を適切に制御して、PayPalのレート制限をトリガーしないようにします。

セキュリティ上の注意事項

• 暗号化転送: すべての機密情報がHTTPSを介して転送されることを確認してください。
• 最小権限の原則: 必要なAPIアクセス権限のみを付与します。
• 定期的な監査: APIキーとトークンポリシーを定期的にレビューして更新します。