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 siehst | Wahrscheinliche Ursache | Springe zu |
|---|---|---|
| "has not been used in project ... before or it is disabled" | Search Console API ist in diesem Cloud-Projekt aus | API nicht aktiviert |
| 403 "User does not have sufficient permission for site" | Dienstkonto nicht zur Property hinzugefügt oder falsche URL | Berechtigungsfehler |
| "is not a verified Search Console site in this account" | Domain- und URL-Präfix-Property verwechselt | Falsches Property-Format |
| "Failed to add user: email not found" in der Search Console | Google-Fehler bei neuen Dienstkonten | E-Mail nicht gefunden |
| "Access blocked" oder "Error 403: access_denied" auf dem Google-Bildschirm | OAuth-App im Testmodus, du bist kein Testnutzer | Fehler auf dem OAuth-Bildschirm |
invalid_grant etwa eine Woche, nachdem es lief | Refresh-Tokens im Testmodus laufen nach 7 Tagen ab | Läuft, dann nicht mehr |
| "Error 400: redirect_uri_mismatch" | Web-Client statt Desktop-Client verwendet | Fehler auf dem OAuth-Bildschirm |
| "Service account credentials file not found" | Relativer Pfad oder falsches Paket | Datei mit Zugangsdaten |
spawn uvx ENOENT oder spawn npx ENOENT | Der Client findet den Befehl nicht | Client-Fehler |
| Keine Tools erscheinen, kein Log wird geschrieben | Python älter als 3.11 | Client-Fehler |
| Zahlen passen nicht zum Search-Console-Dashboard | Datenverzögerung, Zeilenlimits, anonymisierte Suchanfragen | Zahlen 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.
- Vergleiche die Projektnummer im Fehler mit dem Projekt deiner JSON-Datei mit Zugangsdaten.
- Öffne in Google Cloud in diesem Projekt APIs & Services > Library und aktiviere die Google Search Console API.
- 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.
- Öffne den JSON-Schlüssel des Dienstkontos und kopiere den Wert
client_email. - Öffne in der Search Console Settings > Users and permissions > Add user, füge die E-Mail-Adresse ein und gib ihr die Berechtigung „Full“.
- 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.
- Setz in Google Cloud den Veröffentlichungsstatus des Zustimmungsbildschirms auf In production. Für die private Nutzung kann er unverifiziert bleiben.
- Lösch die Token-Datei, die der Server gespeichert hat.
- 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.jsonzeigt 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 Paketmcp-gscauf PyPI. Starte es alsuvx 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 eineclient_email. Eine OAuth-Client-Datei beginnt mit einem Schlüsselinstalledoderweb. Jede gehört in ihre eigene Einstellung: mcp-gsc nutztGSC_CREDENTIALS_PATHfür die erste undGSC_OAUTH_CLIENT_SECRETS_FILEfür die zweite, mcp-server-gsc nutztGOOGLE_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.logenthält Verbindungsfehler,mcp-server-<name>.logdie 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/mcpinnerhalb 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.