Hoe koppel je Claude via MCP aan GA4?
De meeste GA4-workflows bestaan uit inloggen, door menu's klikken, data exporteren en die data daarna apart interpreteren. Als je Claude via MCP (Model Context Protocol) aan GA4 koppelt, wordt dat proces teruggebracht tot één gesprek. In deze gids lees je precies wat je nodig hebt om de koppeling op te zetten, goed te authenticeren en vragen te stellen over je live analyticsdata.
Bijdrage van
SaaS Hackers
Kort antwoord: Je koppelt Claude aan GA4 door een Google Analytics MCP-server in te richten die Claude directe toegang geeft tot de data van je property. Dat kost 20 tot 30 minuten en vereist een Google Cloud-serviceaccount, de GA4 Data API en een lokaal MCP-configuratiebestand. Zodra de koppeling werkt, kan Claude queries uitvoeren, trends signaleren en wekelijkse inzichtrapporten maken op basis van je live analyticsdata.
Inzichten uit GA4 halen betekent meestal inloggen, door rapporten klikken, CSV's exporteren en dan proberen de cijfers te duiden. Dat is traag en je slaat het gemakkelijk over.
Als je Claude via MCP (Model Context Protocol) aan GA4 koppelt, verandert dat. Je geeft Claude directe toegang tot je analyticsdata en stelt vragen in gewone taal. In deze gids vind je de volledige setup: authenticatie, je eerste queries en een set prompts voor wekelijkse inzichten, gemaakt voor B2B SaaS-teams.
Wat is MCP en waarom is het belangrijk voor GA4?
MCP (Model Context Protocol) is een open standaard waarmee AI-modellen zoals Claude verbinding maken met externe databronnen en tools. In plaats van data in een chatvenster te plakken, leest Claude die rechtstreeks uit de bron.
Voor GA4 betekent MCP dat Claude je analyticsproperty in realtime kan bevragen. Je kunt vragen: "welke acquisitiekanalen leverden vorige maand de meeste trialaanmeldingen op?" en krijgt een antwoord uit je eigen data, geen generiek sjabloon.
Waarom dit belangrijk is voor B2B SaaS-teams:
- Geen handmatige rapportexports meer
- Zowel analisten als niet-analisten krijgen snel antwoord
- Claude kan patronen over meerdere dimensies tegelijk signaleren
- Wekelijkse rapportage wordt een prompt in plaats van een project
Wat je nodig hebt voordat je begint
Zorg dat je het volgende klaar hebt voordat je configuratiebestanden aanpast:
- Een Google Analytics 4-property waar data binnenkomt
- Een Google Cloud-account (de gratis variant volstaat)
- Claude Desktop, geïnstalleerd op je computer
- Node.js, geïnstalleerd (versie 18 of hoger)
- Basiskennis van terminalopdrachten en het bewerken van JSON-bestanden
Gebruik je Claude via de API in plaats van Claude Desktop, dan verschilt de setup van de MCP-server. Deze gids behandelt de route via Claude Desktop.
Stap 1: Maak een Google Cloud-project aan
- Ga naar console.cloud.google.com
- Klik bovenaan op Select a project en daarna op New Project
- Geef het een herkenbare naam, bijvoorbeeld "Claude GA4 MCP"
- Klik op Create en wacht tot het project is aangemaakt
Heb je al een Google Cloud-project dat aan je GA4-property is gekoppeld, dan kun je dat gebruiken. Een apart project houdt de rechten overzichtelijk.
Stap 2: Schakel de Google Analytics Data API in
- Ga in je nieuwe project naar APIs & Services > Library
- Zoek naar "Google Analytics Data API"
- Klik op het resultaat en kies Enable
Deze API geeft programmatische toegang tot de rapportdata van GA4. Zonder deze API kan de MCP-server je property niet lezen.
Stap 3: Maak een serviceaccount aan
Een serviceaccount is een niet-menselijke Google-identiteit waarmee de MCP-server zich bij GA4 authenticeert. Dit is de juiste aanpak voor lokale tooling, omdat je niet bij elke sessie opnieuw via OAuth hoeft in te loggen.
- Ga naar APIs & Services > Credentials
- Klik op Create Credentials > Service Account
- Geef het een naam zoals "claude-ga4-reader"
- Klik op Create and Continue
- Sla bij de stap voor de rol het toevoegen van een rol over (je verleent toegang straks op GA4-niveau)
- Klik op Done
Genereer vervolgens een sleutel voor dit serviceaccount:
- Klik in de lijst op je nieuwe serviceaccount
- Ga naar het tabblad Keys
- Klik op Add Key > Create New Key
- Kies JSON en klik op Create
- Er wordt een JSON-bestand naar je computer gedownload. Bewaar dit bestand veilig. Het is je authenticatiegegeven.
Stap 4: Geef het serviceaccount toegang tot je GA4-property
Het serviceaccount bestaat in Google Cloud, maar GA4 kent het nog niet. Je moet het als gebruiker toevoegen in GA4.
- Open analytics.google.com
- Ga naar Admin > Property Access Management
- Klik op de knop + en kies Add users
- Vul het e-mailadres van het serviceaccount in (het ziet er zo uit:
claude-ga4-reader@your-project.iam.gserviceaccount.com) - Stel de rol in op Viewer
- Klik op Add
Viewer-toegang is genoeg voor alleen-lezen queries. Geef geen Editor- of Admin-rechten, tenzij je daar een specifieke reden voor hebt.
Stap 5: Noteer je GA4-property-ID
Je hebt je GA4-property-ID nodig om de MCP-server te vertellen met welke property hij verbinding moet maken.
- Ga in GA4 naar Admin > Property Settings
- Kopieer de Property ID (een numerieke waarde, bijvoorbeeld
123456789)
Houd dit bij de hand voor de volgende stap.
Stap 6: installeer de Google Analytics MCP-server
Open je terminal en voer uit:
npm install -g @modelcontextprotocol/server-google-analyticsIs dat pakket niet beschikbaar in je npm-register, dan is de door de community onderhouden optie die de meeste teams gebruiken die van insightfulpipe.com. Raadpleeg die bron voor de exacte pakketnaam en eventuele versie-updates, want het MCP-ecosysteem ontwikkelt zich snel.
Je kunt ook een lokale MCP-server rechtstreeks clonen en draaien:
git clone https://github.com/[repo-name]/ga4-mcp-server
cd ga4-mcp-server
npm installStap 7: Configureer Claude Desktop om de MCP-server te gebruiken
Claude Desktop gebruikt een configuratiebestand om te bepalen welke MCP-servers geladen worden. Dit bestand moet je aanpassen om je GA4-server toe te voegen.
Zoek het configuratiebestand:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Open het bestand in een willekeurige teksteditor. Bestaat het niet, maak het dan aan.
Voeg de configuratie van je GA4 MCP-server toe:
{
"mcpServers": {
"google-analytics": {
"command": "node",
"args": ["/path/to/your/ga4-mcp-server/index.js"],
"env": {
"GA4_PROPERTY_ID": "123456789",
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account-key.json"
}
}
}
}Vervang de placeholders:
/path/to/your/ga4-mcp-server/index.jsdoor het daadwerkelijke pad naar het serverbestand123456789door je echte GA4-property-ID/path/to/your/service-account-key.jsondoor het pad naar de JSON-sleutel die je in stap 3 hebt gedownload
Sla het bestand op.
Stap 8: herstart Claude Desktop en test de koppeling
- Sluit Claude Desktop volledig af (sluit niet alleen het venster)
- Open het opnieuw
- Zoek naar een tools- of MCP-indicator in de interface (dit bevestigt dat de server is geladen)
Test de koppeling met een eenvoudige prompt:
"Using the GA4 MCP tool, show me sessions and users for the last 7 days."
Als Claude echte cijfers uit je property teruggeeft, werkt de koppeling. Krijg je een foutmelding, controleer dan of:
- De bestandspaden in je configuratie absoluut zijn en niet relatief
- Het e-mailadres van het serviceaccount met Viewer-toegang aan GA4 is toegevoegd
- De Google Analytics Data API is ingeschakeld in je Cloud-project
- Node.js bereikbaar is via het pad dat Claude gebruikt om opdrachten uit te voeren
Je eerste GA4-queries uitvoeren met Claude
Zodra de koppeling werkt, kun je Claude in gewone taal GA4-queries laten uitvoeren. Claude vertaalt je verzoek naar het formaat van de GA4 Data API, haalt de data op en geeft een gestructureerd antwoord.
Basisqueries om mee te beginnen:
- "Wat waren mijn top 10 landingspagina's op basis van sessies vorige maand?"
- "Laat me het conversiepercentage per verkeersbron zien voor de afgelopen 30 dagen"
- "Welke landen leverden in Q2 de meeste gebruikers op?"
- "Wat is de gemiddelde sessieduur, uitgesplitst per apparaatcategorie?"
Specifiek voor B2B SaaS:
- "Hoeveel gebruikers hebben de afgelopen 14 dagen het event voor trialaanmelding voltooid, uitgesplitst per acquisitiekanaal?"
- "Wat is het uitvalpercentage tussen de prijspagina en de aanmeldpagina?"
- "Laat me de sessies van terugkerende gebruikers en nieuwe gebruikers per week zien voor de afgelopen 8 weken"
Claude kan dimensies en metrics ook combineren op manieren die in de standaardinterface van GA4 lastig zijn. Vraag het om acquisitiebron en engagementpercentage te kruisen, of om twee periodes naast elkaar te vergelijken. Is organisch zoeken een belangrijk groeikanaal voor je team, dan kan het ook helpen om je rapportageworkflows te vergelijken met hoe vooraanstaande SaaS-teams samenwerken met gespecialiseerde B2B SaaS SEO-bureaus.
Wekelijkse insight-prompts voor B2B SaaS-teams
Een van de waardevolste toepassingen van deze integratie is je handmatige wekelijkse analyticsreview vervangen door een vaste routine van gestructureerde prompts. Voer ze elke maandagochtend uit.
Prompt 1: samenvatting van verkeer en acquisitie
"Pull last week's sessions, new users, and returning users. Break sessions down by channel group. Compare to the previous week and flag any channel that changed by more than 15% in either direction."
Prompt 2: controle van de conversiefunnel
"Show me the completion rate for [your key conversion event] last week versus the week before. Then show me the top 3 pages users visited before completing that event."
Prompt 3: contentprestaties
"Which 5 pages had the highest engaged sessions last week? Which 5 had the lowest engagement rate with more than 100 sessions? Summarise what that pattern suggests."
Prompt 4: betaald versus organisch
"Compare sessions and conversion events from organic search versus paid search over the last 4 weeks. Show week-by-week. Identify the trend direction for each."
Prompt 5: anomaliedetectie
"Look at daily sessions for the last 30 days. Identify any days where sessions were more than 20% above or below the 30-day average. List the dates and the percentage deviation."
Bewaar deze prompts als tekstbestand of als prompt in een Claude Project. Alle vijf uitvoeren kost minder dan 5 minuten en geeft je een compleet weekbeeld zonder één keer GA4 te openen. Wil je die inzichten omzetten in een breder demand gen-plan, dan kan het ook nuttig zijn om de aanpak van B2B SaaS Performance Marketing-bureaus, B2B SaaS PPC-bureaus of B2B SaaS Content Marketing-bureaus te vergelijken.
Veelvoorkomende setupfouten en hoe je ze oplost
Fout: "MCP server failed to start"
Controleer of het bestandspad in je claude_desktop_config.json correct en absoluut is. Relatieve paden werken niet.
Fout: "Permission denied on GA4 property"
Het e-mailadres van het serviceaccount is niet aan GA4 toegevoegd, of aan de verkeerde property. Controleer nogmaals of het e-mailadres exact overeenkomt.
Fout: "Google Analytics Data API not enabled"
Ga terug naar de Google Cloud Console en controleer of de API is ingeschakeld voor het juiste project. Het serviceaccount en de API moeten in hetzelfde project zitten.
Fout: "Invalid property ID"
Controleer of je de numerieke property-ID uit GA4 Admin gebruikt en niet de Measurement ID (die begint met G-).
Veelgestelde vragen
Wat is de Google Analytics MCP-server voor Claude?
De Google Analytics MCP-server is een lokaal proces dat Claude Desktop via de Google Analytics Data API met je GA4-property verbindt. Hij gebruikt de Model Context Protocol-standaard, zodat Claude je analyticsdata rechtstreeks kan lezen en er vragen over kan beantwoorden zonder handmatige data-export.
Heb ik codeerkennis nodig om Claude met GA4 te verbinden?
Je moet je redelijk thuisvoelen bij terminalcommando's en het bewerken van een JSON-bestand. Je hoeft zelf geen code te schrijven, maar je moet wel npm-commando's uitvoeren, een serviceaccount aanmaken in Google Cloud en een configuratiebestand aanpassen. De meeste B2B SaaS-professionals met enige technische achtergrond hebben dit in minder dan 30 minuten voor elkaar.
Is het veilig om Claude met mijn GA4-data te verbinden?
Ja, als je het goed instelt. Het serviceaccount heeft alleen leestoegang als Viewer, dus Claude kan je GA4-property of data niet wijzigen. De inloggegevens blijven op je eigen computer, in het configuratiebestand. Commit de JSON-sleutel van je serviceaccount nooit naar een openbare repository.
Kan ik dit gebruiken met Claude via de API in plaats van Claude Desktop?
De MCP-serveraanpak die hier wordt beschreven is bedoeld voor Claude Desktop. Als je de Claude API rechtstreeks gebruikt, kun je GA4-data als resultaten van toolaanroepen doorgeven in je eigen applicatie. Daarvoor is wel maatwerkontwikkeling nodig, in plaats van de configuratiebestandsaanpak hierboven.
Wat is het verschil met Windsor.ai om GA4 met Claude te verbinden?
Windsor.ai is een no-code connector die GA4-data zonder lokale installatie met Claude synchroniseert. De MCP-aanpak die hier wordt beschreven draait lokaal, geeft je meer controle over welke data Claude kan inzien en vereist geen betaalde externe dienst. Het nadeel is dat de MCP-setup in het begin meer tijd kost om te configureren.
Tot welke GA4-data heeft Claude toegang via MCP?
Claude heeft toegang tot alle data die beschikbaar is via de GA4 Data API, waaronder sessies, gebruikers, events, conversies, engagementstatistieken, verkeersbronnen, data op paginaniveau en aangepaste dimensies of events die je in je property hebt ingesteld. Via deze methode heeft Claude geen toegang tot ruwe data op eventniveau uit BigQuery-exports.
Bijdrage van
SaaS Hackers


