So richten Sie Analytics mit Hermes Agent und dem Flowsery-Plugin ein

Analytics mit Hermes Agent richten Sie mit zwei Terminalbefehlen und einer Anmeldung im Browser ein, über das Flowsery-Plugin aus dem Hermes-Plugin-Katalog. Danach beantwortet Hermes Fragen zu Ihrer Website aus Ihren echten Flowsery-Daten: wer kam, woher, was konvertiert hat, was Umsatz gebracht hat und was kaputt ist.

Hermes Agent, der Agent von Nous Research, läuft in Ihrem Terminal und kann geplante Aufgaben selbstständig ausführen. Ab Werk kann er Ihre Website-Analytics nicht lesen. Das Flowsery-Plugin ergänzt genau das. Flowsery hält die Daten, Hermes fragt Flowsery, und Sie geben alles frei, was eine Zahl verändert.

Die Kurzfassung: Fügen Sie Ihre Website auf flowsery.com hinzu und installieren Sie das Tracking-Snippet, führen Sie hermes plugins install flowsery und hermes plugins enable flowsery aus, starten Sie eine neue Hermes-Sitzung und melden Sie sich an, wenn sich der Browser öffnet. Fragen Sie Hermes dann: "Wie ist mein Traffic diese Woche im Vergleich zur letzten Woche?" Wenn die Antwort Ihre Besucher enthält, funktioniert das Plugin.

Was ist das Flowsery-Plugin für Hermes Agent?

Das Flowsery-Plugin ist ein Eintrag im Hermes-Plugin-Katalog, gelistet im Hermes Marketplace unter Tools, der Hermes Agent mit dem Flowsery-MCP-Server unter https://mcp.flowsery.com/mcp verbindet. Das Paket enthält drei Dinge: ein plugin.json-Manifest, eine mcp.json-Serverkonfiguration und einen Skill, der Hermes beibringt, Analytics-Fragen mit Flowsery zu beantworten. Eigenen Code liefert es nicht mit.

Der Server ist derselbe, den Claude Code, ChatGPT und Cursor nutzen, also liest Hermes dieselben Zahlen, die Ihr Flowsery-Dashboard zeigt. Flowsery listet Hermes auf der Seite zu KI-Agenten und im Tab AI Agents der Seite API Tokens in der App.

Hermes speichert nie ein Flowsery-Passwort. Sie melden sich einmal im Browser an, und das Plugin behält ein OAuth-Token, das es selbst erneuert.

Was brauchen Sie vor der Installation?

Sie brauchen Hermes Agent 0.21.6 oder neuer, Node.js 20.18.1 oder neuer mit npx im PATH und ein Flowsery-Konto mit mindestens einer Website, auf der das Flowsery-Tracking-Snippet läuft. Der Team-Plan von Flowsery (250 $ im Monat) und der Pro-Plan (500 $ im Monat) enthalten beide den MCP-Server, und beide starten mit einer 14-tägigen kostenlosen Testphase ohne Kreditkarte.

Die Node.js-Voraussetzung wird am häufigsten übersehen. Das Plugin startet eine kleine Anmeldebrücke, mcp-remote, über npx, daher scheitert eine Hermes-Installation auf einem Rechner ohne Node beim Anmeldeschritt.

Wie installieren Sie das Flowsery-Plugin in Hermes Agent?

Sie installieren Flowsery per Namen aus dem Hermes-Plugin-Katalog und melden sich einmal im Browser an:

1. Führen Sie hermes plugins install flowsery aus. Hermes zeigt die Fähigkeitsübersicht des Eintrags, bevor es etwas klont, und checkt dann genau den Commit aus, den der Katalog geprüft hat.
2. Führen Sie hermes plugins enable flowsery aus. Die Installation legt das Plugin auf die Festplatte, das Aktivieren lässt Hermes es laden. Im Terminal fragt der Installationsschritt auch "Enable now?", ein Ja deckt also beides ab.
3. Starten Sie eine neue Hermes-Sitzung. Beim ersten Start des Servers öffnet Ihr Browser die Flowsery-Anmeldeseite.
4. Melden Sie sich mit der E-Mail-Adresse an, die Sie bei Flowsery nutzen, und erlauben Sie den Zugriff.
5. Fragen Sie Hermes: "Listen Sie meine Flowsery-Websites auf."

