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.
Configurazione guidata
Collega Zoho Books a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Zoho Books con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Zoho Books. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?