インストール不要。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 + Gemini
ソフトウェア販売の 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 — Gemini にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、
geminiを再起動します。 - Gemini CLI で
/mcpを実行します（またはシェルでgemini mcp list）。anythingmcpが接続済みとして表示されるはずです。 - プロンプトを入力しましょう。Gemini CLI が
Paddle Billingのツールを呼び出せるようになりました。
利用可能なツール
| 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
Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。
次のステップ
このガイドは役に立ちましたか?