Google Search Console koppelen aan Claude Code met MCP

Waarom Search Console aan een codeerassistent koppelen?

Claude Code is nuttig wanneer SEO-werk de website zelf raakt. In dezelfde ontwikkelomgeving bekijk je templates, repareer je redirects, wijzig je paginatitels, test je een build en beoordeel je een sitemap. Maar je broncode kan je niet vertellen welke pagina vorige week 300 klikken uit Google verloor.

Zonder toegang tot Search Console kan een assistent naar een pagina kijken en redelijke suggesties doen. Hij kan geen onderscheid maken tussen een probleem met hoge prioriteit en iets waar niemand op zoekt. Dat verschil telt als je weinig tijd hebt.

Een MCP-verbinding voegt een ontbrekende bron van bewijs toe. Je kunt Claude Code getroffen URL’s uit Search Console laten bepalen, ze laten vergelijken met de lokale paginatemplates en codewijzigingen laten voorbereiden op basis van een echt onderzoek.

Deze gids behandelt de workflow in de terminal van Claude Code, niet de gewone connector van de Claude-website. Werk je vooral in een browser, gebruik dan onze installatiegids voor Claude en Search Console.

Wat je nodig hebt voordat je een commando draait

Je hebt Claude Code nodig, geïnstalleerd en werkend in een terminal, een Google-account met toegang tot de beoogde Search Console-property en een MCP-server die de data van die property kan ophalen. De server kan zelf gehost of extern zijn.

De stappen hieronder gebruiken het gehoste endpoint van GSC Magic. Volgens de documentatie van GSC Magic accepteert het de Streamable HTTP-transportlaag en ondersteunt het aanmelden via OAuth of met een toegangstoken. Je account moet zijn ingericht en de dienst moet bereikbaar zijn; een geldige URL invoeren betekent niet automatisch dat de authenticatie is gelukt.

Controleer eerst of Claude Code zelf draait. Open hem in een gewoon project en kijk of je prompts kunt invoeren. Je hoeft niet je hele productiewebsite te klonen om alleen een alleen-lezen verbinding met Search Console te testen.

Bepaal vóór het koppelen of het werk bedoeld is voor één website of meerdere. Het is makkelijk de verkeerde Search Console-property te kiezen wanneer een Google-account toegang heeft tot klantsites, staging-domeinen en oude URL-voorvoegselproperties.

Stap 1: voeg het externe MCP-endpoint toe

Open je terminal en draai het volgende commando:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

Zo werkt elk onderdeel. claude mcp add registreert een server bij Claude Code. De transportlaag http geeft aan dat het om een externe MCP-dienst gaat en niet om een lokaal uitvoerbaar bestand. --scope user maakt de connector beschikbaar in je configuratie op gebruikersniveau. De korte naam gsc-magic is de identifier die je terugziet in je lijst met tools.

De URL is het gedocumenteerde externe endpoint van GSC Magic. Het is niet de URL van je Search Console-property, de sitemap van je website of een endpoint van een Google-API.

Waarom user scope? Doe je SEO-werk in meerdere lokale projecten, dan is een verbinding op gebruikersniveau handig. Lees voor een gedeelde repository of een gevoelige klantomgeving eerst de regels voor configuratiescopes van Claude Code en het beleid van je team voordat je externe integraties toevoegt.

De algemene aanwijzingen voor het MCP-commando en de transportlagen vind je in de documentatie van Anthropic over Claude Code. Raadpleeg die als een CLI-optie in een nieuwere release verandert.

Stap 2: authenticeer in Claude Code

Start Claude Code en voer in:

/mcp

Selecteer de server gsc-magic. Biedt de client een actie Authenticate aan, volg die dan en rond het inloggen in de browser af. Gebruik het Google-account dat de juiste rechten op de Search Console-property heeft.

Stuur je Google-wachtwoord, OAuth-autorisatiecode of toegangstoken nooit als gewoon chatbericht. Authenticatie is een aparte stap die de client en de server afhandelen. Opent je browser maar wordt de autorisatie nooit afgerond, ga dan terug naar het MCP-menu en bekijk de verbindingsstatus voordat je het opnieuw probeert.

In sommige omgevingen lukt OAuth via de browser niet. GSC Magic documenteert dan persoonlijke toegangstokens onder Connect → Access tokens in het dashboard. Een verbinding met een token gebruikt een header, bijvoorbeeld:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

