Koppel Claude, ChatGPT of een andere AI-assistent aan je Personyze-account en werk ermee in een gewoon gesprek — vraag hoe campagnes het doen, zoek waar je verkeer verliest, bouw een campagne, pauzeer een actie, krijg antwoord op een vraag over hoe iets werkt.
Wat dit is
MCP (Model Context Protocol) is de open standaard die AI-assistenten gebruiken om met externe diensten te werken. Personyze draait een MCP-server, zodat een assistent je account direct kan bereiken: geen code, geen data kopiëren tussen tabbladen, geen exportbestanden.
Het draait op dezelfde externe API als de Full-featured API, met dezelfde rechten.
Server-URL: https://personyze.com/mcp/
Een assistent koppelen
De meeste assistenten vragen alleen om de URL en leiden je daarna door het inloggen:
- Open in Personyze Integraties → AI-assistenten (MCP) en kopieer de server-URL.
- Voeg in de assistent een eigen connector toe en plak hem:
• **Claude** — Instellingen → Connectors → Eigen connector toevoegen
• **ChatGPT** — Instellingen → Connectors - Keur de koppeling goed op het Personyze-scherm dat opent. Er valt niets te kopiëren en te plakken: de assistent krijgt een eigen inlogbewijs.
Tools die geen browser kunnen openen — een script, of een plug-in voor een IDE — kunnen in plaats daarvan een Personyze-API-sleutel als header meesturen:
Authorization: Bearer YOUR_API_KEYDe sleutels staan op dezelfde kaart bij Integraties.
Wat je het kunt vragen
Alles hieronder werkt vandaag. De formulering is aan jou — dit zijn voorbeelden van het soort vraag, geen commando’s met een vaste syntaxis.
Begrijpen hoe je campagnes presteren
- “Welke campagnes presteerden de afgelopen 30 dagen het best?”
- “Welke actie kreeg vorige maand de meeste kliks?”
- “Hoe doet de banner op de prijspagina het vergeleken met april?”
- “Welke campagnes hadden de afgelopen 30 dagen helemaal geen activiteit?”
- “Is de pop-up bij het afrekenen echt getoond, of alleen uitgevoerd?”
Het leest de dagelijkse prestatiesamenvatting per actie: weergaven, bezorgingen, kliks, wegklikken, mislukkingen, je eigen ingestelde doelen, en totalen zoals omzet. Het weigert een klikratio te noemen op een steekproef die te klein is om iets te betekenen, en zegt dat liever dan het getal toch te noemen.
Zoeken waar je verkeer verliest
- “Welke landingspagina’s verliezen de meeste sessies?”
- “Wat zijn deze week mijn meest bezochte pagina’s?”
- “Waar komt mijn verkeer vandaan?”
- “Welke verkeersbronnen converteren het slechtst?”
- “Welke apparaten en browsers gebruiken mijn bezoekers?”
- “Uit welke landen en steden komen mijn bezoekers?”
- “Via welke organische zoektermen komen mensen binnen?”
Verkeer voor de hele site over elke periode, uitgesplitst naar pagina, landingspagina, verwijzer, zoekterm, apparaat, stad of land — met sessies, bezoeken, gebruikers, bounces, doelen, doelwaarde, tijd op de pagina, en de weergaven en kliks van personalisatie op die pagina’s. Ratio’s (bounce, doel, klikratio, nieuwe gebruikers, mobiel) worden berekend na het groeperen, en rijen met weinig verkeer worden uitgesloten bij rangschikken op een ratio, zodat een bouncepercentage van 100% over drie sessies niet boven een echt probleem uitkomt.
Naar producten kijken
- “Wat zijn mijn bestverkopende producten?”
- “Welke producten worden vaak bekeken maar zelden gekocht?”
- “Wat wordt het vaakst aanbevolen?”
Zien wat er draait, en waarom
- “Toon mijn campagnes.”
- “Welke campagnes draaien op mijn homepage?”
- “Waarom verschijnt de welkomstbanner niet?”
- “Wat is de targeting van campagne 1834?”
- “Welke campagnes targeten mobiele bezoekers?”
- “Laat me de HTML van de banner in deze campagne zien.”
- “Welke van mijn acties zijn live en welke staan nog in de testmodus?”
Targeting komt terug als leesbare regeltekst — “Include on current page: Contains /pricing and not Full URL contains login” — niet als ruwe configuratie.
Campagnes bouwen en wijzigen
- “Maak een campagne die terugkerende mobiele bezoekers target.”
- “Bouw een campagne voor bezoekers op de prijspagina die nog niets hebben gekocht.”
- “Hernoem hem naar Zomerpromotie en verander de targeting naar bezoekers uit betaald zoeken.”
- “Zet dat concept aan zodat ik het kan testen.”
- “Pauzeer de pop-up op de afrekenpagina.”
- “Hervat de exit-intent-banner.”
Twee dingen die je moet weten over hoe dit zich gedraagt:
Nieuwe campagnes worden in stagingmodus aangemaakt. Ze worden alleen getoond aan bezoekers die van een staging-IP komen. Echt verkeer blijft zien wat er nu live staat, en je publiceert zelf in het panel. De assistent geeft je een directe link naar de campagne, zodat je die kunt openen. Beschrijf targeting in gewone woorden en die wordt omgezet in echte regels — de assistent leest het resultaat aan je terug, omdat een regel die net iets anders zegt dan wat je vroeg er van buiten precies hetzelfde uitziet.
Een actie pauzeren of hervatten gebeurt live. Het werkt voor echte bezoekers zodra de JavaScript van je account opnieuw is opgebouwd. De assistent vraagt eerst om bevestiging, en doet dat concreet — met de naam van de actie, de campagne waarin die zit, en wat je bezoekers niet meer of juist wel gaan zien. Het is volledig terug te draaien. Eén actie tegelijk: “pauzeer de campagne” wordt niet opgevat als toestemming om alles erin uit te zetten zonder het je te vertellen.
Werken met doelgroepen en bezoekersprofielen
- “Hoeveel doelgroepen heb ik, en hoe groot is elke doelgroep?”
- “Maak een doelgroep met de naam Enterprise-prospects.”
- “Voeg iedereen uit deze lijst eraan toe.”
- “Voeg john@example.com toe aan de doelgroep Enterprise-prospects.”
- “Verwijder bezoeker 48213 uit die doelgroep.”
- “Zoek het profiel met CRM-id crm-123.”
- “Welke bezoekers zijn meer dan vijf keer langs geweest?”
- “Werk het profiel van Ann bij met haar nieuwe telefoonnummer.”
Bezoekers kunnen worden geïdentificeerd met de numerieke profiel-ID van Personyze, met je eigen CRM-/site-ID, of met een e-mailadres.
Placeholders beheren
- “Welke placeholders heb ik?”
- “Maak een placeholder voor het element met id hero-banner.”
Vragen hoe het product werkt
- “Hoe importeer ik mijn productcatalogus?“
- “Hoe stel ik conversietracking in?“
- “Hoe installeer ik Personyze op Shopify?“
- “Wat is het verschil tussen een campagne en een actie?”
- “Hoe werken webpushmeldingen?”
De assistent doorzoekt deze kennisbank en antwoordt vanuit wat die vindt, met links naar de gebruikte artikelen zodat je ze kunt controleren. Dekt de documentatie je vraag niet, dan zegt die dat en biedt die aan een supportticket te openen in plaats van te gokken.
Hulp van een mens krijgen
- “Open een supportticket — aanbevelingen verschijnen niet op mobiel.”
Het vraagt eerst om bevestiging, schrijft op wat je aan het doen was en wat het al heeft gecontroleerd, zodat support niet bij nul begint, en geeft je het ticketnummer. Antwoorden komen binnen in het panel, onder Hulp & ondersteuning.
Al het andere
Voor verzoeken die de speciale tools niet dekken, kan de assistent de REST API van Personyze rechtstreeks aanroepen — dezelfde objecten die voor elke API-client beschikbaar zijn.
Volledige lijst met tools
| Tool | Wat het doet |
|---|---|
list_campaigns |
De campagnes van het account opsommen |
get_campaign_targeting |
De regels die bepalen aan wie een campagne wordt getoond |
create_campaign_draft |
Een campagne in stagingmodus maken |
update_campaign_draft |
Een stagingcampagne hernoemen, opnieuw targeten of aan-/uitzetten |
list_actions |
Personalisatieacties opsommen |
get_action_content |
Eén actie met de bewerkbare HTML en de weergaveregels |
set_action_active |
Eén live actie pauzeren of hervatten |
list_placeholders |
Benoemde plekken op de pagina waarin acties worden weergegeven |
create_placeholder |
Er een maken |
get_campaign_performance |
Dagelijkse prestaties per actie over een periode |
get_traffic_analytics |
Verkeer voor de hele site per pagina, bron, apparaat, geografie |
get_product_stats |
Weergaven, aanbevelingen en aankopen per product |
list_audiences |
Doelgroepen (bezoekerssegmenten) opsommen |
create_audience |
Er een maken |
delete_audience |
Er een verwijderen (bezoekersprofielen worden niet verwijderd) |
list_audience_members |
Wie er in een doelgroep zit |
add_audience_member |
Een bezoeker aan een doelgroep toevoegen |
remove_audience_member |
Er een verwijderen |
get_visitors |
Bezoekersprofielen doorzoeken |
save_visitor |
Een bezoekersprofiel maken of bijwerken |
search_docs |
Deze kennisbank doorzoeken |
open_support_ticket |
Een ticket openen bij het supportteam |
personyze_api |
Elke aanroep van de REST API van Personyze, voor de rest |
Authenticatie in detail
Voor developers die een client bouwen in plaats van een kant-en-klare assistent te gebruiken:
- OAuth 2.1, autorisatiecode met PKCE (S256). Openbare clients — geen clientgeheim.
- Dynamische clientregistratie (RFC 7591) op het aangekondigde
registration_endpoint, zodat een client zichzelf kan registreren. - Discovery volgens RFC 9728 (protected resource) en RFC 8414 (autorisatieserver), geserveerd op de root van de host: –
https://personyze.com/.well-known/oauth-protected-resource–https://personyze.com/.well-known/oauth-authorization-server - Scope:
personyze:full - Een verzoek zonder authenticatie aan
/mcp/antwoordt met401met een headerWWW-Authenticatedieresource_metadatabevat, en dat is het beginpunt voor discovery.
Rechten en toegang intrekken
Elke gekoppelde assistent werkt met een API-sleutel van je account, en handelt met de rechten van dat account — die kan alleen zien en wijzigen wat dat account kan.
Om een assistent los te koppelen, verwijder je de sleutel ervan onder Integraties → AI-assistenten (MCP) (of Full-featured API — die delen één set sleutels). Intrekken werkt meteen.
Problemen oplossen
De assistent zegt dat die de server niet kan bereiken. Controleer of je de URL met de slash aan het eind hebt geplakt: https://personyze.com/mcp/.
Het koppelingsscherm verschijnt nooit. Je assistent blokkeert misschien eigen connectors in je abonnement — zowel Claude als ChatGPT maken dit afhankelijk van het niveau.
Een tool geeft geen data terug. Controleer of je de koppeling hebt goedgekeurd voor het bedoelde Personyze-account; de accountwisselaar in het panel en de koppeling van de assistent staan los van elkaar.
Het zegt dat een campagne niet kan worden bewerkt. Alleen campagnes in stagingmodus kunnen door een assistent worden hernoemd of opnieuw getarget. Een live campagne bewerk je in het panel.
Installeren in Claude
Personyze staat in de connectordirectory van Claude — in Claude installeer je het met één klik in plaats van de server-URL te plakken: Personyze aan Claude toevoegen.