Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте Zuora одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Zuora Billing REST API для одного тенанта: клиентские аккаунты, подписки и заказы с предпросмотром, продлением, приостановкой и возобновлением, счета с позициями и PDF, платежи, возвраты и кредит-ноты, каталог продуктов с тарифными планами, учёт потребления и чтение через ZOQL, Object Query и Data Query. OAuth2 client credentials, без входа через браузер. Отмена подписок, платежи и возвраты при установке отключены.
Попробуй спросить
Примеры промптов для Zuora
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Zuora, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Zuora + ChatGPT
Zuora Billing REST API для одного тенанта: клиентские аккаунты, подписки и заказы с предпросмотром, продлением, приостановкой и возобновлением, счета с позициями и PDF, платежи, возвраты и кредит-ноты, каталог продуктов с тарифными планами, учёт потребления и чтение через ZOQL, Object Query и Data Query. OAuth2 client credentials, без входа через браузер. Отмена подписок, платежи и возвраты при установке отключены.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
ZUORA_CLIENT_ID, ZUORA_CLIENT_SECRET, ZUORA_API_URL
Шаг 1 — Получите учётные данные
Настройка занимает около 5 минут. Нужен тенант Zuora и доступ к управлению его пользователями.
- В Zuora откройте Settings, Administration, Manage Users и выберите или создайте API-пользователя, роль которого даёт инструментам нужные права: доступ к API и права на чтение Billing и Payments, а также права на запись для инструментов, которые меняют данные.
- Откройте этого пользователя и создайте клиент в OAuth Clients. Скопируйте client id в
ZUORA_CLIENT_ID, а client secret вZUORA_CLIENT_SECRET. Секрет показывается только один раз; если он потерян, создайте новый клиент. - Укажите в
ZUORA_API_URLREST-хост вашего тенанта, без пути и без слэша в конце:https://rest.zuora.com(US Cloud 2),https://rest.na.zuora.com(US Cloud 1),https://rest.eu.zuora.com(EU),https://rest.ap.zuora.com(APAC) или хост песочницы:https://rest.apisandbox.zuora.com,https://rest.sandbox.na.zuora.com,https://rest.sandbox.eu.zuora.com,https://rest.test.zuora.com,https://rest.test.eu.zuora.comилиhttps://rest.test.ap.zuora.com. Хост виден в Zuora в сведениях о тенанте и в адресе документации API для вашего дата-центра. - Установите коннектор и запустите
zuora_list_products: он выведет каталог продуктов и подтвердит настройку.
Входа через браузер нет. AnythingMCP получает access token на /oauth/token этого хоста по OAuth2 client credentials grant и обновляет его до истечения срока. Клиент песочницы работает только на своём хосте песочницы. В тенанте с Multi-entity OAuth-клиент должен принадлежать той entity, которую вы хотите читать.
Что он читает: клиентские аккаунты через zuora_list_accounts (фильтры Object Query вроде ["status.EQ:Active", "balance.GT:0"]), zuora_get_account, zuora_get_account_summary (контакты, подписки, последние счета, платежи и потребление за один вызов) и zuora_list_account_payment_methods (маскированные номера); подписки через zuora_list_subscriptions, zuora_list_account_subscriptions и zuora_get_subscription; заказы через zuora_list_orders и zuora_get_order; счета через zuora_list_invoices (просроченные, например, с ["status.EQ:Posted", "balance.GT:0", "duedate.LT:2026-10-01"]), zuora_get_invoice, zuora_list_invoice_items и zuora_list_invoice_files (ссылки на PDF); платежи через zuora_list_payments и zuora_get_payment, возвраты через zuora_list_refunds и zuora_get_refund, кредит-ноты через zuora_list_credit_memos, zuora_get_credit_memo и zuora_list_credit_memo_items; каталог продуктов через zuora_list_products, zuora_get_product, zuora_list_product_rate_plans и zuora_get_product_rate_plan (id тарифных планов передаются в заказы как productRatePlanId); записи потребления через zuora_list_usages.
Запросы: zuora_query выполняет ZOQL по одному объекту, например SELECT Id, Name, Balance FROM Account WHERE Status = 'Active', а zuora_query_more получает следующую порцию. Для SQL по нескольким объектам с join и итогами zuora_create_data_query запускает задание Data Query, и ИИ вызывает zuora_get_data_query, пока queryStatus не станет completed; результат приходит временной ссылкой на скачивание в dataFile. zuora_list_data_queries показывает прошлые задания, zuora_describe_object перечисляет поля объекта (в XML). Все инструменты запросов только читают.
Что он записывает: zuora_create_account и zuora_update_account. Изменения подписок идут через заказы: zuora_preview_order показывает позиции счёта и суммы, ничего не сохраняя, затем zuora_create_order создаёт новую подписку, добавляет или убирает продукт либо меняет количество, цену или срок. zuora_renew_subscription продлевает срочную подписку без выставления счёта, zuora_suspend_subscription останавливает биллинг, пока zuora_resume_subscription его не возобновит. zuora_email_invoice отправляет проведённый счёт в PDF по email, zuora_create_credit_memo_from_invoice создаёт кредит-ноту по всем или отдельным позициям счёта (в статусе Draft, если auto_post не true), а zuora_create_usage загружает одну запись потребления. Всё это меняет то, что выставляется клиентам, поэтому ИИ сначала делает предпросмотр, показывает суммы и ждёт вашего «да». zuora_create_order с processing_options (runBilling, collectPayment) ещё и выставляет счёт и списывает деньги с клиента.
Отключены при установке: zuora_cancel_subscription, zuora_create_payment и zuora_refund_payment. Они двигают деньги или необратимы, поэтому администратор workspace включает их, когда они нужны команде.
Форматы данных: большинство ключей (account_key, subscription_key, invoice_key) принимают номер (A00000001, A-S00000001, INV00000001) или 32-символьный id; фильтрам вроде accountId нужен id. Суммы это десятичные числа в валюте аккаунта. Даты в формате YYYY-MM-DD; метки времени в часовом поясе тенанта, если не заканчиваются на Z. Ответы v1 содержат success: true или success: false с reasons (код и сообщение); ответы Object Query содержат data.
Постраничный вывод: списки Object Query (zuora_list_accounts, zuora_list_subscriptions, zuora_list_invoices, zuora_list_usages) возвращают до page_size записей (по умолчанию 10, не более 99) и nextPage, который ИИ передаёт обратно как cursor, пока он не исчезнет. Остальные списки принимают page и page_size и возвращают ссылку nextPage, пока есть ещё записи. ZOQL возвращает до 2 000 записей и done: false с queryLocator для остального.
Частые ошибки: 400 при получении токена значит, что Zuora не выдала токен: проверьте client id и secret и то, что ZUORA_API_URL соответствует дата-центру вашего тенанта. 401 означает неверный client id или secret либо не тот хост. 403 означает, что у API-пользователя нет нужного права. 404 означает неверный номер или id. Ошибки в ответах v1 могут приходить и с HTTP 200 и success: false; ИИ читает reasons. 429 означает, что достигнут лимит Zuora на одновременные запросы тенанта или на запросы пользователя в час: подождите и повторите.
С инструментами, включёнными при установке, коннектор не отменяет подписки, не проводит платежи и не делает возвраты. Он читает каталог продуктов, но не создаёт и не меняет продукты, тарифные планы и цены, не добавляет способы оплаты и ничего не удаляет.
Шаг 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 — Добавьте коннектор в ChatGPT
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
ChatGPT добавляет MCP-серверы как плагины на странице Plugins, в веб-версии и в платных планах. Режим разработчика для этого больше не нужен. В рабочем пространстве Business это могут только администраторы и владельцы; в Enterprise и Edu администратор может выдать право Create plugins with MCPs.
- Перейди на chatgpt.com/plugins, нажми Add, затем Add custom MCP server.
- Введи название, например Name:
Zuora. - В разделе 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 |
|---|---|
zuora_list_accounts | List customer accounts with Object Query: filter (e.g. status.EQ:Active, name.SW:Acme, balance.GT:0), choose fields, expand bill-to contact… |
zuora_get_account | Get one customer account by number or id: basic info, billing and payment settings, bill-to and sold-to contacts, balance and metrics |
zuora_get_account_summary | Get an account summary in one call: basic info, contacts, subscriptions, recent invoices, payments and usage, with balance and last payment |
zuora_list_account_payment_methods | List the payment methods of an account (cards, bank accounts, PayPal) with type, masked number, expiry, default flag and status |
zuora_create_account | Create a customer account with name, currency and bill-to contact, plus billing settings (bill cycle day, payment term, batch, auto-pay)… |
zuora_update_account | Update an account: name, notes, contacts, billing settings, auto-pay, default payment method, CRM id or custom fields |
zuora_list_subscriptions | List subscriptions with Object Query: filter by account, status (Active, Cancelled, Suspended, Expired, Draft), term dates or latest… |
zuora_list_account_subscriptions | List the subscriptions of one account with rate plans, charges, prices, quantities, terms and status, as Zuora shows them on the account |
zuora_get_subscription | Get one subscription by number or id with term, renewal settings, status, rate plans, charges (price, quantity, billing period) and owner… |
zuora_list_orders | List orders (the records of subscription changes: new subscription, add product, update, renew, cancel) by status and date range, with… |
zuora_get_order | Get one order by order number with its order actions, the subscriptions it created or changed, and the order metrics |
zuora_preview_order | Preview an order without saving it: the invoice items, charge metrics and amounts a new subscription or a change would produce |
zuora_create_order | Create an order: new subscription, add or remove a product, change quantity or price, renew or change terms |
zuora_renew_subscription | Renew a termed subscription for another renewal term now, without billing |
zuora_suspend_subscription | Suspend an active subscription: billing stops from the suspend date until it is resumed |
zuora_resume_subscription | Resume a suspended subscription today, on a date or after a number of periods; billing restarts from the resume date |
zuora_cancel_subscription | Cancel a subscription at the end of the term, at the end of the last invoiced period or on a date |
zuora_list_invoices | List invoices with Object Query: filter by account, status (Draft, Posted, Canceled), balance, invoice or due date, expand invoice items or… |
zuora_get_invoice | Get one invoice by number or id with account, dates, amounts, tax, balance, status and payment and credit applications |
zuora_list_invoice_items | List the items of an invoice: charge name, subscription, service period, quantity, unit price, amount and tax per line |
zuora_list_invoice_files | List the PDF files generated for an invoice with their download URLs (the newest first) |
zuora_email_invoice | Email a posted invoice as PDF to the bill-to contact, to the extra addresses of the account or to given addresses |
zuora_list_payments | List payments with amount, applied and unapplied amount, status, type, effective date and account |
zuora_get_payment | Get one payment by number or id with amount, applied, unapplied and refunded amounts, gateway state, payment method and dates |
zuora_create_payment | Create a payment: an External payment records money received, an Electronic one charges the payment method through the gateway |
zuora_refund_payment | Refund a payment: Electronic sends money back through the gateway, External records a refund made elsewhere |
zuora_list_refunds | List refunds with amount, status, type, method, refund date, account and the payment or credit memo they come from |
zuora_get_refund | Get one refund by number or id with amount, status, method, gateway state, reason code and source payment or credit memo |
zuora_list_credit_memos | List credit memos with amount, applied, refunded and unapplied amounts, status, date, account and the invoice they refer to |
zuora_get_credit_memo | Get one credit memo by number or id with amounts, status, reason code, dates and the invoice it refers to |
zuora_list_credit_memo_items | List the items of a credit memo: charge, service period, amount, applied and refunded amount and tax per line |
zuora_create_credit_memo_from_invoice | Create a credit memo from a posted invoice, for all or some of its items |
zuora_list_products | List the product catalog: products with their rate plans and charges (model, billing period, prices per currency and tiers) |
zuora_get_product | Get one catalog product by SKU or id with its rate plans and charges, prices per currency and tiers |
zuora_list_product_rate_plans | List the rate plans of one product with effective dates, status and, with charge definitions, the charges and prices |
zuora_get_product_rate_plan | Get one product rate plan by id or number with its charges, prices, billing periods and effective dates |
zuora_list_usages | List usage records with Object Query: filter by account, unit of measure, start date or rating status, page with a cursor |
zuora_create_usage | Upload one usage record for usage-based charges: account, unit of measure, quantity and start time, optionally tied to a subscription or… |
zuora_query | Run a ZOQL query (SELECT fields FROM object WHERE ...), e.g |
zuora_query_more | Get the next batch of a ZOQL query: pass the queryLocator of the previous answer while done is false |
zuora_create_data_query | Start a Data Query job: SQL across objects with joins and aggregates, e.g |
zuora_get_data_query | Get a Data Query job: queryStatus (accepted, in_progress, completed, failed) and, when completed, dataFile (a temporary download link) and… |
zuora_list_data_queries | List recent Data Query jobs with their query, status, row count and result link, newest first |
zuora_describe_object | Describe a Zuora object for ZOQL and Data Query: its fields with type, label, whether they are filterable, and related objects |
Примеры запросов
- «У каких аккаунтов есть проведённые счета со сроком оплаты до 1 октября, которые всё ещё не оплачены? Покажи аккаунт, номер счёта и остаток.»
- «Дай сводку по аккаунту A00001234: активные подписки, последние счета и последние платежи.»
- «Покажи предпросмотр: сколько будет стоить добавить 5 мест тарифа Pro в подписку A-S00000120 с первого числа следующего месяца. Только потом создавай заказ.»
- «С помощью Data Query посчитай неоплаченный остаток по счетам для каждого клиента и выведи 10 крупнейших.»
- «Отправь счёт INV00004567 в PDF ещё раз на [email protected].»
FAQ
Работает ли бесплатный план ChatGPT со своими MCP-серверами? OpenAI описывает свои MCP-серверы только для платных планов; план Free в этом списке не указан.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
- Подключить к Microsoft Copilot
Это руководство помогло?