hermes plugins install flowsery
hermes plugins enable flowsery

Das Token wird gespeichert und erneuert, Sie melden sich also nur einmal an. Wenn die Tools nach der Anmeldung nicht erscheinen, führen Sie /reload-mcp in der Sitzung aus.

Sie können auch direkt von GitHub installieren, mit hermes plugins install Flowsery/claude-plugin --no-enable und danach hermes plugins enable flowsery. Nehmen Sie den Weg über den Katalog, denn er installiert den Commit, den ein Mensch geprüft hat.

Was installiert das Plugin auf Ihrem Rechner?

Das Flowsery-Plugin installiert eine Konfiguration, kein Programm. mcp.json startet das fest gepinnte mcp-remote@0.1.49 über npx, das es beim ersten Start von npm lädt, öffnet einen lokalen Callback-Port für die Anmeldung und speichert die OAuth-Tokens in ~/.mcp-auth. Das Paket sendet keine Telemetrie.

Der Katalog pinnt einen 40-stelligen Commit, und Installationen checken diesen Pin aus statt der Spitze eines Branches. Die Liste der Tools deckt der Pin nicht ab. Der Flowsery-Server legt die Tools zur Laufzeit fest, also erreicht ein neues Tool auf dem Server Hermes ohne neue Prüfung im Katalog. Das steht im Hinweis des Eintrags und in der README des Plugins.

Welche Analytics kann Hermes Agent über Flowsery lesen?

Hermes Agent bekommt über das Plugin 28 Flowsery-Tools, und 23 davon lesen nur. Jeder Bericht nimmt einen Zeitraum, eine Zeitzone und Filter nach Land, Region, Stadt, Gerät, Browser, Betriebssystem, Seite, Hostname, Referrer, Kanal und UTM-Parametern. Das deckt nach Aufgabe Folgendes ab:

• Traffic. Besucher, Sitzungen, Absprungrate, Sitzungsdauer, Umsatz, Umsatz pro Besucher und Conversion-Rate für jeden Zeitraum, dazu dieselben Kennzahlen pro Stunde, Tag, Woche oder Monat.
• Live-Besucher. Wie viele Menschen in den letzten 5 Minuten aktiv waren, und eine Karte dieser Besucher nach Stadt.
• Aufschlüsselungen. Besucher nach Seite, Referrer, Kanal, UTM-Kampagne, Land, Region, Stadt, Gerät, Browser, Betriebssystem und Hostname. Ein weiteres Tool gruppiert Besucher nach jeder von 25 Dimensionen, Einstiegsseite und jeder UTM-Parameter eingeschlossen. Referrer nennen bekannte Quellen wie Google, ChatGPT und Reddit beim Namen.
• Ziele und Umsatz. Abschlüsse für jedes Ziel, einschließlich der automatischen Ziele für Zahlungen und kostenlose Testphasen.
• Ein Besucher. Standort, Gerät, Quelle, Besuche, Ziele, Umsatz und Zeitachse eines einzelnen Besuchers.
• Sitzungsprobleme. Die Bugs, kaputten Abläufe und UX-Probleme, die die KI von Flowsery in Sitzungsaufzeichnungen gefunden hat, nach Schweregrad sortiert, mit den Schritten zur Reproduktion und einem verknüpften Linear- oder Jira-Ticket.

Kein Tool gibt IP-Adressen oder Rechnungsdaten zurück, und die Live-Karte rundet Koordinaten auf 0,1 Grad. Hermes sieht, was Ihr Flowsery-Dashboard für Ihre eigenen Websites zeigt, und nicht mehr.

Welche MCP-Tools von Hermes Agent fragen nach Freigabe?

Hermes Agent fragt Sie vor jedem der fünf Flowsery-Tools, die Daten ändern, um Freigabe, weil die plugin.json des Plugins den Flowsery-Server als untrusted markiert. Diese fünf sind track_goal, das einen Zielabschluss erfasst, delete_goals, das passende Zielabschlüsse dauerhaft löscht, track_payment, das eine Zahlung, Verlängerung oder Rückerstattung für die Umsatzzuordnung erfasst, delete_payments, das passende Zahlungseinträge dauerhaft löscht, und update_issue_status, das ein Problem auf offen, in Bearbeitung, gelöst oder ausgesetzt setzt. Die Zahlungs-Tools ändern nur Analytics-Einträge und belasten oder erstatten nie jemanden. Die anderen 23 Tools tragen eine Nur-Lesen-Markierung und laufen ohne Rückfrage.

