ClickFlare MCP en LanderLab MCP: koppel ze aan Hermes en track Meta-leads

Je hebt een LanderLab-pagina klaar voor Meta-verkeer. Vóór de eerste klik moet iemand het trackerwerk doen: een aanbod, een verkeersbron, een campagne en een trackinglink vol Meta-macro's. Ook heb je een postback vanuit LanderLab nodig en een testlead om te bewijzen dat alles werkt.

In deze stap-voor-stapgids gaat het grootste deel van dat werk naar Hermes Agent, via de ClickFlare MCP en de LanderLab MCP, allemaal vanuit een Telegram-chat. Het sluit aan op het eerste deel van deze serie, waarin dezelfde agent een quizpagina met 2 varianten bouwde voor een kliniek voor tandimplantaten in Prato, Italië.

We hebben deze run in juni 2026 opgenomen. Sindsdien heeft LanderLab aangepast hoe de MCP-server verbindt, dus stap 1 laat de huidige methode zien en niet die uit onze opname.

Dit is de hele setup in 7 stappen:

1. Koppel de LanderLab MCP aan Hermes met een eenmalige inlog in de browser.
2. Koppel de ClickFlare MCP met een API-sleutel, keur het commando goed en laad opnieuw.
3. Vraag om een campagneoverzicht van 30 dagen om te bewijzen dat de koppeling echte data leest.
4. Plan een dagelijkse briefing om 9 uur in Telegram.
5. Vraag Hermes je pagina als aanbod aan ClickFlare toe te voegen en de Meta-campagne te bouwen.
6. Voeg de ClickFlare S2S-postback toe in LanderLab.
7. Stuur één testlead en controleer 4 plekken.

Wat je nodig hebt voordat je begint

• Hermes Agent met zijn Telegram-bot actief. Hermes is een open-source AI-agent van Nous Research die op je eigen computer of server draait.
• Een Grow-, Scale- of Enterprise-abonnement van LanderLab. Die abonnementen bevatten toegang tot de API en MCP.
• Een ClickFlare-account.
• Een gepubliceerde LanderLab-pagina. Die van ons draait 2 quizvarianten op één URL, 50/50 verdeeld.
• Toegang tot de terminal van de machine waarop Hermes draait, voor één inlogstap.

MCP, kort voor Model Context Protocol, is een open standaard waarmee een AI-agent de tools van een andere app kan gebruiken. LanderLab en ClickFlare hebben elk een MCP-server. Zodra Hermes met beide verbonden is, kan één chat je ClickFlare-rapporten lezen en wijzigingen doorvoeren in beide accounts.

Stap 1: koppel de LanderLab MCP met een inlog

In onze opname van juni koppelden we LanderLab door een API-sleutel in de chat te plakken. LanderLab heeft die methode inmiddels vervangen. Op 1 september 2026 verhuisde LanderLab zijn MCP-server naar inloggen via de browser (OAuth) op https://api.landerlab.dev/mcp, volgens de changelog van LanderLab. API-sleutels gelden nu alleen nog voor directe REST API-aanroepen.

Staat er in je Hermes-config nog een LanderLab-item dat naar /api/v2/mcp wijst, verwijder dat dan en voeg het nieuwe toe. De MCP-gids van Hermes behandelt servers die inloggen gebruiken. Het komt neer op 4 handelingen:

1. Vraag Hermes in Telegram een MCP-server met de naam landerlab toe te voegen met de URL https://api.landerlab.dev/mcp en auth: oauth. Je kunt die regels ook zelf toevoegen aan ~/.hermes/config.yaml.
2. Voer op de machine waarop Hermes draait hermes mcp login landerlab uit.
3. Open de link die verschijnt, log in bij LanderLab en klik op Authorize.
4. Draait Hermes op een server, log dan in op je eigen computer. Kopieer daarna het adres waarop je browser uitkomt en plak het in de terminal wanneer Hermes erom vraagt.

Er komt geen sleutel in je chatgeschiedenis terecht, en dat is de echte winst. De MCP-pagina van LanderLab toont dezelfde inlog voor Claude, ChatGPT en andere chat-apps.

Stap 2: koppel de ClickFlare MCP met een API-sleutel

De MCP-server van ClickFlare gebruikt nog steeds API-sleutels. Open in ClickFlare Settings, dan API Keys, en klik op Create API key. Geef hem de naam van de agent (wij gebruikten hermes-tutorial), klik op Generate en kopieer de sleutel. ClickFlare toont hem maar één keer.

Stuur Hermes daarna in Telegram één bericht, met de sleutel eronder geplakt:

Maak een nieuwe MCP-verbinding met ClickFlare met de API-sleutel hieronder.

We hebben hem de server-URL niet gegeven. Hermes vulde https://mcp.clickflare.com/mcp zelf in, schreef het item naar zijn config, testte het en meldde dat het verbonden was, met toen 37 tools. Onze installatie had bij eerdere klussen een trackerskill gebouwd, wat hielp. Vraagt die van jou om de URL, dan staat hij in de MCP-documentatie van ClickFlare.

Een sleutel die je in Telegram plakt, blijft in je chatgeschiedenis staan, en de API-pagina van ClickFlare zelf zegt dat je geheime sleutels nooit moet delen. Verwijder het bericht zodra de verbinding werkt. Voor een nettere setup bewaar je de sleutel in ~/.hermes/.env en verwijs je ernaar in config.yaml als ${VAR}, zoals de MCP-gids van Hermes beschrijft.

Keur het commando goed, maar lees de waarschuwing

Hermes vraagt om toestemming voordat hij een commando uitvoert dat zijn setup wijzigt. In Telegram is dat een kaart met 4 knoppen: Allow Once, Session, Always en Deny.

Onze kaart verscheen toen we in juni LanderLab koppelden en bevatte een beveiligingsmelding over een domein dat op een ander lijkt. Hermes controleert commando's met een scanner genaamd Tirith. Die markeert elk domein dat eindigt op .dev, .app, .zip, .mov of .run, omdat zulke uitgangen voor bestandsnamen kunnen doorgaan. De markering is algemeen, en api.landerlab.dev is het echte API-adres van LanderLab.

Denk na voordat je op Always tikt. Volgens de beveiligingsdocs van Hermes slaat dat het commandopatroon voorgoed op in je allowlist, waardoor vergelijkbare commando's niet meer om toestemming vragen. Wij tikten op Always. Bij een nieuwe agent is Allow Once of Session de veiligere gewoonte. Nieuwere Hermes-versies formuleren de kaart anders, maar de knoppen zijn hetzelfde.

Laad opnieuw voordat je test

Nieuwe servers verschijnen pas in de chat na een herlaadbeurt. Hermes herinnerde ons er na elke koppeling aan. Het advies in onze opname was om elke keer opnieuw te laden, omdat gecachte toollijsten kunnen voorkomen dat nieuwe tools werken. Typ /reload-mcp in Telegram.

Onze herlaadbeurt meldde 241 tools van 5 servers. Dat totaal omvat andere servers die deze Hermes-installatie al had gekoppeld, zoals Ahrefs.

Stap 3: vraag de ClickFlare MCP om een overzicht van 30 dagen

Begin met een vraag die alleen leest. Die bewijst dat de koppeling werkt en wijzigt niets in je account. Wij stuurden dit:

Laat me een overzicht van mijn campagnes van de afgelopen 30 dagen zien. Geef me nuttige inzichten en dingen waar ik rekening mee moet houden.

Het is een zwaar verzoek, want de agent moet meerdere ClickFlare-endpoints aanroepen, maar hij antwoordde toch binnen een minuut.

Het antwoord opende met de totalen van het account: bezoeken, klikken, conversies, omzet, kosten, winst, ROI, gemiddelde CVR (conversiepercentage) en EPV (verdiensten per bezoek). Daarna groepeerde het de campagnes per type en gaf het elke campagne een kort oordeel, zoals „Opruimen nodig”. De campagnes in dit account zijn testcampagnes, dus lees de cijfers als een demo.

Toen kwamen de inzichten, het deel dat het lezen waard is. Organisch verkeer droeg het account, betaalde social had verkeer maar zwakke conversie-economie, en retargeting had de beste betaalde ROI.

Ook zei het dat de lange staart van kleine tests ruis toevoegde en dat quizpagina's voor mobiel de eerste vraag moeten tonen zonder te scrollen. Bij deze testcampagnes klopte die analyse.

Stap 4: plan een dagelijkse ClickFlare-briefing

Maak van dat rapport nu iets waar je niet om hoeft te vragen. Wij stuurden:

Maak een dagelijks briefingrapport over mijn campagnes. Het moet elke dag om 9 uur draaien. Neem op: een momentopname van mijn campagnes, de grootste winnaars en verliezers, nuttige inzichten, eventuele afwijkingen of trends.

Hermes maakte een cronjob aan, oftewel een taak die volgens een vast schema draait. Zijn antwoord vermeldde de naam van de job, de eerste run en het schema, namelijk 09:00 in onze tijdzone (Europe/Tirane). De levering ging naar dezelfde Telegram-chat.

