Google Search Console MCP installeren en koppelen aan Claude: complete stap-voor-stap handleiding

Je Google Search Console rechtstreeks aan Claude koppelen klinkt als iets voor doorgewinterde developers, maar in de praktijk ben je in een half uur klaar. Zodra de koppeling staat, stel je in gewone taal een vraag over je rankings, klikken of indexering, en haalt Claude de data zelf op uit Search Console. In deze handleiding lopen we stap voor stap door de complete installatie, van Google Cloud credentials tot de juiste configuratie in Claude Desktop, inclusief de fouten waar de meeste mensen op vastlopen.

We gebruiken hiervoor de open source server mcp-gsc van AminForou, die je vindt op github.com/AminForou/mcp-gsc. Wil je eerst weten wat deze server precies kan en welke SEO-analyses je ermee uitvoert, lees dan onze eerdere gids over Google Search Console koppelen aan Claude met mcp-gsc. Dit artikel is de praktische installatiehandleiding bij dat verhaal.

Wat je nodig hebt voordat je begint

Zorg dat je het volgende bij de hand hebt. Met deze ingrediënten verloopt de rest van de installatie zonder verrassingen.

• Een Google-account dat toegang heeft tot ten minste één Search Console property.
• Toegang tot Google Cloud Console om een project en credentials aan te maken.
• De Claude Desktop app, te downloaden via claude.ai/download. De browserversie werkt niet, omdat de server lokaal op jouw machine draait.
• Een Mac, Windows of Linux. mcp-gsc is een Python-pakket en draait op alle drie.

Stap 1. Google API credentials aanmaken

Claude moet namens jou bij de Search Console API kunnen. Daarvoor maak je in Google Cloud een OAuth-koppeling aan. Dit is verreweg de meest aanbevolen methode voor persoonlijk gebruik, omdat je je eigen Google-account gebruikt en geen wachtwoorden met derden deelt.

1. Ga naar Google Cloud Console en maak een nieuw project aan of selecteer een bestaand project.
2. Schakel de Search Console API in. Zoek in de bibliotheek op “Search Console API” en klik op Inschakelen.
3. Ga naar Credentials, kies Create Credentials en daarna OAuth client ID.
4. Stel zo nodig het OAuth consent screen in, kies als applicatietype Desktop app en klik op Create.
5. Download het JSON-bestand en bewaar het op een vaste plek, bijvoorbeeld in je map Documenten als client_secrets.json. Het volledige pad naar dit bestand heb je straks nodig.

Let op het applicatietype: kies Desktop app en niet Web application. Dit is de fout die later de meeste OAuth-problemen veroorzaakt.

Stap 2. uv en uvx installeren

De makkelijkste manier om mcp-gsc te draaien is met uvx. Je hoeft dan niets te clonen, geen Python apart te installeren en geen virtuele omgeving te beheren. uvx downloadt en draait de server automatisch en houdt hem bij. Open je terminal en voer deze drie commando’s na elkaar uit.

# 1. Downloaden en installeren
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Activeren in je huidige terminalsessie
source $HOME/.local/bin/env

# 3. Permanent maken voor alle toekomstige sessies
echo 'source $HOME/.local/bin/env' >> ~/.zshrc

Controleer daarna of de installatie is gelukt met:

uv --version

Waarom alle drie de commando’s? De installer plaatst uv in ~/.local/bin, maar je al geopende terminal kent die map nog niet. Stap twee activeert het direct, stap drie zorgt dat elke nieuwe terminal het automatisch oppakt.

Stap 3. Claude Desktop configureren

Nu koppel je mcp-gsc aan Claude Desktop. Open het configuratiebestand van Claude Desktop. Op een Mac vind je dit op:

~/Library/Application Support/Claude/claude_desktop_config.json

Voeg het volgende blok toe. Bestaat het bestand nog niet, maak het dan aan met precies deze inhoud. Vervang de twee paden door jouw eigen paden.

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

Het pakket heet mcp-search-console, dat is correct. De property die je in Claude aanspreekt heet straks gscServer, zoals in dit blok.

Stap 4. Het juiste pad naar uvx invullen

Grafische apps zoals Claude Desktop lezen je shellconfiguratie niet uit en kennen ~/.local/bin dus niet. Daarom moet je het volledige pad naar uvx invullen in plaats van alleen uvx. Zoek het pad op met:

which uvx

Op een Mac is dat meestal /Users/JOUW_NAAM/.local/bin/uvx. Vervang /FULL/PATH/TO/uvx in de config door deze uitkomst. Sla je dit over, dan krijg je later vrijwel zeker de foutmelding spawn uvx ENOENT.

Stap 5. Herstarten en testen

Sla het configuratiebestand op en sluit Claude Desktop volledig af met Cmd+Q. Alleen het venster sluiten is niet genoeg, de app moet echt herstarten om de nieuwe configuratie te laden. Open Claude Desktop daarna opnieuw.

Bij het eerste gebruik opent automatisch een browservenster waarin je je Google-account koppelt. Daarna wordt de token lokaal bewaard en hoef je dit niet opnieuw te doen. Test de koppeling met een eenvoudige vraag in Claude:

List my GSC properties

Zie je je properties verschijnen, dan staat de koppeling. Werkt het niet, vraag Claude dan om get_capabilities aan te roepen. Die tool rapporteert precies de authenticatiestatus en helpt je de oorzaak te vinden.

Alternatief: installeren via een lokale clone

Wil je de code zelf kunnen aanpassen of een specifieke versie draaien, dan kun je de repository klonen in plaats van uvx te gebruiken. Dit is de geavanceerde route.

git clone https://github.com/AminForou/mcp-gsc.git
cd mcp-gsc
uv venv .venv
uv pip install -r requirements.txt