Hermes verweigert diese fünf Tools außerdem in Cron-Jobs und anderen unbeaufsichtigten Läufen. Eine geplante Hermes-Aufgabe kann um 7 Uhr den Traffic der letzten Nacht lesen, aber um 7 Uhr keine Ziel- oder Zahlungsdaten löschen, während niemand zusieht. Für Analytics ist das die richtige Voreinstellung. Ein falscher Lesezugriff kostet Sie eine verwirrende Antwort. Ein falsches Löschen kostet Sie Verlauf, den Sie nicht zurückbekommen.

Ihre Rolle im Workspace ist die zweite Grenze, denn Hermes handelt als Sie. Die fünf Schreibzugriffe brauchen die Berechtigung flowsery.write, die die Rollen Admin und Editor haben. Fehlt sie Ihrer Rolle, antwortet Flowsery mit permission_denied, und Hermes sagt Ihnen, dass ein Workspace-Admin Ihre Rolle ändern muss.

Welche Prompts sollten Sie zuerst ausprobieren?

Diese Prompts stammen aus der README des Plugins, hier übersetzt. Unter jedem steht, was Hermes in Flowsery tut.

"Wie ist mein Traffic diese Woche im Vergleich zur letzten Woche?"

Hermes listet Ihre Websites, liest die Zeitzone der Website und ruft die Übersicht zweimal ab, einmal pro Woche. Sie bekommen Besucher, Sitzungen, Absprungrate, Umsatz und Conversion-Rate nebeneinander. Wenn Sie mehrere Websites haben, nennen Sie die Domain, sonst fragt Hermes, welche Sie meinen.

"Welche Kanäle und Kampagnen haben diesen Monat zahlende Kunden gebracht?"

Hermes liest Ihre Kanäle und UTM-Kampagnen für den Monat mit dem Umsatz daneben. Die Kanäle folgen Gruppen im Stil von GA4 wie Organic Search, Paid Social, Email und Direct, also passt die Antwort zu der Art, wie die meisten Teams ohnehin berichten.

"Am Dienstag sind die Besucher eingebrochen. Prüfen Sie Seiten, Referrer und Geräte und sagen Sie mir, warum."

Hermes vergleicht den Dienstag mit den Tagen davor und danach über drei Aufschlüsselungen und zeigt auf die, die sich bewegt hat, etwa einen Referrer, der verstummt ist, oder eine Seite, die keine Besuche mehr bekommt. Bei dieser Art Frage schlägt ein Agent das Dashboard, weil er die Berichte abruft und vergleicht, die Sie sonst einzeln durchklicken würden.

"Wie viel Traffic haben uns ChatGPT, Perplexity und andere KI-Assistenten diesen Monat geschickt?"

Hermes liest Ihre Referrer für den Monat und zieht die KI-Assistenten heraus. Flowsery nennt bekannte Quellen beim Namen, also erscheint ChatGPT als ChatGPT statt als rohe Domain.

"Was hat Flowsery diese Woche in Sitzungsaufzeichnungen gefunden? Setzen Sie den Checkout-Bug auf in Bearbeitung."

Hermes listet die Probleme dieser Woche nach Schweregrad, öffnet das Checkout-Problem mit seinen Vorkommen und den Schritten zur Reproduktion und fragt dann um Ihre Freigabe, bevor es den Status ändert. Nur der Status ändert sich. Das Problem, seine Sitzungen und seine Kommentare bleiben, wie sie waren.

"Zeigen Sie mir den Weg des Besuchers, der gerade eine kostenlose Testphase gestartet hat."

Hermes findet den Besucher unter den Menschen auf der Live-Karte und liest dann dessen Profil: woher er kam, welches Gerät er nutzte, seine Besuche, die abgeschlossenen Ziele und eine Zeitachse der Seiten, die neuesten zuerst. Namen, E-Mail-Adressen, User-IDs und IP-Adressen sind nie Teil der Antwort.

Kann Hermes Agent Ihnen einen täglichen Traffic-Bericht schicken?

