Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Paddle Billing одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
AnythingMCP есть в каталоге коннекторов Claude: добавьте его в Claude в один клик (откроется в новой вкладке), затем войдите и выберите, какие MCP-серверы может использовать Claude.
Кратко
Paddle Billing, merchant of record для продажи софта: товары, цены и скидки, клиенты с адресами и компаниями, подписки с предпросмотром, паузой и возобновлением, транзакции и PDF-счета, возвраты и кредиты, CSV-отчёты, метрики выручки и MRR, события и webhook-уведомления. Live или sandbox; отмена подписки и разовые списания отключены при установке.
Попробуй спросить
Примеры промптов для Paddle Billing
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Paddle Billing, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Paddle Billing + Claude
Paddle Billing, merchant of record для продажи софта: товары, цены и скидки, клиенты с адресами и компаниями, подписки с предпросмотром, паузой и возобновлением, транзакции и PDF-счета, возвраты и кредиты, CSV-отчёты, метрики выручки и MRR, события и webhook-уведомления. Live или sandbox; отмена подписки и разовые списания отключены при установке.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
PADDLE_API_KEY, PADDLE_API_URL
Шаг 1 — Получите учётные данные
Настройка занимает около 2 минут. Нужен аккаунт Paddle Billing, live или sandbox, и право создавать в нём API-ключи.
- В Paddle откройте Developer tools, Authentication, API keys и создайте ключ.
- Выдайте ключу права, которые нужны инструментам: чтение для товаров, цен, скидок, клиентов, адресов, компаний, подписок, транзакций, корректировок, отчётов, уведомлений и событий, а запись только для тех сущностей, которые ИИ должен менять. Вызов по сущности без права отвечает 403.
- Вставьте ключ в
PADDLE_API_KEYбез кавычек и без префиксаBearer. Live-ключи начинаются сpdl_live_apikey_, sandbox-ключи сpdl_sdbx_apikey_. - Укажите в
PADDLE_API_URLhttps://api.paddle.comдля live-аккаунта илиhttps://sandbox-api.paddle.comдля sandbox-аккаунта, без косой черты в конце. Ключ работает только на хосте своего окружения. - Установите коннектор и запустите
paddle_list_event_types: ему не нужны id, и он подтверждает ключ.
Коннектор передаёт ключ как bearer-токен и фиксирует версию API 1 заголовком Paddle-Version. Он работает только с Paddle Billing, не с Paddle Classic.
Что он читает: каталог, то есть товары с их ценами, цены с периодом оплаты, пробным периодом, переопределениями по странам и ограничениями количества, а также скидки с кодом, типом, лимитом использования, числом использований и сроком действия; клиентов (поиск по e-mail или тексту) с их адресами, компаниями (название, регистрационный номер, номер плательщика НДС, контакты для счетов) и кредитными балансами по валютам; подписки со статусом, позициями, расчётным периодом, датой следующего списания и запланированной паузой, отменой или возобновлением, при желании с предпросмотром следующего списания; транзакции (checkout, продления, счета) с суммами, разбивкой налогов, платежами с кодами ошибок и номером счёта, с фильтрами по клиенту, подписке, статусу, номеру счёта или дате выставления либо создания; корректировки (возвраты, кредиты, чарджбэки) со статусом одобрения; ранее запрошенные отчёты; чистую выручку, MRR и число активных подписчиков по дням, как на дашборде Paddle; события за последние 90 дней; адресатов уведомлений, отправленные webhook- и e-mail-уведомления и каждую попытку доставки с HTTP-статусом и ответом вашего эндпоинта.
Что он записывает: создаёт и изменяет товары, цены, скидки, клиентов, адреса и компании (архивируются через status: archived; в Paddle ничего не удаляется); изменяет подписки (смена тарифа или количества с proration_billing_mode, скидка, дата списания, адрес, способ оплаты), ставит их на паузу, возобновляет и активирует подписку на пробном периоде, при этом первый платёж списывается сразу; создаёт и изменяет транзакции: checkout, который оплачивает клиент (его checkout.url), или счёт с collection_mode: manual и status: billed; делает возврат или кредит по транзакции через paddle_create_adjustment (возвраты имеют статус pending_approval, пока Paddle их не проверит); создаёт ссылки на клиентский портал, заказывает CSV-отчёты и повторно отправляет уведомления. Запланированная пауза или отмена снимается через paddle_update_subscription с scheduled_change: null.
Сначала предпросмотр: paddle_preview_subscription_update, paddle_preview_transaction и paddle_preview_prices рассчитывают списания, налоги и суммы, ничего не сохраняя. Перед сменой тарифа ИИ запускает предпросмотр, показывает вам немедленное списание и ждёт вашего «да». На live-хосте выставленные транзакции, изменения подписок, активации и возвраты двигают настоящие деньги.
Отключено при установке: paddle_cancel_subscription (немедленная отмена окончательна) и paddle_create_subscription_charge (разовое списание с сохранённого способа оплаты). Администратор workspace включает их осознанно.
Форматы данных: в каждом ответе есть data и meta.request_id. У id есть префикс: pro_ товар, pri_ цена, dsc_ скидка, ctm_ клиент, add_ адрес, biz_ компания, sub_ подписка, txn_ транзакция, adj_ корректировка, rep_ отчёт, ntf_ уведомление. Суммы передаются строками в минимальных единицах валюты: "1999" в USD это 19,99, у JPY нет дробной части. Итоги транзакции лежат в details.totals (subtotal, discount, tax, total, grand_total), по позициям в details.line_items. Даты в формате RFC 3339 в UTC. Фильтры с несколькими значениями перечисляются через запятую.
Файлы и отчёты: paddle_get_transaction_invoice и paddle_get_adjustment_credit_note возвращают временную ссылку на PDF, которая истекает примерно через час. Отчёты готовятся в фоне: paddle_create_report, затем paddle_get_report, пока статус не станет ready, затем paddle_get_report_csv для ссылки на CSV, которая истекает через несколько минут. Типы отчётов: транзакции, позиции транзакций, корректировки, позиции корректировок, скидки, товары и цены, баланс, сверка выплат, checkout и подписки.
Постраничная выдача: инструменты списков возвращают до per_page элементов (по умолчанию 50, максимум 200). Пока meta.pagination.has_more равно true, ИИ берёт значение after из URL в meta.pagination.next и передаёт его как after.
Ограничения: Paddle допускает 240 запросов в минуту с одного IP-адреса, сверх этого отвечает 429.
Частые ошибки: ошибки приходят как error.type, error.code и error.detail, а error.errors перечисляет неверные поля. 401 означает неверный ключ или ключ другого окружения (sandbox-ключ на live-хосте или наоборот). 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 — Добавьте коннектор в Claude
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Рекомендуемый путь: работает в claude.ai web без редактирования конфигурационных файлов.
- Открой в Claude Customize → Connectors.
- Нажми +, затем Add custom connector.
- Введи название, например
Paddle Billing, и URL удалённого MCP-сервераhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Add. - Нажми Connect и войди в AnythingMCP (OAuth), чтобы разрешить доступ.
Все инструменты ниже появятся в чате: начинайте писать промпты.
Доступные инструменты
| 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: клиент, сумма и ошибка платежа.»
- «Какие webhook-уведомления не доставлены за последние 24 часа и что ответил наш эндпоинт?»
FAQ
Работает ли с Claude Code так же как с Claude Desktop? Да, оба указывайте на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Следующие шаги
- Страница коннектора
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
- Подключить к Microsoft Copilot
Это руководство помогло?