インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Zuora をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
1 つのテナントの Zuora Billing REST API：顧客アカウント、サブスクリプションと注文（プレビュー、更新、一時停止、再開）、明細と PDF 付きの請求書、支払い、返金、クレジットメモ、レートプラン付きの商品カタログ、使用量、ZOQL・Object Query・Data Query による読み取り。OAuth2 クライアントクレデンシャルで、ブラウザでのサインインは不要です。解約、支払い、返金はインストール時にオフです。
こう聞いてみよう
Zuora のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Zuora をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Zuora + Gemini
1 つのテナントの Zuora Billing REST API：顧客アカウント、サブスクリプションと注文（プレビュー、更新、一時停止、再開）、明細と PDF 付きの請求書、支払い、返金、クレジットメモ、レートプラン付きの商品カタログ、使用量、ZOQL・Object Query・Data Query による読み取り。OAuth2 クライアントクレデンシャルで、ブラウザでのサインインは不要です。解約、支払い、返金はインストール時にオフです。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
ZUORA_CLIENT_ID, ZUORA_CLIENT_SECRET, ZUORA_API_URL
ステップ 1 — 認証情報を取得
設定は約 5 分です。Zuora のテナントと、そのユーザー管理へのアクセスが必要です。
- Zuora で Settings、Administration、Manage Users を開き、ツールに必要な権限を持つロールの API ユーザーを選ぶか作成します。必要なのは API アクセスと Billing・Payments の読み取り権限、さらにデータを変更するツールのための書き込み権限です。
- そのユーザーを開き、OAuth Clients でクライアントを作成します。クライアント ID を
ZUORA_CLIENT_IDに、クライアントシークレットをZUORA_CLIENT_SECRETにコピーします。シークレットは一度しか表示されません。失くした場合は新しいクライアントを作成してください。 ZUORA_API_URLにテナントの REST ホストを、パスや末尾のスラッシュなしで設定します：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 はそのホストの /oauth/token で OAuth2 クライアントクレデンシャルグラントによりアクセストークンを取得し、期限切れの前に自動で更新します。サンドボックスのクライアントはそのサンドボックスのホストでのみ動作します。Multi-entity テナントでは、OAuth クライアントが読み取りたいエンティティに属している必要があります。
読み取れるデータ: 顧客アカウントは zuora_list_accounts（["status.EQ:Active", "balance.GT:0"] のような Object Query フィルター）、zuora_get_account、zuora_get_account_summary（連絡先、サブスクリプション、最近の請求書、支払い、使用量を 1 回で取得）、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 は 1 つのオブジェクトに対して ZOQL を実行します（例 SELECT Id, Name, Balance FROM Account WHERE Status = 'Active'）。zuora_query_more は次のまとまりを取得します。結合や集計を含む複数オブジェクトにまたがる SQL には、zuora_create_data_query で Data Query ジョブを開始し、AI が queryStatus が completed になるまで zuora_get_data_query を呼びます。結果は 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 でメール送信し、zuora_create_credit_memo_from_invoice は請求書の全部または一部の明細からクレジットメモを作成し（auto_post が true でなければ Draft）、zuora_create_usage は使用量レコードを 1 件アップロードします。これらは顧客への請求内容を変えるため、AI はまずプレビューを作り、金額を見せてから了承を待ちます。zuora_create_order に processing_options（runBilling、collectPayment）を付けると、請求書の発行と顧客への課金も同時に行われます。
インストール時はオフ: zuora_cancel_subscription、zuora_create_payment、zuora_refund_payment です。お金を動かすか元に戻せない操作のため、チームが必要なときにワークスペース管理者がオンにします。
データ形式: ほとんどのキー（account_key、subscription_key、invoice_key）は番号（A00000001、A-S00000001、INV00000001）か 32 文字の ID のどちらでも受け付けます。accountId などのフィルターには ID が必要です。金額はアカウントの通貨の小数です。日付は YYYY-MM-DD、タイムスタンプは Z で終わらない限りテナントのタイムゾーンです。v1 の応答には success: true、または reasons（コードとメッセージ）付きの success: false が含まれます。Object Query の応答は data を含みます。
ページング: Object Query の一覧（zuora_list_accounts、zuora_list_subscriptions、zuora_list_invoices、zuora_list_usages）は最大 page_size 件（既定 10、最大 99）と nextPage を返し、AI はそれがなくなるまで cursor として渡します。その他の一覧は page と page_size を受け付け、続きがある間は nextPage リンクを返します。ZOQL は最大 2,000 件と、残りがある場合は done: false と queryLocator を返します。
よくあるエラー: トークン取得時の 400 は Zuora がトークンを発行しなかったことを意味します。クライアント ID とシークレット、そして ZUORA_API_URL がテナントのデータセンターかを確認してください。401 はクライアント ID かシークレットの誤り、またはホストの誤りです。403 は API ユーザーに権限が足りません。404 は番号か ID の誤りです。v1 のエラーは HTTP 200 と success: false で返ることもあり、AI は reasons を読みます。429 はテナントごとの同時リクエスト数またはユーザーごとの 1 時間あたりのリクエスト数の上限に達したことを意味します。少し待ってから再試行してください。
インストール時にオンのツールでは、コネクタはサブスクリプションの解約、支払いの回収、返金を行いません。商品カタログは読み取りますが、商品、レートプラン、価格の作成や変更はせず、支払い方法の追加も、削除も一切行いません。
ステップ 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 — Gemini にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、
geminiを再起動します。 - Gemini CLI で
/mcpを実行します（またはシェルでgemini mcp list）。anythingmcpが接続済みとして表示されるはずです。 - プロンプトを入力しましょう。Gemini CLI が
Zuoraのツールを呼び出せるようになりました。
利用可能なツール
| 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 |
プロンプトの例
- 「10 月 1 日より前が期日で、まだ残高のある転記済み請求書を持つアカウントはどれですか？ アカウント、請求書番号、未払い額を表示してください。」
- 「アカウント A00001234 の概要を教えてください：有効なサブスクリプション、最近の請求書、最近の支払い。」
- 「サブスクリプション A-S00000120 に来月 1 日から Pro プランを 5 席追加した場合の金額をプレビューして、注文を作成する前に見せてください。」
- 「Data Query で顧客ごとの未払い請求額を合計し、上位 10 件を一覧にしてください。」
- 「請求書 INV00004567 を PDF で [email protected] にもう一度送ってください。」
FAQ
Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。
次のステップ
このガイドは役に立ちましたか?