Hermes Agent für Freshdesk: so verbindest du ihn sicher (2026)

Warum ich mir Hermes auf Freshdesk angesehen habe

Mein Hauptjob bei eesel ist der Bau von Integrationen, und mit der API von Freshdesk habe ich genug Zeit verbracht, um Meinungen zu ihren Rate Limits zu haben. eesel betreibt seit Jahren KI auf Live-Support-Warteschlangen, und dieselbe Lektion kehrt immer wieder: Das Modell ist der leichte Teil. Schwer ist zu entscheiden, was die KI anfassen darf, und zu wissen, dass sie bereit ist, bevor ein Kunde der Erste ist, der merkt, dass sie es nicht ist.

Hermes Agent ist der quelloffene, selbst gehostete Agent von Nous Research, mit 251.479 GitHub-Sternen unter MIT-Lizenz. Die allgemeine Frage habe ich schon in Hermes Agent for customer support durchgearbeitet. Was du gerade liest, ist die Freshdesk-Version davon, und sie brauchte einen eigenen Beitrag, weil Freshdesk die Antwort letzten Monat geändert hat.

Vorab: Hermes liefert nichts Freshdesk-Spezifisches mit. Der kuratierte Katalog mit 68 MCP-Servern hat keinen Freshdesk-Eintrag, und als ich Hacker News, Reddit und X durchsucht habe, beschrieb auch niemand ein Setup aus Hermes und Freshdesk. Alles Folgende habe ich deshalb aus den Dokumentationen der beiden Anbieter zusammengesetzt, was ohnehin ungefähr der Weg ist, auf dem du es selbst bauen müsstest.

Was sich geändert hat: Freshdesk hat jetzt einen eigenen MCP-Server

Bis vor Kurzem bedeutete ein externer Agent auf Freshdesk Community-Code oder einen selbst geschriebenen Wrapper um die Freshdesk API v2. Jetzt betreibt Freshdesk einen eigenen Server. Laut dem MCP-Artikel gilt: "Starting September 10, 2026, the Freshworks MCP integration is generally available."

Die wichtigsten Fakten, alle aus den MCP-FAQs von Freshdesk und demselben Artikel:

• Pläne: Growth, Pro und Enterprise, nur in den Versionen 2021 Standalone oder Omni 2026. Ältere Konten werden nicht unterstützt.
• Endpunkt: https://<subdomain>.freshdesk.com/mcp. Eigene Domains funktionieren nicht.
• Authentifizierung: nur API-Schlüssel, und Aufrufe folgen den Rollenberechtigungen des jeweiligen Nutzers.
• Tools: 37, für Tickets, Konversationen, Kontakte, Agenten, Gruppen, Unternehmen und Help-Center-Artikel. Keine Lösch- oder Zusammenführungs-Tools.
• Standardmäßig aktiv. Ein Admin kann ihn unter Admin Settings > Apps & Integrations > MCP abschalten.

Er wird außerdem abgerechnet, und das ist für Freshdesk neu. Die Position steht auf jeder Plankarte:

Freshdesk dokumentiert Claude Code, Claude Desktop, Cursor, Copilot Studio und VS Code als Clients und ergänzt, dass "any AI tool that provides MCP support" funktioniert. Da Hermes MCP über HTTP spricht, fällt es darunter. Wer schon meinen Beitrag Claude for Freshdesk gelesen hat: Das ist derselbe Server, nur aus dem Early Access heraus und in günstigeren Plänen verfügbar.

Vier Wege, Hermes mit Freshdesk zu verbinden

Unten stehen alle Wege, die ich finden konnte, und wer den Code geprüft hat, der am Ende deinen API-Schlüssel hält:

Heute würde ich den ersten nehmen. Der Anbieter, dessen Daten betroffen sind, pflegt ihn selbst, und deine Helpdesk-Zugangsdaten machen keinen Umweg über Dritte. Er deckt außerdem Help-Center-Artikel ab, was der Server von effytech nicht tut (er hat keine Tools für Lösungsartikel). Der Webhook-Weg ist weniger eine vierte Alternative als ein Auslöser: Er sagt Hermes, dass ein Ticket eingetroffen ist, und Hermes braucht trotzdem einen der anderen drei, um es tatsächlich zu lesen oder zu beschreiben.

So richtest du es sicher ein

In dieser Reihenfolge würde ich vorgehen. Die meisten Schritte gibt es nur wegen eines einzigen Satzes in den Freshdesk-FAQs: "tool-level access management is not available. All supported MCP tools are available by default to any user who connects using a valid API key."

1. Gib Hermes einen eigenen Agentenplatz

Der MCP-Server handelt als der Agent, zu dem der API-Schlüssel gehört. Fügst du deinen eigenen Schlüssel ein, kann Hermes alles, was du kannst, und jede geschriebene Notiz sieht aus, als hättest du sie verfasst.

