Google Search Console MCP Server für SEOs

Ein Model Context Protocol (MCP)-Server, der Google Search Console (GSC) mit KI-Assistenten verbindet und es Ihnen ermöglicht, Ihre SEO-Daten über natürliche Sprachdialoge zu analysieren. Funktioniert mit Claude Desktop, Cursor, Codex CLI, Gemini CLI, Antigravity und jedem anderen MCP-kompatiblen Client.

Setup überspringen, mehr bekommen. Eine fortschrittlichere gehostete Version – Anmeldung mit einem Klick, zusätzliche GA4-Tools. Funktioniert mit Claude Desktop, Claude Code, Claude.ai, Codex, Cursor und jedem MCP-Client. Nur 100 Plätze. → Erweiterter GSC MCP (gehostet)

Was gibt es Neues

[0.3.3] – Juli 2026

• Fehler bei Neuinstallationen durch mcp 2.0 behoben – mcp[cli]<2.0.0 festgepinnt. Das mcp SDK 2.0.0 (veröffentlicht am 28.07.2026) hat das Modul mcp.server.fastmcp entfernt, sodass jede frische uvx mcp-search-console-Installation beim Start mit ModuleNotFoundError: No module named 'mcp.server.fastmcp' abstürzte. Neue Installationen lösen jetzt wieder ein funktionierendes 1.x SDK auf – kein --with "mcp<2"-Workaround mehr nötig.

[0.3.2] – April 2026

• OAuth-Browserablauf für uvx behoben – den isatty-Block entfernt, der verhinderte, dass sich das Browser-Login-Fenster öffnet, wenn der Server als MCP-Subprozess auf macOS läuft. OAuth funktioniert jetzt sofort mit uvx, kein manueller Terminal-Lauf erforderlich.

• get_capabilities-Tool hinzugefügt – rufen Sie dies auf, um eine vollständige Liste der verfügbaren Tools und den aktuellen Authentifizierungsstatus auf einen Schlag zu erhalten. Nützlich, wenn Ihr KI-Assistent nicht sicher ist, welche Tools verfügbar sind.

• Bessere Fehlermeldungen zur Authentifizierung – alle Tools sagen Ihnen jetzt genau, was zu tun ist, wenn Anmeldedaten fehlen oder abgelaufen sind.

Related MCP server: Google Search Console MCP Server

Was kann das?

Eigenschaftsverwaltung

• Alle Ihre GSC-Eigenschaften an einem Ort sehen

• Verifizierungsdetails und Besitzinformationen abrufen

• Eigenschaften zu Ihrem Konto hinzufügen oder entfernen

Suchanalyse & Berichte

• Herausfinden, welche Suchanfragen Besucher auf Ihre Website bringen

• Impressionen, Klicks und Klickraten verfolgen

• Leistungstrends analysieren und Zeiträume vergleichen

• Daten mit Diagrammen visualisieren, die Ihr KI-Assistent erstellt

URL-Inspektion & Indexierung

• Prüfen, ob bestimmte Seiten Indexierungsprobleme haben

• Sehen, wann Google Ihre Seiten zuletzt gecrawlt hat

• Mehrere URLs gleichzeitig inspizieren, um Muster zu erkennen

Sitemap-Verwaltung

• Alle Sitemaps und ihren Status anzeigen

• Neue Sitemaps einreichen

• Auf Fehler oder Warnungen prüfen

Verfügbare Tools

Bitten Sie Ihren KI-Assistenten, „get_capabilities" aufzurufen, um die vollständige Liste aller 20 Tools zu erhalten.

Erste Schritte

Schritt 1 – Google-API-Anmeldedaten einrichten

Sie benötigen Anmeldedaten, bevor Sie einen Client konfigurieren. Wählen Sie eine Methode:

Option A – OAuth (Empfohlen – verwendet Ihr eigenes Google-Konto)

1. Gehen Sie zu Google Cloud Console und erstellen oder wählen Sie ein Projekt

2. Aktivieren Sie die Search Console API

3. Gehen Sie zu Anmeldedaten → Anmeldedaten erstellen → OAuth-Client-ID

4. Konfigurieren Sie den OAuth-Zustimmungsbildschirm, wählen Sie Desktop-App, klicken Sie auf Erstellen

5. Laden Sie die JSON-Datei herunter – speichern Sie sie an einem dauerhaften Ort (z. B. ~/Documents/client_secrets.json)

Bei der ersten Verwendung öffnet sich ein Browserfenster, in dem Sie aufgefordert werden, sich bei Ihrem Google-Konto anzumelden. Danach wird das Token gespeichert und keine Browserinteraktion ist mehr erforderlich.

