Claude in Zoho Flow und Deluge einbinden: Schritt für Schritt mit Freigaben

Um Claude in Zoho Flow und Deluge einzubinden, rufen Sie die Claude API über eine in Zoho hinterlegte Verbindung auf. Sie übergeben einen festen Prompt mit knappen Datensatzdaten und verlangen eine Antwort im JSON-Format. Diese Antwort schreiben Sie in eigene Felder von Zoho CRM oder Zoho Desk. Hat die Antwort Folgen, gibt ein Mensch frei.

Ein Claude-Aufruf ist eine Anfrage, die Ihre Zoho-Automatisierung an die Claude API schickt und deren Antwort sie weiterverarbeitet. Zoho Flow ist die Integrationsplattform von Zoho, in der Sie Abläufe aus Auslösern und Aktionen zusammenstellen. Deluge ist die Skriptsprache von Zoho, in der Sie Funktionen für Zoho CRM und andere Zoho-Anwendungen schreiben. JSON ist ein einfaches Textformat aus Schlüsseln und Werten, das ein Programm sicher auslesen kann.

Die technische Grundlage ist günstig, weil Zoho für fast jede Funktion eine Programmierschnittstelle anbietet. Ein Betreiber einer kleinen IT-Firma schreibt in einem Beitrag im Forum r/Zoho, genau das habe die Automatisierung mit Claude für ihn stark erleichtert. Er baut damit sein eigenes Ticketsystem.

Schwierig wird es an drei Stellen: bei den Zugangsdaten, bei langsamen Antworten und bei einem Prompt, der keine verlässliche Struktur zurückliefert. Diese Anleitung behandelt jede dieser Stellen einzeln. Danach folgen ein durchgespieltes Beispiel mit einem Desk-Ticket und die Frage, wo Freigaben zwingend sind.

Zoho Flow eignet sich für Abläufe, die in einer Anwendung beginnen und in einer anderen enden. Ein neues Ticket in Zoho Desk löst etwa einen Schritt aus, der Claude befragt und das Ergebnis weitergibt. Der Ablauf bleibt in der Oberfläche sichtbar, und auch Mitarbeitende ohne Programmierkenntnisse können ihn nachvollziehen.

Eine Deluge-Funktion brauchen Sie, sobald Sie mehr Kontrolle benötigen. Das betrifft vor allem drei Aufgaben:

• den Prompt aus mehreren Feldern und verknüpften Datensätzen zusammensetzen,
• die JSON-Antwort von Claude auslesen und auf erlaubte Werte prüfen,
• Fehlerfälle abfangen, bevor ein falscher Wert im Datensatz landet.

In der Praxis kombinieren viele Teams beide Wege. Zoho Flow übernimmt den Auslöser und die Weitergabe zwischen Anwendungen, eine Deluge-Funktion übernimmt den eigentlichen Claude-Aufruf und die Prüfung der Antwort.

Eine Einschränkung bei der Pflege von Deluge-Funktionen

Den Quellcode von Deluge-Funktionen können Sie nicht über die öffentliche REST-API von Zoho CRM verwalten. Die Beschreibung eines auf Glama gelisteten Zoho CRM MCP Servers nennt den Deluge-Funktionsquellcode ausdrücklich unter den Dingen, die nur über die Benutzeroberfläche verfügbar sind. Sie pflegen Funktionen also in der Oberfläche. Halten Sie deshalb eine Kopie jeder produktiven Funktion mit Datum in Ihrer eigenen Dokumentation fest, damit Sie Änderungen nachvollziehen können.

Der API-Schlüssel für Claude gehört nie als Klartext in den Funktionscode. Hinterlegen Sie ihn an einer geschützten Stelle in Zoho, etwa in einer Verbindung (Connection), und lesen Sie ihn von dort. So erscheint der Schlüssel weder in Kopien des Codes noch in Bildschirmfotos für den Support. Wechseln Sie den Schlüssel, ändern Sie ihn an einer einzigen Stelle.