Ich würde einen eigenen Agenten für den Bot anlegen, ihm eine enge Rolle geben und ihn etwa "Hermes (draft only)" nennen. Bei Freshdesk heißt das ein bezahlter Platz, ab 19 $/Agent/Monat bei Growth bei jährlicher Abrechnung. Von allem in diesem Setup ist das die günstigste Sicherheitsfunktion, denn Rollenberechtigungen sind die einzige Grenze, die Freshdesk serverseitig durchsetzt.

2. Füge den Server hinzu und filtere seine Tools

Hermes hält MCP-Server unter mcp_servers in ~/.hermes/config.yaml und löst ${VAR}-Platzhalter aus ~/.hermes/.env auf. Außerdem kannst du pro Server Tools auf eine Whitelist setzen (Hermes MCP docs). Kombiniert mit dem Endpunkt und dem Auth-Header von Freshdesk ergibt das die Konfiguration unten, meine eigene Zusammenstellung der beiden Dokumentationen und kein offizielles Beispiel:

mcp_servers:
  freshdesk:
    url: "https://yourcompany.freshdesk.com/mcp"
    headers:
      Authorization: "${FRESHDESK_API_KEY}"
    tools:
      include:
        - fetchTicket
        - fetchTicketConversations
        - fetchSearchTickets
        - fetchSolutionArticle
        - createTicketNote

Sobald include gesetzt ist, gilt laut Hermes-Dokumentation: "Only those MCP server tools are registered." Diese eine kurze Liste übernimmt also die Aufgabe, die die Berechtigungen von Freshdesk nicht erfüllen können.

Hermes hat außerdem eine trust-Einstellung pro Server. Bei einem untrusted-Server "every write-capable tool call... requires user approval through the standard approval surface before it runs" (MCP config reference). Der Standard ist full. Falls du Hermes aus einem Slack- oder Telegram-Chat startest, in dem jemand zusieht, bringt untrusted eine zweite Kontrolle für jede Notiz.

3. Schreibe private Notizen, niemals Antworten

Freshdesk hält beides auf API-Ebene getrennt. Eine Notiz, die du über /notes hinzufügst, ist standardmäßig privat, und "Private notes are for collaboration between agents and are not visible to the customer." Der Update-Endpunkt dagegen sagt: "Only public & private notes can be edited" (Freshdesk API). Eine gesendete Antwort bleibt gesendet.

Der Ablauf sieht so aus: Hermes entwirft in eine private Notiz, ein Agent liest sie durch und sendet die Antwort unter eigenem Namen. Die KI-Entwurfsantworten von Freshdesk funktionieren nach demselben Muster, ebenso jedes Agent-Assist-Tool. Meine Regel: dabei bleiben, bis die Fehlgriffe langweilig werden.

4. Wähle einen Auslöser: Chat, Cron oder Webhook

Hermes muss wissen, wann es sich ein Ticket ansehen soll, und dafür gibt es drei Optionen:

• Auf Anfrage. Ein Agent fügt eine Ticketnummer in Slack ein und bittet Hermes um einen Entwurf. Das ist die einfachste Variante, und ein Mensch bleibt die ganze Zeit eingebunden.
• Cron-Abfrage. Der Scheduler von Hermes tickt alle 60 Sekunden, und ein Vorprüfungsskript kann {"wakeAgent": false} ausgeben, sodass "cron skips the agent run entirely", wenn sich nichts geändert hat (cron docs). Gut für "alle 5 Minuten Notizen-Entwürfe für neue Tickets in dieser Gruppe".
• Webhook. Eine Freshdesk-Automatisierungsregel bei Ticketerstellung löst "Trigger webhook" an einer Hermes-Route wie http://your-server:8644/webhooks/freshdesk aus.

Von den dreien sind Webhooks am echtzeitnächsten und auch am fummeligsten. Hermes verlangt auf jeder Route ein Secret und lehnt jede Anfrage ohne "a recognized signature header" ab (webhook docs). Die Regel von Freshdesk kann eigene Header hinzufügen, aber eine Option zum Signieren des Bodys habe ich nicht gefunden. Teste also vorab, welches der von Hermes akzeptierten Verfahren deine Regel überhaupt erfüllen kann. Bei Fehlern wiederholt Freshdesk alle 30 Minuten, 48 Mal, und Webhooks sind auf 1.000 Aufrufe pro Stunde begrenzt (Freshdesk help).

Ein paar weitere Webhook-Details sind gut zu wissen. Webhook-Läufe starten mit einem schmalen Standard-Toolset, die Route braucht also eine manuelle Freigabe toolsets: ["mcp-freshdesk"], bevor sie Tickets anfassen kann. Die Dokumentation warnt außerdem: "HMAC validation authenticates the sender, not the content." Da ein Kunde den Ticketinhalt schreibt, behandle ihn als nicht vertrauenswürdigen Text. Das ist ein weiterer Grund dafür, dass das einzige Schreib-Tool eine private Notiz ist.

