インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Paddle Billing をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
ソフトウェア販売の Merchant of Record である Paddle Billing：商品、価格、割引、住所と事業者情報付きの顧客、プレビュー・一時停止・再開に対応したサブスクリプション、取引と PDF 請求書、返金とクレジット、CSV レポート、売上と MRR の指標、イベントと Webhook 通知。本番とサンドボックスに対応し、解約と単発請求はインストール時にオフです。
こう聞いてみよう
Paddle Billing のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Paddle Billing をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Paddle Billing + Microsoft Copilot
ソフトウェア販売の Merchant of Record である Paddle Billing：商品、価格、割引、住所と事業者情報付きの顧客、プレビュー・一時停止・再開に対応したサブスクリプション、取引と PDF 請求書、返金とクレジット、CSV レポート、売上と MRR の指標、イベントと Webhook 通知。本番とサンドボックスに対応し、解約と単発請求はインストール時にオフです。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
PADDLE_API_KEY, PADDLE_API_URL
ステップ 1 — 認証情報を取得
設定は約 2 分です。本番またはサンドボックスの Paddle Billing アカウントと、そこで API キーを作成する権限が必要です。
- Paddle で Developer tools、Authentication、API keys を開き、キーを作成します。
- ツールに必要な権限をキーに付与します。商品、価格、割引、顧客、住所、事業者、サブスクリプション、取引、調整、レポート、通知、イベントには読み取りを、AI に変更させたいエンティティにだけ書き込みを付けます。権限のないエンティティへの呼び出しは 403 を返します。
- キーを
PADDLE_API_KEYに貼り付けます。引用符やBearerは付けません。本番キーはpdl_live_apikey_、サンドボックスキーはpdl_sdbx_apikey_で始まります。 PADDLE_API_URLを、本番アカウントならhttps://api.paddle.com、サンドボックスアカウントならhttps://sandbox-api.paddle.comに設定します。末尾のスラッシュは付けません。キーは自分の環境のホストでしか使えません。- コネクタをインストールし、
paddle_list_event_typesを実行します。ID は不要で、キーが確認できます。
コネクタはキーを Bearer トークンとして送り、Paddle-Version ヘッダーで API バージョン 1 を固定します。対象は Paddle Billing のみで、Paddle Classic には対応しません。
読み取れるデータ: カタログ、つまり価格付きの商品、請求サイクル・トライアル期間・国別上書き・数量制限を持つ価格、コード・種類・利用上限・利用回数・有効期限を持つ割引；メールアドレスまたはテキストで検索できる顧客と、その住所、事業者情報（会社名、法人番号、VAT 番号、請求先の連絡先）、通貨ごとのクレジット残高；ステータス、品目、請求期間、次回請求日、予定された一時停止・解約・再開を含むサブスクリプション（必要なら次回請求のプレビュー付き）；合計、税の内訳、エラーコード付きの支払い、請求書番号を含む取引（チェックアウト、更新、請求書）。顧客、サブスクリプション、ステータス、請求書番号、請求日または作成日で絞り込めます；承認ステータス付きの調整（返金、クレジット、チャージバック）；過去に作成したレポート；Paddle ダッシュボードと同じ日別の純売上、MRR、アクティブ購読者数；過去 90 日間のイベント；通知の送信先、送信された Webhook とメール通知、エンドポイントが返した HTTP ステータスと本文付きの各配信試行です。
書き込める内容: 商品、価格、割引、顧客、住所、事業者の作成と更新（アーカイブは status: archived で行い、Paddle では何も削除されません）；サブスクリプションの更新（proration_billing_mode を指定したプランや数量の変更、割引、請求日、住所、回収方法）、一時停止と再開、トライアル中のサブスクリプションの有効化（最初の支払いが即時に回収されます）；取引の作成と更新。顧客が支払うチェックアウト（その checkout.url）か、collection_mode: manual と status: billed による請求書です；paddle_create_adjustment による取引の返金またはクレジット（返金は Paddle の審査が終わるまで pending_approval です）；カスタマーポータルのリンク作成、CSV レポートの依頼、通知の再送です。予定された一時停止や解約は paddle_update_subscription と scheduled_change: null で取り消します。
まずプレビュー: paddle_preview_subscription_update、paddle_preview_transaction、paddle_preview_prices は何も保存せずに請求額、税、合計を計算します。プラン変更の前に AI はプレビューを実行し、即時の請求額を示してあなたの同意を待ちます。本番ホストでは、請求済みの取引、サブスクリプションの変更、有効化、返金は実際のお金を動かします。
インストール時はオフ: paddle_cancel_subscription（即時の解約は取り消せません）と paddle_create_subscription_charge（保存済みの支払い方法に単発の請求をします）です。ワークスペースの管理者が意図的にオンにします。
データ形式: すべての応答に data と meta.request_id があります。ID には接頭辞が付きます：pro_ 商品、pri_ 価格、dsc_ 割引、ctm_ 顧客、add_ 住所、biz_ 事業者、sub_ サブスクリプション、txn_ 取引、adj_ 調整、rep_ レポート、ntf_ 通知。金額は通貨の最小単位の文字列です。USD の "1999" は 19.99 で、JPY には小数がありません。取引の合計は details.totals（subtotal、discount、tax、total、grand_total）に、品目ごとの金額は details.line_items にあります。日付は UTC の RFC 3339 です。複数の値を取るフィルターはカンマ区切りです。
ファイルとレポート: paddle_get_transaction_invoice と paddle_get_adjustment_credit_note は約 1 時間で期限切れになる一時的な PDF リンクを返します。レポートはバックグラウンドで作成されます。paddle_create_report の後、ステータスが ready になるまで paddle_get_report を確認し、paddle_get_report_csv で数分で期限切れになる CSV リンクを取得します。レポートの種類は、取引、取引明細、調整、調整明細、割引、商品と価格、残高、入金照合、チェックアウト、サブスクリプションです。
ページング: 一覧ツールは最大 per_page 件（既定 50 件、最大 200 件）を返します。meta.pagination.has_more が true の間、AI は meta.pagination.next の URL から after の値を取り出し、after として渡します。
制限: Paddle の上限は IP アドレスあたり毎分 240 リクエストで、それを超えると 429 を返します。
よくあるエラー: エラーは error.type、error.code、error.detail で返り、error.errors に無効なフィールドが並びます。401 はキーの誤りか、別環境のキー（本番ホストにサンドボックスキー、またはその逆）を意味します。403 forbidden はそのエンティティへの権限がキーにないことを意味します。Paddle でキーを編集して権限を追加してください。404 entity_not_found は ID の誤りか、別環境の ID を意味します。
このコネクタは何も削除せず、通知の送信先の作成や変更も行わず、Paddle Classic のアカウントには対応しません。
ステップ 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 ウィンドウで試します。
Paddle Billingのツールが必要になる依頼をしてみましょう。 - 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 |
|---|---|
paddle_list_products | List products in the catalog with name, tax category, type, status and custom data |
paddle_get_product | Get one product by id (pro_...) with its name, description, tax category, image URL, status and custom data; include prices to list its… |
paddle_create_product | Create a catalog product (what you sell) |
paddle_update_product | Update a product: name, description, tax category, image, custom data, or archive it with status archived |
paddle_list_prices | List prices with their product id, unit price (amount in the lowest currency unit), billing cycle, trial period, quantity limits and status |
paddle_get_price | Get one price by id (pri_...): product, description, unit price and overrides per country, billing cycle, trial period, tax mode and… |
paddle_create_price | Create a price for a product: amount and currency, optional billing cycle (subscription) and trial, country overrides and quantity limits |
paddle_update_price | Update a price: description, name, amount, billing cycle, trial, overrides, quantity limits, custom data, or archive it |
paddle_list_discounts | List discounts with code, type (flat, flat_per_seat, percentage), amount, recurring settings, usage limit, times used, expiry and status |
paddle_get_discount | Get one discount by id (dsc_...): code, type, amount, currency, whether it recurs and for how many intervals, usage limit, times used… |
paddle_create_discount | Create a discount: percentage or flat amount, optional checkout code, recurring behaviour, usage limit, product or price restrictions and… |
paddle_update_discount | Update a discount: amount, code, recurring settings, limits, restrictions, expiry, custom data, or archive it with status archived |
paddle_list_customers | List customers with name, email, locale, marketing consent and status |
paddle_get_customer | Get one customer by id (ctm_...): name, email, locale, marketing consent, status, custom data and timestamps |
paddle_create_customer | Create a customer by email (unique per account) with optional name, locale and custom data |
paddle_update_customer | Update a customer: email, name, locale, custom data, or archive it with status archived |
paddle_list_customer_addresses | List the addresses saved for a customer (add_... ids): country, postal code, region, city and lines |
paddle_create_customer_address | Add an address to a customer |
paddle_update_customer_address | Update a customer address: lines, city, postal code, region, country, custom data, or archive it |
paddle_list_customer_businesses | List the businesses saved for a customer (biz_... ids): company name, company number, tax identifier (VAT number) and contacts, used for… |
paddle_create_customer_business | Add a business to a customer for B2B billing: name, company number, VAT or tax id and invoice contacts |
paddle_update_customer_business | Update a customer business: name, company number, tax identifier, contacts, custom data, or archive it |
paddle_list_customer_credit_balances | Credit balances of a customer per currency: available, reserved and used credit created by adjustments (credits) on their subscriptions |
paddle_create_customer_portal_session | Create authenticated links to the Paddle customer portal for a customer, where they can update payment methods, see invoices and cancel |
paddle_list_subscriptions | List subscriptions with status, customer, address, items (price and quantity), currency, billing period, next billing date and any… |
paddle_get_subscription | Get one subscription by id (sub_...): status, customer, items, discount, billing cycle and current period, next billing date, scheduled… |
paddle_preview_subscription_update | Preview what an update to a subscription would charge or credit, without changing it: immediate transaction, next transaction and the… |
paddle_update_subscription | Update a subscription: change items or quantities (upgrade, downgrade, add-ons) with a proration mode, apply a discount, change billing… |
paddle_pause_subscription | Pause a subscription at the end of the billing period (default) or immediately, optionally with a date to resume automatically |
paddle_resume_subscription | Resume a paused subscription now (effective_from immediately) or at a given date-time, or change the date of a scheduled resume |
paddle_cancel_subscription | Cancel a subscription at the end of the billing period (default, can be undone by removing the scheduled change) or immediately (final) |
paddle_activate_subscription | End the trial of a trialing subscription now and start billing it: the first payment is collected immediately |
paddle_create_subscription_charge | Bill a one-time charge on a subscription (e.g. extra seats or a setup fee), now or with the next renewal |
paddle_list_transactions | List transactions (checkouts, renewals, invoices) with status, customer, subscription, items, totals in the lowest currency unit, invoice… |
paddle_get_transaction | Get one transaction by id (txn_...): status, items, totals and tax breakdown (details.totals, amounts in the lowest currency unit)… |
paddle_create_transaction | Create a transaction: a draft or ready checkout for a customer to pay (returns checkout.url), or an invoice for manual collection (status… |
paddle_update_transaction | Update a draft or ready transaction: items, customer, address, business, currency, discount, billing details, or set status billed or… |
paddle_preview_transaction | Preview a transaction without creating it: line items, tax, discounts and totals for given prices, customer or location |
paddle_get_transaction_invoice | Get a temporary link to the PDF invoice of a billed or completed transaction |
paddle_preview_prices | Localized price preview for a list of prices: subtotal, tax, discount and total per item in the customer's currency and country, as on a… |
paddle_list_adjustments | List adjustments (refunds, credits, chargebacks) with action, status (pending_approval, approved, rejected, reversed), transaction… |
paddle_create_adjustment | Refund or credit a billed or completed transaction, fully or for some items |
paddle_get_adjustment_credit_note | Get a temporary link to the PDF credit note of an approved adjustment |
paddle_list_reports | List reports you requested with type, status (pending, ready, failed, expired), filters, row count and expiry |
paddle_create_report | Request a CSV report: transactions, transaction_line_items, adjustments, adjustment_line_items, discounts, products_prices, balance… |
paddle_get_report | Get one report by id (rep_...): type, status, filters, number of rows and when it expires |
paddle_get_report_csv | Get a temporary download link for a ready report as CSV |
paddle_get_revenue_metrics | Net revenue per day for a date range in the account balance currency, as shown in the Paddle dashboard (amounts in the lowest currency unit) |
paddle_get_mrr_metrics | Monthly recurring revenue per day for a date range, as shown in the Paddle dashboard (amounts in the lowest currency unit) |
paddle_get_active_subscribers_metrics | Number of active subscribers per day for a date range, as shown in the Paddle dashboard metrics |
paddle_list_event_types | List the event types Paddle can send (transaction.completed, subscription.canceled, ...) with a description and the API version of each |
paddle_list_events | List events (what happened in the account): event_type, occurred_at and the full entity in data |
paddle_list_notification_settings | List notification destinations (webhook URLs and emails) with their subscribed event types, active flag and API version |
paddle_list_notifications | List webhook and email notifications sent for events, with status (delivered, failed, needs_retry, not_attempted), times attempted and the… |
paddle_get_notification | Get one notification by id (ntf_...): status, event payload, destination, attempts and last error |
paddle_list_notification_logs | List the delivery attempts of a notification with the HTTP status and response body your endpoint returned, to debug failing webhooks |
paddle_replay_notification | Send a notification again to its destination, e.g. after fixing a failing webhook endpoint |
プロンプトの例
- 「先月の日別の純売上と MRR はいくらで、月末のアクティブ購読者数は何人でしたか？」
- 「顧客 [email protected] を探して、そのサブスクリプションをステータス、品目、次回請求日付きで見せてください。」
- 「このサブスクリプションを日割り計算で年額プランに変更した場合のプレビューを出して、何かを変更する前に即時の請求額を見せてください。」
- 「今週の past_due の取引を、顧客、金額、支払いエラー付きで一覧にしてください。」
- 「過去 24 時間に失敗した Webhook 通知はどれで、こちらのエンドポイントは何と応答しましたか？」
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" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?