Für den Zugriff auf Zoho selbst ist OAuth der Standard. OAuth ist ein Verfahren, bei dem eine Anwendung mit einem befristeten Token statt mit einem Passwort zugreift. Zoho hat die älteren Authtokens für API-Aufrufe in der Finanz-Suite abgeschafft, die Frist für die Umstellung auf OAuth lief bis zum 30. August 2021. Wer noch alte Skripte mit Authtokens findet, muss sie umbauen.

Berechtigungen so eng wie möglich

Jede OAuth-Verbindung trägt Bereiche (Scopes), die festlegen, was sie lesen und schreiben darf. Fordern Sie nur die Bereiche an, die der Ablauf wirklich braucht. Legen Sie für Automatisierungen einen eigenen technischen Benutzer mit minimalen Rechten an, statt das Konto einer Führungskraft zu verwenden.

Der Fehler invalid_client

Tokens gehören immer zu genau einem OAuth-Client. Der genannte MCP Server löscht deshalb beim Wechsel der client_id alle gespeicherten Tokens, um den Fehler invalid_client von Zoho zu vermeiden. Dieselbe Regel gilt für Ihre eigenen Verbindungen. Ändern Sie den Client, autorisieren Sie die Verbindung danach neu.

Für die meisten Automatisierungen in Zoho entscheidet das Modell über Antwortzeit und laufende Kosten. Anthropic rechnet nach Tokens ab. Ein Token ist ein kurzer Textbaustein, und die Preise gelten je Million Tokens Eingabe und Ausgabe. Die folgende Übersicht stammt aus der Modellübersicht von Anthropic.

Anthropic empfiehlt, im Zweifel mit Claude Opus 5.5 zu beginnen. Opus 5.5 kostet laut Anthropic 40 % weniger als Opus 5. Claude Sonnet 5.5 läuft nach Anthropics Angaben 30 % schneller als das Vorgängermodell und kostet für die meisten Aufgaben bis zu 30 % weniger.

Claude Haiku 4.5 beschreibt Anthropic als schnellstes Modell. Für kurze Einordnungen wirkt es daher naheliegend. Das frühestmögliche Ausmusterungsdatum liegt aber am 15. Oktober 2026. Hinterlegen Sie den Modellnamen deshalb an einer zentralen Stelle statt in jeder Funktion.

Die Models API von Anthropic liefert für jedes verfügbare Modell max_input_tokens, max_tokens und ein Objekt mit den Fähigkeiten. Damit prüfen Sie Grenzen, statt sie fest einzutragen.

Ein Prompt ist der Text, den Sie dem Modell zusammen mit den Daten übergeben. In einer Automatisierung liest niemand die Antwort vorab. Der Prompt muss deshalb eine Antwort erzwingen, die Ihre Funktion ohne Rückfrage verarbeiten kann. Bewährt hat sich ein Aufbau in vier Teilen:

1. eine feste Anweisung, was Claude tun soll und was nicht,
2. nur die Felder, die für diese Aufgabe nötig sind,
3. die Liste der erlaubten Werte für jedes Feld der Antwort,
4. eine Regel für den Zweifelsfall, etwa den Wert „unklar“.

Den folgenden Block fügen Sie als Vorgabe am Ende Ihres Prompts ein. Er zeigt Claude genau die Struktur, die Ihre Deluge-Funktion anschließend ausliest.

{
  "kategorie": "Rechnung",
  "prioritaet": "hoch",
  "zusammenfassung": "Kunde meldet eine doppelte Abbuchung im Oktober.",
  "sicherheit": "hoch",
  "rueckfrage_noetig": false
}

Anpassen müssen Sie die Schlüssel und Beispielwerte. Die Schlüssel kategorie und prioritaet benennen Sie so, wie Ihre Felder in Zoho heißen. Für kategorie nennen Sie im Prompt alle Werte Ihrer Auswahlliste. Mit sicherheit und rueckfrage_noetig meldet Claude, ob die Einordnung belastbar ist.

Weisen Sie Claude außerdem an, ausschließlich dieses JSON zu liefern, ohne einleitenden Satz. Jeder zusätzliche Text erschwert das Auslesen. Geben Sie Signaturen, lange Zitatverläufe und Anhänge nur mit, wenn die Aufgabe sie verlangt. Kürzere Eingaben sind billiger und schneller.

