Come configurare l'analytics con Hermes Agent e il plugin di Flowsery

Configurare l'analytics con Hermes Agent richiede due comandi nel terminale e un accesso nel browser, con il plugin di Flowsery dal catalogo dei plugin di Hermes. Dopo, Hermes risponde alle domande sul tuo sito con i tuoi dati reali di Flowsery: chi è arrivato, da dove, cosa ha convertito, cosa ha portato entrate e cosa si è rotto.

Hermes Agent, l'agente di Nous Research, gira nel tuo terminale e può eseguire da solo attività pianificate. Di base non ha modo di leggere l'analytics del tuo sito. Il plugin di Flowsery aggiunge questa possibilità. Flowsery tiene i dati, Hermes interroga Flowsery e tu approvi tutto ciò che cambia un numero.

In breve: aggiungi il tuo sito su flowsery.com e installa lo snippet di tracciamento, esegui hermes plugins install flowsery e hermes plugins enable flowsery, avvia una nuova sessione di Hermes e accedi quando si apre il browser. Poi chiedi a Hermes: "Com'è il mio traffico questa settimana rispetto alla settimana scorsa?" Se risponde con i tuoi visitatori, il plugin funziona.

Cos'è il plugin di Flowsery per Hermes Agent?

Il plugin di Flowsery è una voce del catalogo dei plugin di Hermes, pubblicata sull'Hermes Marketplace nella categoria Tools, che collega Hermes Agent al server MCP di Flowsery su https://mcp.flowsery.com/mcp. Il pacchetto contiene tre cose: un manifest plugin.json, una configurazione del server mcp.json e una skill che insegna a Hermes a rispondere alle domande di analytics con Flowsery. Non include codice proprio.

Il server è lo stesso che usano Claude Code, ChatGPT e Cursor, quindi Hermes legge gli stessi numeri che mostra la tua dashboard di Flowsery. Flowsery elenca Hermes nella pagina degli agenti IA e nella scheda AI Agents della pagina API Tokens dell'app.

Hermes non salva mai una password di Flowsery. Accedi una volta nel browser, e il plugin conserva un token OAuth che rinnova da solo.

Cosa ti serve prima di installarlo?

Ti servono Hermes Agent 0.21.6 o successivo, Node.js 20.18.1 o successivo con npx nel PATH e un account Flowsery con almeno un sito che esegue lo snippet di tracciamento di Flowsery. Il piano Team di Flowsery (250 $ al mese) e il piano Pro (500 $ al mese) includono entrambi il server MCP, ed entrambi partono con una prova gratuita di 14 giorni senza carta di credito.

Il requisito di Node.js è quello che si dimentica più spesso. Il plugin avvia un piccolo ponte per l'accesso, mcp-remote, tramite npx, quindi un'installazione di Hermes su una macchina senza Node fallisce al passaggio di accesso.

Come si installa il plugin di Flowsery in Hermes Agent?

Installi Flowsery per nome dal catalogo dei plugin di Hermes e accedi una volta nel browser:

1. Esegui hermes plugins install flowsery. Hermes mostra il riepilogo delle capacità della voce prima di clonare qualsiasi cosa, poi scarica esattamente il commit che il catalogo ha revisionato.
2. Esegui hermes plugins enable flowsery. L'installazione mette il plugin sul disco, e l'attivazione fa sì che Hermes lo carichi. Nel terminale, il passaggio di installazione chiede anche "Enable now?", quindi rispondere sì copre entrambi.
3. Avvia una nuova sessione di Hermes. La prima volta che il server parte, il browser apre la pagina di accesso di Flowsery.
4. Accedi con l'email che usi su Flowsery e approva l'accesso.
5. Chiedi a Hermes: "Elenca i miei siti su Flowsery."

hermes plugins install flowsery
hermes plugins enable flowsery

Il token viene conservato e rinnovato, quindi accedi una sola volta. Se gli strumenti non compaiono dopo l'accesso, esegui /reload-mcp nella sessione.

Puoi anche installarlo direttamente da GitHub con hermes plugins install Flowsery/claude-plugin --no-enable, poi hermes plugins enable flowsery. Scegli il catalogo, perché installa il commit che una persona ha revisionato.

Cosa installa il plugin sulla tua macchina?

Il plugin di Flowsery installa una configurazione, non un programma. mcp.json avvia la versione fissata mcp-remote@0.1.49 tramite npx, che la scarica da npm al primo utilizzo, apre una porta di callback locale per l'accesso e salva i token OAuth in ~/.mcp-auth. Il pacchetto non invia telemetria.

