Zoho Books über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Zoho Books klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Zoho Books + Gemini

Lass deine KI in Zoho Books arbeiten: Kunden, Lieferanten und Artikel nachschlagen und pflegen, Rechnungen anlegen, per E-Mail senden, als gesendet markieren und stornieren, Angebote anlegen, Kundenzahlungen, Eingangsrechnungen und Ausgaben erfassen sowie Kontenplan, Kontenblätter und Banktransaktionen lesen. Jedes Zoho-Rechenzentrum, Anmeldung über Zoho OAuth.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

ZOHO_BOOKS_CLIENT_ID, ZOHO_BOOKS_CLIENT_SECRET, ZOHO_BOOKS_ORGANIZATION_ID, ZOHO_BOOKS_ACCOUNTS_URL, ZOHO_BOOKS_API_URL

Schritt 1 — Zugangsdaten holen

1. Finde dein Zoho-Rechenzentrum: Du siehst es in der Adressleiste, wenn du Zoho Books nutzt (zum Beispiel books.zoho.eu oder books.zoho.com). Setze ZOHO_BOOKS_ACCOUNTS_URL und ZOHO_BOOKS_API_URL auf dieses Rechenzentrum, ohne Schrägstrich am Ende: https://accounts.zoho.eu und https://www.zohoapis.eu für die EU, https://accounts.zoho.com und https://www.zohoapis.com für die USA. Indien, Australien, Japan, Saudi-Arabien, die VAE und China folgen demselben Muster (.in, .com.au, .jp, .sa, .ae, .com.cn); Kanada nutzt https://accounts.zohocloud.ca und https://www.zohoapis.ca.
2. Öffne die Zoho API Console unter api-console.zoho.com, angemeldet mit deinem Zoho-Konto, und wähle Add Client → Server-based Applications.
3. Gib dem Client einen Namen (zum Beispiel AnythingMCP), deine Firmenwebsite als Homepage-URL und https://cloud.anythingmcp.com/api/mcp-oauth/callback als Authorized Redirect URI. Wenn du AnythingMCP selbst betreibst, trage stattdessen https://dein-anythingmcp-host/api/mcp-oauth/callback ein. Lege den Client an.
4. Kopiere im Tab Client Secret die Client ID (sie beginnt mit 1000.) und das Client Secret in ZOHO_BOOKS_CLIENT_ID und ZOHO_BOOKS_CLIENT_SECRET. Liegt deine Books-Organisation in einem anderen Rechenzentrum als dem, in dem sich die Console geöffnet hat, aktiviere dieses Rechenzentrum im Tab Settings des Clients (Multi-DC) und nutze das dort angezeigte Client Secret dafür.
5. Ermittle die Organisations-ID: Klicke in Zoho Books oben rechts auf den Namen der Organisation und öffne Manage Organizations; die ID steht neben jeder Organisation. Trage die Ziffern in ZOHO_BOOKS_ORGANIZATION_ID ein. Ein Connector arbeitet mit genau einer Organisation; für eine zweite installierst du ihn erneut.
6. Installiere den Connector, klicke auf der Connector-Seite auf Authorize with Provider, melde dich bei Zoho an und bestätige den angefragten Zugriff.
7. Führe zoho_books_list_organizations aus und prüfe, ob deine Organisations-ID dabei ist, dann zoho_books_get_organization, um Namen und Basiswährung zu prüfen, bevor die KI etwas liest oder schreibt.

Angemeldet bleiben: Access-Tokens gelten eine Stunde und werden mit dem gespeicherten Refresh-Token automatisch erneuert; der Refresh-Token läuft nicht ab, solange er nicht widerrufen wird. Zoho speichert höchstens 20 Refresh-Tokens pro Benutzer und Client: Wer denselben Client zum 21. Mal autorisiert, ob in AnythingMCP oder anderswo, widerruft stillschweigend den ältesten. Verliert der Connector seine Anmeldung, klicke erneut auf Authorize with Provider.

Berechtigungen und Nur lesen: Der Connector fragt 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 an. Artikel, Steuern und Organisationseinstellungen fallen unter ZohoBooks.settings, der Kontenplan unter ZohoBooks.accountants. Er arbeitet als der Zoho-Benutzer, der ihn autorisiert hat, im Rahmen von dessen Rolle. Für ein Nur-lesen-Setup änderst du in den OAuth-Einstellungen des Connectors jedes .ALL in .READ, autorisierst erneut und schaltest 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 und zoho_books_create_expense aus.

