概要
AI に PayPal ビジネスアカウントで作業させます。注文の作成と代金の回収、支払いの返金、請求書の作成・送信・督促、取引履歴と残高の検索、異議申し立ての確認、サブスクリプションプラン、サブスクリプション、Payouts のバッチの参照ができます。サンドボックスと本番に対応し、自分の REST アプリのキーを使います。
ガイド付きセットアップ
PayPal を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで PayPal を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
PayPal のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → PayPal をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
PayPal + Microsoft Copilot
AI に PayPal ビジネスアカウントで作業させます。注文の作成と代金の回収、支払いの返金、請求書の作成・送信・督促、取引履歴と残高の検索、異議申し立ての確認、サブスクリプションプラン、サブスクリプション、Payouts のバッチの参照ができます。サンドボックスと本番に対応し、自分の REST アプリのキーを使います。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
PAYPAL_CLIENT_ID, PAYPAL_CLIENT_SECRET, PAYPAL_API_URL
ステップ 1 — 認証情報を取得
- PayPal ビジネスアカウントで developer.paypal.com にサインインし、Apps & Credentials を開きます。上部の切り替えで Sandbox と Live を選べます。それぞれに別のアプリとキーがあります。
- Default Application を使うか Create App をクリックし、タイプに Merchant を選びます。サンドボックスでは、アプリが代理で操作するサンドボックスのビジネスアカウントも選びます。
- アプリを開き、機能の一覧で AI に使わせたいものにチェックを入れます: Invoicing、Transaction Search、Subscriptions（カタログ商品も含みます）、Customer Disputes、Payouts。
- Client ID を
PAYPAL_CLIENT_IDに、Secret key 1（クリックすると表示されます）をPAYPAL_CLIENT_SECRETにコピーします。どちらも同じアプリの、同じ Sandbox または Live のセクションから取得してください。 PAYPAL_API_URLには、サンドボックスのキーならhttps://api-m.sandbox.paypal.com、本番のキーならhttps://api-m.paypal.comを、末尾のスラッシュなしで設定します。- コネクターをインストールします。Authorize with Provider の手順も PayPal の同意画面もありません。コネクターは client ID と secret を使い、あなたの REST アプリとしてサインインします。
- まず
paypal_get_balancesを実行し、キーが正しいアカウントにつながっているか確認します（アプリで Transaction Search が有効になっている必要があります）。
サインイン状態の維持: コネクターは client ID と secret でアクセストークンを取得し、期限が切れる前に自動で更新します。サインインをやり直す必要はありません。
新しい機能の反映には時間がかかります: すでにトークンを発行したアプリに新しく機能を追加した場合、PayPal での反映に最大 9 時間かかることがあります。それまでは該当する呼び出しが 403 NOT_AUTHORIZED を返すため、必要な機能は最初のインストール前にすべてチェックしておいてください。
支払いとメール: paypal_capture_order、paypal_refund_capture、paypal_cancel_subscription は本番アカウントで実際のお金を動かしたり止めたりします。paypal_send_invoice、paypal_remind_invoice、paypal_cancel_invoice は顧客にメールを送ります。AI は実行前に何が起きるか（金額、通貨、顧客、ID）を正確に伝え、あなたの承認を待ちます。売上確定と返金にはリクエスト ID が付くため、再試行しても二重に実行されません。
権限と読み取り専用の設定: アプリが使えるのはチェックを入れた機能だけです。AI に使わせたくない機能はチェックしないでください。読み取り専用にするには、paypal_create_order、paypal_capture_order、paypal_refund_capture、paypal_create_draft_invoice、paypal_send_invoice、paypal_remind_invoice、paypal_cancel_invoice、paypal_cancel_subscription を無効にします。まずはサンドボックスのキーで安全にすべて試せます。
インストール時はオフ: paypal_delete_draft_invoice は、下書きまたは送信予定の請求書を完全に削除します。AI に下書きを削除させたい場合だけオンにしてください。送信済みの請求書は代わりに paypal_cancel_invoice で取り消します。
注文と返金: paypal_create_order の時点では何も請求されません。返される承認リンクを購入者が開いて承認したあとで、初めて paypal_capture_order で代金を回収できます。paypal_refund_capture は売上を全額返金するか、金額を指定すれば一部を返金します。上限は過去の返金を差し引いた残額です。
請求書と取引履歴: paypal_create_draft_invoice で作った請求書は、paypal_send_invoice で送るまでメールされません。督促メールは 1 日 2 回までです。paypal_search_transactions は 1 回の呼び出しで最大 31 日分を扱い（それより長い期間は月ごとに照会します）、3 年前までさかのぼれます。新しい取引と残高は最大 3 時間遅れて反映されます。異議申し立ては 180 日前までさかのぼれます。
よくあるエラー: 401 invalid_client または invalid_token は、client ID か secret が間違っているか、キーの環境が PAYPAL_API_URL と一致していないことを示します（サンドボックスのキーにはサンドボックスの URL、本番のキーには本番の URL が必要です）。403 NOT_AUTHORIZED または PERMISSION_DENIED は、その機能がアプリでチェックされていないか、チェックしてから 9 時間たっていないことを示します。422 UNPROCESSABLE_ENTITY は違反した業務ルールを示します。たとえば ORDER_NOT_APPROVED（購入者がまだ承認していない）、AMOUNT_MISMATCH、CAPTURE_FULLY_REFUNDED などです。429 RATE_LIMIT_REACHED は PayPal がアプリのリクエストを制限していることを示します。1 分待ってからやり直してください。
このコネクターは、カード決済と支払い方法の保存（vaulting）、Webhook、Payouts の送金、異議申し立ての受け入れや回答、サブスクリプションプランの編集は扱いません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Microsoft Copilot にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name（例:
AnythingMCP）、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
PayPalのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
paypal_create_order | Create a checkout order (nothing is charged yet) |
paypal_get_order | Read one checkout order: status (CREATED, APPROVED, COMPLETED, VOIDED, ...), amounts, payer, and for completed orders the captures under… |
paypal_capture_order | Collect the money of an order the buyer has approved (intent CAPTURE) |
paypal_get_capture | Read one captured payment: amount, status (COMPLETED, PENDING, PARTIALLY_REFUNDED, REFUNDED, DECLINED), seller fees and net amount, and… |
paypal_refund_capture | Refund a captured payment, in full (no amount) or in part |
paypal_get_refund | Read one refund: amount, status (COMPLETED, PENDING, FAILED, CANCELLED), note to the payer and the capture it belongs to |
paypal_get_authorization | Read one authorized payment (an order created with intent AUTHORIZE): amount, status (CREATED, CAPTURED, PARTIALLY_CAPTURED, VOIDED… |
paypal_list_invoices | List invoices, newest first, with id, number, status, recipient, amount and due date |
paypal_search_invoices | Search invoices by recipient, number, status, currency, dates or amount (all filters combined with AND) |
paypal_create_draft_invoice | Create a draft invoice |
paypal_get_invoice | Read one invoice: status, recipient, items, amounts, due amount, payments and refunds recorded on it, and the payer link (links[] rel… |
paypal_send_invoice | Send a draft invoice |
paypal_remind_invoice | Email a payment reminder for a sent, unpaid invoice (PayPal allows 2 reminders a day) |
paypal_cancel_invoice | Cancel a sent invoice so it can no longer be paid; by default the recipient is told by email |
paypal_delete_draft_invoice | Delete a draft or scheduled invoice for good (sent invoices are cancelled with paypal_cancel_invoice instead) |
paypal_search_transactions | Search the account history (Transaction Search): payments received and sent, refunds, fees, transfers and their payer and cart details |
paypal_get_balances | Read the account balances per currency (available, withheld and total), now or as of a past time: balances[] with as_of_time |
paypal_list_disputes | List disputes, claims and chargebacks raised against the account (last 180 days), with dispute_id, reason, status, dispute_state, amount… |
paypal_get_dispute | Read one dispute in full: reason, status, amounts, disputed transactions, messages, offers, evidence and the deadline to respond… |
paypal_list_products | List catalog products (the products subscription plans belong to): id, name, description, type and dates |
paypal_get_product | Read one catalog product: name, description, type (PHYSICAL, DIGITAL, SERVICE), category, image and home URLs |
paypal_list_plans | List subscription plans, optionally for one product: id, name, status (CREATED, ACTIVE, INACTIVE), product_id and dates |
paypal_get_plan | Read one subscription plan: billing cycles with prices and frequency, trial periods, setup fee, taxes and payment failure settings |
paypal_list_subscriptions | List subscriptions, filtered by plan and status: id, status, plan_id, subscriber, start time and next billing time |
paypal_get_subscription | Read one subscription: status, plan, subscriber (name, email, shipping address), billing info (outstanding balance, last payment, next… |
paypal_list_subscription_transactions | List the payments of one subscription between two times: id, status, amounts with fees and net, payer and time |
paypal_cancel_subscription | Cancel a subscription for good: no further payments are collected and it cannot be reactivated |
paypal_get_payout_batch | Read one payout batch: batch status and totals, and its items (receiver, amount, status, fees, errors) |
プロンプトの例
- 「PayPal の現在の残高はいくら？過去 7 日間に入金された支払いも教えて。」
- 「Acme Ltd 宛ての請求書の下書きを作成して。コンサルティング 10 時間、単価 90 EUR、支払期限は 30 日後で。送信する前に内容を見せて。」
- 「私の対応を待っている異議申し立てはどれ？それぞれの回答期限も教えて。」
- 「Pro Monthly プランの有効なサブスクリプションを一覧にして、支払いに失敗しているものを教えて。」
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?