Option B – Dienstkonto (Für Automatisierung oder Teamnutzung)

1. Gehen Sie zu Google Cloud Console und erstellen oder wählen Sie ein Projekt

2. Aktivieren Sie die Search Console API

3. Gehen Sie zu Anmeldedaten → Anmeldedaten erstellen → Dienstkonto

4. Gehen Sie zum Tab Schlüssel → Schlüssel hinzufügen → Neuen Schlüssel erstellen → JSON → Herunterladen

5. Speichern Sie die Datei an einem dauerhaften Ort (z. B. ~/Documents/service_account.json)

6. Fügen Sie die Dienstkonto-E-Mail zu Ihrer GSC-Eigenschaft hinzu: Search Console → Einstellungen → Benutzer und Berechtigungen → Benutzer hinzufügen → Vollzugriff

🎥 Sehen Sie sich das Schritt-für-Schritt-Setup-Tutorial für diesen Abschnitt an

Aktualisiert 2026 – deckt den gesamten Installationsprozess mit der neuen uvx-Methode ab, von der Einrichtung Ihrer Google-Anmeldedaten bis zu Ihrer ersten erfolgreichen Abfrage.

Schritt 2 – Installation

Option A – uvx (Empfohlen)

Kein Klonen, keine Python-Installation, keine virtuellen Umgebungen. uvx lädt den Server automatisch herunter und führt ihn aus und hält ihn auf dem neuesten Stand.

uv installieren – öffnen Sie das Terminal und führen Sie alle drei Befehle der Reihe nach aus:

# 1. Download and install
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Activate in the current Terminal session
source $HOME/.local/bin/env

# 3. Make it permanent for all future sessions
echo 'source $HOME/.local/bin/env' >> ~/.zshrc

Überprüfen:

uv --version

Warum alle drei Befehle? Der Installer legt uv in ~/.local/bin ab, aber Ihre bereits geöffnete Terminal-Sitzung kennt diesen Ordner noch nicht. Schritt 2 aktiviert ihn sofort. Schritt 3 stellt sicher, dass jedes zukünftige Terminal-Fenster ihn automatisch hat.

Konfigurieren Sie nun Ihren KI-Client:

Claude Desktop

Konfigurationsdatei: ~/Library/Application Support/Claude/claude_desktop_config.json

OAuth:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

Dienstkonto:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

Cursor

Konfigurationsdatei: ~/.cursor/mcp.json

OAuth:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

Codex CLI

Konfigurationsdatei: ~/.codex/config.toml

OAuth:

[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_OAUTH_CLIENT_SECRETS_FILE = "/full/path/to/client_secrets.json" }

Dienstkonto:

[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_CREDENTIALS_PATH = "/full/path/to/service_account.json", GSC_SKIP_OAUTH = "true" }

So finden Sie Ihren uvx-Pfad: Führen Sie auf macOS/Linux which uvx im Terminal aus, nachdem Sie uv installiert haben (normalerweise /Users/IHR_NAME/.local/bin/uvx). Auf Windows führen Sie Get-Command uvx | Select-Object -ExpandProperty Source in PowerShell aus (oder where uvx in cmd) – normalerweise C:\Users\IHR_NAME\.local\bin\uvx.exe. Ersetzen Sie /FULL/PATH/TO/uvx in den obigen Konfigurationen durch diesen Pfad.

Warum der vollständige Pfad? GUI-Apps wie Claude Desktop und Cursor starten ohne Ihre Shell-Konfiguration (~/.zshrc) zu lesen, daher kennen sie ~/.local/bin nicht. Die Verwendung des vollständigen Pfads stellt sicher, dass es funktioniert, unabhängig davon, wie die App gestartet wird. Wenn Sie einen spawn uvx ENOENT-Fehler sehen, ist dies die Lösung.

Nach dem Speichern der Konfiguration die App vollständig beenden (Cmd+Q) und erneut öffnen.

Für OAuth: Bei der ersten Verwendung öffnet sich automatisch ein Browserfenster für die Anmeldung. Danach wird das Token zwischengespeichert und Sie werden nicht erneut gefragt.

Option B – Klonen (Erweitert)

Bevorzugen Sie eine Video-Anleitung für diese Methode? Das folgende Tutorial behandelt den Klon-Installationspfad Schritt für Schritt – Einrichtung der virtuellen Umgebung, Abhängigkeiten und Konfiguration:

