Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Zuora mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
Zuora Billing REST API für einen Tenant: Kundenkonten, Abonnements und Orders mit Vorschau, Verlängern, Pausieren und Fortsetzen, Rechnungen mit Positionen und PDFs, Zahlungen, Erstattungen und Gutschriften, der Produktkatalog mit Rate Plans, Nutzungsdaten sowie ZOQL-, Object-Query- und Data-Query-Abfragen. OAuth2 Client Credentials, keine Anmeldung im Browser. Kündigungen, Zahlungen und Erstattungen sind bei der Installation aus.
Frag einfach
Beispiel-Prompts für Zuora
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Zuora klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Zuora + Microsoft Copilot
Zuora Billing REST API für einen Tenant: Kundenkonten, Abonnements und Orders mit Vorschau, Verlängern, Pausieren und Fortsetzen, Rechnungen mit Positionen und PDFs, Zahlungen, Erstattungen und Gutschriften, der Produktkatalog mit Rate Plans, Nutzungsdaten sowie ZOQL-, Object-Query- und Data-Query-Abfragen. OAuth2 Client Credentials, keine Anmeldung im Browser. Kündigungen, Zahlungen und Erstattungen sind bei der Installation aus.
Voraussetzungen
Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:
ZUORA_CLIENT_ID, ZUORA_CLIENT_SECRET, ZUORA_API_URL
Schritt 1 — Zugangsdaten holen
Die Einrichtung dauert etwa 5 Minuten. Du brauchst einen Zuora-Tenant und Zugriff auf seine Benutzerverwaltung.
- Öffne in Zuora Settings, Administration, Manage Users und wähle oder lege einen API-Benutzer an, dessen Rolle die Rechte hat, die die Tools brauchen: API-Zugriff und Leserechte für Billing und Payments, dazu Schreibrechte für die Tools, die Daten ändern.
- Öffne diesen Benutzer und lege unter OAuth Clients einen Client an. Kopiere die Client-ID in
ZUORA_CLIENT_IDund das Client-Secret inZUORA_CLIENT_SECRET. Das Secret wird nur einmal angezeigt; ist es verloren, lege einen neuen Client an. - Setze
ZUORA_API_URLauf den REST-Host deines Tenants, ohne Pfad und ohne Schrägstrich am Ende: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) oder einen Sandbox-Host: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.comoderhttps://rest.test.ap.zuora.com. Zuora zeigt den Host bei den Tenant-Infos und in der Adresse der API-Doku für dein Rechenzentrum. - Installiere den Connector und führe
zuora_list_productsaus: Es listet den Produktkatalog und bestätigt die Einrichtung.
Eine Anmeldung im Browser gibt es nicht. AnythingMCP holt sich mit dem OAuth2-Client-Credentials-Grant einen Access Token bei /oauth/token auf diesem Host und erneuert ihn, bevor er abläuft. Ein Sandbox-Client funktioniert nur auf seinem Sandbox-Host. Bei einem Multi-Entity-Tenant muss der OAuth-Client zu der Entity gehören, die du lesen willst.
Was er liest: Kundenkonten mit zuora_list_accounts (Object-Query-Filter wie ["status.EQ:Active", "balance.GT:0"]), zuora_get_account, zuora_get_account_summary (Kontakte, Abonnements, letzte Rechnungen, Zahlungen und Nutzung in einem Aufruf) und zuora_list_account_payment_methods (maskierte Nummern); Abonnements mit zuora_list_subscriptions, zuora_list_account_subscriptions und zuora_get_subscription; Orders mit zuora_list_orders und zuora_get_order; Rechnungen mit zuora_list_invoices (überfällige etwa mit ["status.EQ:Posted", "balance.GT:0", "duedate.LT:2026-10-01"]), zuora_get_invoice, zuora_list_invoice_items und zuora_list_invoice_files (PDF-Downloadlinks); Zahlungen mit zuora_list_payments und zuora_get_payment, Erstattungen mit zuora_list_refunds und zuora_get_refund, Gutschriften (Credit Memos) mit zuora_list_credit_memos, zuora_get_credit_memo und zuora_list_credit_memo_items; den Produktkatalog mit zuora_list_products, zuora_get_product, zuora_list_product_rate_plans und zuora_get_product_rate_plan (die Rate-Plan-IDs kommen als productRatePlanId in Orders); Nutzungsdaten mit zuora_list_usages.
Abfragen: zuora_query führt ZOQL auf einem Objekt aus, z. B. SELECT Id, Name, Balance FROM Account WHERE Status = 'Active', und zuora_query_more holt den nächsten Block. Für SQL über mehrere Objekte mit Joins und Summen startet zuora_create_data_query einen Data-Query-Job, und die KI ruft zuora_get_data_query auf, bis queryStatus completed ist; das Ergebnis ist ein temporärer Downloadlink in dataFile. zuora_list_data_queries zeigt frühere Jobs, zuora_describe_object listet die Felder eines Objekts (als XML). Alle Abfrage-Tools lesen nur.
Was er schreibt: zuora_create_account und zuora_update_account. Änderungen an Abonnements laufen über Orders: zuora_preview_order zeigt Rechnungspositionen und Beträge, ohne etwas zu speichern, danach legt zuora_create_order ein neues Abonnement an, fügt ein Produkt hinzu oder entfernt es oder ändert Menge, Preis oder Laufzeit. zuora_renew_subscription verlängert ein befristetes Abonnement ohne Abrechnung, zuora_suspend_subscription stoppt die Abrechnung, bis zuora_resume_subscription sie wieder startet. zuora_email_invoice schickt eine gebuchte Rechnung als PDF per E-Mail, zuora_create_credit_memo_from_invoice erstellt eine Gutschrift für alle oder einzelne Positionen einer Rechnung (als Draft, außer auto_post ist true), und zuora_create_usage lädt einen Nutzungsdatensatz hoch. Das ändert, was Kunden in Rechnung gestellt wird, deshalb erstellt die KI zuerst die Vorschau, zeigt dir die Beträge und wartet auf dein Ja. zuora_create_order mit processing_options (runBilling, collectPayment) stellt dem Kunden außerdem gleich eine Rechnung und belastet ihn.
Bei der Installation deaktiviert: zuora_cancel_subscription, zuora_create_payment und zuora_refund_payment. Sie bewegen Geld oder lassen sich nicht rückgängig machen, deshalb schaltet ein Workspace-Admin sie ein, wenn das Team sie braucht.
Datenformate: Die meisten Schlüssel (account_key, subscription_key, invoice_key) nehmen entweder die Nummer (A00000001, A-S00000001, INV00000001) oder die 32-stellige ID; Filter wie accountId brauchen die ID. Beträge sind Dezimalzahlen in der Währung des Kontos. Datumswerte sind YYYY-MM-DD, Zeitstempel stehen in der Zeitzone des Tenants, außer sie enden auf Z. v1-Antworten tragen success: true oder success: false mit reasons (Code und Meldung); Object-Query-Antworten tragen data.
Blättern: Die Object-Query-Listen (zuora_list_accounts, zuora_list_subscriptions, zuora_list_invoices, zuora_list_usages) liefern bis zu page_size Datensätze (Standard 10, höchstens 99) und nextPage, das die KI als cursor zurückgibt, bis es fehlt. Andere Listen nehmen page und page_size und liefern einen nextPage-Link, solange es weitere gibt. ZOQL liefert bis zu 2.000 Datensätze und done: false mit einem queryLocator für den Rest.
Häufige Fehler: 400 beim Token-Abruf heißt, Zuora hat keinen Token ausgestellt: Prüfe Client-ID und Secret und ob ZUORA_API_URL das Rechenzentrum deines Tenants ist. 401 bedeutet eine falsche Client-ID, ein falsches Secret oder den falschen Host. 403 bedeutet, dass dem API-Benutzer ein Recht fehlt. 404 bedeutet eine falsche Nummer oder ID. Fehler in v1-Antworten können auch mit HTTP 200 und success: false kommen; die KI liest reasons. 429 bedeutet, dass Zuoras Limit für gleichzeitige Anfragen pro Tenant oder Anfragen pro Stunde und Benutzer erreicht ist: Warte kurz und versuch es erneut.
Mit den Tools, die bei der Installation aktiv sind, kündigt der Connector keine Abonnements, zieht keine Zahlungen ein und erstattet nichts. Er liest den Produktkatalog, legt aber keine Produkte, Rate Plans oder Preise an und ändert sie nicht, er fügt keine Zahlungsmethoden hinzu und löscht nichts.
Schritt 2 — Adapter installieren
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
Schritt 3 — Connector in Microsoft Copilot hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
Zuora-Tools braucht. - Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.
Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.
Verfügbare Tools
| 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 |
Beispiel-Prompts
- „Welche Konten haben gebuchte Rechnungen, die vor dem 1. Oktober fällig waren und noch offen sind? Zeig Konto, Rechnungsnummer und offenen Betrag.“
- „Gib mir eine Übersicht zu Konto A00001234: aktive Abonnements, die letzten Rechnungen und die letzten Zahlungen.“
- „Zeig mir in einer Vorschau, was es kostet, dem Abonnement A-S00000120 ab dem Ersten des nächsten Monats 5 Plätze des Pro-Plans hinzuzufügen, bevor du die Order anlegst.“
- „Summiere per Data Query den offenen Rechnungsbetrag pro Kunde und liste die 10 größten auf.“
- „Schick die Rechnung INV00004567 noch einmal als PDF an [email protected].“
FAQ
Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.
Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.
Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.
Nächste Schritte
- Connector-Startseite
- Mit Claude verbinden
- Mit ChatGPT verbinden
- Mit Cursor verbinden
- Mit Gemini verbinden
- Mit Meta Muse verbinden
War dieser Guide hilfreich?