Il catalogo fissa un commit di 40 caratteri, e le installazioni scaricano quel commit invece della punta di un branch. Il commit fissato non copre l'elenco degli strumenti. Il server di Flowsery decide gli strumenti in fase di esecuzione, quindi un nuovo strumento sul server arriva a Hermes senza una nuova revisione del catalogo. La scheda lo dice nella sua avvertenza, e lo dice anche il README del plugin.

Quali dati di analytics può leggere Hermes Agent tramite Flowsery?

Hermes Agent riceve 28 strumenti di Flowsery tramite il plugin, e 23 di questi leggono soltanto. Ogni report accetta un intervallo di date, un fuso orario e filtri per paese, regione, città, dispositivo, browser, sistema operativo, pagina, hostname, referrer, canale e parametri UTM. Ecco cosa copre, per attività:

• Traffico. Visitatori, sessioni, frequenza di rimbalzo, durata della sessione, entrate, entrate per visitatore e tasso di conversione per qualsiasi periodo, e le stesse metriche per ora, giorno, settimana o mese.
• Visitatori in tempo reale. Quante persone erano attive negli ultimi 5 minuti, e una mappa di queste persone per città.
• Suddivisioni. Visitatori per pagina, referrer, canale, campagna UTM, paese, regione, città, dispositivo, browser, sistema operativo e hostname. Un altro strumento raggruppa i visitatori per una qualsiasi di 25 dimensioni, pagina di ingresso e ogni parametro UTM compresi. I referrer indicano per nome le fonti note come Google, ChatGPT e Reddit.
• Obiettivi ed entrate. I completamenti di ogni obiettivo, compresi gli obiettivi automatici di pagamento e di prova gratuita.
• Un visitatore. Posizione, dispositivo, fonte, visite, obiettivi, entrate e cronologia di un singolo visitatore.
• Problemi delle sessioni. I bug, i flussi rotti e i problemi di UX che l'IA di Flowsery ha trovato nelle registrazioni delle sessioni, ordinati per gravità, con i passaggi per riprodurli e l'eventuale ticket Linear o Jira collegato.

Nessuno strumento restituisce indirizzi IP o dati di fatturazione, e la mappa in tempo reale arrotonda le coordinate a 0,1 gradi. Hermes vede quello che la tua dashboard di Flowsery mostra per i tuoi siti e niente di più.

Quali strumenti MCP di Hermes Agent chiedono un'approvazione?

Hermes Agent ti chiede un'approvazione prima di ciascuno dei cinque strumenti di Flowsery che modificano i dati, perché il plugin.json del plugin segna il server di Flowsery come untrusted. I cinque sono track_goal, che registra il completamento di un obiettivo, delete_goals, che elimina per sempre i completamenti che corrispondono ai tuoi filtri, track_payment, che registra un pagamento, un rinnovo o un rimborso per l'attribuzione delle entrate, delete_payments, che elimina per sempre i record dei pagamenti che corrispondono ai tuoi filtri, e update_issue_status, che imposta un problema come aperto, in corso, risolto o sospeso. Gli strumenti dei pagamenti modificano solo record di analytics e non addebitano né rimborsano mai nessuno. Gli altri 23 strumenti hanno un'indicazione di sola lettura e girano senza chiedere.

Hermes rifiuta anche questi cinque strumenti nei job cron e nelle altre esecuzioni senza supervisione. Un'attività pianificata di Hermes può leggere il traffico della notte alle 7, ma non può eliminare dati degli obiettivi o dei pagamenti alle 7 senza nessuno davanti allo schermo. Per l'analytics è l'impostazione predefinita giusta. Una lettura sbagliata ti costa una risposta confusa. Un'eliminazione sbagliata ti costa uno storico che non puoi recuperare.

Il tuo ruolo nel workspace è il secondo limite, perché Hermes agisce come te. Le cinque scritture richiedono il permesso flowsery.write, che hanno i ruoli Admin ed Editor. Se il tuo ruolo non ce l'ha, Flowsery risponde permission_denied e Hermes ti dice che un amministratore del workspace deve cambiare il tuo ruolo.

Quali prompt provare per primi?

Questi prompt vengono dal README del plugin, qui tradotti. Sotto ognuno c'è quello che Hermes fa in Flowsery.

"Com'è il mio traffico questa settimana rispetto alla settimana scorsa?"

Hermes elenca i tuoi siti, legge il fuso orario del sito ed esegue la panoramica due volte, una per settimana. Ottieni visitatori, sessioni, frequenza di rimbalzo, entrate e tasso di conversione affiancati. Se hai più siti, indica il dominio, altrimenti Hermes ti chiede quale intendi.

"Quali canali e campagne hanno portato clienti paganti questo mese?"

Hermes legge i tuoi canali e le tue campagne UTM del mese con le entrate accanto a ciascuno. I canali seguono gruppi in stile GA4 come Organic Search, Paid Social, Email e Direct, quindi la risposta segue il modo in cui la maggior parte dei team già fa i report.

"Martedì i visitatori sono calati. Controlla pagine, referrer e dispositivi e dimmi perché."

Hermes confronta il martedì con i giorni intorno su tre suddivisioni e indica quella che si è mossa, per esempio un referrer che ha smesso di mandare visite o una pagina che non ne riceve più. È il tipo di domanda in cui un agente batte una dashboard, perché esegue e confronta i report che altrimenti apriresti uno per uno.

"Quanto traffico ci hanno mandato questo mese ChatGPT, Perplexity e gli altri assistenti IA?"

Hermes legge i referrer del mese e separa gli assistenti IA. Flowsery indica per nome le fonti note, quindi ChatGPT compare come ChatGPT e non come un dominio grezzo.

"Cosa ha trovato Flowsery questa settimana nelle registrazioni delle sessioni? Segna il bug del checkout come in corso."

Hermes elenca i problemi della settimana per gravità, apre il problema del checkout con le sue occorrenze e i passaggi per riprodurlo, poi ti chiede un'approvazione prima di cambiare lo stato. Cambia solo lo stato. Il problema, le sue sessioni e i suoi commenti restano com'erano.

"Mostrami il percorso del visitatore che ha appena iniziato una prova gratuita."

Hermes trova il visitatore tra le persone sulla mappa in tempo reale, poi legge il suo profilo: da dove è arrivato, quale dispositivo ha usato, le sue visite, gli obiettivi completati e una cronologia delle pagine, dalla più recente. Nomi, email, ID utente e indirizzi IP non fanno mai parte della risposta.

Hermes Agent può mandarti un report giornaliero sul traffico?

Hermes Agent può mandarti un report giornaliero sul traffico con il suo pianificatore cron, perché gli strumenti di Flowsery che gli servono leggono soltanto. Chiedilo a parole tue, per esempio: "Ogni mattina alle 9, dammi i visitatori di ieri, i cinque referrer principali e ogni nuovo problema di gravità alta su Flowsery, e mandamelo su Telegram." Hermes crea il job con il suo strumento cron, oppure ne aggiungi uno in chat con /cron add.

Il report gira in una sessione nuova all'ora che scegli e consegna il risultato nella chat da cui l'hai chiesto o su una piattaforma che hai configurato. Non può registrare o eliminare obiettivi o pagamenti né cambiare lo stato di un problema, perché Hermes rifiuta gli strumenti di scrittura nelle esecuzioni senza supervisione. Se vuoi che il report segni anche i problemi, lascia quel passaggio a una sessione in cui ci sei tu per approvarlo.

Come si usa Hermes Agent senza browser con una chiave API?

Su un server o su una macchina senza browser, salta il plugin e aggiungi il server MCP di Flowsery a ~/.hermes/config.yaml con una chiave API. L'accesso OAuth ha bisogno di una finestra del browser, e una macchina senza schermo non ce l'ha.

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

Crea la chiave su flowsery.com/api-tokens e metti FLOWSERY_API_KEY=... in ~/.hermes/.env. La chiave funziona come una password del tuo account Flowsery, quindi tienila fuori dalle chat.

Questa strada salta il plugin, quindi salta anche la sua skill e l'impostazione untrusted del suo plugin.json. Un token di workspace porta il ruolo che scegli quando lo crei, e il modulo Create Token segna il ruolo Contributor come "Recommended for AI agents". Un token Contributor legge la tua analytics e riceve permission_denied su tutte e cinque le scritture, ed è proprio quello che dovrebbe avere un agente di analytics senza browser.

Quando conviene usare Claude Code, ChatGPT, Zapier o n8n?

Usa Hermes quando ci lavori già. Lo stesso pacchetto di Flowsery si installa in Claude Code con /plugin install flowsery --marketplace Flowsery/claude-plugin, e ChatGPT ha il suo plugin pubblicato, descritto nella guida al plugin di analytics per ChatGPT di Flowsery. Anche Cursor, Claude Desktop e Gemini CLI si collegano a https://mcp.flowsery.com/mcp, e un agente che accetta solo un token Bearer, come un connettore personalizzato di Manus, funziona con un token di workspace, come mostra la guida al connettore Manus Cue per la web analytics.

Se vuoi ricevere i numeri da un flusso automatico invece che da una conversazione, usa uno strumento di automazione. Il nodo Flowsery per n8n manda report settimanali e avvisi sui nuovi problemi dal tuo server, e la guida all'analytics con Zapier costruisce gli stessi flussi senza server. Entrambi possono anche registrare un pagamento in automatico ogni volta che arriva una vendita, mentre Hermes ne registra uno solo quando glielo chiedi e lo approvi.

Domande frequenti

Hermes Agent può leggere l'analytics del mio sito?

Hermes Agent legge l'analytics del tuo sito tramite il plugin di Flowsery del catalogo dei plugin di Hermes. Installalo con hermes plugins install flowsery, attivalo e accedi con il tuo account Flowsery. Poi Hermes risponde alle domande su visitatori, fonti di traffico, obiettivi, entrate, visitatori in tempo reale e i problemi che Flowsery ha trovato nelle registrazioni delle sessioni.

Mi serve una chiave API per usare Flowsery in Hermes Agent?

Il plugin di Flowsery per Hermes Agent non richiede una chiave API. Accede con OAuth nel tuo browser la prima volta che il server parte e rinnova il token da solo. Una chiave API ti serve solo per un'installazione senza browser, in cui aggiungi il server a ~/.hermes/config.yaml con una chiave creata su flowsery.com/api-tokens.

Quale versione di Hermes Agent richiede il plugin di Flowsery?

Il plugin di Flowsery richiede Hermes Agent 0.21.6 o successivo e Node.js 20.18.1 o successivo con npx nel PATH. Node.js avvia mcp-remote, il ponte che gestisce l'accesso e comunica con il server MCP di Flowsery.

Hermes Agent può modificare i miei dati di Flowsery senza chiedere?

Hermes Agent non modifica i dati di Flowsery senza chiedere. Solo cinque strumenti scrivono: track_goal, delete_goals, track_payment, delete_payments e update_issue_status. Il plugin segna il server come untrusted, quindi Hermes chiede prima di ciascuno dei cinque e li rifiuta nei cron e nelle altre esecuzioni senza supervisione. Gli altri 23 strumenti leggono soltanto.

Un job cron di Hermes può mandarmi un report sul traffico?

Un job cron di Hermes può leggere Flowsery e mandarti un report, perché tutti gli strumenti di report sono di sola lettura. Chiedi a Hermes qualcosa come "ogni mattina alle 9, mandami i visitatori di ieri e i referrer principali", e pianifica il job. Il job cron non può registrare o eliminare obiettivi o pagamenti, né cambiare lo stato di un problema.

Dove salva il plugin il mio accesso a Flowsery?

Il plugin di Flowsery salva i token OAuth in ~/.mcp-auth sulla tua macchina. Il ponte mcp-remote li scrive lì dopo l'accesso e li rinnova, quindi accedi una sola volta. Il pacchetto non invia telemetria.

Perché gli strumenti di Flowsery non compaiono in Hermes dopo l'accesso?

Esegui /reload-mcp nella sessione di Hermes se gli strumenti di Flowsery mancano dopo l'accesso nel browser. Controlla anche che il plugin sia attivo, perché hermes plugins install lo mette sul disco e hermes plugins enable flowsery fa sì che Hermes lo carichi.

Hermes Agent può vedere gli indirizzi IP dei miei visitatori?

Hermes Agent non riceve mai indirizzi IP o dati di fatturazione tramite Flowsery, perché nessuno strumento di Flowsery li restituisce. Il profilo di un singolo visitatore mostra posizione approssimativa, dispositivo, fonte, visite, obiettivi ed entrate, e la mappa in tempo reale arrotonda le coordinate a 0,1 gradi.

Il plugin di Flowsery funziona con più siti?

Il plugin di Flowsery funziona con ogni sito di ogni workspace raggiunto dal tuo accesso. Hermes chiama prima list_websites e, se ci sono più siti, chiede quale intendi. Indica il dominio o il workspace nella domanda per saltare questo passaggio.

Hermes Agent può registrare pagamenti in Flowsery?

Hermes Agent registra pagamenti in Flowsery con lo strumento track_payment, che aggiunge un pagamento, un rinnovo o un rimborso ai tuoi report sulle entrate. Hermes ti chiede un'approvazione prima di ogni chiamata e rifiuta lo strumento nei cron e nelle altre esecuzioni senza supervisione. Lo strumento non addebita mai nulla a nessuno e non sposta denaro, e un ID transazione ripetuto viene rifiutato. Non usarlo quando Stripe, Lemon Squeezy o Polar sono collegati a Flowsery, perché Flowsery conta già quei pagamenti e un secondo inserimento conta le entrate due volte.