Dit is een sjabloon, geen werkende inlogsleutel. Vervang de plaatshouder in een beveiligde lokale configuratie en commit hem niet naar Git. Heb je alleen analyse- en indexeringsrapporten nodig, maak dan een alleen-lezen token aan. In de documentatie van het platform staat hoe tokens verlopen, kunnen worden ingetrokken en welke rechten ze hebben.

Stap 3: bewijs dat de verbinding werkt

Begin niet met “audit mijn hele site en los alles op”. Vraag om één antwoord dat je kunt controleren.

Toon de Google Search Console-properties waartoe deze verbinding toegang heeft. Neem de exacte property-identifiers en, indien beschikbaar, de rechtenniveaus mee. Analyseer geen property voordat ik die heb gekozen.

Hiermee controleer je meerdere dingen tegelijk: de client kan de tools van de server vinden, de server kan authenticeren bij Google en je Google-account ziet minstens één property.

Kies de exacte property-identifier die je nodig hebt. Een property in de vorm sc-domain:example.com kan subdomeinen omvatten. Een URL-voorvoegselproperty zoals https://www.example.com/ dekt een smallere set URL’s. Een ongemerkte mismatch kan een verkeersvergelijking er verkeerd uit laten zien, ook als de tool perfect werkt.

Is de lijst leeg, controleer dan eerst je Google-account en de rechten op de property. Ga er niet van uit dat de server kapot is.

Stap 4: draai een bruikbare eerste SEO-vergelijking

Een goede eerste taak is smal, meetbaar en makkelijk te herhalen:

Vergelijk voor de gekozen Search Console-property de laatste 28 volledige rapportagedagen met de 28 dagen daarvoor. Toon de exacte datumbereiken, het totaal aan klikken, vertoningen en CTR en noem daarna de tien pagina’s met het grootste absolute klikverlies. Gebruik data uit Search Console, geen schattingen. Label mogelijke verklaringen als hypotheses.

Dat rapport kun je nalopen in de interface Prestaties van Search Console. Verschillen de totalen, controleer dan de aggregatiekeuzes, tijdzones, zoektypen en of de data definitief is. Google telt klikken en vertoningen volgens eigen rapportagedefinities, niet volgens de sessieregels van GA4.

Vraag Claude Code daarna één pagina uit te diepen:

Vergelijk voor de URL met het grootste verlies de top tien zoekopdrachten tussen de twee perioden. Groepeer materiële veranderingen per apparaat en land. Vertel me welke waarnemingen aanleiding geven om de paginatemplate te onderzoeken en welke niet.

Hier wordt een codeerassistent nuttig. Verloor de pagina zichtbaarheid op mobiel, dan kun je de mobiele navigatie, de responsieve opmaak en het renderen bekijken. Verloor de pagina vertoningen voor een smalle groep zoekopdrachten, dan kijk je naar de inhoud en de interne links van de pagina. Laat het model correlatie alleen nooit als bewijs behandelen.

Stap 5: koppel de data aan de echte code van je website

Stel dat Search Console een belangrijke productpagina aanwijst met een dalende doorklikratio. Vraag Claude Code dan de route of template te vinden die verantwoordelijk is voor de HTML-titel, de beschrijving en de koppen van die pagina.

Een verstandige volgorde ziet er zo uit:

1. Zoek de pagina of template in je project.
2. Bekijk de bestaande titel, canonical URL, kopstructuur en hoofdinhoud.
3. Lees de zoekopdrachten die vertoningen voor de pagina opleverden.
4. Stel een beperkte verbetering voor die past bij de werkelijke inhoud van de pagina.
5. Toon een diff voordat je wijzigingen doorvoert.
6. Draai je gebruikelijke build en tests.
7. Noteer de datum van de livegang zodat je later kunt vergelijken.

Niet elke pagina met een lage CTR heeft een nieuwe titel nodig. Een pagina kan ranken op brede informatieve zoekopdrachten met weinig klikintentie, of de gemiddelde positie kan zijn veranderd. Gebruik de gids voor het analyseren van een lage CTR voordat je metadata herschrijft op basis van één cijfer.

Vertel Claude Code nooit pagina’s te verwijderen of door te sturen alleen omdat twee URL’s een zoekopdracht delen. Dat kan meer schade aanrichten dan het oorspronkelijke probleem.

Een herhaalbare wekelijkse workflow opzetten

Je kunt de analyseprompt bewaren in je notities of in het interne draaiboek van je project. Claude Code hoeft het vorige gesprek niet te onthouden als de prompt de parameters van het rapport vastlegt.

