Comment configurer l'analytics avec Hermes Agent et le plugin Flowsery

Configurer l'analytics avec Hermes Agent demande deux commandes dans le terminal et une connexion dans le navigateur, grâce au plugin Flowsery du catalogue de plugins Hermes. Ensuite, Hermes répond aux questions sur votre site à partir de vos vraies données Flowsery : qui est venu, d'où, ce qui a converti, ce qui a rapporté de l'argent et ce qui est cassé.

Hermes Agent, l'agent de Nous Research, tourne dans votre terminal et peut exécuter seul des tâches planifiées. Par défaut, il n'a aucun moyen de lire l'analytics de votre site. Le plugin Flowsery ajoute ce moyen. Flowsery garde les données, Hermes interroge Flowsery, et vous validez tout ce qui modifie un chiffre.

La version courte : ajoutez votre site sur flowsery.com et installez le snippet de suivi, lancez hermes plugins install flowsery et hermes plugins enable flowsery, démarrez une nouvelle session Hermes et connectez-vous quand le navigateur s'ouvre. Demandez ensuite à Hermes : "Comment évolue mon trafic cette semaine par rapport à la semaine dernière ?" S'il répond avec vos visiteurs, le plugin fonctionne.

Qu'est-ce que le plugin Flowsery pour Hermes Agent ?

Le plugin Flowsery est une entrée du catalogue de plugins Hermes, publiée sur le Hermes Marketplace dans la catégorie Tools, qui relie Hermes Agent au serveur MCP de Flowsery sur https://mcp.flowsery.com/mcp. Le paquet contient trois éléments : un manifeste plugin.json, une configuration de serveur mcp.json et un skill qui apprend à Hermes à répondre aux questions d'analytics avec Flowsery. Il n'embarque aucun code propre.

Le serveur est le même que celui qu'utilisent Claude Code, ChatGPT et Cursor, donc Hermes lit les mêmes chiffres que votre tableau de bord Flowsery. Flowsery présente Hermes sur la page des agents IA et dans l'onglet AI Agents de la page API Tokens de l'application.

Hermes ne stocke jamais de mot de passe Flowsery. Vous vous connectez une fois dans le navigateur, et le plugin conserve un jeton OAuth qu'il renouvelle lui-même.

De quoi avez-vous besoin avant de l'installer ?

Il vous faut Hermes Agent 0.21.6 ou plus récent, Node.js 20.18.1 ou plus récent avec npx dans votre PATH, et un compte Flowsery avec au moins un site qui exécute le snippet de suivi Flowsery. Le plan Team de Flowsery (250 $ par mois) et le plan Pro (500 $ par mois) incluent tous deux le serveur MCP, et les deux commencent par un essai gratuit de 14 jours sans carte bancaire.

L'exigence Node.js est celle qu'on oublie le plus. Le plugin lance une petite passerelle de connexion, mcp-remote, via npx, donc une installation de Hermes sur une machine sans Node échoue à l'étape de connexion.

Comment installer le plugin Flowsery dans Hermes Agent ?

Vous installez Flowsery par son nom depuis le catalogue de plugins Hermes, puis vous vous connectez une fois dans le navigateur :

1. Lancez hermes plugins install flowsery. Hermes affiche le résumé des capacités de l'entrée avant de cloner quoi que ce soit, puis récupère le commit exact que le catalogue a examiné.
2. Lancez hermes plugins enable flowsery. L'installation place le plugin sur le disque, et l'activation fait que Hermes le charge. Dans un terminal, l'étape d'installation demande aussi "Enable now?", donc répondre oui couvre les deux.
3. Démarrez une nouvelle session Hermes. Au premier démarrage du serveur, votre navigateur ouvre la page de connexion Flowsery.
4. Connectez-vous avec l'e-mail que vous utilisez sur Flowsery et autorisez l'accès.
5. Demandez à Hermes : "Listez mes sites Flowsery."

hermes plugins install flowsery
hermes plugins enable flowsery

Le jeton est conservé et renouvelé, donc vous vous connectez une seule fois. Si les outils n'apparaissent pas après la connexion, lancez /reload-mcp dans la session.

Vous pouvez aussi installer directement depuis GitHub avec hermes plugins install Flowsery/claude-plugin --no-enable, puis hermes plugins enable flowsery. Préférez le catalogue, car il installe le commit qu'une personne a examiné.

Qu'est-ce que le plugin installe sur votre machine ?

Le plugin Flowsery installe une configuration, pas un programme. mcp.json lance la version épinglée mcp-remote@0.1.49 via npx, qui la télécharge depuis npm au premier usage, ouvre un port de rappel local pour la connexion et stocke les jetons OAuth dans ~/.mcp-auth. Le paquet n'envoie aucune télémétrie.