Hermes Agent kann Ihnen über seinen Cron-Planer einen täglichen Traffic-Bericht schicken, weil die Flowsery-Tools, die er dafür braucht, nur lesen. Fragen Sie in normalen Worten, zum Beispiel: "Geben Sie mir jeden Morgen um 9 Uhr die Besucher von gestern, die fünf wichtigsten Referrer und neue Probleme mit hohem Schweregrad aus Flowsery und schicken Sie mir das per Telegram." Hermes legt den Job mit seinem eigenen Cron-Tool an, oder Sie fügen im Chat einen mit /cron add hinzu.

Der Bericht läuft zur eingestellten Zeit in einer frischen Sitzung und liefert das Ergebnis in den Chat, aus dem Sie gefragt haben, oder an eine Plattform, die Sie konfiguriert haben. Er kann keine Ziele oder Zahlungen erfassen oder löschen und keinen Problemstatus ändern, weil Hermes schreibende Tools in unbeaufsichtigten Läufen verweigert. Wenn der Bericht auch Probleme markieren soll, erledigen Sie diesen Schritt in einer Sitzung, in der Sie zur Freigabe da sind.

Wie betreiben Sie Hermes Agent headless mit einem API-Schlüssel?

Auf einem Server oder einem Rechner ohne Browser lassen Sie das Plugin weg und tragen den Flowsery-MCP-Server mit einem API-Schlüssel in ~/.hermes/config.yaml ein. Die OAuth-Anmeldung braucht ein Browserfenster, und ein Headless-Rechner hat keins.

mcp_servers:
  flowsery:
    url: 'https://mcp.flowsery.com/mcp'
    headers:
      Authorization: 'Bearer ${FLOWSERY_API_KEY}'

Erstellen Sie den Schlüssel unter flowsery.com/api-tokens und schreiben Sie FLOWSERY_API_KEY=... in ~/.hermes/.env. Der Schlüssel wirkt wie ein Passwort für Ihr Flowsery-Konto, also gehört er nicht in Chats.

Dieser Weg lässt das Plugin weg, also auch seinen Skill und die Einstellung untrusted in seiner plugin.json. Ein Workspace-Token trägt die Rolle, die Sie beim Erstellen wählen, und das Formular Create Token markiert die Rolle Contributor mit "Recommended for AI agents". Ein Contributor-Token liest Ihre Analytics und bekommt bei allen fünf Schreibzugriffen permission_denied, und genau das sollte ein Headless-Analytics-Agent haben.

Wann sollten Sie stattdessen Claude Code, ChatGPT, Zapier oder n8n nutzen?

Nutzen Sie Hermes, wenn Sie ohnehin darin arbeiten. Dasselbe Flowsery-Paket installiert sich in Claude Code mit /plugin install flowsery --marketplace Flowsery/claude-plugin, und ChatGPT hat ein eigenes gelistetes Plugin, beschrieben im Leitfaden zum ChatGPT-Analytics-Plugin von Flowsery. Cursor, Claude Desktop und Gemini CLI verbinden sich ebenfalls mit https://mcp.flowsery.com/mcp, und ein Agent, der nur ein Bearer-Token annimmt, etwa ein benutzerdefinierter Connector in Manus, funktioniert mit einem Workspace-Token, wie der Leitfaden zum Manus-Cue-Connector für Web-Analytics zeigt.

Wenn Zahlen aus einem Workflow statt aus einem Gespräch kommen sollen, nutzen Sie ein Automatisierungstool. Die Flowsery-Node für n8n verschickt Wochenberichte und Warnungen zu neuen Problemen von Ihrem eigenen Server, und der Leitfaden zu Analytics mit Zapier baut dieselben Abläufe ohne Server. Beide können auch bei jedem eingehenden Verkauf automatisch eine Zahlung erfassen, während Hermes eine Zahlung nur erfasst, wenn Sie darum bitten und sie freigeben.

Häufig gestellte Fragen

Kann Hermes Agent meine Website-Analytics lesen?

Hermes Agent liest Ihre Website-Analytics über das Flowsery-Plugin aus dem Hermes-Plugin-Katalog. Installieren Sie es mit hermes plugins install flowsery, aktivieren Sie es und melden Sie sich mit Ihrem Flowsery-Konto an. Danach beantwortet Hermes Fragen zu Besuchern, Traffic-Quellen, Zielen, Umsatz, Live-Besuchern und den Problemen, die Flowsery in Sitzungsaufzeichnungen gefunden hat.