Lees de laatste regel van dat antwoord. Hermes heeft een toolset-beperking verwijderd zodat de geplande run de ClickFlare MCP-tools kon gebruiken. Komt je eerste briefing leeg binnen, vraag Hermes dan eerst naar die instelling.

De waarde zit in de afwijkingen. Laat de briefing een conversiepercentage noemen dat 's nachts wegzakt, een verkeersbron die niet meer converteert of een landingspagina die kapotgaat. Dat lees je om 9 uur in Telegram, in plaats van in te loggen bij ClickFlare en steeds hetzelfde gegroepeerde rapport opnieuw op te bouwen.

Een kapotte pagina wil je vóór 9 uur opvangen, dus houd ook een routine voor het monitoren van landingspagina's aan.

Stap 5: laat Hermes de Meta-campagne in ClickFlare bouwen

Eerst één ClickFlare-term. Het aanbod is de pagina waar de conversie plaatsvindt. We verzamelen de leads zelf op de LanderLab-pagina, dus die pagina is het aanbod. Staat er een pre-lander (een opwarmpagina) voor, dan is de pre-lander de landingspagina in ClickFlare en blijft deze pagina het aanbod.

Onze prompt was met opzet vaag:

Voeg de landingspagina die je eerder in LanderLab hebt gemaakt (URL van je pagina) toe aan ClickFlare als aanbod. Ik wil verkeer vanaf Meta sturen naar een campagne die verkeer naar dit aanbod stuurt. Zet de campagne en al het andere wat nodig is op en stuur me de trackinglink.

Ongeveer 2 minuten later had Hermes via de ClickFlare MCP 3 items gemaakt:

• Een verkeersbron voor Meta Ads.
• Een aanbod met de pagina-URL plus ?cf_click_id={cf_click_id}, zodat ClickFlare zijn click ID aan de pagina kan doorgeven.
• Een campagne met redirect-tracking, met een trackinglink voor Meta.

De trackinglink komt als bestemmings-URL in de Meta-advertentie. Hij bevat 8 van de dynamische URL-parameters van Meta, zoals {{ad.id}}, {{adset.name}} en {{placement}}. Meta vult ze in op het moment van de klik, zodat ClickFlare kan rapporteren per advertentie, advertentieset, campagne, plaatsing en site.

Een kanttekening uit de documentatie van Meta: naamparameters geven de naam door die een advertentie had toen ze voor het eerst werd gepubliceerd. Hernoem je een advertentie later, dan houden je rapporten de oude naam.

Redirect-tracking stuurt de klik eerst naar ClickFlare. ClickFlare registreert hem en stuurt de bezoeker daarna door naar je pagina, met het click ID in de URL. ClickFlare raadt deze methode aan als de verkeersbron het toelaat. De andere optie, directe tracking, leunt op een script op de pagina.

Lees de controles en de waarschuwing aan het eind

Voordat hij antwoordde, controleerde Hermes de live pagina. Hij bevestigde dat de pagina cf_click_id leest, het conversie-endpoint /cf/cv van ClickFlare aanroept en een event afvuurt wanneer iemand het leadformulier verstuurt. Die ClickFlare-code kwam uit deel 1, waar we de agent vroegen hem toe te voegen.

Toen kwam de nuttigste regel van de hele run. Kostentracking stond op „niet getrackt”, dus ClickFlare zou bezoeken, leads en omzet vastleggen, maar niet de Meta-uitgaven. Zolang je de Meta-kosten niet koppelt of importeert, staan de kosten op $0 en betekent de ROI niets. Los het op voordat iemand het eerste rapport leest.

Om de redirect te controleren open je de trackinglink in een nieuw browservenster. Je browser bewaart een cookie, dus hij toont je steeds dezelfde variant. Een nieuwe browser kan op de andere uitkomen.

Stap 6: stuur LanderLab-leads naar ClickFlare met de S2S-postback

Een S2S-postback (server-to-server) is een aanroep van de server van LanderLab naar die van ClickFlare wanneer iemand het formulier verstuurt. Hij bevat het click ID, zodat ClickFlare de juiste campagne en advertentie kan crediteren zonder op de browser van de bezoeker te leunen. Dit deel deden we handmatig in LanderLab:

1. Open in ClickFlare de campagne en kopieer de postback-URL.
2. Open in LanderLab de landingspagina, ga naar Integrations en klik op Add Integration.
3. Kies ClickFlare en geef de integratie een naam.
4. Plak de postback-URL en verwijder alles na /cf/cv.
5. Vul de URL-parameter voor het Click ID in.
6. Klik op Continue, laat de veldtoewijzing aan staan en sla op.