Eine Claude-Antwort darf erst nach einer Prüfung in Zoho CRM oder Zoho Desk landen. Ihre Deluge-Funktion liest das JSON, prüft jeden Schlüssel und vergleicht die Werte mit den erlaubten Einträgen. Ein Wert außerhalb der Auswahlliste wird nicht geschrieben, sondern als Fehler markiert. Fehlt ein Schlüssel ganz, behandeln Sie die Antwort als gescheitert.

Ordnen Sie jedem Schlüssel genau ein Feld zu. Die Zusammenfassung gehört in ein mehrzeiliges Textfeld, die Kategorie in eine Auswahlliste. Ein Zeitstempel und der verwendete Modellname zeigen später, welche Antwort von welchem Aufruf stammt.

Prüffelder statt direkter Statusänderung

Bei Svennis schreiben wir Claude-Antworten zuerst in eigene Prüffelder und lassen erst eine Workflow-Regel oder einen Menschen den eigentlichen Status ändern. So bleibt eine falsch eingeordnete Anfrage sichtbar, bevor sie eine Zuweisung oder eine Kundenmail auslöst.

Eine Workflow-Regel in Zoho besteht aus einem Auslöser und Bedingungen, die auf zuvor angelegte Aktionen verweisen. Sie kann auf die Prüffelder reagieren, etwa nur bei hoher Sicherheit automatisch zuweisen. Bei geringer Sicherheit landet das Ticket in einer Warteschlange zur Sichtung. Wie Sie solche Regeln für eingehende Post aufbauen, beschreibt der Beitrag zu E-Mail-Triage und Entwürfen mit Claude.

Das folgende Beispiel zeigt einen vollständigen Ablauf mit Zoho Flow, einer Deluge-Funktion und Claude. Ein neues Ticket in Zoho Desk erhält eine Zusammenfassung, eine Kategorie und eine Priorität. Die Feldnamen sind Vorschläge, die Sie an Ihr Desk-Layout anpassen.

1. Felder anlegen: Legen Sie in Zoho Desk die Felder „KI-Kategorie“ (Auswahlliste), „KI-Priorität“ (Auswahlliste), „KI-Zusammenfassung“ (mehrzeilig) und „KI-Status“ an.
2. Auslöser setzen: In Zoho Flow startet der Ablauf, sobald in Zoho Desk ein neues Ticket entsteht.
3. Daten sammeln: Die Deluge-Funktion liest Betreff und Beschreibung des Tickets und kürzt lange Zitatverläufe.
4. Claude aufrufen: Die Funktion schickt den festen Prompt mit der JSON-Vorgabe an die Claude API. Für kurze Einordnungen genügt ein schnelles Modell wie Claude Sonnet 5.5.
5. Antwort prüfen: Die Funktion liest das JSON aus und vergleicht Kategorie und Priorität mit den Auswahllisten.
6. Zurückschreiben: Gültige Werte landen in den KI-Feldern, „KI-Status“ wird auf „Vorschlag“ gesetzt. Ungültige Antworten setzen „KI-Status“ auf „Fehler“.
7. Sichtung: Die zuständige Person sieht den Vorschlag im Ticket und bestätigt oder korrigiert ihn.

Nach einigen Wochen zeigt der Vergleich zwischen Vorschlag und Korrektur, wo der Prompt nachgeschärft werden muss. Erst wenn die Korrekturen selten werden, lohnt sich eine automatische Zuweisung bei hoher Sicherheit. Den Ablauf übertragen Sie leicht auf Zoho CRM, etwa für die Einordnung neuer Leads.

Zoho-Funktionen laufen nicht unbegrenzt, und ein Claude-Aufruf kann länger dauern als geplant. Rechnen Sie damit, dass die Zoho-Umgebung eine Funktion nach einer festen Zeit abbricht. Den genauen Wert entnehmen Sie der Dokumentation des jeweiligen Zoho-Produkts. Planen Sie jeden Aufruf so, dass er deutlich darunter bleibt.

Drei Stellschrauben verkürzen die Antwortzeit:

• kurze Eingaben, also nur die nötigen Felder,
• eine kurze, fest strukturierte Antwort statt freier Texte,
• ein schnelles Modell für einfache Aufgaben wie die Einordnung.

Jeder Aufruf braucht einen definierten Fehlerweg. Scheitert der Aufruf oder fehlt das JSON, setzt die Funktion ein Statusfeld auf „Fehler“ und schreibt nichts anderes. Ein Mensch bearbeitet den Datensatz dann wie ohne KI. Wiederholen Sie fehlgeschlagene Aufrufe nicht in einer Schleife innerhalb derselben Funktion, denn das verlängert die Laufzeit nur weiter.

Protokolle und Aufrufmengen

Protokollieren Sie jeden Aufruf mit Zeitpunkt, Datensatz, Modell und Ergebnis. Der auf Glama gelistete MCP Server zeigt, wie das aussehen kann. Er protokolliert jedes Auth-Ereignis, jeden API-Aufruf und jede Genehmigungsentscheidung als JSON. Außerdem begrenzt er ausgehende Aufrufe standardmäßig auf 10 pro Sekunde. Eine solche Bremse schützt auch Ihre eigenen Abläufe, wenn viele Datensätze gleichzeitig eintreffen, etwa nach einem Import.

Eine Freigabe ist nötig, sobald eine Claude-Antwort etwas auslöst, das sich nicht folgenlos rückgängig machen lässt. Ein Vorschlag in einem Prüffeld braucht keine Freigabe. Eine Statusänderung, eine Kundenmail oder eine Löschung braucht eine. Für die Einordnung hilft eine einfache Abstufung:

• Lesen und zusammenfassen: keine Freigabe, das Ergebnis ist nur ein Hinweis.
• In Prüffelder schreiben: keine Freigabe, aber sichtbare Kennzeichnung als KI-Vorschlag.
• Status ändern oder zuweisen: Freigabe, solange die Trefferquote nicht belegt ist.
• Nach außen senden, löschen, Belege erzeugen: immer Freigabe durch einen Menschen.

Technisch lässt sich eine Freigabe als Warteschlange umsetzen. Der genannte MCP Server stellt destruktive Aktionen standardmäßig als ausstehende Anfrage mit einer request_id zurück, statt sie auszuführen. Ein Mensch genehmigt sie per approve_action oder verwirft sie per reject_action. Abschalten lässt sich das über ZOHO_REQUIRE_APPROVAL.

Dasselbe Prinzip funktioniert auch ohne eigene Software. Der Betreiber aus dem Forum r/Zoho lässt abgeschlossene Tickets per Cronjob in einen Rechnungsentwurf übernehmen und prüft diesen, bevor er ihn verwendet. Wie eine solche Prüfung bei Belegen aussieht, zeigen die Beiträge zu Angeboten mit Claude und zur Verarbeitung von Rechnungen und Verträgen mit Claude.

Der zoho-crm Skill ist eine Anleitungsdatei (SKILL.md), mit der KI-Werkzeuge wie Claude Code, Codex, Cursor oder GitHub Copilot in Visual Studio Code Lösungen für Zoho CRM entwerfen. Zoho beschreibt ihn als Orchestrierungsschicht über REST-APIs, Deluge-Funktionen, Client Scripts, Widgets, COQL, Abfragen und Verbindungen. Für Funktionen unterstützt der Skill derzeit nur Deluge, nicht Java, Node.js oder Python.

Den Skill installieren Sie mit dem folgenden Befehl im Terminal Ihres Entwicklungsprojekts.

npx skills add zoho/crm-skills

An dem Befehl ändern Sie nichts. In GitHub Copilot in Visual Studio Code rufen Sie den Skill danach mit /zoho-crm auf. Der Skill wählt die passende Operation der CRM API v8 und leitet Parameter und OAuth-Bereiche aus den OpenAPI-Beschreibungen ab. Mit MCP ruft er das API-Werkzeug direkt auf, ohne MCP erzeugt er eine vollständige cURL-Anfrage.

