MCP di ClickFlare e LanderLab: collegali a Hermes e traccia i lead di Meta

Hai una pagina LanderLab pronta per il traffico Meta. Prima del primo clic, però, qualcuno deve occuparsi del lavoro sul tracker: un'offerta, una fonte di traffico, una campagna e un link di tracciamento pieno di macro di Meta. Ti servono anche un postback da LanderLab e un lead di prova che dimostri che tutto funziona.

Questa guida passa gran parte del lavoro a Hermes Agent tramite l'MCP di ClickFlare e l'MCP di LanderLab, tutto da una chat di Telegram. Fa seguito a la prima parte di questa serie, in cui lo stesso agente aveva creato una pagina quiz con 2 varianti per una clinica di impianti dentali a Prato, in Italia.

Abbiamo registrato questa prova a giugno 2026. Da allora LanderLab ha cambiato il modo in cui si collega il suo server MCP, quindi il passo 1 mostra il metodo attuale, non quello della nostra registrazione.

Ecco l'intera configurazione in 7 passi:

1. Collega l'MCP di LanderLab a Hermes con un accesso una tantum dal browser.
2. Collega l'MCP di ClickFlare con una chiave API, approva il comando e ricarica.
3. Chiedi una panoramica delle campagne degli ultimi 30 giorni per verificare che la connessione legga dati reali.
4. Pianifica un briefing quotidiano alle 9 su Telegram.
5. Chiedi a Hermes di aggiungere la tua pagina a ClickFlare come offerta e di creare la campagna Meta.
6. Aggiungi in LanderLab il postback S2S di ClickFlare.
7. Invia un lead di prova e controlla 4 posti.

Cosa ti serve prima di iniziare

• Hermes Agent con il suo bot Telegram attivo. Hermes è un agente AI open source di Nous Research che gira sul tuo computer o sul tuo server.
• Un piano Grow, Scale o Enterprise di LanderLab. Questi piani includono l'accesso a API e MCP.
• Un account ClickFlare.
• Una pagina LanderLab pubblicata. La nostra gestisce 2 varianti di quiz su un solo URL, divise 50/50.
• Accesso al terminale della macchina su cui gira Hermes, per un passaggio di accesso.

MCP, abbreviazione di Model Context Protocol, è uno standard aperto che permette a un agente AI di usare gli strumenti di un'altra app. LanderLab e ClickFlare hanno ciascuno un server MCP. Una volta che Hermes è collegato a entrambi, una sola chat può leggere i tuoi report di ClickFlare e fare modifiche in tutti e due gli account.

Passo 1: collega l'MCP di LanderLab con un accesso

Nella nostra registrazione di giugno abbiamo collegato LanderLab incollando una chiave API nella chat. Da allora LanderLab ha sostituito quel metodo. Il 1° settembre 2026 LanderLab ha spostato il suo server MCP su un accesso dal browser (OAuth) all'indirizzo https://api.landerlab.dev/mcp, come riporta il changelog di LanderLab. Le chiavi API ora valgono solo per le chiamate dirette all'API REST.

Se la configurazione di Hermes contiene ancora una voce LanderLab che punta a /api/v2/mcp, eliminala e aggiungi quella nuova. La guida MCP di Hermes spiega come gestire i server con accesso. In pratica sono 4 azioni:

1. Chiedi a Hermes su Telegram di aggiungere un server MCP chiamato landerlab con l'URL https://api.landerlab.dev/mcp e auth: oauth. Puoi anche aggiungere tu stesso queste righe a ~/.hermes/config.yaml.
2. Sulla macchina su cui gira Hermes, esegui hermes mcp login landerlab.
3. Apri il link che viene stampato, accedi a LanderLab e clicca su Authorize.
4. Se Hermes gira su un server, fai l'accesso dal tuo computer. Poi copia l'indirizzo su cui atterra il browser e incollalo nel terminale quando Hermes te lo chiede.

Nessuna chiave finisce nella cronologia della chat, ed è questo il vero vantaggio. La pagina MCP di LanderLab mostra lo stesso accesso per Claude, ChatGPT e altre app di chat.

Passo 2: collega l'MCP di ClickFlare con una chiave API

Il server MCP di ClickFlare usa ancora le chiavi API. In ClickFlare apri Settings, poi API Keys, e clicca su Create API key. Dalle il nome dell'agente (noi abbiamo usato hermes-tutorial), clicca su Generate e copia la chiave. ClickFlare la mostra una volta sola.

Poi manda a Hermes un messaggio su Telegram, con la chiave incollata sotto:

Crea una nuova connessione MCP a ClickFlare usando la chiave API qui sotto.

Non gli abbiamo dato l'URL del server. Hermes ha compilato da solo https://mcp.clickflare.com/mcp, ha scritto la voce nella sua configurazione, l'ha testata e ha riferito che era collegata, con 37 strumenti all'epoca. La nostra installazione aveva creato una skill per il tracker in lavori precedenti, e questo ha aiutato. Se la tua ti chiede l'URL, lo trovi nella documentazione MCP di ClickFlare.

Una chiave incollata su Telegram resta nella cronologia della chat, e la stessa pagina API di ClickFlare ti dice di non condividere mai le chiavi segrete. Elimina il messaggio appena la connessione funziona. Per una configurazione più pulita, tieni la chiave in ~/.hermes/.env e richiamala in config.yaml come ${VAR}, come descrive la guida MCP di Hermes.

Approva il comando, ma leggi l'avviso

Hermes chiede conferma prima di eseguire un comando che modifica la sua configurazione. Su Telegram è una scheda con 4 pulsanti: Allow Once, Session, Always e Deny.

La nostra scheda è comparsa mentre collegavamo LanderLab a giugno e conteneva un avviso di sicurezza su un dominio sospetto, simile a uno legittimo. Hermes controlla i comandi con uno scanner chiamato Tirith. Segnala ogni dominio che finisce in .dev, .app, .zip, .mov o .run, perché queste terminazioni possono passare per nomi di file. La segnalazione è generica, e api.landerlab.dev è il vero indirizzo API di LanderLab.

Pensaci bene prima di toccare Always. Secondo la documentazione sulla sicurezza di Hermes, salva quel modello di comando nella tua allowlist in modo permanente, così i comandi simili smettono di chiedere conferma. Noi abbiamo toccato Always. Con un agente nuovo, l'abitudine più sicura è Allow Once o Session. Le versioni più recenti di Hermes formulano la scheda in modo diverso, ma i pulsanti sono gli stessi.

Ricarica prima di testare

I nuovi server compaiono nella chat solo dopo un ricaricamento. Hermes ce l'ha ricordato dopo ogni connessione. Il consiglio nella nostra registrazione era di ricaricare ogni volta, perché gli elenchi di strumenti in cache possono impedire ai nuovi strumenti di funzionare. Scrivi /reload-mcp su Telegram.

Il nostro ricaricamento ha riportato 241 strumenti da 5 server. Il totale comprende altri server già collegati a questa installazione di Hermes, come Ahrefs.

Passo 3: chiedi all'MCP di ClickFlare una panoramica degli ultimi 30 giorni

Parti da una domanda di sola lettura. Dimostra che la connessione funziona e non modifica nulla nel tuo account. Noi abbiamo mandato questo:

Mostrami una panoramica delle mie campagne degli ultimi 30 giorni. Dammi spunti utili e cose di cui dovrei essere al corrente.

È una richiesta pesante, perché l'agente deve chiamare diversi endpoint di ClickFlare, ma ha risposto comunque in meno di un minuto.

La risposta si apriva con i totali dell'account: visite, clic, conversioni, ricavi, costi, profitto, ROI, CVR (tasso di conversione) medio ed EPV (guadagno per visita). Poi raggruppava le campagne per tipo e dava a ciascuna un breve giudizio, come «Da ripulire». Le campagne di questo account sono campagne di prova, quindi leggi i numeri come una demo.

Poi arrivavano gli spunti, la parte che vale la pena leggere. Il traffico organico reggeva l'account, il paid social aveva traffico ma una resa di conversione debole, e il retargeting aveva il miglior ROI tra i canali a pagamento.

Segnalava anche che la lunga coda di piccoli test aggiungeva rumore e che le pagine quiz per mobile dovrebbero mostrare la prima domanda senza dover scorrere. Su queste campagne di prova, la lettura era accurata.

Passo 4: pianifica un briefing quotidiano di ClickFlare

Ora trasforma quel report in qualcosa che non devi più chiedere. Noi abbiamo mandato:

Crea un report di briefing quotidiano sulle mie campagne. Deve partire ogni giorno alle 9. Includi: un quadro delle mie campagne, i migliori e i peggiori risultati, spunti utili, eventuali anomalie o tendenze.

Hermes ha creato un cron job, cioè un'attività che viene eseguita con una pianificazione fissa. La sua risposta elencava il nome del job, la prima esecuzione e la pianificazione, cioè le 09:00 nel nostro fuso orario (Europe/Tirane). La consegna è avvenuta nella stessa chat di Telegram.

