Search Console MCP-setupfouten en oplossingen

Oplossingen voor fouten van community-servers voor Search Console MCP: API niet ingeschakeld, 403, sc-domain, access blocked, invalid_grant, spawn uvx ENOENT.

Door Denis Veisllari

De meeste fouten met Google Search Console MCP komen uit vijf hoeken: het Google Cloud-project, de Search Console-property, het OAuth-toestemmingsscherm, het credentials-bestand en de configuratie van de AI-client. Zoek hieronder je foutmelding op, los die ene stap op en start de client opnieuw. Wil je Google Cloud liever helemaal overslaan, dan laat de laatste sectie de route zien die alleen een Google-login nodig heeft.

Google heeft geen officiële MCP-server voor Search Console uitgebracht. De MCP-repository van Google dekt Google Analytics, BigQuery, Maps en andere producten, maar niet Search Console. Elke Search Console-server die je kunt installeren is dus een communityproject. De twee meestgebruikte zijn mcp-gsc (geïnstalleerd als mcp-search-console) en mcp-server-gsc. De fouten hieronder gelden voor beide en voor de meeste andere.

Snel opzoeken

De foutmeldingen staan in het Engels, zoals je ze op je scherm ziet.

Wat je zietWaarschijnlijke oorzaakGa naar
"has not been used in project ... before or it is disabled"De Search Console API staat uit in dat Cloud-projectAPI niet ingeschakeld
403 "User does not have sufficient permission for site"Serviceaccount niet toegevoegd aan de property, of verkeerde URLToestemmingsfouten
"is not a verified Search Console site in this account"Domein- en URL-voorvoegsel-property door elkaar gehaaldVerkeerd property-formaat
"Failed to add user: email not found" in Search ConsoleBug van Google bij nieuwe serviceaccountsE-mailadres niet gevonden
"Access blocked" of "Error 403: access_denied" op het Google-schermOAuth-app in testmodus, en je bent geen testgebruikerFouten op het OAuth-scherm
invalid_grant ongeveer een week nadat het werkteRefresh-tokens in testmodus verlopen na 7 dagenWerkt, en stopt dan
"Error 400: redirect_uri_mismatch"Webclient gebruikt waar een desktopclient nodig isFouten op het OAuth-scherm
"Service account credentials file not found"Relatief pad, of verkeerd pakketCredentials-bestand
spawn uvx ENOENT of spawn npx ENOENTDe client kan het commando niet vindenClientfouten
Er verschijnen geen tools en er wordt geen log geschrevenPython ouder dan 3.11Clientfouten
Cijfers kloppen niet met het Search Console-dashboardVertraging van data, rijlimieten, geanonimiseerde zoekopdrachtenCijfers kloppen niet

De API is niet ingeschakeld

De fout is een 403 die zegt dat de Google Search Console API "has not been used in project", gevolgd door een projectnummer, vaak met een link om hem in te schakelen. De API is in dat project dus nooit gebruikt of staat uit.

De API moet ingeschakeld zijn in hetzelfde Cloud-project waar je OAuth-client of serviceaccount bij hoort. De gebruikelijke fout is hem in een ander project inschakelen.

  1. Vergelijk het projectnummer in de fout met het project van je JSON-bestand met inloggegevens.
  2. Open in Google Cloud in dat project APIs & Services > Library en schakel de Google Search Console API in.
  3. Wacht een paar minuten en probeer het opnieuw. Volgens Google kan het even duren voordat nieuwe instellingen in de systemen zijn doorgevoerd.

Toestemmingsfouten

De fout is een 403 "User does not have sufficient permission for site". Bij URL-inspectie staat er in plaats daarvan "The caller does not have permission".

Een nieuw serviceaccount krijgt geen enkele toegang tot Search Console. Het e-mailadres ervan moet worden toegevoegd aan precies de property die je opvraagt.

  1. Open de JSON-sleutel van het serviceaccount en kopieer de waarde van client_email.
  2. Open in Search Console Settings > Users and permissions > Add user, plak het e-mailadres en geef het de toestemming Full.
  3. Log je in plaats daarvan in met OAuth, gebruik dan een Google-account dat de property al ziet in Search Console.

Heeft het account toegang en krijg je nog steeds een 403, dan is de property-string waarschijnlijk verkeerd. Lees de volgende sectie.

Het property-formaat klopt niet

De fout is "'sc-domain:example.com' is not a verified Search Console site in this account", of dezelfde 403 als hierboven.