Le catalogue épingle un commit de 40 caractères, et les installations récupèrent ce commit plutôt que la pointe d'une branche. L'épinglage ne couvre pas la liste des outils. Le serveur Flowsery choisit ses outils à l'exécution, donc un nouvel outil sur le serveur arrive dans Hermes sans nouvel examen du catalogue. La fiche le précise dans son avertissement, et le README du plugin aussi.

Quelles données d'analytics Hermes Agent peut-il lire via Flowsery ?

Hermes Agent reçoit 28 outils Flowsery via le plugin, et 23 d'entre eux ne font que lire. Chaque rapport prend une période, un fuseau horaire et des filtres par pays, région, ville, appareil, navigateur, système d'exploitation, page, nom d'hôte, référent, canal et paramètres UTM. Voici ce que cela couvre, par tâche :

• Trafic. Visiteurs, sessions, taux de rebond, durée de session, chiffre d'affaires, chiffre d'affaires par visiteur et taux de conversion pour n'importe quelle période, et les mêmes métriques par heure, jour, semaine ou mois.
• Visiteurs en direct. Combien de personnes étaient actives ces 5 dernières minutes, et une carte de ces personnes par ville.
• Répartitions. Visiteurs par page, référent, canal, campagne UTM, pays, région, ville, appareil, navigateur, système d'exploitation et nom d'hôte. Un autre outil regroupe les visiteurs selon l'une des 25 dimensions, page d'entrée et chaque paramètre UTM compris. Les référents nomment les sources connues comme Google, ChatGPT et Reddit.
• Objectifs et chiffre d'affaires. Les conversions de chaque objectif, y compris les objectifs automatiques de paiement et d'essai gratuit.
• Un visiteur. La localisation, l'appareil, la source, les visites, les objectifs, le chiffre d'affaires et la chronologie d'un seul visiteur.
• Problèmes de session. Les bugs, parcours cassés et problèmes d'UX que l'IA de Flowsery a trouvés dans les enregistrements de sessions, classés par gravité, avec les étapes pour les reproduire et tout ticket Linear ou Jira lié.

Aucun outil ne renvoie d'adresse IP ni de données de facturation, et la carte en direct arrondit les coordonnées à 0,1 degré. Hermes voit ce que votre tableau de bord Flowsery affiche pour vos propres sites, et rien de plus.

Quels outils MCP de Hermes Agent demandent une validation ?

Hermes Agent vous demande une validation avant chacun des cinq outils Flowsery qui modifient des données, car le plugin.json du plugin marque le serveur Flowsery comme untrusted. Ces cinq outils sont track_goal, qui enregistre une conversion d'objectif, delete_goals, qui supprime définitivement les conversions correspondant à vos filtres, track_payment, qui enregistre un paiement, un renouvellement ou un remboursement pour l'attribution des revenus, delete_payments, qui supprime définitivement les enregistrements de paiement correspondant à vos filtres, et update_issue_status, qui passe un problème en ouvert, en cours, résolu ou suspendu. Les outils de paiement ne modifient que des données d'analytics et ne débitent ni ne remboursent jamais personne. Les 23 autres outils portent une marque de lecture seule et s'exécutent sans demande.

Hermes refuse aussi ces cinq outils dans les tâches cron et les autres exécutions sans surveillance. Une tâche Hermes planifiée peut lire le trafic de la nuit à 7 h, mais elle ne peut pas supprimer des données d'objectifs ou de paiements à 7 h sans personne devant l'écran. Pour l'analytics, c'est le bon réglage par défaut. Une mauvaise lecture vous coûte une réponse confuse. Une mauvaise suppression vous coûte un historique que vous ne récupérerez pas.

Votre rôle dans l'espace de travail est la seconde limite, car Hermes agit en votre nom. Les cinq écritures exigent la permission flowsery.write, que détiennent les rôles Admin et Editor. Si votre rôle ne l'a pas, Flowsery répond permission_denied et Hermes vous dit qu'un administrateur de l'espace de travail doit changer votre rôle.

Quels prompts essayer en premier ?

Ces prompts viennent du README du plugin, traduits ici. Sous chacun figure ce que Hermes fait dans Flowsery.

"Comment évolue mon trafic cette semaine par rapport à la semaine dernière ?"

Hermes liste vos sites, lit le fuseau horaire du site et lance l'aperçu deux fois, une par semaine. Vous obtenez visiteurs, sessions, taux de rebond, chiffre d'affaires et taux de conversion côte à côte. Si vous avez plusieurs sites, nommez le domaine, sinon Hermes vous demande lequel vous voulez.

"Quels canaux et quelles campagnes ont amené des clients payants ce mois-ci ?"

