Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Zoho Books con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
AnythingMCP è nella directory dei connettori di Claude: aggiungilo a Claude con un clic (si apre in una nuova scheda), poi accedi e scegli quali server MCP può usare Claude.
In breve
Fai lavorare la tua AI in Zoho Books: cerca e gestisci clienti, fornitori e articoli, crea, invia per email, segna come inviate e annulla le fatture, crea preventivi, registra pagamenti dei clienti, fatture dei fornitori e spese, e leggi il piano dei conti, i mastrini e i movimenti bancari. Qualsiasi data center Zoho, accesso con OAuth di Zoho.
Prova a chiedere
Prompt di esempio per Zoho Books
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Zoho Books, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Zoho Books + Claude
Fai lavorare la tua AI in Zoho Books: cerca e gestisci clienti, fornitori e articoli, crea, invia per email, segna come inviate e annulla le fatture, crea preventivi, registra pagamenti dei clienti, fatture dei fornitori e spese, e leggi il piano dei conti, i mastrini e i movimenti bancari. Qualsiasi data center Zoho, accesso con OAuth di Zoho.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
ZOHO_BOOKS_CLIENT_ID, ZOHO_BOOKS_CLIENT_SECRET, ZOHO_BOOKS_ORGANIZATION_ID, ZOHO_BOOKS_ACCOUNTS_URL, ZOHO_BOOKS_API_URL
Step 1 — Ottieni le credenziali
- Individua il tuo data center Zoho: lo vedi nella barra degli indirizzi quando usi Zoho Books (per esempio books.zoho.eu o books.zoho.com). Imposta
ZOHO_BOOKS_ACCOUNTS_URLeZOHO_BOOKS_API_URLsu quel data center, senza barra finale:https://accounts.zoho.euehttps://www.zohoapis.euper l'UE,https://accounts.zoho.comehttps://www.zohoapis.comper gli Stati Uniti. India, Australia, Giappone, Arabia Saudita, Emirati Arabi Uniti e Cina seguono lo stesso schema (.in,.com.au,.jp,.sa,.ae,.com.cn); il Canada usahttps://accounts.zohocloud.caehttps://www.zohoapis.ca. - Apri la Zoho API Console su api-console.zoho.com, con l'accesso del tuo account Zoho, e scegli Add Client → Server-based Applications.
- Dai un nome al client (per esempio AnythingMCP), indica il sito della tua azienda come homepage URL e
https://cloud.anythingmcp.com/api/mcp-oauth/callbackcome Authorized Redirect URI. Se ospiti AnythingMCP in proprio, inserisci invecehttps://tuo-host-anythingmcp/api/mcp-oauth/callback. Crea il client. - Nella scheda Client Secret copia il Client ID (inizia con
1000.) e il Client Secret inZOHO_BOOKS_CLIENT_IDeZOHO_BOOKS_CLIENT_SECRET. Se la tua organizzazione Books si trova in un data center diverso da quello in cui si è aperta la console, abilita quel data center nella scheda Settings del client (Multi-DC) e usa il client secret indicato lì. - Trova l'ID dell'organizzazione: in Zoho Books clicca sul nome dell'organizzazione (in alto a destra) e apri Manage Organizations; l'ID compare accanto a ogni organizzazione. Inserisci le cifre in
ZOHO_BOOKS_ORGANIZATION_ID. Un connettore lavora con una sola organizzazione; per una seconda installalo di nuovo. - Installa il connettore, clicca su Authorize with Provider nella pagina del connettore, accedi a Zoho e approva l'accesso richiesto.
- Esegui
zoho_books_list_organizationse controlla che il tuo ID organizzazione sia nell'elenco, poizoho_books_get_organizationper verificare nome e valuta di base prima che l'AI legga o scriva qualsiasi cosa.
Restare connessi: gli access token durano un'ora e vengono rinnovati automaticamente con il refresh token salvato, che non scade finché non viene revocato. Zoho conserva al massimo 20 refresh token per utente e client: autorizzare lo stesso client per la 21ª volta, in AnythingMCP o altrove, revoca in silenzio il più vecchio. Se il connettore perde l'accesso, clicca di nuovo su Authorize with Provider.
Permessi e solo lettura: il connettore richiede 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. Articoli, imposte e impostazioni dell'organizzazione rientrano in ZohoBooks.settings, il piano dei conti in ZohoBooks.accountants. Lavora come l'utente Zoho che lo ha autorizzato, nei limiti del suo ruolo. Per un setup in sola lettura, cambia ogni .ALL in .READ nelle impostazioni OAuth del connettore, autorizza di nuovo e disattiva 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 e zoho_books_create_expense.
Disattivati all'installazione: i tool di eliminazione zoho_books_delete_contact, zoho_books_delete_invoice, zoho_books_delete_estimate, zoho_books_delete_customer_payment, zoho_books_delete_bill e zoho_books_delete_expense. Un record eliminato non si può recuperare, quindi attivane uno solo se l'AI deve davvero eliminare quel tipo di record.
Le scritture sono reali: zoho_books_email_invoice invia un'email al cliente dalla tua organizzazione, zoho_books_mark_invoice_sent e zoho_books_void_invoice modificano la contabilità, e zoho_books_create_customer_payment, zoho_books_create_bill e zoho_books_create_expense registrano in contabilità generale. L'AI dice prima cosa sta per registrare o inviare e aspetta il tuo sì. Registrare un pagamento di un cliente è solo contabilità: non viene incassato denaro.
Fatture e correzioni: una nuova fattura è una bozza numerata dalla numerazione automatica della tua organizzazione e viene inviata per email solo se chiedi di spedirla subito. Zoho rifiuta di eliminare una fattura inviata: annullala invece con zoho_books_void_invoice. Una fattura annullata resta agli atti, come richiedono regole contabili quali le GoBD tedesche, e zoho_books_mark_invoice_draft la riporta a bozza modificabile da correggere e riemettere.
Totali e saldi: Zoho non documenta un'API dei report per Books. Per i totali l'AI legge i saldi dal piano dei conti, i movimenti di un conto con zoho_books_list_account_transactions o elenchi filtrati per data.
Limiti: 100 richieste al minuto per organizzazione e, al giorno, 1.000 con Free, 2.000 con Standard, 5.000 con Professional e 10.000 da Premium in su. Oltre il limite Zoho risponde 429 (codice 44 al minuto, 45 al giorno): attendi un minuto, o il giorno dopo.
Errori comuni: invalid_client all'accesso o un elenco di organizzazioni vuoto significa che i due URL non sono quelli del tuo data center. 401 con codice 57 ("You are not authorized to perform this operation") o invalid_oauthtoken significa che all'accesso manca uno scope, che è stato revocato o che ZOHO_BOOKS_API_URL è il data center sbagliato: controlla entrambi gli URL, poi clicca di nuovo su Authorize with Provider. 400 o 404 che citano l'organizzazione significano che ZOHO_BOOKS_ORGANIZATION_ID è errato o non visibile a questo utente: confrontalo con zoho_books_list_organizations. Gli altri errori 400 indicano il campo (un nome duplicato, un valore non valido, un campo obbligatorio mancante). Il codice 4529 significa che una fattura inviata non si può eliminare: annullala. Il codice 3000 quando elimini un contatto significa che fatture o pagamenti fanno ancora riferimento a esso: usa zoho_books_mark_contact_inactive.
Il connettore non gestisce ordini di vendita, ordini di acquisto, note di credito, pagamenti ai fornitori, registrazioni di prima nota, progetti, fatture ricorrenti, allegati o PDF.
Step 2 — Installa l'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
Step 3 — Aggiungi il connettore in Claude
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.
- In Claude apri Customize → Connectors.
- Clicca + e poi Add custom connector.
- Inserisci un nome, ad esempio
Zoho Books, e l'URL del server MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add. - Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.
Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.
Tool disponibili
| 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 |
Esempi di prompt
- "Quali fatture sono scadute e quanto ci deve ancora ogni cliente?"
- "Mostrami il saldo del conto di spesa Cancelleria e tutti i movimenti di settembre."
- "Crea una bozza di fattura per Acme Srl: 12 ore di Consulenza a 95 EUR, scadenza a 14 giorni. Non inviarla ancora."
- "Registra il bonifico di oggi di 1.140 EUR da Acme Srl come pagamento della fattura INV-000123."
FAQ
Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Prossimi passi
- Landing del connettore
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?
