Search Console MCP: Einrichtungsfehler und Lösungen

Lösungen für Fehler von Community-Servern für Google Search Console MCP: API nicht aktiviert, 403, sc-domain, Access blocked, invalid_grant, spawn uvx ENOENT.

Von Denis Veisllari

Die meisten Fehler mit Google Search Console MCP haben fünf Quellen: das Google-Cloud-Projekt, die Search-Console-Property, den OAuth-Zustimmungsbildschirm, die Datei mit den Zugangsdaten und die Konfiguration des KI-Clients. Such unten deine Fehlermeldung, behebe diesen einen Schritt und starte den Client neu. Wenn du Google Cloud lieber ganz auslassen willst, zeigt der letzte Abschnitt den Weg, der nur eine Google-Anmeldung braucht.

Google hat keinen offiziellen MCP-Server für Search Console veröffentlicht. Googles MCP-Repository deckt Google Analytics, BigQuery, Maps und andere ab, aber nicht Search Console. Jeder Search-Console-Server, den du installieren kannst, ist also ein Community-Projekt. Die zwei meistgenutzten sind mcp-gsc (installiert als mcp-search-console) und mcp-server-gsc. Die Fehler unten gelten für beide und für die meisten anderen.

Schnellübersicht

Die Fehlermeldungen stehen auf Englisch da, so wie du sie auf dem Bildschirm siehst.

Was du siehstWahrscheinliche UrsacheSpringe zu
"has not been used in project ... before or it is disabled"Search Console API ist in diesem Cloud-Projekt ausAPI nicht aktiviert
403 "User does not have sufficient permission for site"Dienstkonto nicht zur Property hinzugefügt oder falsche URLBerechtigungsfehler
"is not a verified Search Console site in this account"Domain- und URL-Präfix-Property verwechseltFalsches Property-Format
"Failed to add user: email not found" in der Search ConsoleGoogle-Fehler bei neuen DienstkontenE-Mail nicht gefunden
"Access blocked" oder "Error 403: access_denied" auf dem Google-BildschirmOAuth-App im Testmodus, du bist kein TestnutzerFehler auf dem OAuth-Bildschirm
invalid_grant etwa eine Woche, nachdem es liefRefresh-Tokens im Testmodus laufen nach 7 Tagen abLäuft, dann nicht mehr
"Error 400: redirect_uri_mismatch"Web-Client statt Desktop-Client verwendetFehler auf dem OAuth-Bildschirm
"Service account credentials file not found"Relativer Pfad oder falsches PaketDatei mit Zugangsdaten
spawn uvx ENOENT oder spawn npx ENOENTDer Client findet den Befehl nichtClient-Fehler
Keine Tools erscheinen, kein Log wird geschriebenPython älter als 3.11Client-Fehler
Zahlen passen nicht zum Search-Console-DashboardDatenverzögerung, Zeilenlimits, anonymisierte SuchanfragenZahlen passen nicht

Die API ist nicht aktiviert

Der Fehler ist ein 403, laut dem die Google Search Console API "has not been used in project", gefolgt von einer Projektnummer, oft mit einem Link zum Aktivieren. Die API wurde in diesem Projekt also nie genutzt oder ist deaktiviert.

Die API muss im selben Cloud-Projekt aktiviert sein, zu dem dein OAuth-Client oder dein Dienstkonto gehört. Der übliche Fehler ist, sie in einem anderen Projekt zu aktivieren.

  1. Vergleiche die Projektnummer im Fehler mit dem Projekt deiner JSON-Datei mit Zugangsdaten.
  2. Öffne in Google Cloud in diesem Projekt APIs & Services > Library und aktiviere die Google Search Console API.
  3. Warte ein paar Minuten und versuch es noch einmal. Laut Google kann es einen Moment dauern, bis neue Einstellungen in den Systemen ankommen.

Berechtigungsfehler

Der Fehler ist ein 403 "User does not have sufficient permission for site". Bei der URL-Prüfung heißt es stattdessen "The caller does not have permission".

Ein neu angelegtes Dienstkonto hat keinerlei Zugriff auf die Search Console. Seine E-Mail-Adresse muss genau der Property hinzugefügt werden, die du abfragst.

  1. Öffne den JSON-Schlüssel des Dienstkontos und kopiere den Wert client_email.
  2. Öffne in der Search Console Settings > Users and permissions > Add user, füge die E-Mail-Adresse ein und gib ihr die Berechtigung „Full“.
  3. Wenn du dich stattdessen mit OAuth anmeldest, nimm ein Google-Konto, das die Property in der Search Console bereits sieht.

Hat das Konto Zugriff und du bekommst trotzdem einen 403, ist wahrscheinlich der Property-String falsch. Lies den nächsten Abschnitt.

Das Property-Format ist falsch

Der Fehler lautet "'sc-domain:example.com' is not a verified Search Console site in this account", oder es kommt derselbe 403 wie oben.