Hermes lit vos canaux et vos campagnes UTM du mois avec le chiffre d'affaires en regard de chacun. Les canaux suivent des groupes de type GA4 comme Organic Search, Paid Social, Email et Direct, donc la réponse correspond à la façon dont la plupart des équipes font déjà leurs rapports.

"Les visiteurs ont chuté mardi. Vérifiez les pages, les référents et les appareils et dites-moi pourquoi."

Hermes compare mardi avec les jours autour sur trois répartitions et montre celle qui a bougé, par exemple un référent devenu silencieux ou une page qui ne reçoit plus de visites. C'est le genre de question où un agent bat un tableau de bord, car il lance et compare les rapports que vous parcourriez sinon un par un.

"Combien de trafic ChatGPT, Perplexity et les autres assistants IA nous ont-ils envoyé ce mois-ci ?"

Hermes lit vos référents du mois et isole les assistants IA. Flowsery nomme les sources connues, donc ChatGPT apparaît comme ChatGPT et non comme un simple domaine.

"Qu'est-ce que Flowsery a trouvé cette semaine dans les enregistrements de sessions ? Passez le bug du checkout en cours."

Hermes liste les problèmes de la semaine par gravité, ouvre le problème du checkout avec ses occurrences et ses étapes de reproduction, puis vous demande une validation avant de changer le statut. Seul le statut change. Le problème, ses sessions et ses commentaires restent tels quels.

"Montrez-moi le parcours du visiteur qui vient de démarrer un essai gratuit."

Hermes trouve le visiteur parmi les personnes de la carte en direct, puis lit son profil : d'où il vient, quel appareil il a utilisé, ses visites, les objectifs qu'il a atteints et une chronologie des pages, la plus récente en premier. Les noms, e-mails, identifiants utilisateur et adresses IP ne font jamais partie de la réponse.

Hermes Agent peut-il vous envoyer un rapport de trafic quotidien ?

Hermes Agent peut vous envoyer un rapport de trafic quotidien avec son planificateur cron, car les outils Flowsery dont il a besoin ne font que lire. Demandez-le en langage courant, par exemple : "Chaque matin à 9 h, donnez-moi les visiteurs d'hier, les cinq premiers référents et tout nouveau problème de gravité élevée dans Flowsery, et envoyez-le-moi sur Telegram." Hermes crée la tâche avec son propre outil cron, ou vous en ajoutez une dans le chat avec /cron add.

Le rapport s'exécute dans une nouvelle session à l'heure choisie et livre le résultat dans le chat d'où vous l'avez demandé ou sur une plateforme que vous avez configurée. Il ne peut ni enregistrer ni supprimer des objectifs ou des paiements, ni changer le statut d'un problème, car Hermes refuse les outils d'écriture dans les exécutions sans surveillance. Si vous voulez aussi que le rapport marque des problèmes, gardez cette étape pour une session où vous êtes là pour valider.

Comment faire tourner Hermes Agent sans navigateur avec une clé d'API ?

Sur un serveur ou toute machine sans navigateur, laissez le plugin de côté et ajoutez le serveur MCP de Flowsery à ~/.hermes/config.yaml avec une clé d'API. La connexion OAuth a besoin d'une fenêtre de navigateur, et une machine sans écran n'en a pas.

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

Créez la clé sur flowsery.com/api-tokens et mettez FLOWSERY_API_KEY=... dans ~/.hermes/.env. La clé agit comme un mot de passe pour votre compte Flowsery, donc gardez-la hors des chats.

Cette méthode laisse de côté le plugin, donc aussi son skill et le réglage untrusted de son plugin.json. Un jeton d'espace de travail porte le rôle que vous choisissez à sa création, et le formulaire Create Token marque le rôle Contributor comme "Recommended for AI agents". Un jeton Contributor lit votre analytics et reçoit permission_denied sur les cinq écritures, ce qui est exactement ce qu'un agent d'analytics sans navigateur devrait détenir.

Quand utiliser plutôt Claude Code, ChatGPT, Zapier ou n8n ?

Utilisez Hermes quand vous y travaillez déjà. Le même paquet Flowsery s'installe dans Claude Code avec /plugin install flowsery --marketplace Flowsery/claude-plugin, et ChatGPT a son propre plugin publié, présenté dans le guide du plugin d'analytics pour ChatGPT de Flowsery. Cursor, Claude Desktop et Gemini CLI se connectent aussi à https://mcp.flowsery.com/mcp, et un agent qui n'accepte qu'un jeton Bearer, comme un connecteur personnalisé Manus, fonctionne avec un jeton d'espace de travail, comme le montre le guide du connecteur Manus Cue pour l'analytics web.