5. Teste an alten Tickets, bevor du vertraust

Hier würde ich die meiste Zeit investieren, und hier hilft Hermes am wenigsten. Es hat keinen Replay-Modus, um die Tickets des letzten Monats durchzuspielen und die Entwürfe mit dem zu vergleichen, was dein Team tatsächlich gesendet hat.

Du kannst das selbst bauen: gelöste Tickets holen, Hermes in einem Sandbox-Profil darüber laufen lassen und dann vergleichen. Dabei gibt es zwei Freshdesk-Fallen. List Tickets liefert "by default" nur Tickets, die "created within the past 30 days" wurden, außer du übergibst updated_since, und der Such-Endpunkt hört bei etwa 300 Ergebnissen auf (Freshdesk API). Hinzu kommt: Jeder Lesezugriff während der Evaluierung zählt gegen dein MCP-Kontingent, deshalb ist es sinnvoller, die Evaluierung über die REST-API laufen zu lassen. Wie "gut genug" aussieht, erkläre ich in meinem Leitfaden zum Trainieren von KI auf einer Wissensdatenbank.

Was Hermes auf Freshdesk wirklich kostet

Die Lizenz kostet nichts. Die anderen vier Posten auf der Rechnung schon.

MCP-Aktionen. "Any call to an MCP server counts as one action, regardless of whether it reads or writes data" (MCP FAQs). Das Kontingent gilt pro Konto und Jahr und wird nicht übertragen:

Alles darüber kostet 15 $ pro 1.000, laut Preisseite. Die REST-Limits stammen aus der API-Dokumentation und gelten kontoweit gemeinsam mit jeder anderen Integration, die du betreibst.

Ein brauchbarer Entwurf braucht mehr als einen Aufruf. Hermes liest das Ticket, dann den Verlauf, sucht ähnliche Tickets und holt einen Help-Artikel, bevor es die Notiz schreibt:

Bei fünf Aktionen pro Ticket deckt Growth etwa 240 Entwürfe im Jahr ab, grob 20 im Monat. Danach sind es 7,5 Cent pro Ticket an Aktionen, was pro Ticket günstig aussieht, in der Summe aber leicht unterschätzt wird. Agenten wiederholen und erkunden außerdem, behandle fünf also als Untergrenze, nicht als Durchschnitt. Hier kannst du eigene Zahlen einsetzen:

Modell-Tokens. Nous Portal Plus kostet 20 $/Monat für 22 $ Guthaben, Super 100 $ und Ultra 200 $. Eine andere Möglichkeit ist, einen geeigneten ChatGPT-Plan zu verbinden und ihn für die Inferenz zu nutzen.

Der Platz des Bots. Zwischen 19 und 89 $ im Monat, je nachdem, welchen Plan du hast.

Der Bau. Dieser Posten wird gern übersehen. Ein Freshdesk-Käufer aus den Verkaufsgesprächen von eesel, ein E-Mail-Sicherheitsunternehmen mit Kurs auf 20.000 Tickets im Jahr, ging an einem einzigen Testtag 200 Interaktionen durch, und die erste Frage war, wie das bei 9.000 im Monat aussähe. Bei abgerechneter KI wird das Volumen zur ersten Frage eines Support-Leiters, und Hermes lässt dich drei Dinge gleichzeitig messen: Tokens und MCP-Aktionen, und obendrauf Ingenieurstunden. Zu Letzterem liefert meine Aufschlüsselung build vs buy Zahlen.

Wo Hermes auf Freshdesk an Grenzen stößt

All das geht vom Entwurfs-Muster aus. Sobald du Hermes direkt auf Freshdesk-Kunden ansetzt, stößt du auf dieselben Wände wie im allgemeinen Support-Review:

• Der Speicher gilt pro Profil, nicht pro Anfragendem. Der eingebaute Speicher besteht aus MEMORY.md (2.200 Zeichen) und USER.md (1.375) und wird in jede Session geladen, die das Profil ausführt (memory docs). Was es aus dem Ticket eines Kunden speichert, steht dann im Prompt für den nächsten.
• Kein Freshdesk-Zustellziel. Die deliver-Optionen eines Webhook-Laufs sind Chat-Plattformen, E-Mail oder ein Log. Um die Antwort ins Ticket zu bringen, gehst du immer über einen Tool-Aufruf.
• Keine Probe. Das habe ich oben behandelt, und es ist die Lücke, der ich das meiste Gewicht gebe.
• Den nativen Bot gibt es schon. Der Freddy AI Agent von Freshdesk ist in jedem Plan enthalten, mit 500 einmaligen Sessions, danach 49 $ pro 100. Wenn du einen kundenorientierten Bot innerhalb von Freshdesk willst, würde Hermes nachbauen, was der Helpdesk schon verkauft.