Verwenden Sie dies, wenn Sie den Code ändern oder eine bestimmte lokale Version ausführen möchten. Diese Methode verwendet das obige Video-Tutorial für die Schritte zur Einrichtung der Anmeldedaten.

Erfordert Python 3.11+. Dieser Server startet nicht auf Python 3.10 oder älter – und wenn er von einem GUI-Client wie Claude Desktop gestartet wird, schlägt er still fehl (keine Tools erscheinen und keine Logdatei wird geschrieben). Überprüfen Sie Ihre Version mit python --version. Wenn sie unter 3.11 liegt, installieren Sie Python 3.11 oder neuer und erstellen Sie Ihre virtuelle Umgebung neu. Die uvx-Methode (Option A) vermeidet dies vollständig, indem sie die Python-Version für Sie verwaltet, daher ist sie der empfohlene Weg unter Windows.

Repository klonen:

git clone https://github.com/AminForou/mcp-gsc.git
cd mcp-gsc

Oder laden Sie das ZIP über den grünen Code-Button oben auf dieser Seite herunter und entpacken Sie es.

Umgebung einrichten:

uv venv .venv
uv pip install -r requirements.txt

Konfigurieren Sie Ihren KI-Client (Claude Desktop-Beispiel):

OAuth:

{
  "mcpServers": {
    "gscServer": {
      "command": "/full/path/to/mcp-gsc/.venv/bin/python",
      "args": ["/full/path/to/mcp-gsc/gsc_server.py"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

Dienstkonto:

{
  "mcpServers": {
    "gscServer": {
      "command": "/full/path/to/mcp-gsc/.venv/bin/python",
      "args": ["/full/path/to/mcp-gsc/gsc_server.py"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

Mac-Pfadbeispiele:

• Python: /Users/yourname/Documents/mcp-gsc/.venv/bin/python

• Skript: /Users/yourname/Documents/mcp-gsc/gsc_server.py

Schritt 3 – Testen

Fragen Sie Ihren KI-Assistenten: „Liste meine GSC-Eigenschaften auf"

Wenn Sie Ihre Eigenschaften sehen – funktioniert es. Wenn nicht, fragen Sie: „Rufe get_capabilities auf", um den Auth-Status zu sehen und das Problem zu diagnostizieren.

Referenz der Umgebungsvariablen

Cursor Marketplace

Installation mit einem Klick verfügbar – suchen Sie im Cursor Marketplace nach mcp-search-console.

Nach der Installation konfigurieren Sie Ihre Anmeldedaten (siehe Schritt 1 oben) und verwenden dann die gebündelten Fähigkeiten direkt im Cursor-Agent-Chat:

Beispiel-Prompts

Fehlerbehebung

spawn uvx ENOENT oder command not found: uvx

Ihr KI-Client kann uvx nicht finden. Verwenden Sie den vollständigen Pfad anstelle von nur uvx:

# Find your full path (macOS/Linux):
which uvx
# Typically: /Users/YOUR_NAME/.local/bin/uvx

# Find your full path (Windows PowerShell):
Get-Command uvx | Select-Object -ExpandProperty Source
# Typically: C:\Users\YOUR_NAME\.local\bin\uvx.exe

Ersetzen Sie "command": "uvx" durch den vollständigen Pfad (z. B. "command": "/Users/YOUR_NAME/.local/bin/uvx") in Ihrer Konfiguration.

uv --version meldet "command not found" direkt nach der Installation

Der Installer aktualisiert ~/.local/bin, aber Ihre aktuelle Terminal-Sitzung sieht es noch nicht. Führen Sie aus:

source $HOME/.local/bin/env

Dann fügen Sie es dauerhaft hinzu:

echo 'source $HOME/.local/bin/env' >> ~/.zshrc

Authentifizierung fehlgeschlagen / Anmeldedatendatei nicht gefunden

Stellen Sie sicher, dass Sie den absoluten Pfad zu Ihrer Anmeldedatendatei verwenden – keinen relativen Pfad, kein ~/. Beispiel:

/Users/yourname/Documents/client_secrets.json   ✅
~/Documents/client_secrets.json                 ✅
client_secrets.json                              ❌

MCP funktioniert nur in der Claude-Desktop-App, nicht auf der Website

Der MCP-Server läuft lokal auf Ihrem Rechner. Er funktioniert nur in der Claude-Desktop-App (heruntergeladen von claude.ai/download), nicht in der claude.ai-Browseroberfläche.

Konfigurationsprobleme mit dem KI-Client

1. Stellen Sie sicher, dass alle Dateipfade in Ihrer Konfiguration korrekte absolute Pfade sind

2. Beenden Sie die App vollständig (Cmd+Q) und öffnen Sie sie nach jeder Konfigurationsänderung erneut – nur das Schließen des Fensters reicht nicht

3. Bitten Sie Ihren KI-Assistenten, "call get_capabilities" aufzurufen – er meldet den genauen Authentifizierungsstatus und Fehler

Sicherheit: Destruktive Operationen

Standardmäßig sind add_site, delete_site und delete_sitemap deaktiviert. Um sie zu aktivieren:

"GSC_ALLOW_DESTRUCTIVE": "true"

Remote-Bereitstellung & Docker (Erweitert)

Das Standard-Setup führt den Server lokal aus. Dieser Abschnitt ist nur für Benutzer, die ihn auf einem Remote-Server oder in einem Container ausführen möchten.

HTTP-Transport

MCP_TRANSPORT=sse MCP_HOST=0.0.0.0 MCP_PORT=3001 python gsc_server.py

Docker

docker build -t mcp-gsc .

docker run \
  -e MCP_TRANSPORT=sse \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=3001 \
  -e GSC_CREDENTIALS_PATH=/app/credentials.json \
  -v /path/to/credentials.json:/app/credentials.json \
  -p 3001:3001 \
  mcp-gsc

Verwandte Tools

Advanced GSC Visualizer — Eine Chrome-Erweiterung (14.000+ Nutzer) mit interaktiven Diagrammen, Ein-Klick-Export von bis zu 25.000 Zeilen, Erkennung von Keyword-Kannibalisierung und einem KI-Assistenten – alles direkt in der Google Search Console. Vom selben Autor erstellt. Installieren aus dem Chrome Web Store →

Mitwirken

Einen Fehler gefunden oder eine Idee zur Verbesserung? Eröffnen Sie ein Issue oder reichen Sie einen Pull-Request auf GitHub ein.

Lizenz

MIT-Lizenz. Siehe die Datei LICENSE für Details.

Änderungsprotokoll

[0.3.3] — Juli 2026

• Festgelegt auf mcp[cli]>=1.3.0,<2.0.0. Das mcp-SDK 2.0.0 hat mcp.server.fastmcp entfernt, was alle frischen uvx-Installationen mit ModuleNotFoundError bricht. Die Begrenzung unter 2.0 stellt funktionierende Installationen wieder her. (Behebt #41)

[0.3.2] — April 2026

• OAuth-Browserablauf für uvx behoben – isatty-Block entfernt, der verhinderte, dass sich das OAuth-Browserfenster öffnet, wenn als MCP-Subprozess auf macOS ausgeführt. OAuth + uvx funktioniert jetzt sofort.

• get_capabilities-Tool – gibt alle verfügbaren Tools nach Kategorie gruppiert plus Live-Authentifizierungsstatus in einem Aufruf zurück.

• Bessere Authentifizierungsfehlermeldungen – alle Tools weisen jetzt explizit darauf hin, reauthenticate aufzurufen, wenn Anmeldedaten fehlen oder abgelaufen sind.

• Verbesserte list_properties-Beschreibung – bessere semantische Tool-Erkennung in Clients, die verzögertes Tool-Laden verwenden.

[0.3.1] — April 2026

• Behoben: list_properties maskierte echte Authentifizierungsfehler; jetzt schneller Fehlschlag bei fehlenden Anmeldedaten.

[0.3.0] — April 2026

• Cursor-Marketplace-Plugin mit 4 gebündelten SEO-Fähigkeiten

• Stabile Token-Speicherung im Benutzerkonfigurationsverzeichnis der Plattform (übersteht uvx-Upgrades)

• Strukturierte JSON-Ausgabe für alle Datentools

• 39 Unit-Tests

[0.2.2] — April 2026

• Sicherheitsmodus für destruktive Tools (standardmäßig deaktiviert)

• HTTP/SSE-Transport für Remote-Bereitstellungen

• Dockerfile

[0.2.1] — März 2026

• reauthenticate-Tool zum Wechseln von Google-Konten

• Behoben: sitemap TypeError-Absturz

• Behoben: 404-Fehler bei Domain-Properties

[0.2.0] — März 2026

• dataState: "all" standardmäßig (entspricht dem GSC-Dashboard)

• Flexibler row_limit-Parameter (bis zu 500)

• Mehrdimensionale Filterung für erweiterte Analysen

[0.1.0] — Erstveröffentlichung

• 19 Tools für Property-Verwaltung, Suchanalysen, URL-Inspektion und Sitemap-Verwaltung

• OAuth- und Servicekonto-Authentifizierung