PayPal

PayPal モデルコンテキストプロトコル

PayPalモデルコンテキストプロトコルサーバーを使用すると、関数呼び出しを通じてPayPal APIとの統合が可能になります。このプロトコルは、さまざまなPayPalサービスと連携するための様々なツールをサポートしています。

npx を使用して PayPal MCP サーバーを実行するには、次のコマンドを使用します。

YOUR_ACCESS_TOKEN PayPalアクセストークンに置き換えてください。PayPalアクセストークンの生成方法については、こちらを参照してください。または、環境変数にPAYPAL_ACCESS_TOKENを設定することもできます。

MCP ホスト (Claude Desktop/Cline/Cursor/GitHub Copilot) での使用

このガイドでは、PayPal コネクタを Claude Desktop と統合する方法について説明します。

前提条件

• Claudeデスクトップアプリケーションがインストール済み
• Node.jsをローカルにインストールする

インストール手順

1. Node.jsをインストールする

PayPal コネクタが機能するには Node.js が必要です。

1. Node.js の公式 Web サイトにアクセスし、ダウンロードしてインストールします。
2. 要件: Node 18以上

2. MCPホスト（Claudeデスクトップ/カーソル/Cline）でPayPalコネクタを構成する

Claudeデスクトップとの統合をご紹介します。お好きなMCPホストをご利用ください。

1. クロードデスクトップを開く
2. 設定に移動
3. 開発者または詳細設定セクションを見つけます
4. 外部ツールまたはコネクタの構成領域を見つけます
5. この ~/Claude/claude_desktop_config.json に次の PayPal コネクタ構成を追加します。

YOUR_PAYPAL_ACCESS_TOKEN実際の PayPal アクセストークンに置き換えてください。PAYPAL_ACCESS_TOKEN を環境変数として設定することもできます。また、--access-token を "args" に使用して引数として渡すこともできます。PAYPAL_ENVIRONMENT PAYPAL_ENVIRONMENT値は、ステージテストの場合はSANDBOX 、本番環境の場合はPRODUCTIONに設定してください。

6. 設定の変更を保存する

3. 統合をテストする

1. 変更を適用するには、Claude Desktop を終了して再起動してください。
2. クロードにPayPal関連のタスクを実行してもらい、接続をテストします。
   • 例: 「PayPal 請求書を一覧表示する」

利用可能なツール

請求書

• create_invoice : PayPal システムに新しい請求書を作成する
• list_invoices : オプションのページ区切りとフィルタリングを使用して請求書を一覧表示します
• get_invoice : 特定の請求書の詳細を取得する
• send_invoice : 受信者に請求書を送信する
• send_invoice_reminder : 既存の請求書のリマインダーを送信する
• cancel_sent_invoice : 送信した請求書をキャンセルする
• generate_invoice_qr_code : 請求書のQRコードを生成する

支払い

• 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モード)

このガイドでは、クライアント ID とクライアント シークレットを見つける方法など、PayPal API 統合用のアクセス トークンを生成する方法について説明します。

前提条件

• PayPal 開発者アカウント（サンドボックス用）
• PayPalビジネスアカウント（本番環境用）

クライアントIDとクライアントシークレットの確認

1. PayPal開発者アカウントを作成します:
   • PayPal開発者ダッシュボードへ
   • PayPalの認証情報でサインアップまたはログインしてください
2. 資格情報にアクセスする:
   • 開発者ダッシュボードで、メニューの**「アプリと認証情報」**をクリックします。
   • ニーズに応じてサンドボックスモードとライブモードを切り替えます
3. アプリを作成または表示する:
   • 新しいアプリを作成するには、 **「アプリを作成」**をクリックします
   • アプリに名前を付け、関連付けるビジネスアカウントを選択します
   • 既存のアプリの場合は、アプリ名をクリックして詳細を表示します。
4. 資格情報の取得:
   • アプリが作成または選択されると、次の内容が表示された画面が表示されます。
     • クライアントID : アプリの公開識別子
     • クライアントシークレット: 秘密鍵（「表示」をクリックした後に表示されます）
   • これらの認証情報はアクセストークンの生成に必要なので安全に保存してください

アクセストークンの生成

cURLの使用

CLIENT_IDとCLIENT_SECRET実際の認証情報に置き換えてください。本番環境では、サンドボックスURLではなくhttps://api-m.paypal.com使用してください。

Postmanの使用

1. https://api-m.sandbox.paypal.com/v1/oauth2/tokenへの新しいリクエストを作成します。
2. メソッドをPOSTに設定する
3. 認証の下で、 Basic認証を選択し、クライアントIDとクライアントシークレットを入力します。
4. Bodyの下で、 x-www-form-urlencodedを選択し、キーgrant_typeと値client_credentialsを追加します。
5. リクエストを送信する

応答

成功した応答は次のようになります。

Claude Desktop 統合で使用するためにaccess_token値をコピーします。

トークンの詳細

• サンドボックストークン：3～8時間有効
• 生産トークン：8時間有効
• 有効期限が切れる前にトークン更新ロジックを実装することをお勧めします

Claude Desktopでトークンを使用する

アクセス トークンを取得したら、Claude Desktop コネクタ構成のPAYPAL_ACCESS_TOKEN値を更新します。

ベストプラクティス

1. クライアントIDとクライアントシークレットを安全に保存する
2. トークンの有効期限を処理するためのトークン更新ロジックを実装する
3. 環境固有のトークンを使用する（テストにはサンドボックス、実際のトランザクションには本番環境）
4. アプリケーションコードにトークンをハードコーディングしない

免責事項

@paypal/mcp AI 生成コンテンツへのアクセスを提供しますが、その内容は不正確または不完全である可能性があります。ユーザーは、情報に依拠する前に、自らの責任において検証するものとします。PayPal は出力の正確性について一切保証せず、その使用に起因するいかなる決定、行動、または結果についても責任を負いません。