Google Search Console MCP-server toevoegen aan Claude Desktop

Wat koppel je precies tussen Google Search Console en Claude?

Je koppelt de officiële Google Search Console API aan Claude Desktop via de lokale open-source server mcp-search-console. Claude krijgt daardoor gereedschappen om properties, zoekprestaties, URL-inspecties en sitemaps op te vragen binnen de toegang van jouw Google-account.

De MCP-server draait lokaal op je computer via uvx. Google verzorgt de data en OAuth-toestemming, Claude Desktop start het lokale proces en het externe pakket vertaalt vragen naar API-aanroepen. Het pakket is niet officieel van Google of Anthropic. Bekijk daarom altijd de broncode en actuele release-informatie voordat je toegang verleent.

Wat heb je nodig voordat je begint?

Je hebt Claude Desktop, toegang tot minstens één Search Console-property, een Google Cloud-account en ongeveer 25 tot 40 minuten nodig. Voor de aanbevolen uvx-route hoef je Node.js of Python niet afzonderlijk te installeren.

Stap 1: hoe maak je een Google Cloud-project?

Open Google Cloud Console, klik bovenaan op de huidige projectnaam en kies Nieuw project. Geef het project een herkenbare naam, bijvoorbeeld GSC MCP Claude, klik op Maken en selecteer daarna het nieuwe project.

1. Klik bovenaan op de projectkiezer.
2. Klik rechtsboven op Nieuw project.
3. Vul een projectnaam in en kies indien nodig je organisatie.
4. Klik op Maken.
5. Open de projectkiezer opnieuw en selecteer het nieuwe project.

Klikvolgorde: Google Cloud stappen om een project te maken en de Search Console API in te schakelen

Stap 2: hoe schakel je de Search Console API in?

Open in het linkermenu API’s en services, klik op Bibliotheek, zoek naar Google Search Console API en klik op Inschakelen. Google vereist dat de relevante API actief is voordat een OAuth-client data kan opvragen.

1. Klik linksboven op het menu.
2. Kies API’s en services en daarna Bibliotheek.
3. Typ Google Search Console API in het zoekveld.
4. Open exact dat resultaat.
5. Klik op de blauwe knop Inschakelen.

Laat het project bovenaan geselecteerd. De officiële Search Console API-documentatie bevestigt dat je de API in hetzelfde Cloud-project moet activeren.

Stap 3: hoe configureer je Google Auth Platform?

Open Google Auth Platform en klik op Aan de slag wanneer het project nog niet is geconfigureerd. Vul de appnaam, supportmail, doelgroep en contactmail in en rond de configuratie af.

1. Open het menu en klik op Google Auth Platform.
2. Klik op Aan de slag.
3. Gebruik bijvoorbeeld GSC MCP Claude als appnaam.
4. Kies een supportmail die je zelf beheert.
5. Kies Intern voor één Workspace-organisatie of Extern voor een persoonlijk Google-account.
6. Vul je contactmail in, accepteer het gegevensbeleid en klik op Maken.
7. Staat de externe app in testmodus, open dan Doelgroep en voeg je eigen Google-account toe als testgebruiker.

Klikvolgorde: Google Auth Platform stappen voor appgegevens, doelgroep en testgebruiker

Je hoeft voor deze lokale persoonlijke installatie geen publieke app te lanceren. De exacte labels kunnen licht verschillen per Google Cloud-account, maar Branding, Doelgroep, Gegevenstoegang en Clients blijven de kernonderdelen van het Google Auth Platform.

Stap 4: hoe maak en download je de OAuth-desktopclient?

Open in Google Auth Platform Clients, klik op Client maken, kies Desktop-app, geef de client een naam en download daarna het JSON-bestand. Een desktopclient is de juiste OAuth-client voor een lokale toepassing zoals deze MCP-server.

1. Klik links op Clients.
2. Klik op Client maken.
3. Kies bij applicatietype Desktop-app.
4. Vul bijvoorbeeld Claude Desktop GSC in.
5. Klik op Maken.
6. Klik bij de nieuwe client op JSON downloaden.
7. Verplaats het bestand naar een vaste map, bijvoorbeeld C:/Users/JOUW_NAAM/Documents/gsc-mcp/client_secret.json.

Klikvolgorde: OAuth desktopclient maken en het JSON-bestand downloaden

Stap 5: hoe installeer je uv en vind je uvx?

Installeer uv met het officiële Astral-installatiescript en zoek daarna het volledige pad naar uvx. De MCP-server wordt via uvx opgehaald en geïsoleerd uitgevoerd, zonder aparte Python-installatie.

Windows PowerShell

Open PowerShell en voer deze opdrachten één voor één uit:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv --version
Get-Command uvx | Select-Object -ExpandProperty Source

Het laatste commando geeft meestal een pad zoals C:\Users\JOUW_NAAM\.local\bin\uvx.exe. Kopieer het volledige resultaat.

macOS Terminal

Open Terminal en voer deze opdrachten één voor één uit:

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
echo 'source $HOME/.local/bin/env' >> ~/.zshrc
uv --version
which uvx

Kopieer het volledige pad dat which uvx teruggeeft. De opdrachten komen uit de officiële uv-installatiehandleiding.

Klikvolgorde: uv en uvx installeren en het volledige pad op Windows en macOS vinden

Stap 6: hoe voeg je de MCP-server toe aan Claude Desktop?

Open Claude Desktop, klik op je profiel, ga naar Instellingen, open Ontwikkelaar en klik op Configuratie bewerken. Voeg vervolgens gscServer toe met jouw absolute uvx- en OAuth-paden.

