Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Zuora con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Zuora Billing REST API para un tenant: cuentas de cliente, suscripciones y pedidos con vista previa, renovación, suspensión y reanudación, facturas con líneas y PDF, pagos, reembolsos y notas de crédito, el catálogo de productos con sus rate plans, consumos y lecturas ZOQL, Object Query y Data Query. OAuth2 client credentials, sin inicio de sesión en el navegador. Cancelaciones, pagos y reembolsos se instalan desactivados.
Prueba a pedir
Prompts de ejemplo para Zuora
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Zuora, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Zuora
Zuora Billing REST API para un tenant: cuentas de cliente, suscripciones y pedidos con vista previa, renovación, suspensión y reanudación, facturas con líneas y PDF, pagos, reembolsos y notas de crédito, el catálogo de productos con sus rate plans, consumos y lecturas ZOQL, Object Query y Data Query. OAuth2 client credentials, sin inicio de sesión en el navegador. Cancelaciones, pagos y reembolsos se instalan desactivados.
Configuración
La configuración lleva unos 5 minutos. Necesitas un tenant de Zuora y acceso a su gestión de usuarios.
- En Zuora abre Settings, Administration, Manage Users y elige o crea un usuario de API cuyo rol tenga los permisos que necesitan las herramientas: acceso a la API y permisos de lectura de Billing y Payments, más permisos de escritura para las herramientas que cambian datos.
- Abre ese usuario y crea un cliente en OAuth Clients. Copia el client id en
ZUORA_CLIENT_IDy el client secret enZUORA_CLIENT_SECRET. El secret solo se muestra una vez; si lo pierdes, crea un cliente nuevo. - Pon en
ZUORA_API_URLel host REST de tu tenant, sin ruta ni barra final: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) o un host sandbox: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.comohttps://rest.test.ap.zuora.com. Zuora muestra el host en la información del tenant y en la dirección de la documentación de la API de tu centro de datos. - Instala el conector y ejecuta
zuora_list_products: lista el catálogo de productos y confirma la configuración.
No hay inicio de sesión en el navegador. AnythingMCP obtiene un access token en /oauth/token de ese host con el grant OAuth2 client credentials y lo renueva antes de que caduque. Un cliente sandbox solo funciona en su host sandbox. En un tenant Multi-entity, el cliente OAuth debe pertenecer a la entity que quieres leer.
Qué lee: cuentas de cliente con zuora_list_accounts (filtros Object Query como ["status.EQ:Active", "balance.GT:0"]), zuora_get_account, zuora_get_account_summary (contactos, suscripciones, últimas facturas, pagos y consumos en una sola llamada) y zuora_list_account_payment_methods (números enmascarados); suscripciones con zuora_list_subscriptions, zuora_list_account_subscriptions y zuora_get_subscription; pedidos con zuora_list_orders y zuora_get_order; facturas con zuora_list_invoices (las vencidas, por ejemplo, con ["status.EQ:Posted", "balance.GT:0", "duedate.LT:2026-10-01"]), zuora_get_invoice, zuora_list_invoice_items y zuora_list_invoice_files (enlaces de descarga de los PDF); pagos con zuora_list_payments y zuora_get_payment, reembolsos con zuora_list_refunds y zuora_get_refund, notas de crédito con zuora_list_credit_memos, zuora_get_credit_memo y zuora_list_credit_memo_items; el catálogo con zuora_list_products, zuora_get_product, zuora_list_product_rate_plans y zuora_get_product_rate_plan (los ids de rate plan van en los pedidos como productRatePlanId); registros de consumo con zuora_list_usages.
Consultas: zuora_query ejecuta ZOQL sobre un objeto, por ejemplo SELECT Id, Name, Balance FROM Account WHERE Status = 'Active', y zuora_query_more trae el siguiente bloque. Para SQL entre objetos con joins y totales, zuora_create_data_query inicia un job de Data Query y la IA llama a zuora_get_data_query hasta que queryStatus sea completed; el resultado es un enlace de descarga temporal en dataFile. zuora_list_data_queries muestra los jobs anteriores y zuora_describe_object lista los campos de un objeto (en XML). Todas las herramientas de consulta son de solo lectura.
Qué escribe: zuora_create_account y zuora_update_account. Los cambios de suscripción pasan por pedidos: zuora_preview_order muestra las líneas de factura y los importes sin guardar nada, y después zuora_create_order crea una suscripción nueva, añade o quita un producto o cambia cantidad, precio o plazo. zuora_renew_subscription renueva una suscripción con plazo sin facturar, zuora_suspend_subscription detiene la facturación hasta que zuora_resume_subscription la reanuda. zuora_email_invoice envía por email una factura contabilizada en PDF, zuora_create_credit_memo_from_invoice crea una nota de crédito para todas o algunas líneas de una factura (en Draft salvo que auto_post sea true) y zuora_create_usage sube un registro de consumo. Todo esto cambia lo que se factura a los clientes, así que la IA prepara la vista previa, te enseña los importes y espera tu sí. zuora_create_order con processing_options (runBilling, collectPayment) además factura y cobra al cliente.
Desactivadas al instalar: zuora_cancel_subscription, zuora_create_payment y zuora_refund_payment. Mueven dinero o no se pueden deshacer, así que un admin del workspace las activa cuando el equipo las necesita.
Formatos de datos: la mayoría de las claves (account_key, subscription_key, invoice_key) aceptan el número (A00000001, A-S00000001, INV00000001) o el id de 32 caracteres; filtros como accountId necesitan el id. Los importes son números decimales en la moneda de la cuenta. Las fechas son YYYY-MM-DD; las marcas de tiempo están en la zona horaria del tenant salvo que terminen en Z. Las respuestas v1 llevan success: true o success: false con reasons (código y mensaje); las respuestas de Object Query llevan data.
Paginación: las listas de Object Query (zuora_list_accounts, zuora_list_subscriptions, zuora_list_invoices, zuora_list_usages) devuelven hasta page_size registros (10 por defecto, 99 como máximo) y nextPage, que la IA vuelve a pasar como cursor hasta que falte. Las demás listas aceptan page y page_size y devuelven un enlace nextPage mientras haya más. ZOQL devuelve hasta 2.000 registros y done: false con un queryLocator para el resto.
Errores comunes: 400 al pedir el token significa que Zuora no lo emitió: revisa el client id y el secret y que ZUORA_API_URL sea el centro de datos de tu tenant. 401 indica un client id o secret incorrecto o el host equivocado. 403 indica que al usuario de API le falta un permiso. 404 indica un número o id incorrecto. Los errores en respuestas v1 también pueden llegar con HTTP 200 y success: false; la IA lee reasons. 429 significa que se alcanzó el límite de Zuora de peticiones simultáneas por tenant o de peticiones por hora por usuario: espera y vuelve a intentarlo.
Con las herramientas activas al instalar, el conector no cancela suscripciones, no cobra pagos ni emite reembolsos. Lee el catálogo de productos pero no crea ni cambia productos, rate plans ni precios, no añade métodos de pago y no borra nada.
Requisitos previos: ZUORA_CLIENT_ID, ZUORA_CLIENT_SECRET, ZUORA_API_URL
Instalar el conector localmente
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
Abre http://localhost:3000/connectors/store, elige Zuora e introduce las variables listadas en los Requisitos previos.
Herramientas disponibles
| 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 |
Ejemplos de prompts
- "¿Qué cuentas tienen facturas contabilizadas que vencieron antes del 1 de octubre y siguen con saldo? Muestra cuenta, número de factura e importe pendiente."
- "Dame un resumen de la cuenta A00001234: suscripciones activas, últimas facturas y últimos pagos."
- "Enséñame en una vista previa cuánto cuesta añadir 5 puestos del plan Pro a la suscripción A-S00000120 desde el día 1 del mes que viene, antes de crear el pedido."
- "Con una Data Query, suma el saldo pendiente de facturas por cliente y lista los 10 mayores."
- "Vuelve a enviar la factura INV00004567 en PDF a [email protected]."
Siguientes pasos
¿Te ha sido útil esta guía?