Let op bij punt 5. De ClickFlare-postbackgids van LanderLab zegt dat deze waarde moet overeenkomen met de click ID-parameter in de URL van je aanbod. Die van ons gebruikte cf_click_id, dus dat is de waarde om in te vullen. In de opname typten we clickid, de placeholder van het veld. De testconversie kwam toch bij ClickFlare aan, maar we laten de namen liever overeenkomen dan dat we daarop rekenen.

Het toewijzingsscherm geeft leadgegevens door aan de aangepaste parameters van ClickFlare, waaronder de lander-URL, variant-ID, lead-ID en het ClickFlare click ID. De gids van LanderLab raadt ook aan ct=lead als extra parameter toe te voegen, zodat ClickFlare het conversietype vastlegt.

Deze pagina draait ook de Telegram-workflow uit deel 1. Eén formulierverzending doet nu dus 2 dingen: de conversie naar ClickFlare sturen en de lead naar je chat.

Stap 7: stuur één testlead en controleer 4 plekken

Open de trackinglink in een privévenster, beantwoord de quiz en verstuur het formulier. Controleer daarna deze 4 plekken, in deze volgorde:

1. Telegram. De workflowmelding met de leadgegevens. Die van ons kwam binnen een paar seconden binnen.
2. LanderLab, tabblad Leads. De lead en de variant die hij zag. Bij ons was dat Variant A.
3. LanderLab, tabblad Logs. Onder Integrations een regel „200 - OK” voor de ClickFlare-postback en een regel „WorkflowExecuted” voor de workflow.
4. ClickFlare, Activity, Event Logs. Een Conversion-regel met je click ID. Campagnerapporten kunnen een paar minuten achterlopen doordat ClickFlare data cachet, dus begin bij de logs.

Kijk ook naar het tabblad Postback Status van ClickFlare. In onze run toonde dat mislukte items voor de test. Onze lezing is dat het nepnummer in de testlead dat veroorzaakte. Gebruik testdata die er echt uitziet.

Veelgemaakte fouten die je kunt voorkomen

• De oude LanderLab-setup aanhouden. Items die met een API-sleutel naar /api/v2/mcp wijzen, moeten worden verwijderd en opnieuw worden toegevoegd met inloggen.
• Click ID-namen die niet overeenkomen. De URL-parameter Click ID in LanderLab moet overeenkomen met de URL van je aanbod.
• De ROI lezen zonder kosten. Met kostentracking uit zien winst en ROI er beter uit dan ze zijn.
• Uit gewoonte op Always tikken. Het staat dat commandopatroon voorgoed toe.
• Testsleutels laten bestaan. Gebruik één sleutel per agent. Die van ons maakten we voor de opname en we waren van plan hem meteen daarna te verwijderen.
• Alleen vertrouwen op de controle van de agent. Zijn paginacheck bewijst dat de code er staat. Alleen een testlead bewijst dat de data stroomt.

FAQ

Wat is de ClickFlare MCP?

Het is de MCP-server van ClickFlare, op https://mcp.clickflare.com/mcp. Met je API-sleutel kan een AI-agent of -assistent je prestatiedata analyseren en campagnes, aanbiedingen en landers maken vanuit een chat.

Moet ik de URL's van de MCP-servers kennen?

Niet in onze run. Hermes vulde de ClickFlare-URL in op basis van alleen de API-sleutel, geholpen door een skill die hij bij eerdere klussen had gebouwd. Voor de huidige inlog van LanderLab is de URL https://api.landerlab.dev/mcp.

Welke LanderLab-abonnementen bevatten MCP-toegang?

Grow, Scale en Enterprise. Je kunt pagina's bouwen en publiceren in het gratis abonnement en upgraden wanneer je een agent wilt koppelen.

Kan ik Claude of ChatGPT gebruiken in plaats van Hermes?

Voor het MCP-deel wel. Beide servers werken met MCP-clients zoals Claude en ChatGPT. De Telegram-chat, de dagelijkse cronjob en de goedkeuringsknoppen zijn functies van Hermes.

Is het veilig om een AI-agent toegang tot mijn tracker te geven?

Het is zo veilig als de toegang die je geeft. Gebruik één sleutel per agent, laat goedkeuringen aan staan, kies Allow Once voor nieuwe commando's en verwijder oude sleutels.

Waar je begint

Begin met het deel dat alleen leest. Koppel beide MCP-servers, vraag de ClickFlare MCP om een overzicht van 30 dagen en vergelijk het met je dashboard. Kloppen de cijfers, laat Hermes dan één campagne bouwen, voeg de postback zelf toe en stuur een testlead voordat er Meta-budget live gaat.