Nieuwere Claude-versies kunnen de serverstatus en logs ook tonen onder Instellingen, Extensies en Geavanceerde instellingen. De handmatige serverconfiguratie blijft in claude_desktop_config.json.

Configuratie voor Windows

{
  "mcpServers": {
    "gscServer": {
      "command": "C:/Users/JOUW_NAAM/.local/bin/uvx.exe",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "C:/Users/JOUW_NAAM/Documents/gsc-mcp/client_secret.json"
      }
    }
  }
}

Configuratie voor macOS

{
  "mcpServers": {
    "gscServer": {
      "command": "/Users/JOUW_NAAM/.local/bin/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/Users/JOUW_NAAM/Documents/gsc-mcp/client_secret.json"
      }
    }
  }
}

Klikvolgorde: Claude Desktop instellingen openen en gscServer aan de configuratie toevoegen

Stap 7: hoe herstart en machtig je Claude?

Sla het configuratiebestand op, sluit Claude Desktop volledig af en open de app opnieuw. Start daarna een nieuw gesprek en vraag om je Search Console-properties, waarna de browser de Google OAuth-toestemming opent.

1. Sla het bestand op als gewone JSON en niet als tekstbestand.
2. Kies in Claude Afsluiten. Alleen het venster sluiten is niet voldoende.
3. Open Claude Desktop opnieuw.
4. Typ Toon mijn GSC-properties.
5. Kies in de browser het Google-account dat toegang heeft tot Search Console.
6. Controleer de project- en appnaam en klik op Doorgaan of Toestaan.
7. Ga terug naar Claude en keur de toolaanroep goed wanneer Claude daarom vraagt.

Staat je externe app in testmodus en krijg je een toegangsblokkade, voeg het gebruikte Google-account dan onder Google Auth Platform en Doelgroep toe als testgebruiker.

Stap 8: hoe test je of de koppeling werkt?

Vraag eerst om de beschikbare properties en daarna om get_capabilities. Verschijnen je properties en de serverstatus, dan werken de lokale server, OAuth-toegang en Search Console API samen.

Toon alle Google Search Console-properties waartoe ik toegang heb.

Roep get_capabilities aan en geef de authenticatiestatus en beschikbare GSC-tools weer.

Klikvolgorde: Google OAuth-toestemming geven en de Search Console MCP-server testen in Claude

Welke Search Console-vragen kun je daarna aan Claude stellen?

Je kunt Claude prestaties laten vergelijken, CTR-kansen vinden, pagina-querycombinaties analyseren en URL’s op indexering controleren. Geef altijd de property, periode, markt, apparaatfilter en gewenste uitvoer aan.

Hoe voorkom je verkeerde conclusies uit GSC-data?

Vergelijk volledige periodes, splits branded en non-branded queries en behandel gemiddelde positie als een geaggregeerde metriek. Claude kan snel patronen samenvatten, maar het model verandert de beperkingen van de Search Console-data niet.

1. Vermijd de laatste twee tot drie dagen wanneer je alleen bevestigde data wilt vergelijken.
2. Zet optioneel GSC_DATA_STATE op final voor bevestigde data met extra vertraging.
3. Vergelijk gelijke weekdagen en houd rekening met seizoen, campagnes en migraties.
4. Controleer pagina, query, land, apparaat en zoektype afzonderlijk.
5. Vraag Claude om ruwe aantallen naast percentages te tonen.
6. Controleer belangrijke conclusies opnieuw in Search Console.

Is de Google Search Console MCP-koppeling veilig?

De koppeling kan verantwoord worden gebruikt wanneer je de bron controleert, lokale paden afschermt en alleen noodzakelijke accounts machtigt. OAuth deelt je Google-wachtwoord niet met de MCP-server, maar de lokale token geeft wel toegang binnen de verleende scopes.

• Gebruik een afzonderlijk Google Cloud-project voor deze koppeling.
• Bewaar OAuth JSON en tokens buiten repositories en gedeelde mappen.
• Geef alleen toegang met een account dat de nodige properties mag zien.
• Controleer updates van het externe pakket voordat je ze gebruikt.
• Laat GSC_ALLOW_DESTRUCTIVE op false.
• Trek toegang in via je Google-account wanneer je de koppeling niet meer gebruikt.

Wanneer kies je OAuth en wanneer een serviceaccount?

Kies OAuth voor persoonlijk en interactief gebruik in Claude Desktop. Kies een serviceaccount voor een beheerde team- of automatiseringsomgeving waarin je de technische identiteit bewust als gebruiker aan Search Console toevoegt.

Hoe los je de meest voorkomende installatiefouten op?

De meeste fouten komen door een onjuist absoluut pad, ongeldige JSON, een niet-actieve API of een Claude-proces dat niet volledig is herstart. Controleer de melding in deze volgorde.

Werkt dezelfde configuratie ook voor Claude Code?

Nee, Claude Code gebruikt een andere MCP-configuratie dan Claude Desktop. Deze gids richt zich bewust op claude_desktop_config.json; gebruik voor Claude Code de actuele MCP-opdrachten en configuratie uit de officiële Claude Code-documentatie.

Wil je Search Console-data combineren met bestanden, code en een lokale website, dan kan Claude Code nuttig zijn. Begin echter pas nadat de datatoegang, propertykeuze en analysemethode in Claude Desktop correct werken.

Welke bronnen zijn voor deze installatie gecontroleerd?

De klikroute en commando’s zijn gecontroleerd op 2 augustus 2026 aan de hand van primaire documentatie en de onderhouden repository van de MCP-server.

• mcp-gsc repository en release-instructies
• Anthropic: lokale MCP-servers in Claude Desktop
• Google: Search Console API-vereisten
• Google: OAuth-client voor een desktop-app maken
• Astral: uv installeren op Windows en macOS