Die Search Console kennt zwei Arten von Property, und die API will den exakten String für die, die du hast:

  • Domain-Property: sc-domain:example.com
  • URL-Präfix-Property: die vollständige URL mit Protokoll und abschließendem Schrägstrich, etwa https://www.example.com/

http und https sind verschiedene Properties, ebenso www und die nackte Domain. Rate nicht. Bitte den Agenten, das Tool des Servers zum Auflisten der Websites auszuführen, und kopiere die Website-URL genau so, wie sie zurückkommt.

Die Search Console findet die E-Mail des Dienstkontos nicht

Wenn du das Dienstkonto als Nutzer hinzufügst, antwortet die Search Console mit "Failed to add user: email not found."

Das ist ein Problem von Google mit neu angelegten Dienstkonten, kein Fehler von dir. Es wurde erstmals um April 2026 gemeldet, kam im September 2026 wieder und betrifft auch Google Analytics. Google hat es bestätigt, aber noch kein Datum für eine Lösung genannt. Nutzer berichten von drei Workarounds:

  • Ein paar Stunden bis einen Tag warten und den Nutzer erneut hinzufügen.
  • Den Nutzer über die API statt über die Search-Console-Oberfläche hinzufügen.
  • OAuth statt eines Dienstkontos nutzen, wenn dein Server das unterstützt.

Fehler auf dem OAuth-Bildschirm

"Access blocked" mit "Error 403: access_denied". Dein Zustimmungsbildschirm ist im Testmodus, und das Google-Konto, mit dem du dich angemeldet hast, ist kein Testnutzer. Öffne in Google Cloud Google Auth Platform > Audience > Test users und füge deine eigene Adresse hinzu.

"Google hasn't verified this app". Diese Meldung erscheint, wenn eine nicht verifizierte App Zugriff auf die Search Console anfragt. Wenn du das Cloud-Projekt selbst angelegt hast und nur du es nutzt, kannst du über die Warnung hinweg fortfahren. Die Verifizierung zählt nur, wenn du die App an andere weitergibst.

"Error 400: redirect_uri_mismatch". Du hast einen OAuth-Client vom Typ „Web application“ angelegt, aber lokale Server melden sich über eine Loopback-Adresse wie http://localhost mit zufälligem Port an. Leg einen neuen OAuth-Client vom Typ Desktop app an, lade seine JSON-Datei herunter und verweise den Server darauf. Bei mcp-gsc ist das die Einstellung GSC_OAUTH_CLIENT_SECRETS_FILE.

Es lief, dann eine Woche später nicht mehr

Der Fehler ist invalid_grant, meist mit "Token has been expired or revoked."

Google lässt Refresh-Tokens nach 7 Tagen ablaufen, solange der Zustimmungsbildschirm einer externen App im Testmodus ist. Tokens werden auch ungültig, wenn du den Zugriff widerrufst oder sie sechs Monate lang nicht nutzt.

  1. Setz in Google Cloud den Veröffentlichungsstatus des Zustimmungsbildschirms auf In production. Für die private Nutzung kann er unverifiziert bleiben.
  2. Lösch die Token-Datei, die der Server gespeichert hat.
  3. Melde dich erneut an.

Wenn du mcp-gsc nutzt, aktualisiere es auch. Versionen vor 0.4.2 konnten beim Erneuern von Tokens mit reinem Lesezugriff scheitern und die Token-Datei löschen.

Die Datei mit den Zugangsdaten wird nicht gefunden

Der Fehler lautet "Service account credentials file not found."

  • Relativer Pfad. Tools wie uvx starten den Server aus einem Cache-Ordner, ein Pfad wie ./key.json zeigt also ins Leere. Trag den vollständigen Pfad in die Client-Konfiguration ein. Unter Windows verdoppelst du die Backslashes: C:\\Users\\you\\key.json.
  • Falsches Paket. Installiere für mcp-gsc das Paket mcp-search-console, nicht das nicht verwandte Paket mcp-gsc auf PyPI. Starte es als uvx mcp-search-console@latest, damit du die aktuelle Version bekommst.
  • Falsche Datei in der falschen Einstellung. Ein Dienstkonto-Schlüssel enthält "type": "service_account" und eine client_email. Eine OAuth-Client-Datei beginnt mit einem Schlüssel installed oder web. Jede gehört in ihre eigene Einstellung: mcp-gsc nutzt GSC_CREDENTIALS_PATH für die erste und GSC_OAUTH_CLIENT_SECRETS_FILE für die zweite, mcp-server-gsc nutzt GOOGLE_APPLICATION_CREDENTIALS.

Der Client kann den Server nicht starten

spawn uvx ENOENT oder spawn npx ENOENT. Desktop-Apps laden den PATH deines Terminals nicht und finden den Befehl deshalb nicht. Trag den vollständigen Pfad in "command" ein. Du bekommst ihn mit which uvx unter macOS oder Linux oder mit where uvx unter Windows. Für npx unter Windows nimmst du "command": "cmd" mit den Argumenten ["/c", "npx", "-y", ...].

