インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Zoho Books をワンクリックで追加して、AI クライアント(Claude、ChatGPT、Copilot、Cursor)を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
AI に Zoho Books で作業させます。顧客、仕入先、品目の検索と管理、請求書の作成、メール送信、送信済みへの変更と無効化、見積書の作成、顧客からの入金、仕入請求書、経費の記録、勘定科目表、勘定元帳、銀行取引の読み取りができます。すべての Zoho データセンターに対応し、Zoho の OAuth でサインインします。
こう聞いてみよう
Zoho Books のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Zoho Books をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Zoho Books + ChatGPT
AI に Zoho Books で作業させます。顧客、仕入先、品目の検索と管理、請求書の作成、メール送信、送信済みへの変更と無効化、見積書の作成、顧客からの入金、仕入請求書、経費の記録、勘定科目表、勘定元帳、銀行取引の読み取りができます。すべての Zoho データセンターに対応し、Zoho の OAuth でサインインします。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
ZOHO_BOOKS_CLIENT_ID, ZOHO_BOOKS_CLIENT_SECRET, ZOHO_BOOKS_ORGANIZATION_ID, ZOHO_BOOKS_ACCOUNTS_URL, ZOHO_BOOKS_API_URL
ステップ 1 — 認証情報を取得
- Zoho のデータセンターを確認します。Zoho Books を使っているときのアドレスバーに表示されます(例: books.zoho.eu や books.zoho.com)。
ZOHO_BOOKS_ACCOUNTS_URLとZOHO_BOOKS_API_URLをそのデータセンターに合わせ、末尾のスラッシュなしで設定します。EU ならhttps://accounts.zoho.euとhttps://www.zohoapis.eu、米国ならhttps://accounts.zoho.comとhttps://www.zohoapis.comです。インド、オーストラリア、日本、サウジアラビア、UAE、中国も同じパターンです(.in、.com.au、.jp、.sa、.ae、.com.cn)。カナダはhttps://accounts.zohocloud.caとhttps://www.zohoapis.caを使います。 - Zoho アカウントでサインインした状態で Zoho API Console(api-console.zoho.com)を開き、Add Client → Server-based Applications を選びます。
- クライアントに名前(例: AnythingMCP)を付け、homepage URL に自社サイトを、Authorized Redirect URI に
https://cloud.anythingmcp.com/api/mcp-oauth/callbackを入力します。AnythingMCP をセルフホストしている場合は、代わりにhttps://your-anythingmcp-host/api/mcp-oauth/callbackを入力します。クライアントを作成します。 - Client Secret タブで、Client ID(
1000.で始まります)と Client Secret をZOHO_BOOKS_CLIENT_IDとZOHO_BOOKS_CLIENT_SECRETにコピーします。Books の組織が、コンソールが開いたデータセンターとは別のデータセンターにある場合は、クライアントの Settings タブ(Multi-DC)でそのデータセンターを有効にし、そこに表示される client secret を使います。 - 組織 ID を確認します。Zoho Books で右上の組織名をクリックし、Manage Organizations を開くと、各組織の横に ID が表示されます。その数字を
ZOHO_BOOKS_ORGANIZATION_IDに貼り付けます。1 つのコネクターで扱えるのは 1 つの組織だけです。2 つ目の組織には、コネクターをもう一度インストールしてください。 - コネクターをインストールし、コネクターのページで Authorize with Provider をクリックして Zoho にサインインし、要求されたアクセスを承認します。
zoho_books_list_organizationsを実行して自分の組織 ID が含まれていることを確認し、続けてzoho_books_get_organizationで組織名と基本通貨を確認してから、AI に読み書きさせます。
サインイン状態の維持: アクセストークンの有効期間は 1 時間で、保存されたリフレッシュトークンで自動的に更新されます。リフレッシュトークンは取り消されない限り失効しません。Zoho が保持するリフレッシュトークンはユーザーとクライアントごとに最大 20 個です。同じクライアントを 21 回目に承認すると、AnythingMCP でもそれ以外でも、最も古いものが通知なく取り消されます。コネクターのサインインが切れた場合は、もう一度 Authorize with Provider をクリックしてください。
権限と読み取り専用の設定: コネクターは ZohoBooks.settings.ALL, ZohoBooks.contacts.ALL, ZohoBooks.invoices.ALL, ZohoBooks.estimates.ALL, ZohoBooks.customerpayments.ALL, ZohoBooks.bills.ALL, ZohoBooks.expenses.ALL, ZohoBooks.accountants.READ, ZohoBooks.banking.READ を要求します。品目、税、組織の設定は ZohoBooks.settings に、勘定科目表は ZohoBooks.accountants に含まれます。コネクターは承認した Zoho ユーザーとして、そのユーザーのロールの範囲内で動作します。読み取り専用にするには、コネクターの OAuth 設定ですべての .ALL を .READ に変えてもう一度承認し、zoho_books_create_contact、zoho_books_update_contact、zoho_books_mark_contact_inactive、zoho_books_create_item、zoho_books_update_item、zoho_books_mark_item_inactive、zoho_books_create_invoice、zoho_books_email_invoice、zoho_books_mark_invoice_sent、zoho_books_void_invoice、zoho_books_mark_invoice_draft、zoho_books_create_estimate、zoho_books_create_customer_payment、zoho_books_create_bill、zoho_books_create_expense をオフにします。
インストール時はオフ: 削除ツールの zoho_books_delete_contact、zoho_books_delete_invoice、zoho_books_delete_estimate、zoho_books_delete_customer_payment、zoho_books_delete_bill、zoho_books_delete_expense。削除したレコードは元に戻せないため、AI にその種類のレコードを本当に削除させる場合だけオンにしてください。
書き込みは実際に反映されます: zoho_books_email_invoice は組織から顧客にメールを送り、zoho_books_mark_invoice_sent と zoho_books_void_invoice は帳簿を変更し、zoho_books_create_customer_payment、zoho_books_create_bill、zoho_books_create_expense は総勘定元帳に記帳します。AI は記帳や送信の内容を先に伝え、あなたの承認を待ちます。顧客からの入金の記録は帳簿上の処理だけで、実際にお金が回収されるわけではありません。
請求書と訂正: 新しい請求書は、組織の自動採番による番号が付いた下書きとして作成され、すぐに送るよう指示した場合にだけメールで送信されます。送信済みの請求書は Zoho で削除できないため、代わりに zoho_books_void_invoice で無効にします。無効にした請求書は記録として残ります。これはドイツの GoBD などの会計ルールが求めるとおりです。zoho_books_mark_invoice_draft で編集可能な下書きに戻し、訂正して再発行できます。
合計と残高: Zoho は Books 向けのレポート API を公開していません。合計を出すときは、AI が勘定科目表の残高、zoho_books_list_account_transactions による 1 つの勘定の取引、または日付で絞り込んだ一覧を読み取ります。
制限: 組織ごとに 1 分あたり 100 リクエスト、1 日あたり Free で 1,000、Standard で 2,000、Professional で 5,000、Premium 以上で 10,000 です。上限を超えると Zoho は 429 を返します(1 分あたりはコード 44、1 日あたりはコード 45)。1 分待つか、翌日まで待ってください。
よくあるエラー: サインイン時の invalid_client や空の組織一覧は、2 つの URL が自分のデータセンターのものではないことを示します。401 のコード 57("You are not authorized to perform this operation")や invalid_oauthtoken は、サインインにスコープが足りないか、取り消されたか、ZOHO_BOOKS_API_URL のデータセンターが違うことを示します。両方の URL を確認してから、もう一度 Authorize with Provider をクリックしてください。組織に言及する 400 や 404 は、ZOHO_BOOKS_ORGANIZATION_ID が間違っているか、このユーザーから見えないことを示します。zoho_books_list_organizations の結果と比べてください。その他の 400 エラーは、問題のフィールド(重複した名前、無効な値、必須フィールドの不足)を示します。コード 4529 は送信済みの請求書を削除できないことを示すので、無効にしてください。連絡先の削除時のコード 3000 は、まだ請求書や入金がその連絡先を参照していることを示すので、zoho_books_mark_contact_inactive を使ってください。
このコネクターは、受注書、発注書、クレジットノート、仕入先への支払い、仕訳、プロジェクト、定期請求書、添付ファイル、PDF には対応していません。
ステップ 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 は開発者モード(Developer mode)で MCP サーバーをカスタムアプリとして接続します。有料プランで利用でき、無料プランでは使えません。Business・Enterprise のワークスペースでは、先に管理者が許可する必要がある場合があります。
- ChatGPT で Settings → Security and login を開き、Developer mode をオンにします。
- chatgpt.com/plugins を開き、+ をクリックします。
- 名前と短い説明を入力します(例: Name:
Zoho Books)。 - Connection に MCP サーバー URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、接続を作成します。 - ChatGPT に求められたら AnythingMCP にサインイン(OAuth)し、アクセスを許可します。
利用可能なツール
| Tool | What it does |
|---|---|
zoho_books_list_organizations | List the Zoho Books organizations this sign-in can reach: organization_id, name, country, currency, time zone and whether it is the default |
zoho_books_get_organization | Read the connected organization: name, address, base currency, fiscal year start, time zone, tax settings and contact details |
zoho_books_list_contacts | List contacts (customers and vendors) with contact_id, name, company, email, status and outstanding receivables or payables |
zoho_books_get_contact | Read one contact with addresses, contact persons, payment terms, currency, balances and custom fields |
zoho_books_create_contact | Create a customer or vendor |
zoho_books_update_contact | Update a contact |
zoho_books_mark_contact_inactive | Mark a contact inactive: it stays in the books but is hidden from lists and cannot be used on new transactions |
zoho_books_delete_contact | Delete a contact for good |
zoho_books_list_items | List items (products and services) with item_id, name, SKU, rate, unit, tax and status |
zoho_books_get_item | Read one item with selling and purchase prices, accounts, tax, unit and stock details |
zoho_books_create_item | Create an item (product or service) |
zoho_books_update_item | Update an item |
zoho_books_mark_item_inactive | Mark an item inactive so it can no longer be added to new documents |
zoho_books_list_invoices | List invoices with invoice_id, number, customer, status, date, due date, total and balance |
zoho_books_get_invoice | Read one invoice with line items, taxes, totals, balance, payments, customer and status |
zoho_books_create_invoice | Create an invoice (a draft, unless send is true, which also emails it to the customer: confirm that with the user first) |
zoho_books_email_invoice | Email an invoice to the customer from the organization, with the invoice attached |
zoho_books_mark_invoice_sent | Mark a draft invoice as sent without emailing it (for invoices delivered another way) |
zoho_books_void_invoice | Void an invoice: it stays on record with status void but no longer counts as receivable or revenue |
zoho_books_mark_invoice_draft | Turn a void invoice back into a draft, for example to correct and reissue it |
zoho_books_delete_invoice | Delete an invoice for good: only a draft without recorded payments |
zoho_books_list_estimates | List estimates (quotes) with estimate_id, number, customer, status, date, expiry date and total |
zoho_books_get_estimate | Read one estimate with line items, taxes, totals and status |
zoho_books_create_estimate | Create an estimate (quote) as a draft |
zoho_books_delete_estimate | Delete an estimate (quote) for good; it cannot be restored |
zoho_books_list_customer_payments | List payments received from customers with payment_id, customer, date, amount, payment mode and the invoices they paid |
zoho_books_get_customer_payment | Read one customer payment with the invoices it was applied to |
zoho_books_create_customer_payment | Record a payment received from a customer and apply it to invoices (bookkeeping only; no money is collected) |
zoho_books_delete_customer_payment | Delete a recorded customer payment; the invoices become unpaid again |
zoho_books_list_bills | List bills (vendor invoices) with bill_id, number, vendor, status, date, due date, total and balance |
zoho_books_get_bill | Read one bill with line items, accounts, taxes, totals, balance and payments |
zoho_books_create_bill | Record a bill received from a vendor (it posts to the ledger as payable) |
zoho_books_delete_bill | Delete a bill for good (only without recorded payments) |
zoho_books_list_expenses | List expenses with expense_id, date, account, amount, vendor, customer and status (billable, invoiced, ...) |
zoho_books_get_expense | Read one expense with account, paid-through account, tax, vendor, customer and receipts |
zoho_books_create_expense | Record an expense paid from a bank, cash or credit card account (it posts to the ledger) |
zoho_books_delete_expense | Delete an expense for good; its ledger postings are removed |
zoho_books_list_chart_of_accounts | List the chart of accounts: account_id, name, code, type (asset, liability, equity, income, expense, bank, cash, ...), active flag and… |
zoho_books_get_account | Read one account of the chart of accounts: name, code, type, currency, description and balance |
zoho_books_list_account_transactions | List the transactions booked on one account (invoices, payments, bills, expenses, journals) with date, debit, credit and reference: a… |
zoho_books_list_bank_accounts | List bank, cash and credit card accounts with account_id, name, type, currency, balance and bank name |
zoho_books_get_bank_account | Read one bank or credit card account with balance and bank details |
zoho_books_list_bank_transactions | List bank transactions (deposits, withdrawals, transfers and feed lines) with date, amount, type, status (categorized, uncategorized… |
zoho_books_get_bank_transaction | Read one bank transaction with its accounts, amounts and the documents it is matched to |
zoho_books_list_taxes | List the organization's taxes and tax groups with tax_id, name, percentage and type, for line items and expenses |
プロンプトの例
- 「支払期限を過ぎた請求書はどれ?顧客ごとの未払い残高も教えて。」
- 「経費勘定「事務用品費」の残高と、9 月にその勘定に記帳された取引をすべて見せて。」
- 「Acme 株式会社宛ての請求書の下書きを作成して。「コンサルティング」12 時間、単価 95 EUR、支払期限は 14 日後。まだ送信しないで。」
- 「Acme 株式会社から今日振り込まれた 1,140 EUR を、請求書 INV-000123 への入金として記録して。」
FAQ
ChatGPT の無料プランでカスタム MCP コネクタは使えますか? いいえ。カスタム MCP 接続には開発者モードが必要で、有料プランでのみ利用できます。
次のステップ
このガイドは役に立ちましたか?