Como configurar o analytics com o Hermes Agent e o plugin do Flowsery

Configurar o analytics com o Hermes Agent leva dois comandos no terminal e um login no navegador, usando o plugin do Flowsery do catálogo de plugins do Hermes. Depois disso, o Hermes responde perguntas sobre o seu site com os seus dados reais do Flowsery: quem visitou, de onde veio, o que converteu, o que gerou receita e o que quebrou.

O Hermes Agent, o agente da Nous Research, roda no seu terminal e pode executar tarefas agendadas sozinho. De fábrica, ele não tem como ler o analytics do seu site. O plugin do Flowsery acrescenta isso. O Flowsery guarda os dados, o Hermes pergunta ao Flowsery e você aprova tudo o que muda um número.

A versão curta: adicione seu site em flowsery.com e instale o snippet de rastreamento, execute hermes plugins install flowsery e hermes plugins enable flowsery, inicie uma nova sessão do Hermes e entre quando o navegador abrir. Depois pergunte ao Hermes: "Como está o meu tráfego nesta semana em comparação com a semana passada?" Se ele responder com os seus visitantes, o plugin funciona.

O que é o plugin do Flowsery para o Hermes Agent?

O plugin do Flowsery é uma entrada do catálogo de plugins do Hermes, listada no Hermes Marketplace na categoria Tools, que conecta o Hermes Agent ao servidor MCP do Flowsery em https://mcp.flowsery.com/mcp. O pacote contém três coisas: um manifesto plugin.json, uma configuração de servidor mcp.json e uma skill que ensina o Hermes a responder perguntas de analytics com o Flowsery. Ele não traz código próprio.

O servidor é o mesmo que o Claude Code, o ChatGPT e o Cursor usam, então o Hermes lê os mesmos números que o seu painel do Flowsery mostra. O Flowsery lista o Hermes na página de agentes de IA e na aba AI Agents da página API Tokens do app.

O Hermes nunca guarda uma senha do Flowsery. Você entra uma vez no navegador, e o plugin mantém um token OAuth que ele mesmo renova.

Do que você precisa antes de instalar?

Você precisa do Hermes Agent 0.21.6 ou mais recente, do Node.js 20.18.1 ou mais recente com npx no seu PATH e de uma conta do Flowsery com pelo menos um site rodando o snippet de rastreamento do Flowsery. O plano Team do Flowsery (US$ 250 por mês) e o plano Pro (US$ 500 por mês) incluem o servidor MCP, e os dois começam com um teste grátis de 14 dias sem cartão de crédito.

O requisito do Node.js é o que mais passa despercebido. O plugin roda uma pequena ponte de login, mcp-remote, via npx, então uma instalação do Hermes em uma máquina sem Node falha na etapa de login.

Como instalar o plugin do Flowsery no Hermes Agent?

Você instala o Flowsery pelo nome a partir do catálogo de plugins do Hermes e entra uma vez no navegador:

1. Execute hermes plugins install flowsery. O Hermes mostra o resumo de capacidades da entrada antes de clonar qualquer coisa e depois baixa exatamente o commit que o catálogo revisou.
2. Execute hermes plugins enable flowsery. A instalação coloca o plugin no disco, e a ativação faz o Hermes carregá-lo. No terminal, a etapa de instalação também pergunta "Enable now?", então responder sim cobre as duas etapas.
3. Inicie uma nova sessão do Hermes. Na primeira vez que o servidor inicia, o navegador abre a página de login do Flowsery.
4. Entre com o e-mail que você usa no Flowsery e aprove o acesso.
5. Pergunte ao Hermes: "Liste os meus sites do Flowsery."

hermes plugins install flowsery
hermes plugins enable flowsery

O token fica salvo e é renovado, então você entra só uma vez. Se as ferramentas não aparecerem depois do login, execute /reload-mcp na sessão.

Você também pode instalar direto do GitHub com hermes plugins install Flowsery/claude-plugin --no-enable e depois hermes plugins enable flowsery. Prefira o catálogo, porque ele instala o commit que uma pessoa revisou.

O que o plugin instala na sua máquina?

O plugin do Flowsery instala uma configuração, não um programa. O mcp.json roda a versão fixada mcp-remote@0.1.49 via npx, que a baixa do npm no primeiro uso, abre uma porta local de retorno para o login e guarda os tokens OAuth em ~/.mcp-auth. O pacote não envia telemetria.

O catálogo fixa um commit de 40 caracteres, e as instalações baixam esse commit em vez da ponta de uma branch. A fixação não cobre a lista de ferramentas. O servidor do Flowsery decide as ferramentas em tempo de execução, então uma ferramenta nova no servidor chega ao Hermes sem uma nova revisão do catálogo. A página da entrada diz isso no aviso, e o README do plugin também.

Que dados de analytics o Hermes Agent consegue ler pelo Flowsery?

O Hermes Agent recebe 28 ferramentas do Flowsery pelo plugin, e 23 delas só leem. Cada relatório aceita um período, um fuso horário e filtros por país, região, cidade, dispositivo, navegador, sistema operacional, página, hostname, referenciador, canal e parâmetros UTM. Veja o que isso cobre, por tarefa:

• Tráfego. Visitantes, sessões, taxa de rejeição, duração da sessão, receita, receita por visitante e taxa de conversão para qualquer período, e as mesmas métricas por hora, dia, semana ou mês.
• Visitantes em tempo real. Quantas pessoas estavam ativas nos últimos 5 minutos, e um mapa dessas pessoas por cidade.
• Detalhamentos. Visitantes por página, referenciador, canal, campanha UTM, país, região, cidade, dispositivo, navegador, sistema operacional e hostname. Outra ferramenta agrupa visitantes por qualquer uma de 25 dimensões, incluindo página de entrada e todos os parâmetros UTM. Os referenciadores nomeiam fontes conhecidas como Google, ChatGPT e Reddit.
• Metas e receita. As conversões de cada meta, incluindo as metas automáticas de pagamento e de teste grátis.
• Um visitante. A localização, o dispositivo, a fonte, as visitas, as metas, a receita e a linha do tempo de um único visitante.
• Problemas de sessão. Os bugs, fluxos quebrados e problemas de UX que a IA do Flowsery encontrou nas gravações de sessões, ordenados por gravidade, com os passos para reproduzir e qualquer ticket do Linear ou do Jira vinculado.

Nenhuma ferramenta devolve endereços IP ou dados de cobrança, e o mapa em tempo real arredonda as coordenadas para 0,1 grau. O Hermes vê o que o seu painel do Flowsery mostra para os seus próprios sites e nada mais.

Quais ferramentas MCP do Hermes Agent pedem aprovação?

O Hermes Agent pede a sua aprovação antes de cada uma das cinco ferramentas do Flowsery que alteram dados, porque o plugin.json do plugin marca o servidor do Flowsery como untrusted. As cinco são track_goal, que registra a conversão de uma meta, delete_goals, que apaga para sempre as conversões que batem com os seus filtros, track_payment, que registra um pagamento, uma renovação ou um reembolso para atribuição de receita, delete_payments, que apaga para sempre os registros de pagamento que batem com os seus filtros, e update_issue_status, que define um problema como aberto, em andamento, resolvido ou suspenso. As ferramentas de pagamento alteram só registros de analytics e nunca cobram nem reembolsam ninguém. As outras 23 ferramentas têm uma marcação de somente leitura e rodam sem perguntar.

O Hermes também recusa essas cinco ferramentas em tarefas cron e em outras execuções sem supervisão. Uma tarefa agendada do Hermes pode ler o tráfego da noite às 7h, mas não pode apagar dados de metas ou de pagamentos às 7h sem ninguém olhando. Para analytics, esse é o padrão certo. Uma leitura errada custa uma resposta confusa. Uma exclusão errada custa um histórico que você não recupera.

O seu papel no workspace é o segundo limite, porque o Hermes age como você. As cinco gravações exigem a permissão flowsery.write, que os papéis Admin e Editor têm. Se o seu papel não tiver essa permissão, o Flowsery responde permission_denied e o Hermes avisa que um administrador do workspace precisa mudar o seu papel.

Quais prompts experimentar primeiro?

Estes prompts vêm do README do plugin, traduzidos aqui. Abaixo de cada um está o que o Hermes faz no Flowsery.

"Como está o meu tráfego nesta semana em comparação com a semana passada?"

O Hermes lista os seus sites, lê o fuso horário do site e consulta a visão geral duas vezes, uma por semana. Você recebe visitantes, sessões, taxa de rejeição, receita e taxa de conversão lado a lado. Se você tiver vários sites, diga o domínio, ou o Hermes vai perguntar qual você quer.

"Quais canais e campanhas trouxeram clientes pagantes neste mês?"

O Hermes lê os seus canais e campanhas UTM do mês com a receita ao lado de cada um. Os canais seguem grupos no estilo do GA4, como Organic Search, Paid Social, Email e Direct, então a resposta bate com a forma como a maioria das equipes já faz relatórios.

"Os visitantes caíram na terça. Verifique páginas, referenciadores e dispositivos e me diga por quê."

O Hermes compara a terça com os dias ao redor em três detalhamentos e aponta o que mudou, como um referenciador que parou de mandar visitas ou uma página que deixou de recebê-las. É o tipo de pergunta em que um agente ganha de um painel, porque ele consulta e compara os relatórios que você abriria um por um.

"Quanto tráfego o ChatGPT, o Perplexity e outros assistentes de IA nos mandaram neste mês?"

O Hermes lê os seus referenciadores do mês e separa os assistentes de IA. O Flowsery nomeia as fontes conhecidas, então o ChatGPT aparece como ChatGPT e não como um domínio cru.

"O que o Flowsery encontrou nas gravações de sessões nesta semana? Marque o bug do checkout como em andamento."

O Hermes lista os problemas da semana por gravidade, abre o problema do checkout com as ocorrências e os passos para reproduzir e pede a sua aprovação antes de mudar o status. Só o status muda. O problema, as sessões e os comentários continuam como estavam.

"Mostre a jornada do visitante que acabou de começar um teste grátis."

O Hermes encontra o visitante entre as pessoas no mapa em tempo real e depois lê o perfil dele: de onde veio, que dispositivo usou, as visitas, as metas concluídas e uma linha do tempo das páginas, da mais recente para a mais antiga. Nomes, e-mails, IDs de usuário e endereços IP nunca fazem parte da resposta.

O Hermes Agent pode mandar um relatório diário de tráfego?

O Hermes Agent pode mandar um relatório diário de tráfego pelo agendador cron dele, porque as ferramentas do Flowsery de que ele precisa só leem. Peça com palavras comuns, por exemplo: "Toda manhã às 9h, me mostre os visitantes de ontem, os cinco principais referenciadores e qualquer problema novo de gravidade alta no Flowsery, e me mande pelo Telegram." O Hermes cria a tarefa com a própria ferramenta de cron, ou você adiciona uma no chat com /cron add.

O relatório roda em uma sessão nova no horário que você definir e entrega o resultado no chat de onde você pediu ou em uma plataforma que você configurou. Ele não pode registrar nem apagar metas ou pagamentos, nem mudar o status de um problema, porque o Hermes recusa ferramentas de gravação em execuções sem supervisão. Se você quiser que o relatório também marque problemas, deixe essa etapa para uma sessão em que você esteja presente para aprovar.

Como rodar o Hermes Agent sem navegador com uma chave de API?

Em um servidor ou em qualquer máquina sem navegador, deixe o plugin de lado e adicione o servidor MCP do Flowsery ao ~/.hermes/config.yaml com uma chave de API. O login OAuth precisa de uma janela do navegador, e uma máquina sem tela não tem.

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

Crie a chave em flowsery.com/api-tokens e coloque FLOWSERY_API_KEY=... em ~/.hermes/.env. A chave funciona como uma senha da sua conta do Flowsery, então mantenha-a fora dos chats.

Esse caminho deixa o plugin de lado, então também deixa de lado a skill dele e a configuração untrusted do plugin.json. Um token de workspace carrega o papel que você escolhe ao criá-lo, e o formulário Create Token marca o papel Contributor como "Recommended for AI agents". Um token Contributor lê o seu analytics e recebe permission_denied nas cinco gravações, que é exatamente o que um agente de analytics sem navegador deveria ter.

Quando usar o Claude Code, o ChatGPT, o Zapier ou o n8n em vez dele?

Use o Hermes quando você já trabalha nele. O mesmo pacote do Flowsery se instala no Claude Code com /plugin install flowsery --marketplace Flowsery/claude-plugin, e o ChatGPT tem o próprio plugin listado, explicado no guia do plugin de analytics para o ChatGPT do Flowsery. O Cursor, o Claude Desktop e o Gemini CLI também se conectam a https://mcp.flowsery.com/mcp, e um agente que só aceita um token Bearer, como um conector personalizado do Manus, funciona com um token de workspace, como mostra o guia do conector do Manus Cue para web analytics.

Se você quer receber números de um fluxo de trabalho em vez de uma conversa, use uma ferramenta de automação. O nó do Flowsery para o n8n envia relatórios semanais e alertas de problemas novos a partir do seu próprio servidor, e o guia de analytics com o Zapier monta os mesmos fluxos sem servidor. Os dois também podem registrar um pagamento automaticamente a cada venda, enquanto o Hermes só registra um quando você pede e aprova.

Perguntas frequentes

O Hermes Agent consegue ler o analytics do meu site?

O Hermes Agent lê o analytics do seu site pelo plugin do Flowsery do catálogo de plugins do Hermes. Instale com hermes plugins install flowsery, ative e entre com sua conta do Flowsery. Depois, o Hermes responde perguntas sobre visitantes, fontes de tráfego, metas, receita, visitantes em tempo real e os problemas que o Flowsery encontrou nas gravações de sessões.

Preciso de uma chave de API para usar o Flowsery no Hermes Agent?

O plugin do Flowsery para o Hermes Agent não precisa de chave de API. Ele faz login com OAuth no seu navegador na primeira vez que o servidor inicia e mantém o token renovado. Você só precisa de uma chave de API para uma instalação sem navegador, em que adiciona o servidor ao ~/.hermes/config.yaml com uma chave criada em flowsery.com/api-tokens.

Qual versão do Hermes Agent o plugin do Flowsery exige?

O plugin do Flowsery exige o Hermes Agent 0.21.6 ou mais recente e o Node.js 20.18.1 ou mais recente com npx no seu PATH. O Node.js roda o mcp-remote, a ponte que cuida do login e conversa com o servidor MCP do Flowsery.

O Hermes Agent pode alterar meus dados do Flowsery sem perguntar?

O Hermes Agent não altera dados do Flowsery sem perguntar. Só cinco ferramentas gravam: track_goal, delete_goals, track_payment, delete_payments e update_issue_status. O plugin marca o servidor como untrusted, então o Hermes pergunta antes de cada uma dessas cinco e as recusa no cron e em outras execuções sem supervisão. As outras 23 ferramentas só leem.

Uma tarefa cron do Hermes pode me mandar um relatório de tráfego?

Uma tarefa cron do Hermes pode ler o Flowsery e mandar um relatório, porque todas as ferramentas de relatório são somente leitura. Peça ao Hermes algo como "toda manhã às 9h, me mande os visitantes de ontem e os principais referenciadores", e ele agenda a tarefa. A tarefa cron não pode registrar nem apagar metas ou pagamentos, nem mudar o status de um problema.

Onde o plugin guarda o meu login do Flowsery?

O plugin do Flowsery guarda os tokens OAuth em ~/.mcp-auth na sua máquina. A ponte mcp-remote grava os tokens ali depois do login e os renova, então você entra só uma vez. O pacote não envia telemetria.

Por que as ferramentas do Flowsery não aparecem no Hermes depois do login?

Execute /reload-mcp na sessão do Hermes se as ferramentas do Flowsery estiverem faltando depois do login no navegador. Confira também se o plugin está ativado, porque hermes plugins install coloca o plugin no disco e hermes plugins enable flowsery faz o Hermes carregá-lo.

O Hermes Agent consegue ver os endereços IP dos meus visitantes?

O Hermes Agent nunca recebe endereços IP ou dados de cobrança pelo Flowsery, porque nenhuma ferramenta do Flowsery os devolve. O perfil de um visitante mostra localização aproximada, dispositivo, fonte, visitas, metas e receita, e o mapa em tempo real arredonda as coordenadas para 0,1 grau.

O plugin do Flowsery funciona com vários sites?

O plugin do Flowsery funciona com todos os sites de todos os workspaces que o seu login alcança. O Hermes chama list_websites primeiro e pergunta qual site você quer quando há mais de um. Diga o domínio ou o workspace na pergunta para pular essa etapa.

O Hermes Agent pode registrar pagamentos no Flowsery?

O Hermes Agent registra pagamentos no Flowsery pela ferramenta track_payment, que adiciona um pagamento, uma renovação ou um reembolso aos seus relatórios de receita. O Hermes pede a sua aprovação antes de cada chamada e recusa a ferramenta no cron e em outras execuções sem supervisão. A ferramenta nunca cobra ninguém nem movimenta dinheiro, e um ID de transação repetido é rejeitado. Não a use quando Stripe, Lemon Squeezy ou Polar estiver conectado ao Flowsery, porque o Flowsery já conta esses pagamentos e um segundo registro conta a receita duas vezes.