Brauche ich einen API-Schlüssel, um Flowsery in Hermes Agent zu nutzen?

Das Flowsery-Plugin für Hermes Agent braucht keinen API-Schlüssel. Es meldet sich beim ersten Start des Servers per OAuth in Ihrem Browser an und erneuert das Token selbst. Einen API-Schlüssel brauchen Sie nur für ein Headless-Setup, bei dem Sie den Server mit einem Schlüssel von flowsery.com/api-tokens in ~/.hermes/config.yaml eintragen.

Welche Hermes-Agent-Version braucht das Flowsery-Plugin?

Das Flowsery-Plugin braucht Hermes Agent 0.21.6 oder neuer und Node.js 20.18.1 oder neuer mit npx im PATH. Node.js startet mcp-remote, die Brücke, die die Anmeldung übernimmt und mit dem Flowsery-MCP-Server spricht.

Kann Hermes Agent meine Flowsery-Daten ohne Rückfrage ändern?

Hermes Agent ändert keine Flowsery-Daten ohne Rückfrage. Nur fünf Tools schreiben: track_goal, delete_goals, track_payment, delete_payments und update_issue_status. Das Plugin markiert den Server als untrusted, also fragt Hermes vor jedem dieser fünf und verweigert sie in Cron- und anderen unbeaufsichtigten Läufen. Die anderen 23 Tools lesen nur.

Kann ein Hermes-Cron-Job mir einen Traffic-Bericht schicken?

Ein Hermes-Cron-Job kann Flowsery lesen und Ihnen einen Bericht schicken, weil jedes Berichts-Tool nur liest. Bitten Sie Hermes etwa: "schicken Sie mir jeden Morgen um 9 Uhr die Besucher von gestern und die wichtigsten Referrer", und es plant den Job. Der Cron-Job kann keine Ziele oder Zahlungen erfassen oder löschen und keinen Problemstatus ändern.

Wo speichert das Plugin meine Flowsery-Anmeldung?

Das Flowsery-Plugin speichert seine OAuth-Tokens in ~/.mcp-auth auf Ihrem Rechner. Die Brücke mcp-remote schreibt sie nach der Anmeldung dorthin und erneuert sie, Sie melden sich also nur einmal an. Das Paket sendet keine Telemetrie.

Warum erscheinen die Flowsery-Tools nach der Anmeldung nicht in Hermes?

Führen Sie /reload-mcp in der Hermes-Sitzung aus, wenn die Flowsery-Tools nach der Anmeldung im Browser fehlen. Prüfen Sie auch, ob das Plugin aktiviert ist, denn hermes plugins install legt es auf die Festplatte und hermes plugins enable flowsery lässt Hermes es laden.

Kann Hermes Agent die IP-Adressen meiner Besucher sehen?

Hermes Agent bekommt über Flowsery nie IP-Adressen oder Rechnungsdaten, weil kein Flowsery-Tool sie zurückgibt. Das Profil eines einzelnen Besuchers zeigt ungefähren Standort, Gerät, Quelle, Besuche, Ziele und Umsatz, und die Live-Karte rundet Koordinaten auf 0,1 Grad.

Funktioniert das Flowsery-Plugin mit mehreren Websites?

Das Flowsery-Plugin funktioniert mit jeder Website in jedem Workspace, den Ihre Anmeldung erreicht. Hermes ruft zuerst list_websites auf und fragt bei mehreren Websites, welche Sie meinen. Nennen Sie die Domain oder den Workspace in Ihrer Frage, um diesen Schritt zu sparen.

Kann Hermes Agent Zahlungen in Flowsery erfassen?

Hermes Agent erfasst Zahlungen in Flowsery über das Tool track_payment, das eine Zahlung, Verlängerung oder Rückerstattung in Ihre Umsatzberichte einträgt. Hermes fragt vor jedem Aufruf um Ihre Freigabe und verweigert das Tool in Cron- und anderen unbeaufsichtigten Läufen. Das Tool belastet nie jemanden und bewegt kein Geld, und eine wiederholte Transaktions-ID wird abgelehnt. Lassen Sie es weg, wenn Stripe, Lemon Squeezy oder Polar mit Flowsery verbunden ist, weil Flowsery diese Zahlungen schon zählt und ein zweiter Eintrag den Umsatz doppelt zählt.