paypal-mcp-server

PayPal Model Context Protocol

PayPal Model Context Protocol サーバーを使うと、関数呼び出しを通じて PayPal API と連携できます。このプロトコルは、さまざまな PayPal サービスと連携するための各種ツールをサポートしています。

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

npx -y @paypal/mcp --tools=all PAYPAL_ACCESS_TOKEN="YOUR_ACCESS_TOKEN" PAYPAL_ENVIRONMENT="SANDBOX"

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

MCP ホスト（Claude Desktop/Cline/Cursor/GitHub Copilot）での使用方法

このガイドでは、PayPal コネクターを Claude Desktop と連携する方法を説明します。

前提条件

• Claude Desktop アプリケーションがインストールされていること
• Node.js がローカルにインストールされていること

インストール手順

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

PayPal コネクターを動作させるには、Node.js が必要です。

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

2. PayPal コネクターを MCP ホスト（Claude desktop / Cursor / Cline）に設定する

ここでは Claude desktop との連携方法を説明します。お好みの MCP ホストを使用できます。

1. Claude Desktop を開きます
2. Settings に移動します
3. Developer または Advanced の設定セクションを見つけます
4. 外部ツールまたはコネクターの設定エリアを見つけます
5. 次の PayPal コネクター設定を ~/Claude/claude_desktop_config.json に追加します。

{
   "mcpServers": {
     "paypal": {
       "command": "npx",
       "args": [
         "-y",
         "@paypal/mcp",
         "--tools=all"
       ],
       "env": {
         "PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN",
         "PAYPAL_ENVIRONMENT": "SANDBOX"
       }
     }
   }
}

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

6. 設定の変更を保存します

3. 連携をテストする

1. 変更を適用するため、Claude Desktop を終了して再起動します
2. Claude に 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：承認済みの注文の支払いを処理します
• create_refund：キャプチャ済みの支払いの返金を処理します。
• get_refund：特定の返金の詳細を取得します。

異議申し立ての管理

• 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：新しいサブスクリプションプランを作成します
• update_plan：既存のプランを更新します
• list_subscription_plans：サブスクリプションプランを一覧表示します
• show_subscription_plan_details：特定のサブスクリプションプランの詳細を取得します
• create_subscription：新しいサブスクリプションを作成します
• show_subscription_details：特定のサブスクリプションの詳細を取得します
• update_subscription：既存のサブスクリプションを更新します
• cancel_subscription：有効なサブスクリプションをキャンセルします

レポートとインサイト

• list_transactions：ページネーションとフィルタリングを任意で指定して、取引を一覧表示します

環境変数

以下の環境変数を使用できます。

• PAYPAL_ACCESS_TOKEN：PayPal アクセストークン
• PAYPAL_ENVIRONMENT：サンドボックスモードでは SANDBOX、本番環境では PRODUCTION に設定します（デフォルトは SANDBOX モードです）

このガイドでは、クライアント ID とクライアントシークレットの確認方法を含め、PayPal API 統合用のアクセストークンを生成する方法を説明します。

前提条件

• PayPal Developer アカウント（サンドボックス用）
• PayPal Business アカウント（本番環境用）

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

1. PayPal Developer アカウントを作成する：

   • PayPal Developer Dashboard にアクセスします
   • PayPal の認証情報を使用して登録するか、ログインします

2. 認証情報にアクセスする：

   • Developer Dashboard のメニューで Apps & Credentials をクリックします
   • 必要に応じて Sandbox モードと Live モードを切り替えます

3. アプリを作成または表示する：

   • 新しいアプリを作成するには、Create App をクリックします
   • アプリに名前を付け、関連付ける Business アカウントを選択します
   • 既存のアプリの場合は、アプリ名をクリックして詳細を表示します

4. 認証情報を取得する：

   • アプリを作成または選択すると、以下が表示された画面が開きます。
     • Client ID：アプリの公開識別子
     • Client Secret：秘密鍵（「Show」をクリックすると表示されます）
   • アクセストークンの生成に必要なため、これらの認証情報を安全に保管します

アクセストークンの生成

cURL を使用する

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 を実際の認証情報に置き換えます。本番環境では、サンドボックスの URL の代わりに https://api-m.paypal.com を使用します。

Postman を使用する

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

応答

成功すると、次のような応答が返されます。

{
  "scope": "...",
  "access_token": "Your Access Token",
  "token_type": "Bearer",
  "app_id": "APP-80W284485P519543T",
  "expires_in": 32400,
  "nonce": "..."
}

access_token の値をコピーして、Claude Desktop との連携に使用します。

トークンの詳細

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

Claude Desktop でのトークンの使用

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

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

ベストプラクティス

1. クライアント ID とクライアントシークレットを安全に保管します
2. トークンの有効期限切れに対応するため、トークンを更新するロジックを実装します
3. 環境ごとにトークンを使い分けます（テストにはサンドボックス、本番取引には本番環境のトークンを使用します）
4. アプリケーションコードにトークンをハードコードしないでください

免責事項

@paypal/mcp は、不正確または不完全な可能性がある AI 生成コンテンツへのアクセスを提供します。ユーザーは、情報を信頼する前に、自らの責任でその内容を確認する必要があります。PayPal は出力の正確性を保証せず、その利用によって生じた判断、行動、または結果について責任を負いません。