In je Claude Desktop config verwijs je dan rechtstreeks naar de Python in de virtuele omgeving en naar het serverscript:

{
  "mcpServers": {
    "gscServer": {
      "command": "/full/path/to/mcp-gsc/.venv/bin/python",
      "args": ["/full/path/to/mcp-gsc/gsc_server.py"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

Voor de meeste gebruikers is de uvx-route uit stap 2 sneller en makkelijker te onderhouden. Kies clone alleen als je een reden hebt om in de code te willen werken.

Alternatief: een Service Account voor teams en automatisering

Werk je met een team of wil je periodieke rapportages automatiseren, dan is een Service Account praktischer dan persoonlijke OAuth. Maak in Google Cloud onder Credentials een Service Account aan, genereer een JSON-sleutel en voeg het e-mailadres van het Service Account toe als gebruiker met volledige toegang in Search Console onder Instellingen en Gebruikers en machtigingen. In je config gebruik je dan deze omgevingsvariabelen:

"env": {
  "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
  "GSC_SKIP_OAUTH": "true"
}

Troubleshooting: de meest voorkomende fouten

spawn uvx ENOENT of command not found: uvx

Claude kan uvx niet vinden. Gebruik het volledige pad in plaats van alleen uvx. Zoek het pad met which uvx en vul de uitkomst in bij command in je config. Dit is veruit de meest gemelde fout.

uv –version geeft command not found vlak na de installatie

De installer heeft ~/.local/bin bijgewerkt, maar je huidige terminalsessie ziet dat nog niet. Voer source $HOME/.local/bin/env uit en daarna echo 'source $HOME/.local/bin/env' >> ~/.zshrc om het permanent te maken.

Authentication failed of credentials file not found

Gebruik altijd het absolute pad naar je credentials-bestand, dus bijvoorbeeld /Users/jouwnaam/Documents/client_secrets.json en niet een relatief pad zoals client_secrets.json. Controleer ook of je in stap 1 een Desktop app client hebt gemaakt en geen Web application client.

De MCP werkt alleen in de Claude Desktop app, niet op de website

Dat klopt en is geen fout. De server draait lokaal op jouw machine en werkt daarom uitsluitend in de Claude Desktop app, niet in de claude.ai browserinterface.

De configuratie lijkt te kloppen maar er gebeurt niets

Controleer of alle paden in je config correcte absolute paden zijn, sluit de app volledig af met Cmd+Q en open hem opnieuw, en vraag Claude om get_capabilities aan te roepen voor een exacte statusmelding. Sinds versie 0.3.2 van april 2026 is de OAuth-browserflow voor uvx verbeterd, dus draai altijd de nieuwste versie.

De MCP-server centraal hosten op een eigen VPS

De standaardinstallatie draait op je laptop. Wil je mcp-gsc beschikbaar maken voor een heel team of voor meerdere klantsites tegelijk, dan is een centrale installatie op een eigen server praktischer. De server ondersteunt een HTTP-transport en een Docker-image, zodat je hem op een VPS kunt draaien en op afstand kunt benaderen. Voor de achtergrond bij het bouwen en hosten van MCP-servers schreven we eerder over het voordeel van een custom MCP server bouwen in Laravel ten opzichte van een API.

Veelgestelde vragen

Heb ik per se Claude Desktop nodig?

Nee. mcp-gsc werkt naast Claude Desktop ook met Cursor, Codex CLI, Gemini CLI, Antigravity en elke andere MCP-compatibele client. De configuratiemethode verschilt per client, maar het principe is hetzelfde. Wat je niet kunt gebruiken is claude.ai in de browser, want de server draait lokaal.

Is er een variant zonder terminal en zonder installatie?

Ja. Dezelfde auteur biedt een gehoste variant met one-click Google sign-in, zonder Python en zonder terminal, met extra GA4-tools. Die start volgens de documentatie op ongeveer 11 euro per maand (12 dollar) tijdens de founding cohort. De zelf-gehoste open source versie blijft gratis.

Is mijn Search Console data veilig?

De server draait op jouw eigen machine met jouw eigen OAuth credentials. Er zit geen tussenpartij tussen. Wel deelt je AI-client tijdens een sessie inhoudelijke data met de modelaanbieder, dus voor strikt vertrouwelijke data is het verstandig om vooraf te checken of dat past binnen je verwerkersovereenkomsten.

Werkt dit ook met een domain property in Search Console?

Ja. Alle properties die jouw gekoppelde Google-account ziet, inclusief domain properties, zijn via mcp-gsc bereikbaar. In oudere versies gaf een domain property soms een foutmelding, maar dat is sinds versie 0.2.1 opgelost. Draai daarom altijd de nieuwste versie.

Onder welke licentie staat mcp-gsc?

mcp-gsc is open source onder de MIT-licentie. Je mag de code vrij gebruiken, aanpassen en zelf hosten. De repository vind je op github.com/AminForou/mcp-gsc.

Samengevat

De installatie komt neer op drie dingen: OAuth-credentials aanmaken in Google Cloud, uvx installeren en mcp-gsc toevoegen aan je Claude Desktop config. Loop je vast, dan zit de oorzaak bijna altijd in een ontbrekend absoluut pad of een verkeerd OAuth-clienttype. Met de troubleshooting hierboven kom je in de praktijk altijd door de setup heen. Zodra het draait, vervang je het handmatige spitwerk in de GSC-interface door een gesprek met Claude.

Wil je weten welke SEO-analyses je hierna kunt uitvoeren, lees dan onze gids over Google Search Console koppelen aan Claude met mcp-gsc. Wil je de server centraal hosten of integreren in je bestaande SEO-stack, bekijk dan onze Cloud VPS of neem contact op.