De server Klanten geeft een AI-tool dezelfde informatie die een adviseur in de app ziet: wat er bekend is over een klant, hoe hij ervoor staat, wat er is voorgesteld en wat er werkelijk is gewijzigd. Het adres is https://api.leadforge.nl/client-mcp. De servernaam in je configuratie is de naam van je bureau plus -klanten, en een sleutel kan gelden voor alle klanten van het bureau of voor een selectie.
Hoe je een klant aanwijst
Bijna elke tool heeft het argument klant. De server zoekt de klant in deze volgorde:
- op het id van de klant;
- op de exacte naam of de slug, zonder verschil tussen hoofdletters en kleine letters;
- op een deel van de naam.
Valt er precies één klant in het bereik van je sleutel, dan mag klant leeg blijven. Gearchiveerde klanten en klanten buiten het bereik van je sleutel bestaan voor de server niet: je krijgt dan dezelfde melding als bij een naam die niet bestaat, Onbekende klant. Vraag eerst klant_lijst op.
Welke tools je ziet
Een sleutel voor alle klanten ziet alle vijftien leestools. Een sleutel met een selectie klanten ziet alleen de tools van agents die bij die klanten aanstaan:
| Tool | Vraagt de agent |
|---|---|
klant_campagnes, klant_zoektermen, klant_zoekwoorden | google_ads |
klant_social | social_ads |
klant_zoekopdrachten, klant_paginas | seo |
De andere leestools hangen niet aan een agent. De twee schrijftools, klant_voorstel en klant_voorstel_intrekken, zie je alleen met schrijfrecht op de sleutel. Zie Voorstellen klaarzetten via MCP.
Tools
De beschrijvingen hieronder zijn de teksten die de AI-tool zelf van de server krijgt. Getallen worden naar beneden afgerond; een waarde onder 1 geeft de standaard en een waarde boven het maximum geeft het maximum.
klant_lijst
Welke klanten heeft deze organisatie, en wat is er per klant gekoppeld? Begin hier: de andere tools hebben een klantnaam uit deze lijst nodig.
Geen invoer
Kolommen: klant, id, site, status, gekoppeld, laatste_week.
klant_context
Wat we van een klant weten: de secties uit het brein plus de basisgegevens. Zonder 'sectie' krijg je het overzicht, met 'sectie' de volledige inhoud van die ene sectie. Gebruik dit voordat je iets over een klant beweert.
Invoer
| Naam | Type | Beschrijving |
|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst |
| sectie | string | Optioneel: één sectie volledig uitlezen |
* verplicht
Het overzicht heeft de kolommen sectie, regels, bijgewerkt. Een sectie wordt na 20.000 tekens afgekapt. Staat er in het brein een veld met een naam als token, secret, api_key, password, wachtwoord of sleutel, dan komt de waarde terug als ***.
klant_gezondheid
Hoe staat een klant ervoor: de laatste volledige week tegen de week ervoor, wat er openstaat aan aanbevelingen en wat er de laatste 30 dagen is uitgevoerd. Dit is de tool voor 'geef me een overzicht van de gezondheid van klant X'.
Invoer
| Naam | Type | Beschrijving |
|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst |
* verplicht
De weekvergelijking heeft de kolommen metriek, deze week, vorige, verschil.
klant_prestaties
De weekcijfers van een klant. Twee conversiekolommen, en dat verschil is belangrijk: conv_ads is wat Google Ads zelf toeschrijft, conv_ga4 telt alle conversies in GA4 over al het verkeer. Ze lopen ver uiteen en alleen conv_ads hoort bij de klikken en kosten in deze tabel. Vertoningen en klikken zijn advertentiecijfers, niet organisch. Een streepje betekent niet gemeten, geen nul. De kolom ontbreekt noemt de bron die die week niet ophaalde. Eén regel per week, nieuwste onderaan.
Invoer
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst | |
| weken | integer | 12 | Aantal weken terug (default 12, max 104) |
* verplicht
Kolommen: week, status, sessies, vertoningen, klikken, conv_ads, conv_ga4, kosten, omzet, cpa, roas, ctr%, ontbreekt.
klant_signalen
Wat wijkt echt af? Zet de weekreeks van één metriek op een XmR-controlekaart en geeft alleen de punten terug die buiten de grenzen vallen of in een lange reeks aan één kant van het gemiddelde. Gebruik dit in plaats van twee weken met elkaar vergelijken: ruis ziet er week op week altijd uit als een trend.
Invoer
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst | |
| metriek | string | conversies_ads | Welke metriek (default conversies_ads). Let op het verschil tussen conversies_ads en conversies_ga4. Een van: conversies_ads, conversies_ga4, cpa, ctr, klikken, kosten, omzet, roas. |
| weken | integer | 26 | Aantal weken terug (default 26, max 104) |
* verplicht
Een controlekaart vraagt minstens 8 bruikbare weken; met minder zegt de tool dat. De opvallende weken staan in de kolommen week, waarde, waarom.
klant_aanbevelingen
De aanbevelingen voor een klant van alle agents, met urgentie, categorie, onderbouwing en verwachte impact. Standaard alleen wat nog openstaat. Uitvoeren kan hier niet; dat loopt via de goedkeuring in de app.
Invoer
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst | |
| status | string | pending | Standaard 'pending' (openstaand). 'alles' geeft elke status terug, of noem er één: approved, rejected, executed, failed. |
| urgentie | string | Optioneel: alleen deze urgentie. Een van: low, medium, high, critical. |
* verplicht
Hoogstens 120 rijen, nieuwste eerst. Kolommen: datum, id, agent, urgentie, status, categorie, titel, impact. Het id is het korte id van acht tekens dat klant_voorstel_intrekken aanneemt.
klant_wijzigingen
Wat er werkelijk is gewijzigd in de accounts van een klant: elke uitvoerpoging met resultaat of foutmelding, plus de goedgekeurde acties. Dit is het antwoord op 'wat hebben we gedaan en wat gebeurde er daarna'.
Invoer
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst | |
| dagen | integer | 30 | Aantal dagen terug (default 30, max 365) |
* verplicht
Uitvoerpogingen in de kolommen datum, agent, operatie, via, resultaat, fout. Goedgekeurde acties in de kolommen datum, agent, actie, status, titel, verwachte impact.
klant_campagnes
Per campagne opgeteld over een aantal weken: kosten, klikken, conversies, CPA en welk aandeel van het budget eraan opgaat. Dit is de tool voor 'waar gaat het geld heen' en 'welke campagne veroorzaakt de daling'.
Invoer
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst | |
| weken | integer | 4 | Aantal weken terug (default 4, max 104) |
* verplicht
Kolommen: campagne, status, weken, kosten, klikken, conversies, cpa, aandeel. Gesorteerd op kosten.
klant_social
Meta Ads per campagne, opgeteld over een aantal weken tot en met gisteren: kosten, vertoningen, klikken, resultaten (leads plus aankopen volgens Meta), kosten per resultaat en welk aandeel van het budget eraan opgaat, met een totaalregel. Uit de dagmeting van Meta Ads, niet uit de weeksnapshots. Een streepje is niet gemeten of niet te delen, geen nul.
Invoer
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst | |
| weken | integer | 4 | Aantal weken terug (default 4, max 104) |
* verplicht
Kolommen: campagne, dagen, kosten, vertoningen, klikken, resultaten, kpr, aandeel. Het totaal telt ook de campagnes mee die niet in de tabel passen.
klant_zoektermen
Waar zochten mensen echt op voordat ze klikten, met klikken en kosten per term. Let op: deze bron draagt geen conversies, dus of een term iets oplevert is hier niet te zien. Wel waar het geld heen gaat, en daar beginnen uitsluitingen.
Invoer
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst | |
| weken | integer | 4 | Aantal weken terug (default 4, max 104) |
* verplicht
Kolommen: zoekterm, campagne, weken, klikken, kosten, kosten per klik. Duurste bovenaan.
klant_zoekwoorden
De zoekwoorden waarop geboden wordt, met matchtype, campagne, klikken en kosten. Ook hier geen conversies in de bron.
Invoer
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst | |
| weken | integer | 4 | Aantal weken terug (default 4, max 104) |
* verplicht
Kolommen: zoekwoord, type, campagne, weken, klikken, kosten.
klant_zoekopdrachten
Organisch uit Search Console: op welke zoekopdrachten de site gevonden wordt, met klikken, vertoningen, CTR en positie. Het verloop vergelijkt de eerste week van het venster met de laatste.
Invoer
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst | |
| weken | integer | 4 | Aantal weken terug (default 4, max 104) |
* verplicht
Kolommen: zoekopdracht, weken, klikken, vertoningen, ctr%, positie, verloop. De positie is gewogen op vertoningen.
klant_paginas
Welke pagina's organisch verkeer halen, met klikken, vertoningen, CTR, positie en het verloop over het venster.
Invoer
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst | |
| weken | integer | 4 | Aantal weken terug (default 4, max 104) |
* verplicht
Kolommen: pagina, weken, klikken, vertoningen, ctr%, positie, verloop.
klant_kanalen
Hoe het verkeer zich over kanalen verdeelt volgens GA4, met sessies, gebruikers, conversies en omzet per kanaal. Al het verkeer, niet alleen advertenties.
Invoer
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst | |
| weken | integer | 4 | Aantal weken terug (default 4, max 104) |
* verplicht
Kolommen: kanaal, weken, sessies, gebruikers, conversies, omzet, conv%.
klant_dagen
Eén regel per dag, met Google Ads, GA4 en Search Console naast elkaar. Dit is de tool om een verandering op een datum vast te pinnen in plaats van op een week: een kolom die opdroogt terwijl de rest doorloopt wijst op de meting en niet op het gedrag.
Invoer
| Naam | Type | Standaard | Beschrijving |
|---|---|---|---|
| klant*(verplicht) | string | Naam of id van de klant, zoals teruggegeven door klant_lijst | |
| weken | integer | 2 | Aantal weken terug (default 2, max 104) |
* verplicht
Hoogstens 60 dagregels. Kolommen: dag, ads_klikken, ads_kosten, ads_conv, ads_waarde, sessies, ga4_conv, omzet, gsc_klikken.
Antwoorden
- Elk antwoord is platte tekst, met tabellen in vaste kolombreedtes. Dat leest voor een model prettiger dan JSON.
- Een streepje (
-) betekent niet gemeten, geen nul. - Tabellen met campagnes, termen, zoekwoorden, pagina's of kanalen tonen hoogstens 25 detailrijen. Bij
klant_campagnesenklant_socialstaat erbij hoeveel campagnes er niet getoond zijn. - Er komt nooit nagespeelde of verzonnen data terug. Is er niets gemeten, dan zegt de tool dat.
naam n
----- --
taart 12
brood -
Goed om te weten