Keine Tools, keine Log-Datei. mcp-gsc braucht Python 3.11 oder neuer und scheitert bei älteren Versionen ohne Meldung. Starte es über uvx, das eine passende Python-Version für dich wählt, oder installiere Python 3.12.

Änderungen an der Konfiguration bewirken nichts. Prüf das JSON auf abschließende Kommas und nicht maskierte Backslashes, beende dann die App vollständig und öffne sie neu. Auf dem Mac reicht es nicht, das Fenster zu schließen; nutze Cmd+Q.

Wo die Logs liegen:

  • Claude Desktop unter macOS: ~/Library/Logs/Claude. mcp.log enthält Verbindungsfehler, mcp-server-<name>.log die eigenen Fehler des jeweiligen Servers.
  • Claude Desktop unter Windows: %APPDATA%\Claude\logs.
  • Claude Code: Führe claude mcp get <name> für den Fehler aus, oder /mcp innerhalb einer Sitzung.
  • Cursor: Öffne das Output-Panel und wähle MCP Logs.

Noch eine Grenze: Lokale Server laufen nur in Desktop- und Terminal-Apps. Auf claude.ai im Browser und in ChatGPT funktionieren sie nicht, dort braucht es einen Remote-Server.

Die Zahlen passen nicht zum Dashboard

Das sind keine Fehler, aber sie sorgen für die meisten Meldungen der Art „der Agent lag falsch“.

  • Verzögerung. Search-Console-Daten kommen meist nach zwei bis drei Tagen an, und die neuesten Tage können sich noch ändern. Manche Server fragen nur endgültige Daten ab, deshalb wirken ihre letzten Tage leer.
  • Zeilenlimits. Eine API-Anfrage liefert höchstens 25.000 Zeilen, und Google gibt höchstens 50.000 Zeilen pro Tag und Suchtyp heraus. Bei einer großen Website werden Longtail-Suchanfragen abgeschnitten.
  • Fehlende Suchanfragen. Seltene und persönliche Suchanfragen werden weggelassen, deshalb ergeben die Zeilen der Suchanfragen nie die Gesamtzahl der Klicks. Für exakte Summen fragst du Daten ohne die Dimension Suchanfrage oder Seite ab.
  • Unterschiedliche Summen. Das Diagramm summiert nach Property, die Tabelle nach Seite, daher können beide abweichen. Prüf auch den Zeitraum; stündliche Daten nutzen die pazifische Zeit.
  • Kontingente. Die URL-Prüfung erlaubt 2.000 Prüfungen pro Tag und Website, Sammelprüfungen auf einer großen Website brechen also mittendrin ab. Search Analytics erlaubt 1.200 Abfragen pro Minute und Website.

Google Cloud ganz auslassen

Jeder Fehler oben außer im letzten Abschnitt kommt daher, dass du dein eigenes Google-Cloud-Projekt betreibst. Den Google Search Console MCP von zaDojo hosten wir für dich: Du verbindest die Search Console in einem zaDojo-Projekt mit einer normalen Google-Anmeldung, und dein Agent liest sie unter https://app.zadojo.com/mcp. Es gibt kein Cloud-Projekt, keine API zum Aktivieren, kein Dienstkonto, keinen Zustimmungsbildschirm und keine Datei mit Zugangsdaten, und es funktioniert in claude.ai und ChatGPT ebenso wie in Desktop-Clients.

Abfragen der Search Console, URL-Prüfung und Indexabdeckung sind im kostenlosen Plan von zaDojo kostenlos, und der braucht keine Karte. Das gilt auch für Abfragen aus Google Analytics und für Site Audits bis 50 Seiten. Keyword-, Wettbewerbs- und KI-Sichtbarkeitsdaten verbrauchen Credits. Einen Vergleich mit den anderen kostenlosen Optionen findest du unter kostenlose SEO-MCP-Server.

Häufige Fragen

Gibt es einen offiziellen MCP-Server für Google Search Console? Nein. Google veröffentlicht MCP-Server für Google Analytics und andere Produkte, aber nicht für die Search Console. Jeder Search-Console-Server ist ein Community-Projekt oder ein gehosteter Dienst.

Soll ich ein Dienstkonto oder OAuth nutzen? Ein Dienstkonto passt zu einem Server, der unbeaufsichtigt läuft, aber du musst seine E-Mail-Adresse jeder Property hinzufügen. OAuth nutzt dein eigenes Google-Konto und sieht jede Property, die du schon hast, aber im Testmodus musst du dich alle 7 Tage neu anmelden, bis du auf In production umstellst.

Warum sieht mein Agent nur einige meiner Websites? Das Konto oder Dienstkonto, das er nutzt, sieht nur die Properties, denen es hinzugefügt wurde. Bitte den Agenten, die Websites aufzulisten, und vergleiche die Liste mit der Search Console.

Kann ein Search-Console-MCP-Server meine Website ändern? Nein. Diese Server lesen und verwalten Search-Console-Daten. Keiner von ihnen bearbeitet deine Seiten.