Leggi l'ultima riga di quella risposta. Hermes ha rimosso una restrizione sul toolset così che l'esecuzione pianificata potesse usare gli strumenti dell'MCP di ClickFlare. Se il tuo primo briefing arriva vuoto, chiedi prima a Hermes di quell'impostazione.

Il valore sta nelle anomalie. Chiedi al briefing di segnalare un tasso di conversione che crolla durante la notte, una fonte di traffico che smette di convertire o una landing page che si rompe. Lo leggi su Telegram alle 9 invece di accedere a ClickFlare e ricostruire ogni volta lo stesso report raggruppato.

Una pagina rotta conviene scoprirla prima delle 9, quindi tieni anche una routine di monitoraggio delle landing page.

Passo 5: lascia che Hermes crei la campagna Meta in ClickFlare

Prima, un termine di ClickFlare. L'offerta è la pagina in cui avviene la conversione. Raccogliamo noi i lead sulla pagina di LanderLab, quindi quella pagina è l'offerta. Se davanti ci fosse una pre-lander (una pagina di riscaldamento), in ClickFlare la landing page sarebbe la pre-lander e questa pagina resterebbe l'offerta.

Il nostro prompt era volutamente vago:

Aggiungi a ClickFlare come offerta la landing page che hai creato prima su LanderLab (URL della tua pagina). Voglio mandare traffico da Meta a una campagna che porta a questa offerta. Configura la campagna e tutto il necessario e mandami il link di tracciamento.

Circa 2 minuti dopo, Hermes aveva usato l'MCP di ClickFlare per creare 3 elementi:

• Una fonte di traffico per Meta Ads.
• Un'offerta con l'URL della pagina più ?cf_click_id={cf_click_id}, così ClickFlare può passare il suo click ID alla pagina.
• Una campagna con tracciamento tramite redirect, con un link di tracciamento per Meta.

Il link di tracciamento va nell'annuncio Meta come URL di destinazione. Contiene 8 dei parametri URL dinamici di Meta, come {{ad.id}}, {{adset.name}} e {{placement}}. Meta li compila al momento del clic, così ClickFlare può fare report per annuncio, gruppo di inserzioni, campagna, posizionamento e sito.

Un'avvertenza dalla documentazione di Meta: i parametri del nome passano il nome che un annuncio aveva alla prima pubblicazione. Se rinomini un annuncio in seguito, i report continuano a mostrare il vecchio nome.

Il tracciamento con redirect manda prima il clic a ClickFlare. ClickFlare lo registra, poi inoltra il visitatore alla tua pagina con il click ID nell'URL. ClickFlare consiglia questo metodo quando la fonte di traffico lo consente. L'altra opzione, il tracciamento diretto, si affida a uno script sulla pagina.

Leggi i controlli, e l'avviso alla fine

Prima di rispondere, Hermes ha controllato la pagina online. Ha confermato che la pagina legge cf_click_id, chiama l'endpoint di conversione /cf/cv di ClickFlare e fa partire un evento quando qualcuno invia il form dei lead. Quel codice di ClickFlare veniva dalla parte 1, dove avevamo chiesto all'agente di aggiungerlo.

Poi è arrivata la riga più utile dell'intera prova. Il tracciamento dei costi era impostato su «non tracciato», quindi ClickFlare avrebbe registrato visite, lead e ricavi, ma non la spesa su Meta. Finché non colleghi o importi i costi di Meta, il costo risulta $0 e il ROI non significa nulla. Sistemalo prima che qualcuno legga il primo report.

Per controllare il redirect, apri il link di tracciamento in una finestra nuova del browser. Il tuo browser conserva un cookie, quindi ti mostra sempre la stessa variante. Un browser nuovo può portarti sull'altra.

Passo 6: invia i lead di LanderLab a ClickFlare con il postback S2S

Un postback S2S (server-to-server) è una chiamata dal server di LanderLab a quello di ClickFlare quando qualcuno invia il form. Porta con sé il click ID, così ClickFlare può attribuire il merito alla campagna e all'annuncio giusti senza dipendere dal browser del visitatore. Questa parte l'abbiamo fatta a mano in LanderLab:

1. In ClickFlare, apri la campagna e copia il suo URL di postback.
2. In LanderLab, apri la landing page, vai su Integrations e clicca su Add Integration.
3. Scegli ClickFlare e dai un nome all'integrazione.
4. Incolla l'URL di postback, poi elimina tutto ciò che segue /cf/cv.
5. Inserisci il parametro URL del Click ID.
6. Clicca su Continue, lascia attiva la mappatura dei campi e salva.

