Website-analytics uitlezen kost vaak meer tijd dan je lief is: filteren, segmenteren, exporteren, en dan pas interpreteren. Microsoft heeft daar een interessante oplossing voor uitgebracht: de Microsoft Clarity MCP server. Daarmee koppel je je Clarity-analytics rechtstreeks aan een AI-assistent zoals Claude, en stel je je vragen gewoon in gewone taal — “laat de scrolldiepte van de afgelopen week zien per land” — waarna je binnen seconden een net antwoord terugkrijgt. In deze how-to laten we zien wat het is, hoe je het installeert en welke prompts direct werken.
Het is dezelfde aanpak die we eerder beschreven voor Search Console: in onze gids over Google Search Console koppelen aan Claude met mcp-gsc zie je hetzelfde principe voor SEO-data. De Clarity MCP server doet dit voor je gedragsanalytics: scrolldiepte, engagementtijd, verkeer en meer.
In het kort
- Wat het is. Een gratis MCP-server van Microsoft die je Clarity-analytics koppelt aan AI-clients zoals Claude Desktop en Cursor.
- Waarom het werkt. Je stelt vragen in natuurlijke taal; de assistent haalt zelf de juiste metrics op en analyseert ze.
- Wat je nodig hebt. Node.js v16+, een Clarity-project met een Data Export API-token en een MCP-client (Claude for Desktop).
- Wat het kost. Gratis. Let wel op de limieten: 10 API-verzoeken per dag, maximaal 3 dagen data en tot 3 dimensies per verzoek.
- Bron. De officiële aankondiging van Microsoft Clarity.
Wat is een MCP server in het kort?
Het Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten op een veilige, uniforme manier verbinding maken met externe tools en data. Microsoft vergelijkt het treffend met USB-C: net zoals je laptop via één standaard met allerlei apparaten praat, praat een AI-model via MCP met allerlei diensten — of dat nu analytics, een bestandssysteem of een clouddienst is. Wil je de architectuurkant beter begrijpen, lees dan onze blog over een custom MCP server bouwen in Laravel.
De Clarity MCP server fungeert als een brug naar je analytics: je AI-assistent kan tijdens een gesprek zelf je Clarity-data opvragen, filteren en presenteren, zonder dat jij handmatig API-verzoeken bouwt of door dashboards klikt.
Wat kan de Microsoft Clarity MCP server?
De server is gebouwd voor snelle datatoegang via een AI-vriendelijke interface. De belangrijkste mogelijkheden:
- Analytics opvragen met prompts in natuurlijke taal.
- Filteren op dimensies als Browser, OS, Land/Regio of Apparaat.
- Kernmetrics ophalen: scrolldiepte, engagementtijd, totaal verkeer en meer.
- Integratie met Claude for Desktop voor AI-gestuurde analyses.
- Werkt met andere MCP-compatibele clients (zoals Cursor) voor bredere inzetbaarheid.
Wat je nodig hebt voordat je begint
- Node.js v16 of hoger op je machine of server.
- Een Microsoft Clarity-project met een Data Export API-token.
- Een MCP-client, zoals Claude for Desktop (of Cursor).
De Clarity MCP server installeren in vier stappen
Stap 1: Genereer je API-token
- Ga naar je Clarity-project.
- Open Settings > Data Export.
- Klik op Generate new API token.
- Bewaar het token veilig — het geeft toegang tot je analytics.
Stap 2: Start de server met npx
De snelste route is direct draaien via npx, zonder installatie vooraf:
npx @microsoft/clarity-mcp-server --clarity_api_token=jouw-token-hierStap 3: Voeg de server toe aan je MCP-client
Voor Claude for Desktop voeg je de server toe aan het configuratiebestand (claude_desktop_config.json). Een voorbeeldconfiguratie:
{
"mcpServers": {
"@microsoft/clarity-mcp-server": {
"command": "npx",
"args": [
"@microsoft/clarity-mcp-server",
"--clarity_api_token=jouw-token-hier"
]
}
}
}Stap 4: Herstart en test
Herstart je client en stel een eerste vraag, bijvoorbeeld “welke metrics kun je uit mijn Clarity-project ophalen?”. De assistent haalt dan zelf de data op. De exacte configuratie voor verschillende clients staat in de officiële GitHub-repository van Microsoft, waarnaar de aankondiging verwijst.
Let op de limieten
De gratis Data Export API kent grenzen die je workflow bepalen: 10 API-verzoeken per dag, data over maximaal 3 dagen en tot 3 dimensies per verzoek. Plan je vragen dus gericht. Voor de meeste dagelijkse analyses is dat ruim voldoende; voor uitgebreide rapportages combineer je het met je reguliere Clarity-dashboard. Microsoft heeft op de roadmap staan om de daglimieten te verhogen.
Voorbeeldprompts die je direct kunt gebruiken
Zodra de server draait, werk je volledig in natuurlijke taal. Een paar prompts om mee te beginnen:
- Scrolldiepte per apparaat. “Haal de scrolldiepte van de afgelopen 2 dagen op, gefilterd op apparaattype.”
- Verkeer en engagement per browser. “Geef me verkeer en engagementtijd, gesegmenteerd per browser.”
- Top-landen. “Toon de engagementtijd van de afgelopen week per land.”
- Mobiel versus desktop. “Vergelijk scrolldiepte en sessieduur tussen mobiel en desktop.”
- Snelle samenvatting. “Vat de belangrijkste gedragsinzichten van gisteren samen in drie punten.”
Waar het in de praktijk schittert
Marketingteams: sneller antwoord
Wil je weten of bezoekers op mobiel minder ver scrollen dan op desktop? In Microsofts eigen voorbeeld leverde dat direct bruikbare cijfers op: tablet-gebruikers scrolden gemiddeld het diepst (~63%), desktop rond 43% en mobiel het laagst (~32%). Een duidelijk signaal dat de mobiele weergave aandacht verdient — zonder dat iemand een API-verzoek hoefde te schrijven.
Developers: problemen diagnosticeren
Vermoed je dat de prestaties per browser verschillen? Een prompt als “geef verkeer en engagementtijd per browser” laat in seconden zien waar gebruikers afhaken of juist lang blijven hangen. Combineer dat met je serverlogs en je hebt snel een hypothese.
MCP server centraal hosten op een Cloud VPS
Net als bij andere MCP-servers kun je de Clarity MCP server lokaal op je laptop draaien, maar voor teams of bureaus is een centrale installatie praktischer. Op een eigen server is hij altijd beschikbaar voor je hele team, en houd je je API-tokens onder eigen beheer. Je kunt hiervoor eenvoudig een Cloud VPS huren met Node.js erop, in een EU-datacenter en met Nederlandse support.
MCP-servers centraal draaien voor je team?
Host de Clarity MCP server (of een andere MCP-server) op een Cloud VPS in een Duits EU-datacenter, met NVMe-opslag, dagelijkse back-ups en Nederlandse support. Eén centrale installatie, je tokens onder eigen beheer.
Veelgestelde vragen
Is de Microsoft Clarity MCP server gratis?
Ja. Zowel Clarity als de MCP server zijn gratis. Je betaalt alleen eventuele hostingkosten als je de server niet op je laptop maar op een eigen server draait.
Heb ik per se Claude Desktop nodig?
Nee. De server werkt met Claude for Desktop én andere MCP-compatibele clients zoals Cursor.
Hoeveel data kan ik per dag opvragen?
De gratis Data Export API staat 10 verzoeken per dag toe, met maximaal 3 dagen aan data en tot 3 dimensies per verzoek. Microsoft heeft hogere limieten op de roadmap staan.
Is dit hetzelfde als de GSC MCP voor SEO?
Het principe is hetzelfde, maar de databron verschilt. De Clarity MCP server gaat over gedragsanalytics (scrolldiepte, engagement), terwijl de GSC MCP voor Search Console-data over je vindbaarheid gaat. Samen geven ze een compleet beeld.
Wil je sparren over het centraal hosten van MCP-servers of het meten en verbeteren van je website? Bekijk onze Cloud VPS of neem contact op — we denken graag mee.