Search Console heeft twee soorten property, en de API wil de exacte string voor de soort die jij hebt:

  • Domeinproperty: sc-domain:example.com
  • URL-voorvoegsel-property: de volledige URL met protocol en afsluitende slash, zoals https://www.example.com/

http en https zijn verschillende properties, net als www en het kale domein. Gok niet. Vraag de agent om de tool van de server uit te voeren die de sites oplijst, en kopieer de site-URL precies zoals die terugkomt.

Search Console vindt het e-mailadres van het serviceaccount niet

Als je het serviceaccount als gebruiker toevoegt, antwoordt Search Console met "Failed to add user: email not found."

Dit is een probleem van Google met nieuw aangemaakte serviceaccounts, niet iets wat jij fout deed. Het werd voor het eerst gemeld rond april 2026, kwam terug in september 2026 en raakt ook Google Analytics. Google heeft het erkend, maar nog geen datum voor een oplossing gegeven. Gebruikers melden drie omwegen:

  • Wacht een paar uur tot een dag en voeg de gebruiker opnieuw toe.
  • Voeg de gebruiker toe via de API in plaats van via het scherm van Search Console.
  • Gebruik OAuth in plaats van een serviceaccount, als je server dat ondersteunt.

Fouten op het OAuth-scherm

"Access blocked" met "Error 403: access_denied". Je toestemmingsscherm staat in testmodus en het Google-account waarmee je inlogde is geen testgebruiker. Open in Google Cloud Google Auth Platform > Audience > Test users en voeg je eigen adres toe.

"Google hasn't verified this app". Deze melding verschijnt als een niet-geverifieerde app toegang tot Search Console vraagt. Heb je het Cloud-project zelf aangemaakt en gebruik alleen jij het, dan kun je de waarschuwing voorbijgaan. Verificatie is alleen nodig als je de app aan anderen geeft.

"Error 400: redirect_uri_mismatch". Je hebt een OAuth-client van het type "Web application" gemaakt, maar lokale servers loggen in via een loopback-adres zoals http://localhost met een willekeurige poort. Maak een nieuwe OAuth-client van het type Desktop app, download de JSON en wijs de server ernaar. Bij mcp-gsc is dat de instelling GSC_OAUTH_CLIENT_SECRETS_FILE.

Het werkte, en een week later niet meer

De fout is invalid_grant, meestal "Token has been expired or revoked."

Google laat refresh-tokens na 7 dagen verlopen zolang het toestemmingsscherm van een externe app in testmodus staat. Tokens vervallen ook als je de toegang intrekt of ze zes maanden niet gebruikt.

  1. Zet in Google Cloud de publicatiestatus van het toestemmingsscherm op In production. Voor eigen gebruik mag het ongeverifieerd blijven.
  2. Verwijder het tokenbestand dat de server heeft opgeslagen.
  3. Log opnieuw in.

Gebruik je mcp-gsc, werk het dan ook bij. Versies vóór 0.4.2 konden falen bij het vernieuwen van alleen-lezen-tokens en het tokenbestand verwijderen.

Het credentials-bestand wordt niet gevonden

De fout is "Service account credentials file not found."

  • Relatief pad. Tools zoals uvx starten de server vanuit een cachemap, dus een pad als ./key.json wijst nergens naar. Gebruik het volledige pad in de clientconfiguratie. Verdubbel op Windows de backslashes: C:\\Users\\you\\key.json.
  • Verkeerd pakket. Installeer voor mcp-gsc mcp-search-console, niet het ongerelateerde pakket mcp-gsc op PyPI. Start het als uvx mcp-search-console@latest zodat je de actuele versie krijgt.
  • Verkeerd bestand in de verkeerde instelling. Een serviceaccountsleutel bevat "type": "service_account" en een client_email. Een OAuth-clientbestand begint met een sleutel installed of web. Elk hoort in een eigen instelling: mcp-gsc gebruikt GSC_CREDENTIALS_PATH voor het eerste en GSC_OAUTH_CLIENT_SECRETS_FILE voor het tweede, en mcp-server-gsc gebruikt GOOGLE_APPLICATION_CREDENTIALS.

De client kan de server niet starten

spawn uvx ENOENT of spawn npx ENOENT. Desktopapps laden de PATH van je terminal niet, dus ze vinden het commando niet. Zet het volledige pad in "command". Je vindt het met which uvx op macOS of Linux, of met where uvx op Windows. Gebruik voor npx op Windows "command": "cmd" met de argumenten ["/c", "npx", "-y", ...].