Fai attenzione al punto 5. La guida di LanderLab al postback di ClickFlare dice che questo valore deve coincidere con il parametro del click ID nell'URL della tua offerta. La nostra usava cf_click_id, quindi quello è il valore da inserire. Nella registrazione abbiamo scritto clickid, il segnaposto del campo. La conversione di prova è arrivata comunque a ClickFlare, ma conviene far coincidere i nomi invece di sperare che funzioni.

La schermata di mappatura passa i dettagli del lead ai parametri personalizzati di ClickFlare, tra cui l'URL della lander, l'ID della variante, l'ID del lead e il click ID di ClickFlare. La guida di LanderLab suggerisce anche di aggiungere ct=lead come parametro extra, così ClickFlare registra il tipo di conversione.

Questa pagina esegue anche il workflow Telegram della parte 1. Quindi un solo invio del form ora fa 2 cose: manda la conversione a ClickFlare e il lead nella tua chat.

Passo 7: invia un lead di prova e controlla 4 posti

Apri il link di tracciamento in una finestra privata, rispondi al quiz e invia il form. Poi controlla questi 4 posti, in quest'ordine:

1. Telegram. L'avviso del workflow con i dettagli del lead. Il nostro è arrivato in pochi secondi.
2. LanderLab, scheda Leads. Il lead e la variante che ha visto. La nostra era la Variante A.
3. LanderLab, scheda Logs. Sotto Integrations, una riga «200 - OK» per il postback di ClickFlare e una riga «WorkflowExecuted» per il workflow.
4. ClickFlare, Activity, Event Logs. Una riga Conversion con il tuo click ID. I report delle campagne possono ritardare di un paio di minuti perché ClickFlare mette i dati in cache, quindi parti dai log.

Guarda anche la scheda Postback Status di ClickFlare. Nella nostra prova mostrava voci non riuscite per il test. La nostra lettura è che la causa sia il numero di telefono finto del lead di prova. Usa dati di test che sembrino reali.

Errori comuni da evitare

• Tenere la vecchia configurazione di LanderLab. Le voci che puntano a /api/v2/mcp con una chiave API vanno eliminate e aggiunte di nuovo con l'accesso.
• Nomi del click ID che non coincidono. Il parametro URL Click ID in LanderLab deve coincidere con quello dell'URL della tua offerta.
• Leggere il ROI senza i costi. Con il tracciamento dei costi spento, profitto e ROI sembrano migliori di quello che sono.
• Toccare Always per abitudine. Autorizza quel modello di comando per sempre.
• Lasciare attive le chiavi di prova. Usa una chiave per agente. La nostra l'abbiamo creata per la registrazione e avevamo previsto di eliminarla subito dopo.
• Fidarsi solo del controllo dell'agente. Il suo controllo della pagina dimostra che il codice c'è. Solo un lead di prova dimostra che i dati arrivano.

FAQ

Che cos'è l'MCP di ClickFlare?

È il server MCP di ClickFlare, all'indirizzo https://mcp.clickflare.com/mcp. Con la tua chiave API, un agente o un assistente AI può analizzare i tuoi dati di performance e creare campagne, offerte e lander da una chat.

Devo conoscere gli URL dei server MCP?

Non nella nostra prova. Hermes ha compilato l'URL di ClickFlare partendo dalla sola chiave API, aiutato da una skill creata in lavori precedenti. Per l'accesso attuale di LanderLab, l'URL è https://api.landerlab.dev/mcp.

Quali piani LanderLab includono l'accesso MCP?

Grow, Scale ed Enterprise. Puoi creare e pubblicare pagine con il piano gratuito e passare a un piano superiore quando vuoi collegare un agente.

Posso usare Claude o ChatGPT al posto di Hermes?

Per la parte MCP, sì. Entrambi i server funzionano con client MCP come Claude e ChatGPT. La chat di Telegram, il cron job quotidiano e i pulsanti di approvazione sono funzioni di Hermes.

È sicuro dare a un agente AI l'accesso al mio tracker?

È sicuro quanto l'accesso che gli dai. Usa una chiave per agente, tieni attive le approvazioni, scegli Allow Once per i comandi nuovi ed elimina le chiavi vecchie.

Da dove iniziare

Parti dalla parte di sola lettura. Collega i due server MCP, chiedi all'MCP di ClickFlare una panoramica degli ultimi 30 giorni e confrontala con la tua dashboard. Quando i numeri coincidono, lascia che Hermes crei una campagna, aggiungi tu il postback e invia un lead di prova prima che parta qualsiasi budget su Meta.