Vraag elke keer om dezelfde volledige vensters van 7 of 28 dagen en noem de gekozen property. Laat de assistent een tabel teruggeven met URL, klikken in elke periode, absolute verandering, relatieve verandering en de grootste bijdrage op het niveau van zoekopdrachten. Houd de eerste versie alleen-lezen.

Vraag na het rapport om een actieplan van maximaal drie punten. Een bruikbaar actiepunt heeft een waargenomen signaal, één voorgestelde controle, een eigenaar en een manier om het resultaat te meten.

Bijvoorbeeld: “De documentatiepagina verloor 120 klikken, vooral voor zoekopdrachten over de installatie op desktop. Controleer of de pagina nog de actuele versie van de integratie-instructies beantwoordt; werk alleen bij als de inhoud verouderd is.” Dat is veel bruikbaarder dan “Verbeter de kwaliteit van de content.”

Plan je scripts of agents, beheers dan herhaalde aanroepen en respecteer de quota van de Search Console API. Wekelijkse rapportage hoort geen honderden dubbele verzoeken te vragen.

Veelvoorkomende problemen oplossen

Meldt de assistent een toolfout, lees dan de eigenlijke foutmelding voordat je een andere prompt probeert. Een vraag anders formuleren herstelt geen ingetrokken token en geen site waartoe je account geen toegang heeft.

De Search Analytics API-referentie van Google beschrijft datumgrenzen, dimensies, limieten en aggregatie. Wie die grenzen kent, voorkomt verrassend veel verkeerde SEO-diagnoses.

Rechten en veiligheid wanneer code en zoekdata samenkomen

Search Console-data koppelen aan een codeerassistent is krachtig, omdat de assistent mogelijk ook toegang heeft tot het bestandssysteem. Juist daarom scheid je onderzoek van uitvoering.

Behandel rapportagetools waar mogelijk als alleen-lezen. Vraag om voorgestelde codediffs en beoordeel ze voordat de assistent iets schrijft of uitrolt. Gebruik je normale Git-workflow en controles. Werk je met properties van klanten, combineer dan geen data van niet-verwante klanten in één rapport.

GSC Magic documenteert alleen-lezen tokens en aparte besturing voor de schrijfmodus. De Google Search Console-tools omvatten het lezen van analysedata en de status van geïndexeerde URL’s, terwijl beheeracties zoals het indienen van een sitemap sterkere rechten vragen. Die scheiding is belangrijker dan het aantal tools dat de connector noemt.

Onthoud dat de URL Inspection API van Google geen indexering aanvraagt. De resultaten over de geïndexeerde versie verschillen van een live URL-test. De aparte Google Indexing API ondersteunt maar beperkte soorten content en is geen sluiproute voor gewone pagina’s.

Veelgestelde vragen

Kan Claude Code rechtstreeks bij Google Search Console, zonder MCP?

Niet standaard. Je hebt een ander geautoriseerd pad nodig, zoals een eigen API-script of een geïmporteerde export. MCP is een standaardmanier om die aanroepen als tools aan te bieden die Claude Code kan gebruiken.

Is dit dezelfde installatie als voor Claude op het web?

Nee. Claude Code gebruikt een MCP-configuratie die via de CLI wordt beheerd. De Claude-webapp heeft een eigen connectorinterface. De databron kan dezelfde zijn, maar de stappen om te verbinden verschillen.

Kan Claude Code technische SEO-problemen automatisch oplossen?

Hij kan helpen bestanden te bewerken waartoe hij toegang heeft, maar bewijs uit Search Console toont niet aan dat elke voorgestelde wijziging klopt. Beoordeel diffs, test builds en laat een mens de livegang goedkeuren.

Kent de agent mijn Google-conversies?

Alleen als je een geschikte analysebron autoriseert. Search Console rapporteert klikken en vertoningen in zoekresultaten; voor sessies en key events heb je GA4 nodig.

Welke taak probeer ik het eerst?

Begin met een vergelijking van twee volledige perioden van 28 dagen en de tien pagina’s met het grootste klikverlies. Die cijfers kun je bevestigen voordat je codewijzigingen overweegt.

De praktische conclusie

Claude Code werkt het best als brug tussen gemeten zoekgedrag en de website die je daadwerkelijk kunt verbeteren. Gebruik de connector om een probleem te vinden, de codebase om het te onderzoeken en je gebruikelijke review om wijzigingen veilig door te voeren.

Wil je de exacte tools, tokenopties en verbindingsmogelijkheden die nu gedocumenteerd zijn, houd dan de documentatie van GSC Magic open tijdens het configureren van je client. Voor ideeën voor vervolganalyses gebruik je onze 25 prompts voor SEO-agents.