跳过安装。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 key,即可完成。无 Docker、无
git clone、无本地服务器。
Zoho Books + Cursor
让你的 AI 在 Zoho Books 中工作:查找和管理客户、供应商和商品,创建发票、通过邮件发送、标记为已发送和作废,创建报价单,记录客户付款、供应商账单和费用,并读取科目表、科目明细账和银行交易。支持任意 Zoho 数据中心,使用 Zoho OAuth 登录。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
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设为该数据中心的地址,末尾不要加斜杠:欧盟为https://accounts.zoho.eu和https://www.zohoapis.eu,美国为https://accounts.zoho.com和https://www.zohoapis.com。印度、澳大利亚、日本、沙特阿拉伯、阿联酋和中国遵循同样的规则(.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。一个连接器只对应一个组织;如需第二个组织,请再安装一次。 - 安装连接器,在连接器页面点击 Authorize with Provider,登录 Zoho 并批准所请求的访问权限。
- 运行
zoho_books_list_organizations,确认列表中有你的组织 ID,然后运行zoho_books_get_organization核对组织名称和本位币,再让 AI 读取或写入任何内容。
保持登录状态:访问令牌有效期为一小时,会用保存的刷新令牌自动续期;刷新令牌只要不被撤销就不会过期。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 读取某个科目的交易,或者读取按日期筛选的列表。
限制:每个组织每分钟 100 个请求;每天的上限为 Free 版 1,000 个、Standard 版 2,000 个、Professional 版 5,000 个、Premium 及以上 10,000 个。超出限制时 Zoho 返回 429(每分钟限制为代码 44,每日限制为代码 45):请等一分钟,或等到第二天。
常见错误:登录时出现 invalid_client 或组织列表为空,表示这两个 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 — 安装 adapter
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 — 在 Cursor 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目:
{
"mcpServers": {
"anythingmcp": {
"url": "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。 - 保存文件并重启 Cursor。
- 打开 Cursor → Settings → MCP,确认
anythingmcp已列出并处于已连接状态。 - 开始对话,智能体现在可以调用
Zoho Books的工具。
可用工具
| 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 Ltd 创建一张发票草稿:12 小时“咨询”服务,单价 95 EUR,14 天后到期。先不要发送。”
- “把 Acme Ltd 今天转来的 1,140 EUR 记录为发票 INV-000123 的付款。”
FAQ
Cursor 免费套餐支持自定义 MCP 服务器吗? 支持,Hobby、Pro 和 Business 套餐均可使用 MCP。
下一步
这份指南对你有帮助吗?