Es gibt einen Hacker-News-Nutzer, der tatsächlich einen Hermes-basierten Helpdesk betreibt, und dieser Thread fasst den Zielkonflikt gut zusammen:

"We replaced our helpdesk with Hermes. It has long term memory about our business. When a customer messages us, Hermes gets all the relevant details about the customer and creates a Pi session using Gemma 4 running locally and customer talks to that agent."

theturtletalks, Hacker News

Die erste Antwort fragte, ob das riskiere, dass "one customer's data leaking to another" (dezgeg, Hacker News). Schau dir aber das Design an. Hermes ist nicht der Agent, mit dem der Kunde spricht; stattdessen startet es für jeden Kunden eine eigene lokale Session. Das ist eine vernünftige Architektur, aber auch sehr viel Architektur.

Hermes vs. Freddy AI vs. eesel auf Freshdesk

Für den breiteren Vergleich gehen meine Übersicht best AI for Freshdesk und die Liste Freshdesk AI alternatives tiefer, während Hermes Agent alternatives die Seite der allgemeinen Agenten abdeckt.

Solltest du Hermes auf deiner Freshdesk-Warteschlange betreiben?

Nach der Lektüre beider Dokumentationen lande ich hier.

Ja, wenn du einen Entwickler hast, dem solche Arbeit Spaß macht, und die Aufgabe darin besteht, Notizen für Agenten zu entwerfen, die sie prüfen, solange dein Volumen ins Aktionskontingent passt. Der offizielle MCP-Server mit einer include-Liste aus fünf Tools ist ein aufgeräumtes Setup, das du vertreten kannst, und obendrauf bieten dir die Cron- und Webhook-Funktionen von Hermes echte Automatisierung. Es passt auch gut als interner Support-Chatbot, der dein eigenes Team aus dem Freshdesk-Verlauf beantwortet.

Nein, wenn du willst, dass KI Kunden antwortet, oder du ein Protokoll jeder KI-Aktion brauchst, das ein Support-Manager ohne SSH lesen kann. Gleiche Antwort, wenn niemand Zeit hat, eine YAML-Datei und ein Evaluierungs-Setup zu pflegen. Und die Freshdesk-Sicherheitsprüfung, die du bei jedem Anbieter machen würdest, wird zu einer, die du jetzt auf deinem eigenen Server durchführst.

Ehrlich gesagt hat Freshdesk die Verdrahtung gerade zum leichten Teil gemacht. Was bleibt, ist das Problem der KI-Halluzinationen samt Probe und Leitplanken drumherum, und das ist die eigentliche Arbeit, KI auf eine Warteschlange zu bringen.

eesel für Freshdesk

Wenn du dir Hermes angesehen hast, weil du KI willst, die deine Freshdesk-Tickets bearbeitet, ist eesel das Teammitglied, das genau dafür gebaut wurde. Es verbindet sich mit deiner Freshdesk-Subdomain und einem API-Schlüssel, ohne App-Installation, und lernt aus deinem Help Center und deinen Textbausteinen sowie aus deinen gelösten Tickets (eesel docs).

So passt es auf die obigen Lücken:

• Erst proben. Es simuliert an deinen vergangenen Freshdesk-Tickets, bevor es einem einzigen Kunden antwortet.
• Du bestimmst die Schreibstufe. Es kann interne Notizen hinterlassen, Antwortentwürfe zur Freigabe zurückhalten oder senden. Taggen und Zuweisen sind ebenfalls dabei, dazu Status setzen und Felder aktualisieren, was auch das Freshdesk Auto-Triage abdeckt.
• Keine Abrechnung pro Aufruf. Ein Ticket kostet 1 Credit, egal wie viele Antworten hin und her gehen. Pläne beginnen bei 299 $ für 500 Credits, und der kostenlose Plan enthält 100 Credits.
• Freshchat inklusive. Dieselbe Verbindung deckt auch den Freshdesk-Chat ab, es gibt also keine zweite Einrichtung.

Und wenn der halbe Reiz von Hermes das Terminal war: eesel hat auch eines. Die eesel CLI steuert dasselbe Teammitglied: eesel integrations connect freshdesk verbindet das Konto, eesel integrations download start zieht den Ticketverlauf, und eesel automations legt fest, was bei jedem Auslöser passiert. Weil die Befehle JSON ausgeben, kann ein Skript oder ein Coding-Agent wie Claude Code dein Freshdesk-Setup von Anfang bis Ende ausführen. Mehr dazu in meinem Beitrag CLI for customer support.

Behalte Hermes für die Aufgaben, in denen es glänzt. Für die Freshdesk-Warteschlange aber probiere erst eesel an deinen echten Tickets aus.