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 と統合する方法について説明します。
Related MCP server: PayPal MCP Server
前提条件
Claudeデスクトップアプリケーションがインストール済み
Node.jsをローカルにインストールする
インストール手順
1. Node.jsをインストールする
PayPal コネクタが機能するには Node.js が必要です。
Node.js の公式 Web サイトにアクセスし、ダウンロードしてインストールします。
要件: Node 18以上
2. MCPホスト（Claudeデスクトップ/カーソル/Cline）でPayPalコネクタを構成する
Claudeデスクトップとの統合をご紹介します。お好きなMCPホストをご利用ください。
クロードデスクトップを開く
設定に移動
開発者または詳細設定セクションを見つけます
外部ツールまたはコネクタの構成領域を見つけます
この ~/Claude/claude_desktop_config.json に次の PayPal コネクタ構成を追加します。
YOUR_PAYPAL_ACCESS_TOKEN実際の PayPal アクセストークンに置き換えてください。PAYPAL_ACCESS_TOKEN を環境変数として設定することもできます。また、--access-token を "args" に使用して引数として渡すこともできます。PAYPAL_ENVIRONMENT PAYPAL_ENVIRONMENT値は、ステージテストの場合はSANDBOX 、本番環境の場合はPRODUCTIONに設定してください。
設定の変更を保存する
3. 統合をテストする
変更を適用するには、Claude Desktop を終了して再起動してください。
クロードに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とクライアントシークレットの確認
PayPal開発者アカウントを作成します:
PayPalの認証情報でサインアップまたはログインしてください
資格情報にアクセスする:
開発者ダッシュボードで、メニューの**「アプリと認証情報」**をクリックします。
ニーズに応じてサンドボックスモードとライブモードを切り替えます
アプリを作成または表示する:
新しいアプリを作成するには、 **「アプリを作成」**をクリックします
アプリに名前を付け、関連付けるビジネスアカウントを選択します
既存のアプリの場合は、アプリ名をクリックして詳細を表示します。
資格情報の取得:
アプリが作成または選択されると、次の内容が表示された画面が表示されます。
クライアントID : アプリの公開識別子
クライアントシークレット: 秘密鍵（「表示」をクリックした後に表示されます）
これらの認証情報はアクセストークンの生成に必要なので安全に保存してください
アクセストークンの生成
cURLの使用
CLIENT_IDとCLIENT_SECRET実際の認証情報に置き換えてください。本番環境では、サンドボックスURLではなくhttps://api-m.paypal.com使用してください。
Postmanの使用
https://api-m.sandbox.paypal.com/v1/oauth2/tokenへの新しいリクエストを作成します。メソッドをPOSTに設定する
認証の下で、 Basic認証を選択し、クライアントIDとクライアントシークレットを入力します。
Bodyの下で、 x-www-form-urlencodedを選択し、キー
grant_typeと値client_credentialsを追加します。リクエストを送信する
応答
成功した応答は次のようになります。
Claude Desktop 統合で使用するためにaccess_token値をコピーします。
トークンの詳細
サンドボックストークン：3～8時間有効
生産トークン：8時間有効
有効期限が切れる前にトークン更新ロジックを実装することをお勧めします
Claude Desktopでトークンを使用する
アクセス トークンを取得したら、Claude Desktop コネクタ構成のPAYPAL_ACCESS_TOKEN値を更新します。
ベストプラクティス
クライアントIDとクライアントシークレットを安全に保存する
トークンの有効期限を処理するためのトークン更新ロジックを実装する
環境固有のトークンを使用する（テストにはサンドボックス、実際のトランザクションには本番環境）
アプリケーションコードにトークンをハードコーディングしない
免責事項
@paypal/mcp AI 生成コンテンツへのアクセスを提供しますが、その内容は不正確または不完全である可能性があります。ユーザーは、情報に依拠する前に、自らの責任において検証するものとします。PayPal は出力の正確性について一切保証せず、その使用に起因するいかなる決定、行動、または結果についても責任を負いません。