Geen tools, geen logbestand. mcp-gsc heeft Python 3.11 of nieuwer nodig en faalt zonder melding op oudere versies. Start het via uvx, dat een geschikte Python-versie voor je kiest, of installeer Python 3.12.

Wijzigingen in de config doen niets. Controleer de JSON op komma's aan het eind en backslashes zonder escape, sluit de app dan helemaal af en open hem opnieuw. Op een Mac is het venster sluiten niet genoeg; gebruik Cmd+Q.

Waar de logs staan:

  • Claude Desktop op macOS: ~/Library/Logs/Claude. mcp.log bevat verbindingsfouten en mcp-server-<name>.log de eigen fouten van die server.
  • Claude Desktop op Windows: %APPDATA%\Claude\logs.
  • Claude Code: voer claude mcp get <name> uit voor de fout, of /mcp binnen een sessie.
  • Cursor: open het Output-paneel en kies MCP Logs.

Nog één beperking: lokale servers draaien alleen in desktop- en terminalapps. Ze werken niet op claude.ai in de browser of in ChatGPT, die een externe server nodig hebben.

De cijfers kloppen niet met het dashboard

Dit zijn geen fouten, maar ze veroorzaken de meeste meldingen van het type "de agent had het mis".

  • Vertraging. Search Console-data komt meestal na twee tot drie dagen binnen, en de nieuwste dagen kunnen nog veranderen. Sommige servers vragen alleen definitieve data op, waardoor hun laatste dagen leeg lijken.
  • Rijlimieten. Eén API-verzoek geeft maximaal 25.000 rijen terug, en Google stelt maximaal 50.000 rijen per dag per zoektype beschikbaar. Op een grote site worden longtail-zoekopdrachten afgekapt.
  • Ontbrekende zoekopdrachten. Zeldzame en persoonlijke zoekopdrachten worden weggelaten, dus de rijen met zoekopdrachten tellen nooit op tot het totaal aantal klikken. Vraag voor exacte totalen data op zonder de dimensie zoekopdracht of pagina.
  • Andere totalen. De grafiek telt per property en de tabel per pagina, dus die twee kunnen verschillen. Controleer ook de periode; data per uur gebruikt Pacific-tijd.
  • Quota. URL-inspectie staat 2.000 checks per dag per site toe, dus batchinspecties op een grote site stoppen halverwege. Search Analytics staat 1.200 query's per minuut per site toe.

Sla Google Cloud helemaal over

Elke fout hierboven, behalve die in de laatste sectie, komt doordat je je eigen Google Cloud-project draait. De Google Search Console MCP van zaDojo wordt voor je gehost: je koppelt Search Console in een zaDojo-project met een gewone Google-login, en je agent leest de data op https://app.zadojo.com/mcp. Er is geen Cloud-project, geen API om in te schakelen, geen serviceaccount, toestemmingsscherm of credentials-bestand, en het werkt in claude.ai en ChatGPT en in desktopclients.

Search Console lezen, URL-inspectie en indexdekking zijn gratis in het gratis abonnement van zaDojo, waarvoor je geen creditcard nodig hebt. Dat geldt ook voor het lezen van Google Analytics en voor site-audits tot 50 pagina's. Zoekwoord-, concurrentie- en AI-zichtbaarheidsdata kosten credits. Een vergelijking met de andere gratis opties vind je in gratis SEO MCP-servers.

Vragen die mensen stellen

Is er een officiële MCP-server voor Google Search Console? Nee. Google brengt MCP-servers uit voor Google Analytics en andere producten, maar niet voor Search Console. Elke Search Console-server is een communityproject of een gehoste dienst.

Gebruik ik een serviceaccount of OAuth? Een serviceaccount past bij een server die zonder toezicht draait, maar je moet het e-mailadres ervan aan elke property toevoegen. OAuth gebruikt je eigen Google-account en ziet elke property die je al hebt, maar in testmodus moet je elke 7 dagen opnieuw inloggen tot je het op In production zet.

Waarom ziet mijn agent maar een deel van mijn sites? Het account of serviceaccount dat hij gebruikt, ziet alleen de properties waaraan het is toegevoegd. Vraag de agent de sites op te lijsten en vergelijk die lijst met Search Console.

Kan een Search Console MCP-server mijn site aanpassen? Nee. Deze servers lezen en beheren Search Console-data. Geen van hen bewerkt je pagina's.