Руководство по коннектору12 мин чтенияMCP-инструментов: 577 языков

Как подключить Paddle Billing к Meta Muse через MCP

Paddle Billing, merchant of record для продажи софта: товары, цены и скидки, клиенты с адресами и компаниями, подписки с предпросмотром, паузой и возобновлением, транзакции и PDF-счета, возвраты и кредиты, CSV-отчёты, метрики выручки и MRR, события и webhook-уведомления. Live или sandbox; отмена подписки и разовые списания отключены при установке.

HCАвтор: команда HelpCodeОбновлено 30 окт. 2026 г.12 мин чтения Открытый код на GitHub

Установить Paddle Billing в Cloud — бесплатно на пробу Читать пошаговое руководство

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Paddle Billing

Paddle Billing, the merchant of record for software sales: products, prices and discounts, customers with addresses and businesses, subscriptions (update, pause, resume, cancel, previews), transactions and PDF invoices, refunds and credits, reports, revenue and MRR metrics, events and webhook notifications. Live or sandbox.

инструментов

Регион

INTL

Категория

Платежи

Аутентификация

Bearer Token

Требуемые env-vars

PADDLE_API_KEYPADDLE_API_URL

Установить в Cloud одним кликом

7 дней бесплатно · Без карты

7 дней бесплатно
Без банковской карты
GDPR и готовность к SOC 2
Данные в ЕС, журналы аудита
Открытый код на GitHub
Open source · AGPL-3.0
Работает с ChatGPT, Claude, Gemini
Любой MCP-совместимый клиент

Пропустите установку. Заработает меньше чем за 2 минуты.

Начните бесплатный период на cloud.anythingmcp.com, добавьте Paddle Billing одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.

Начать бесплатный период

Кратко

Попробуй спросить

Примеры промптов для Paddle Billing

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

Paddle Billing · live via MCP

Claude — это AI, он может ошибаться. Проверяйте ответы.

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Paddle Billing, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Paddle Billing + Meta Muse

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

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_URL https://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 — Добавьте коннектор в Muse

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.

В Muse открой Settings → Connectors и выбери Add custom connector.
Вставь URL MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
В чате попроси Muse о том, для чего нужны инструменты Paddle Billing.

Настроить коннектор можно и из чата: в вебе, в приложениях для iOS и Android или в WhatsApp. Отправь Muse это сообщение:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Muse подключается из облака Meta, поэтому 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: клиент, сумма и ошибка платежа.»
«Какие webhook-уведомления не доставлены за последние 24 часа и что ответил наш эндпоинт?»

FAQ

Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде: в вебе, в приложениях для iOS и Android и в WhatsApp.

Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.

Следующие шаги

Это руководство помогло?

Ваш агент для Paddle Billing в одном клике.

Установите коннектор, вставьте ключ, спросите Meta Muse. 7 дней бесплатно, без банковской карты.

Начать бесплатно в облаке Self-host с Docker Связаться с отделом продаж

Как подключить Paddle Billing к Meta Muse через MCP

Примеры промптов для Paddle Billing

Paddle Billing + Meta Muse

Предварительные требования

Шаг 1 — Получите учётные данные

Шаг 2 — Установите адаптер

Шаг 3 — Добавьте коннектор в Muse

Доступные инструменты

Примеры запросов

FAQ

Следующие шаги

Ваш агент для Paddle Billing в одном клике.

Похожие руководства

Как подключить Paddle Billing к ChatGPT через MCP

Как подключить Paddle Billing к Claude через MCP

Как подключить Paddle Billing к Microsoft Copilot через MCP

Как подключить Paddle Billing к Cursor через MCP

Как подключить Paddle Billing к Gemini через MCP

Paddle Billing в MCP: подписки, транзакции, счета и MRR в любом AI-агенте