Si vous voulez recevoir des chiffres depuis un workflow plutôt qu'une conversation, utilisez un outil d'automatisation. Le nœud Flowsery pour n8n envoie des rapports hebdomadaires et des alertes sur les nouveaux problèmes depuis votre propre serveur, et le guide de l'analytics avec Zapier monte les mêmes flux sans serveur. Les deux peuvent aussi enregistrer automatiquement un paiement à chaque nouvelle vente, alors que Hermes n'en enregistre un que si vous le demandez et le validez.

Questions fréquentes

Hermes Agent peut-il lire l'analytics de mon site ?

Hermes Agent lit l'analytics de votre site via le plugin Flowsery du catalogue de plugins Hermes. Installez-le avec hermes plugins install flowsery, activez-le et connectez-vous avec votre compte Flowsery. Hermes répond ensuite aux questions sur les visiteurs, les sources de trafic, les objectifs, le chiffre d'affaires, les visiteurs en direct et les problèmes que Flowsery a trouvés dans les enregistrements de sessions.

Ai-je besoin d'une clé d'API pour utiliser Flowsery dans Hermes Agent ?

Le plugin Flowsery pour Hermes Agent n'a pas besoin de clé d'API. Il se connecte avec OAuth dans votre navigateur au premier démarrage du serveur et renouvelle le jeton. Une clé d'API ne sert que pour une installation sans navigateur, où vous ajoutez le serveur à ~/.hermes/config.yaml avec une clé créée sur flowsery.com/api-tokens.

Quelle version de Hermes Agent le plugin Flowsery exige-t-il ?

Le plugin Flowsery exige Hermes Agent 0.21.6 ou plus récent et Node.js 20.18.1 ou plus récent avec npx dans votre PATH. Node.js lance mcp-remote, la passerelle qui gère la connexion et dialogue avec le serveur MCP de Flowsery.

Hermes Agent peut-il modifier mes données Flowsery sans demander ?

Hermes Agent ne modifie pas de données Flowsery sans demander. Seuls cinq outils écrivent : track_goal, delete_goals, track_payment, delete_payments et update_issue_status. Le plugin marque le serveur comme untrusted, donc Hermes demande avant chacun de ces cinq outils et les refuse en cron et dans les autres exécutions sans surveillance. Les 23 autres outils ne font que lire.

Une tâche cron de Hermes peut-elle m'envoyer un rapport de trafic ?

Une tâche cron de Hermes peut lire Flowsery et vous envoyer un rapport, car tous les outils de rapport sont en lecture seule. Demandez à Hermes quelque chose comme "chaque matin à 9 h, envoyez-moi les visiteurs d'hier et les premiers référents", et il planifie la tâche. La tâche cron ne peut ni enregistrer ni supprimer des objectifs ou des paiements, ni changer le statut d'un problème.

Où le plugin stocke-t-il ma connexion Flowsery ?

Le plugin Flowsery stocke ses jetons OAuth dans ~/.mcp-auth sur votre machine. La passerelle mcp-remote les y écrit après votre connexion et les renouvelle, donc vous vous connectez une seule fois. Le paquet n'envoie aucune télémétrie.

Pourquoi les outils Flowsery n'apparaissent-ils pas dans Hermes après la connexion ?

Lancez /reload-mcp dans la session Hermes si les outils Flowsery manquent après la connexion dans le navigateur. Vérifiez aussi que le plugin est activé, car hermes plugins install le place sur le disque et hermes plugins enable flowsery fait que Hermes le charge.

Hermes Agent peut-il voir les adresses IP de mes visiteurs ?

Hermes Agent ne reçoit jamais d'adresse IP ni de données de facturation via Flowsery, car aucun outil Flowsery ne les renvoie. Le profil d'un visiteur montre une localisation approximative, l'appareil, la source, les visites, les objectifs et le chiffre d'affaires, et la carte en direct arrondit les coordonnées à 0,1 degré.

Le plugin Flowsery fonctionne-t-il avec plusieurs sites ?

Le plugin Flowsery fonctionne avec chaque site de chaque espace de travail que votre connexion atteint. Hermes appelle d'abord list_websites et demande de quel site il s'agit quand il y en a plusieurs. Nommez le domaine ou l'espace de travail dans votre question pour sauter cette étape.

Hermes Agent peut-il enregistrer des paiements dans Flowsery ?

Hermes Agent enregistre des paiements dans Flowsery avec l'outil track_payment, qui ajoute un paiement, un renouvellement ou un remboursement à vos rapports de chiffre d'affaires. Hermes vous demande une validation avant chaque appel et refuse l'outil en cron et dans les autres exécutions sans surveillance. L'outil ne débite jamais personne et ne déplace aucun argent, et un ID de transaction répété est rejeté. Ne l'utilisez pas quand Stripe, Lemon Squeezy ou Polar est connecté à Flowsery, car Flowsery compte déjà ces paiements et une seconde saisie compte le chiffre d'affaires deux fois.