Bei der Installation ausgeschaltet: die Lösch-Tools zoho_books_delete_contact, zoho_books_delete_invoice, zoho_books_delete_estimate, zoho_books_delete_customer_payment, zoho_books_delete_bill und zoho_books_delete_expense. Gelöschte Datensätze lassen sich nicht wiederherstellen, schalte ein Tool also nur ein, wenn die KI solche Datensätze wirklich löschen soll.

Schreibzugriffe sind echt: zoho_books_email_invoice schickt dem Kunden eine E-Mail aus deiner Organisation, zoho_books_mark_invoice_sent und zoho_books_void_invoice verändern die Bücher, und zoho_books_create_customer_payment, zoho_books_create_bill und zoho_books_create_expense buchen ins Hauptbuch. Die KI sagt vorher, was sie buchen oder senden will, und wartet auf dein Ja. Eine Kundenzahlung zu erfassen ist reine Buchhaltung: Es wird kein Geld eingezogen.

Rechnungen und Korrekturen: Eine neue Rechnung ist ein Entwurf mit der nächsten Nummer aus dem Nummernkreis deiner Organisation und wird nur per E-Mail verschickt, wenn du das sofortige Senden verlangst. Eine gesendete Rechnung lässt Zoho nicht löschen: Storniere sie stattdessen mit zoho_books_void_invoice. Eine stornierte Rechnung bleibt erhalten, so wie es Regeln wie die GoBD erwarten, und zoho_books_mark_invoice_draft macht daraus wieder einen bearbeitbaren Entwurf, den du korrigieren und neu ausstellen kannst.

Summen und Salden: Zoho dokumentiert für Books keine Berichts-API. Für Summen liest die KI die Salden aus dem Kontenplan, die Buchungen eines Kontos mit zoho_books_list_account_transactions oder nach Datum gefilterte Listen.

Limits: 100 Anfragen pro Minute und Organisation und pro Tag 1.000 im Free-Tarif, 2.000 in Standard, 5.000 in Professional und 10.000 ab Premium. Über dem Limit antwortet Zoho mit 429 (Code 44 pro Minute, 45 pro Tag): Warte eine Minute oder bis zum nächsten Tag.

Häufige Fehler: invalid_client bei der Anmeldung oder eine leere Organisationsliste heißt, dass die beiden URLs nicht zu deinem Rechenzentrum passen. 401 mit Code 57 ("You are not authorized to perform this operation") oder invalid_oauthtoken heißt, dass der Anmeldung ein Scope fehlt, sie widerrufen wurde oder ZOHO_BOOKS_API_URL das falsche Rechenzentrum ist: Prüfe beide URLs und klicke dann erneut auf Authorize with Provider. 400 oder 404 mit Bezug auf die Organisation heißt, dass ZOHO_BOOKS_ORGANIZATION_ID falsch oder für diesen Benutzer nicht sichtbar ist: Vergleiche sie mit zoho_books_list_organizations. Andere 400-Fehler nennen das Feld (ein doppelter Name, ein ungültiger Wert, ein fehlendes Pflichtfeld). Code 4529 heißt, dass eine gesendete Rechnung nicht gelöscht werden kann: Storniere sie. Code 3000 beim Löschen eines Kontakts heißt, dass noch Rechnungen oder Zahlungen darauf verweisen: Nutze zoho_books_mark_contact_inactive.

Der Connector unterstützt keine Kundenaufträge, Bestellungen, Gutschriften, Lieferantenzahlungen, Journalbuchungen, Projekte, wiederkehrenden Rechnungen, Anhänge oder PDFs.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Zoho Books-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Rechnungen sind überfällig, und wie viel schuldet uns jeder Kunde noch?“
• „Zeig mir den Saldo unseres Aufwandskontos Büromaterial und alle Buchungen darauf im September.“
• „Lege einen Rechnungsentwurf für die Acme GmbH an: 12 Stunden Beratung zu 95 EUR, fällig in 14 Tagen. Noch nicht versenden.“
• „Erfasse die heutige Überweisung der Acme GmbH über 1.140 EUR als Zahlung zur Rechnung INV-000123.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden