ClickFlare MCP e LanderLab MCP: conecte ao Hermes e rastreie leads do Meta

Você tem uma página do LanderLab pronta para o tráfego do Meta. Antes do primeiro clique, alguém precisa fazer o trabalho do tracker: uma oferta, uma fonte de tráfego, uma campanha e um link de rastreamento cheio de macros do Meta. Você também precisa de um postback do LanderLab e de um lead de teste para provar que tudo funciona.

Este passo a passo entrega a maior parte desse trabalho ao Hermes Agent por meio do MCP do ClickFlare e do MCP do LanderLab, tudo a partir de um chat do Telegram. Ele dá continuidade à primeira parte desta série, em que o mesmo agente criou uma página de quiz com 2 variações para uma clínica de implantes dentários em Prato, na Itália.

Gravamos este teste em junho de 2026. De lá para cá, o LanderLab mudou a forma como seu servidor MCP se conecta, então o passo 1 mostra o método atual, e não o da nossa gravação.

Aqui está toda a configuração em 7 passos:

1. Conecte o MCP do LanderLab ao Hermes com um login único pelo navegador.
2. Conecte o MCP do ClickFlare com uma chave de API, aprove o comando e recarregue.
3. Peça um panorama das campanhas dos últimos 30 dias para provar que a conexão lê dados reais.
4. Agende um briefing diário às 9h no Telegram.
5. Peça ao Hermes que adicione sua página ao ClickFlare como oferta e monte a campanha do Meta.
6. Adicione o postback S2S do ClickFlare no LanderLab.
7. Envie um lead de teste e confira 4 lugares.

O que você precisa antes de começar

• O Hermes Agent com o bot do Telegram rodando. O Hermes é um agente de IA open source da Nous Research que roda no seu computador ou servidor.
• Um plano Grow, Scale ou Enterprise do LanderLab. Esses planos incluem acesso à API e ao MCP.
• Uma conta no ClickFlare.
• Uma página publicada no LanderLab. A nossa roda 2 variações de quiz em uma só URL, com divisão 50/50.
• Acesso ao terminal da máquina que roda o Hermes, para uma etapa de login.

MCP, sigla de Model Context Protocol, é um padrão aberto que permite que um agente de IA use as ferramentas de outro app. O LanderLab e o ClickFlare têm, cada um, um servidor MCP. Quando o Hermes se conecta aos dois, um único chat consegue ler seus relatórios do ClickFlare e fazer alterações nas duas contas.

Passo 1: conecte o MCP do LanderLab com um login

Na nossa gravação de junho, conectamos o LanderLab colando uma chave de API no chat. Desde então, o LanderLab substituiu esse método. Em 1º de setembro de 2026, o LanderLab migrou seu servidor MCP para um login pelo navegador (OAuth) em https://api.landerlab.dev/mcp, segundo o changelog do LanderLab. As chaves de API agora valem só para chamadas diretas à API REST.

Se a configuração do seu Hermes ainda tem uma entrada do LanderLab apontando para /api/v2/mcp, remova-a e adicione a nova. O guia de MCP do Hermes cobre servidores que usam login. Tudo se resume a 4 ações:

1. No Telegram, peça ao Hermes que adicione um servidor MCP chamado landerlab com a URL https://api.landerlab.dev/mcp e auth: oauth. Você também pode adicionar essas linhas por conta própria em ~/.hermes/config.yaml.
2. Na máquina que roda o Hermes, execute hermes mcp login landerlab.
3. Abra o link que ele exibir, faça login no LanderLab e clique em Authorize.
4. Se o Hermes roda em um servidor, faça o login no seu próprio computador. Depois copie o endereço em que o navegador parar e cole no terminal quando o Hermes pedir.

Nenhuma chave vai parar no histórico do seu chat, e esse é o ganho de verdade. A página de MCP do LanderLab mostra o mesmo login para Claude, ChatGPT e outros apps de chat.

Passo 2: conecte o MCP do ClickFlare com uma chave de API

O servidor MCP do ClickFlare ainda usa chaves de API. No ClickFlare, abra Settings, depois API Keys, e clique em Create API key. Dê a ela o nome do agente (usamos hermes-tutorial), clique em Generate e copie a chave. O ClickFlare a mostra só uma vez.

Depois envie ao Hermes uma mensagem no Telegram, com a chave colada logo abaixo:

Crie uma nova conexão MCP com o ClickFlare usando a chave de API abaixo.

Não demos a URL do servidor. O Hermes preencheu https://mcp.clickflare.com/mcp sozinho, gravou a entrada na configuração, testou e informou que estava conectado, com 37 ferramentas na época. A nossa instalação já tinha criado uma skill de tracker em trabalhos anteriores, o que ajudou. Se a sua pedir a URL, ela está na documentação de MCP do ClickFlare.

Uma chave colada no Telegram fica no histórico do chat, e a própria página de API do ClickFlare diz para nunca compartilhar chaves secretas. Apague a mensagem assim que a conexão funcionar. Para uma configuração mais limpa, guarde a chave em ~/.hermes/.env e referencie-a no config.yaml como ${VAR}, como o guia de MCP do Hermes descreve.

Aprove o comando, mas leia o aviso

O Hermes pergunta antes de rodar um comando que muda a configuração dele. No Telegram, isso aparece como um card com 4 botões: Allow Once, Session, Always e Deny.

O nosso card apareceu quando conectamos o LanderLab em junho e trazia um aviso de segurança sobre um domínio parecido com outro. O Hermes verifica os comandos com um scanner chamado Tirith. Ele sinaliza todo domínio que termina em .dev, .app, .zip, .mov ou .run, porque essas terminações podem se passar por nomes de arquivo. O alerta é genérico, e api.landerlab.dev é o endereço real da API do LanderLab.

Pense bem antes de tocar em Always. A documentação de segurança do Hermes diz que ele salva esse padrão de comando na sua allowlist de forma permanente, e comandos parecidos deixam de pedir confirmação. Nós tocamos em Always. Com um agente novo, o hábito mais seguro é usar Allow Once ou Session. As versões mais novas do Hermes redigem o card de outro jeito, mas os botões são os mesmos.

Recarregue antes de testar

Servidores novos só aparecem no chat depois de um recarregamento. O Hermes nos lembrou disso a cada conexão. O conselho da nossa gravação era recarregar sempre, porque listas de ferramentas em cache podem impedir que as novas funcionem. Digite /reload-mcp no Telegram.

No nosso recarregamento, apareceram 241 ferramentas de 5 servidores. Esse total inclui outros servidores que essa instalação do Hermes já tinha conectado, como o Ahrefs.

Passo 3: peça ao MCP do ClickFlare um panorama de 30 dias

Comece com uma pergunta só de leitura. Ela prova que a conexão funciona e não altera nada na sua conta. Enviamos isto:

Mostre um panorama das minhas campanhas dos últimos 30 dias. Dê insights úteis e pontos a que eu deva ficar atento.

É um pedido pesado, já que o agente precisa chamar vários endpoints do ClickFlare, mas ele respondeu em menos de um minuto.

A resposta abriu com os totais da conta: visitas, cliques, conversões, receita, custo, lucro, ROI, CVR médio (taxa de conversão) e EPV (ganho por visita). Depois agrupou as campanhas por tipo e deu a cada uma um veredito curto, como “Precisa de limpeza”. As campanhas desta conta são campanhas de teste, então leia os números como uma demonstração.

Depois vieram os insights, a parte que vale a leitura. O tráfego orgânico sustentava a conta, o social pago tinha tráfego mas uma economia de conversão fraca, e o retargeting tinha o melhor ROI entre os canais pagos.

Ele também apontou que a cauda longa de testes pequenos estava gerando ruído e que as páginas de quiz para mobile deveriam mostrar a primeira pergunta sem precisar rolar. Nessas campanhas de teste, a leitura estava certa.

Passo 4: agende um briefing diário do ClickFlare

Agora transforme esse relatório em algo que você não precise pedir. Enviamos:

Crie um relatório de briefing diário sobre as minhas campanhas. Ele deve rodar todo dia às 9h. Inclua: um retrato das minhas campanhas, os maiores ganhadores e perdedores, insights úteis, anomalias ou tendências.

O Hermes criou um cron job, ou seja, uma tarefa que roda em horário fixo. A resposta listou o nome do job, a primeira execução e o agendamento, que era 09:00 no nosso fuso horário (Europe/Tirane). A entrega foi para o mesmo chat do Telegram.

Leia a última linha dessa resposta. O Hermes removeu uma restrição de toolset para que a execução agendada pudesse usar as ferramentas do MCP do ClickFlare. Se o seu primeiro briefing chegar vazio, pergunte ao Hermes sobre essa configuração primeiro.

O valor está nas anomalias. Peça ao briefing para destacar uma taxa de conversão que despenca da noite para o dia, uma fonte de tráfego que para de converter ou uma landing page que quebra. Você lê isso no Telegram às 9h, em vez de entrar no ClickFlare e remontar o mesmo relatório agrupado.

Vale pegar uma página quebrada antes das 9h, então mantenha também uma rotina de monitoramento de landing pages.

Passo 5: deixe o Hermes montar a campanha do Meta no ClickFlare

Primeiro, um termo do ClickFlare. A oferta é a página onde a conversão acontece. Nós mesmos coletamos os leads na página do LanderLab, então essa página é a oferta. Com uma pré-lander (uma página de aquecimento) na frente, a pré-lander seria a landing page no ClickFlare, e esta página continuaria sendo a oferta.

Nosso prompt foi vago de propósito:

Adicione ao ClickFlare como oferta a landing page que você criou antes no LanderLab (URL da sua página). Quero mandar tráfego do Meta para uma campanha que leva a essa oferta. Configure a campanha e tudo o mais que for necessário e me envie o link de rastreamento.

Cerca de 2 minutos depois, o Hermes tinha usado o MCP do ClickFlare para criar 3 itens:

• Uma fonte de tráfego para o Meta Ads.
• Uma oferta com a URL da página mais ?cf_click_id={cf_click_id}, para que o ClickFlare possa passar o click ID dele para a página.
• Uma campanha com rastreamento por redirecionamento, com um link de rastreamento para o Meta.

O link de rastreamento vai no anúncio do Meta como URL de destino. Ele carrega 8 dos parâmetros de URL dinâmicos do Meta, como {{ad.id}}, {{adset.name}} e {{placement}}. O Meta os preenche no momento do clique, para que o ClickFlare consiga reportar por anúncio, conjunto de anúncios, campanha, posicionamento e site.

Uma pegadinha da documentação do Meta: os parâmetros de nome passam o nome que o anúncio tinha quando foi publicado pela primeira vez. Se você renomear um anúncio depois, seus relatórios continuam com o nome antigo.

O rastreamento por redirecionamento envia o clique primeiro ao ClickFlare. O ClickFlare registra o clique e depois encaminha o visitante à sua página com o click ID na URL. O ClickFlare recomenda esse método quando a fonte de tráfego permite. A outra opção, o rastreamento direto, depende de um script na página.

Leia as verificações e o aviso do final

Antes de responder, o Hermes verificou a página no ar. Ele confirmou que a página lê cf_click_id, chama o endpoint de conversão /cf/cv do ClickFlare e dispara um evento quando alguém envia o formulário de lead. Esse código do ClickFlare veio da parte 1, em que pedimos ao agente para adicioná-lo.

Depois veio a linha mais útil de todo o teste. O rastreamento de custos estava como “não rastreado”, então o ClickFlare registraria visitas, leads e receita, mas não o gasto com o Meta. Enquanto você não conectar ou importar os custos do Meta, o custo aparece como $0 e o ROI não significa nada. Corrija isso antes que alguém leia o primeiro relatório.

Para testar o redirecionamento, abra o link de rastreamento em uma janela nova do navegador. O seu navegador guarda um cookie, então ele mostra sempre a mesma variação. Um navegador novo pode cair na outra.

Passo 6: envie os leads do LanderLab ao ClickFlare com o postback S2S

Um postback S2S (server-to-server) é uma chamada do servidor do LanderLab para o do ClickFlare quando alguém envia o formulário. Ele leva o click ID, para que o ClickFlare atribua a conversão à campanha e ao anúncio certos sem depender do navegador do visitante. Fizemos essa parte manualmente no LanderLab:

1. No ClickFlare, abra a campanha e copie a URL de postback dela.
2. No LanderLab, abra a landing page, vá em Integrations e clique em Add Integration.
3. Escolha ClickFlare e dê um nome à integração.
4. Cole a URL de postback e apague tudo o que vem depois de /cf/cv.
5. Informe o parâmetro de URL do Click ID.
6. Clique em Continue, mantenha o mapeamento de campos ativado e salve.

Atenção ao item 5. O guia de postback do ClickFlare no LanderLab diz que esse valor deve ser igual ao parâmetro de click ID da URL da sua oferta. A nossa usava cf_click_id, então esse é o valor a informar. Na gravação, digitamos clickid, o texto de exemplo do campo. A conversão de teste chegou ao ClickFlare mesmo assim, mas é melhor fazer os nomes coincidirem do que contar com isso.

A tela de mapeamento passa os detalhes do lead para os parâmetros personalizados do ClickFlare, incluindo a URL da lander, o ID da variação, o ID do lead e o click ID do ClickFlare. O guia do LanderLab também sugere adicionar ct=lead como parâmetro extra, para que o ClickFlare registre o tipo de conversão.

Essa página também roda o workflow do Telegram da parte 1. Então um único envio de formulário agora faz 2 coisas: manda a conversão para o ClickFlare e o lead para o seu chat.

Passo 7: envie um lead de teste e confira 4 lugares

Abra o link de rastreamento em uma janela anônima, responda ao quiz e envie o formulário. Depois confira estes 4 lugares, nesta ordem:

1. Telegram. O alerta do workflow com os detalhes do lead. O nosso chegou em segundos.
2. LanderLab, aba Leads. O lead e a variação que ele viu. A nossa foi a Variação A.
3. LanderLab, aba Logs. Em Integrations, uma linha “200 - OK” para o postback do ClickFlare e uma linha “WorkflowExecuted” para o workflow.
4. ClickFlare, Activity, Event Logs. Uma linha Conversion com o seu click ID. Os relatórios de campanha podem atrasar alguns minutos porque o ClickFlare mantém os dados em cache, então comece pelos logs.

Olhe também a aba Postback Status do ClickFlare. No nosso teste, ela mostrou entradas com falha. Nossa leitura é que o número de telefone falso do lead de teste causou isso. Use dados de teste que pareçam reais.

Erros comuns a evitar

• Manter a configuração antiga do LanderLab. As entradas que apontam para /api/v2/mcp com uma chave de API precisam ser removidas e adicionadas de novo com login.
• Nomes de click ID diferentes. O parâmetro de URL Click ID no LanderLab precisa ser igual ao da URL da sua oferta.
• Ler o ROI sem os custos. Com o rastreamento de custos desligado, lucro e ROI parecem melhores do que são.
• Tocar em Always por hábito. Isso autoriza esse padrão de comando de forma permanente.
• Deixar chaves de teste ativas. Use uma chave por agente. Criamos a nossa para a gravação e planejamos apagá-la logo depois.
• Confiar só na verificação do agente. A checagem da página prova que o código está lá. Só um lead de teste prova que os dados fluem.

FAQ

O que é o MCP do ClickFlare?

É o servidor MCP do ClickFlare, em https://mcp.clickflare.com/mcp. Com a sua chave de API, um agente ou assistente de IA pode analisar seus dados de performance e criar campanhas, ofertas e landers a partir de um chat.

Preciso saber as URLs dos servidores MCP?

No nosso teste, não. O Hermes preencheu a URL do ClickFlare só com a chave de API, ajudado por uma skill que ele criou em trabalhos anteriores. Para o login atual do LanderLab, a URL é https://api.landerlab.dev/mcp.

Quais planos do LanderLab incluem acesso ao MCP?

Grow, Scale e Enterprise. Você pode criar e publicar páginas no plano gratuito e fazer upgrade quando quiser conectar um agente.

Posso usar o Claude ou o ChatGPT no lugar do Hermes?

Na parte do MCP, sim. Os dois servidores funcionam com clientes MCP como o Claude e o ChatGPT. O chat do Telegram, o cron job diário e os botões de aprovação são recursos do Hermes.

É seguro dar a um agente de IA acesso ao meu tracker?

É tão seguro quanto o acesso que você dá. Use uma chave por agente, mantenha as aprovações ligadas, escolha Allow Once para comandos novos e apague as chaves antigas.

Por onde começar

Comece pela parte só de leitura. Conecte os dois servidores MCP, peça ao MCP do ClickFlare um panorama de 30 dias e compare com o seu dashboard. Quando os números baterem, deixe o Hermes montar uma campanha, adicione o postback você mesmo e envie um lead de teste antes de qualquer orçamento do Meta entrar no ar.