Der Skill arbeitet in fünf Schritten: Ziel verstehen, Baustein wählen, Referenzen laden, Lösung erzeugen und Ergebnis prüfen. Zoho will für bereits veröffentlichte APIs wöchentlich neue OpenAPI-Dateien bereitstellen. Wichtig ist der Hinweis in der Ankündigung des zoho-crm Skills: Der Skill beschleunigt die Entwicklung, ersetzt aber nicht die Prüfung durch Entwickler. Testen Sie jede erzeugte Funktion in einer Testumgebung, bevor sie mit echten Datensätzen läuft.

Jeder Claude-Aufruf aus Zoho überträgt Daten aus Ihrem CRM oder Ticketsystem an einen weiteren Dienst. Für Unternehmen in Deutschland heißt das: Der Datenweg muss beschrieben, vertraglich geregelt und auf das Nötige begrenzt sein. Das gilt für eine einzelne Deluge-Funktion ebenso wie für einen großen Ablauf in Zoho Flow.

Laut Anthropic sind die Modelle nicht nur über die Claude API verfügbar. Sie stehen auch über Amazon Bedrock, Google Cloud, Microsoft Foundry und die Claude Platform on AWS bereit. Wenn Ihr Unternehmen bereits Verträge mit einem dieser Cloud-Anbieter hat, kann dieser Weg die Abstimmung mit dem Datenschutz vereinfachen. Welche Bedingungen dort gelten, klären Sie mit dem jeweiligen Anbieter.

Datensparsamkeit setzen Sie im Prompt um. Übergeben Sie für eine Ticketeinordnung Betreff und Beschreibung, aber keine Bankverbindungen, Geburtsdaten oder Gesundheitsangaben. Ersetzen Sie Namen durch Datensatz-IDs, wenn Claude den Namen für die Aufgabe nicht braucht. Halten Sie in Ihrer Dokumentation fest, welche Felder jeder Ablauf überträgt und warum.

Welche Verträge Sie benötigen und welche Daten nie an das Modell gehen sollten, behandelt der Beitrag Claude DSGVO-konform nutzen. Klären Sie diese Punkte, bevor der erste Ablauf produktiv startet.

Der sicherste Einstieg ist ein einzelner, eng umrissener Ablauf mit Vorschlägen statt Entscheidungen. Diese Reihenfolge hat sich bewährt:

1. Wählen Sie einen Ablauf mit vielen gleichartigen Fällen, etwa die Einordnung neuer Tickets.
2. Legen Sie einen technischen Benutzer mit minimalen Rechten und eine Verbindung für den Claude-Schlüssel an.
3. Definieren Sie die JSON-Struktur und die passenden Prüffelder in Zoho CRM oder Zoho Desk.
4. Wählen Sie das Modell anhand von Tempo, Preis und Ausmusterungsdatum und hinterlegen Sie den Namen zentral.
5. Schließen Sie vor dem ersten Aufruf mit echten Datensätzen den Vertrag zur Auftragsverarbeitung mit dem Modellanbieter ab. Prüfen Sie die Grundlage für eine Übermittlung in Drittländer und tragen Sie den Ablauf in Ihr Verzeichnis von Verarbeitungstätigkeiten ein. Ergänzen Sie außerdem Ihre Datenschutzhinweise um den Modellanbieter als Empfänger und um die Drittlandübermittlung.
6. Testen Sie die Deluge-Funktion danach mit echten, aber unkritischen Datensätzen in einer Testumgebung.
7. Legen Sie fest, welche Schritte eine Freigabe brauchen, und protokollieren Sie jeden Aufruf.
8. Werten Sie nach einigen Wochen Vorschläge und Korrekturen aus, bevor Sie mehr automatisieren.

Brauchen Ihre Mitarbeitenden Claude zusätzlich im Dialog, etwa für Rückfragen zu Kunden, ist eine Automatisierung nicht der richtige Weg. Dafür eignet sich eine direkte Anbindung, die der Beitrag Claude mit Zoho CRM über MCP verbinden Schritt für Schritt beschreibt. Beide Wege ergänzen sich: Automatisierungen erledigen wiederkehrende Fälle, die MCP-Anbindung unterstützt die Arbeit im Einzelfall.