跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Paddle Billing，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
Paddle Billing，软件销售的 Merchant of Record：商品、价格和折扣，带地址和企业信息的客户，支持预览、暂停和恢复的订阅，交易和 PDF 发票，退款和抵扣，CSV 报表，收入和 MRR 指标，事件和 Webhook 通知。支持正式环境和沙盒；取消订阅和一次性扣款在安装时关闭。
试试这样问
Paddle Billing 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Paddle Billing、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Paddle Billing + ChatGPT
Paddle Billing，软件销售的 Merchant of Record：商品、价格和折扣，带地址和企业信息的客户，支持预览、暂停和恢复的订阅，交易和 PDF 发票，退款和抵扣，CSV 报表，收入和 MRR 指标，事件和 Webhook 通知。支持正式环境和沙盒；取消订阅和一次性扣款在安装时关闭。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
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。
可读取的内容：目录，即带价格的商品，带计费周期、试用期、按国家覆盖的价格和数量限制的价格，以及带代码、类型、使用上限、已使用次数和到期时间的折扣；客户（可按邮箱或文本搜索）及其地址、企业信息（公司名称、注册号、增值税号、开票联系人）和各币种的抵扣余额；订阅，包括状态、项目、计费周期、下次扣款日期以及已计划的暂停、取消或恢复，可选附带下次扣款的预览；交易（结账、续订、发票），包括总额、税费明细、带错误代码的付款记录和发票号，可按客户、订阅、状态、发票号或开票、创建日期筛选；调整（退款、抵扣、拒付）及其审批状态；以前生成的报表；与 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 返回一个临时 PDF 链接，大约一小时后失效。报表在后台生成：先调用 paddle_create_report，再用 paddle_get_report 查询直到状态为 ready，然后用 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 — 安装 adapter
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 — 在 ChatGPT 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件，仅付费套餐可用，不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加；在 Enterprise 和 Edu 中，管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins，点击 Add，然后选择 Add custom MCP server。
- 填写名称，例如 Name:
Paddle Billing。 - 在 Connection 下的 Server URL 中填入
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID，Authentication 保持为 OAuth。 - 选择 I understand and want to continue，然后点击 Create as a plugin。ChatGPT 提示时，登录 AnythingMCP 并允许访问。
- 在个人插件中安装这个新插件，然后在对话中输入 @ 并选择它。
可用工具
| 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
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明，Free 套餐不在其列。
下一步
这份指南对你有帮助吗?