GSC mit Gemini verbinden

Wie verbinde ich Google-Search-Console-Daten mit Gemini?

Gemini liest Ihre Search-Console-Daten über denselben MCP-Endpunkt wie jeder andere Assistent. Fügen Sie mcp.gscwizard.com in die Gemini-App (USA, persönliche Konten), die Antigravity CLI, Gemini Enterprise oder die Gemini API ein, und Gemini arbeitet mit echten Klicks, Impressionen, Positionen und CTR.

Endpunkt: https://mcp.gscwizard.com/mcp

Die Kurzfassung

Fügen Sie den GSC Wizard MCP-Server in der Gemini-Oberfläche hinzu, die Sie nutzen:

  1. Die Gemini-App: Settings → Connected Apps → Add a custom app, dann https://mcp.gscwizard.com/mcp einfügen. Google bietet dies Erwachsenen in den USA mit persönlichen Google-Konten an.
  2. Antigravity CLI (der Nachfolger der Gemini CLI für Einzelkonten): ein serverUrl-Eintrag in mcp_config.json.
  3. Gemini Enterprise: einen benutzerdefinierten MCP-Server mit OAuth 2.0 hinzufügen. Ein API-Schlüssel wird nicht akzeptiert.
  4. Die Gemini API: eine MCP-Client-Sitzung mit dem Google Gen AI SDK in tools übergeben oder die REST-Schnittstelle unter /v1 direkt aufrufen.

Unsicher, welchen Weg Sie nutzen können? Die Tabelle unten zeigt, für wen welcher Weg gedacht ist.

Welchen Gemini-Weg können Sie nutzen?

Google entscheidet, wer welche Oberfläche bekommt, nicht GSC Wizard. Die folgenden Voraussetzungen stammen aus den Hilfeseiten von Google selbst.

WegWer es nutzen kannAnmeldungEinrichtung
Gemini-AppErwachsene (ab 18) in den USA, persönliches Google-Konto, Englisch, Keep Activity aktiviert. Keine Arbeits- oder Schulkonten.OAuth, automatisch. Kein Schlüssel zu kopieren.Eine URL einfügen. Etwa eine Minute.
Antigravity CLI und IDEEntwickler, überall. Die Gemini CLI selbst bedient inzwischen nur noch Enterprise-Kunden und zahlende API-Key-Nutzer.API-Key-Header oder OAuth.Ein JSON-Eintrag.
Gemini EnterpriseOrganisationen. Ein Team- oder Cloud-Admin fügt den Server hinzu.Nur OAuth 2.0. API-Schlüssel werden nicht akzeptiert.OAuth-Client erstellen, dann das Connector-Formular ausfüllen.
Gemini APIEntwickler, die einen eigenen Agent bauen.API-Key-Header.Ein paar Zeilen mit dem Gen AI SDK.
Video

Die Einrichtung von Anfang bis Ende ansehen

Eine Schritt-für-Schritt-Anleitung zu demselben MCP-Server, mit dem sich Gemini verbindet: hinzufügen, authentifizieren und in natürlicher Sprache nach einer echten Search-Console-Analyse fragen.

Option 1: am einfachsten

Die Gemini-App

Gemini erlaubt es inzwischen, einen eigenen MCP-Server als benutzerdefinierte App hinzuzufügen. GSC Wizard unterstützt dynamische Client-Registrierung, daher registriert sich Gemini selbst, und es gibt keinen API-Schlüssel und kein Client-Secret zu kopieren.

Prüfen, ob Google es Ihnen anbietet

Laut der Hilfeseite von Google zu benutzerdefinierten Apps müssen Sie mindestens 18 Jahre alt sein und sich in den USA befinden, mit einem persönlichen Google-Konto angemeldet sein (Arbeits- und Schulkonten werden vorerst nicht unterstützt), Gemini auf Englisch nutzen und Keep Activity aktiviert haben. Sie fügen die App in der Web-App unter gemini.google.com hinzu, danach funktioniert sie auch in der mobilen App. Wenn Sie Add a custom app nicht sehen, ist eine dieser Bedingungen nicht erfüllt: Nutzen Sie dann die Antigravity CLI, Gemini Enterprise oder die API weiter unten.

  1. 1

    Properties in GSC Wizard verbinden

    Melden Sie sich unter tool.gscwizard.com mit dem Google-Konto an, das Zugriff auf Ihre Search-Console-Properties hat. Gemini liest genau die Properties, die Sie dort verbinden.

  2. 2

    Benutzerdefinierte App in Gemini hinzufügen

    Öffnen Sie gemini.google.com auf einem Computer, klicken Sie unten auf Settings und dann auf Connected Apps. Klicken Sie unter Custom apps auf Add a custom app und geben Sie https://mcp.gscwizard.com/mcp ein. Behalten Sie das /mcp am Ende bei: Die reine Domain beantwortet keine MCP-Anfragen.

  3. 3

    Anmelden und bestätigen

    Klicken Sie auf Next und folgen Sie den Schritten. Gemini leitet Sie zu einer Anmelde- und Zustimmungsseite von GSC Wizard weiter. Die Zugangsdaten unter Advanced features können Sie leer lassen, denn sie sind nur für Server gedacht, die einen Client nicht automatisch registrieren können.

  4. 4

    Mit @ fragen

    Geben Sie in einem neuen Chat @ ein, wählen Sie die GSC Wizard App und fragen Sie zum Beispiel: „Welche Seiten auf example.com haben in den letzten 28 Tagen die meisten Klicks verloren?“. Gemini bittet Sie um Bestätigung, bevor es eine Schreibaktion ausführt.

Google weist darauf hin, dass es MCP-Server von Drittanbietern weder kontrolliert noch überwacht noch absichert und dass Gemini Chat-Inhalte mit einer verbundenen App teilen kann. GSC Wizard liefert nur die Search-Console-, GA4- und Bing-Daten zurück, die Sie mit Ihrem eigenen Konto verbunden haben. Sie können die App jederzeit unter Settings → Connected Apps ausschalten, trennen oder entfernen.

Option 2: Entwickler

Antigravity CLI und IDE

Antigravity ist die Agent-Umgebung von Google und der Nachfolger der Gemini CLI für Einzelkonten. Sie liest Remote-MCP-Server aus einer JSON-Datei und funktioniert überall dort, wo Antigravity verfügbar ist, ohne US-Beschränkung auf der MCP-Seite.

  1. 1

    API-Schlüssel in GSC Wizard erstellen

    Melden Sie sich unter tool.gscwizard.com an, verbinden Sie Ihre Search-Console-Properties und erstellen Sie dann unter Account → API keys einen Schlüssel. Lieber OAuth statt eines gespeicherten Schlüssels? Überspringen Sie diesen Schritt und lesen Sie den Hinweis unter der Konfiguration.

  2. 2

    Server zu mcp_config.json hinzufügen

    Bearbeiten Sie ~/.gemini/config/mcp_config.json für alle Projekte oder .agents/mcp_config.json innerhalb eines Repositorys, um es dort einzugrenzen. Remote-Server verwenden den Schlüssel serverUrl: Laut der Google-Dokumentation werden die älteren Schlüssel url und httpUrl dort nicht unterstützt.

  3. 3

    Prüfen und fragen

    Geben Sie /mcp im Prompt-Bereich ein, um zu prüfen, ob der Server verbunden ist, und um seine Tools zu sehen. Fragen Sie dann in natürlicher Sprache nach Ihrer Website.

~/.gemini/config/mcp_config.json

{
  "mcpServers": {
    "gsc-wizard": {
      "serverUrl": "https://mcp.gscwizard.com/mcp",
      "headers": {
        "Authorization": "Bearer gscw_live_..."
      }
    }
  }
}

Um sich anzumelden, statt einen Schlüssel zu speichern, lassen Sie den Block headers weg. Da GSC Wizard dynamische Client-Registrierung unterstützt, startet Antigravity den OAuth-Ablauf, wenn Sie unter Agent settings → Customizations neben dem Server auf Authenticate klicken.

Noch auf der Gemini CLI?

Google hat die Gemini CLI für kostenlose Einzelkonten sowie Google-AI-Pro- und Ultra-Einzelkonten am 18. Juni 2026 eingestellt und verweist diese Nutzer auf die Antigravity CLI. Enterprise-Kunden und zahlende API-Key-Nutzer behalten die Gemini CLI, und für sie lässt sich der Endpunkt mit einem Bearer-Header einbinden.

gemini mcp add --transport http \
  --header "Authorization: Bearer gscw_live_..." \
  gsc-wizard https://mcp.gscwizard.com/mcp

Oder fügen Sie in ~/.gemini/settings.json einen Eintrag mit "httpUrl": "https://mcp.gscwizard.com/mcp" und demselben headers-Objekt hinzu. Verweisen Sie auf eine Umgebungsvariable wie $GSCW_KEY, statt den Schlüssel einzufügen, damit er nicht in die Versionsverwaltung gelangt.

Option 3: Organisationen

Gemini Enterprise

Gemini Enterprise unterstützt benutzerdefinierte MCP-Server, sodass ein Admin Search-Console-Daten für Agents in der gesamten Organisation bereitstellen kann. Google dokumentiert für diese Server nur zwei Anmeldeoptionen, No authentication und OAuth 2.0, ein statischer API-Key-Header funktioniert hier daher nicht. GSC Wizard verbindet sich über OAuth 2.0 mit einem Client, den Sie selbst erstellen.

  1. 1

    OAuth-Client für Gemini Enterprise erstellen

    Gemini Enterprise leitet Nutzer immer zu https://vertexaisearch.cloud.google.com/oauth-redirect zurück, registrieren Sie also einen Client für diese Redirect-URL. Die Antwort enthält eine Client-ID (beginnt mit gscwc_) und ein Client-Secret, das nur einmal angezeigt wird. Speichern Sie es, bevor Sie fortfahren.

  2. 2

    Formular für benutzerdefinierte MCP-Server öffnen

    Melden Sie sich in der Business Edition unter business.gemini.google an, öffnen Sie Settings & help, wählen Sie Ihr Team und dann Manage team → Connected apps → Add MCP Server. Öffnen Sie in der Google Cloud Console Gemini Enterprise, gehen Sie zu Data stores → Create data store, suchen Sie nach Custom MCP Server und klicken Sie auf Add MCP server.

  3. 3

    OAuth-2.0-Werte eingeben

    Wählen Sie OAuth 2.0, füllen Sie die Tabelle unten aus und klicken Sie auf Verify Auth. Wählen Sie dann einen Standort, benennen Sie den Connector und erstellen Sie ihn.

  4. 4

    Connector und seine Tools einschalten

    Google lässt neue benutzerdefinierte MCP-Verbindungen zunächst ausgeschaltet. Aktivieren Sie die Verbindung in der Business Edition auf der Seite Connectors. Öffnen Sie in der Cloud Console den Data Store, wählen Sie Actions → Reload custom actions, markieren Sie die gewünschten Tools und klicken Sie auf Enable actions.

Schritt 1: Client registrieren

curl -X POST https://tool.gscwizard.com/api/oauth/register \
  -H "Content-Type: application/json" \
  -d '{
    "client_name": "Gemini Enterprise",
    "redirect_uris": ["https://vertexaisearch.cloud.google.com/oauth-redirect"],
    "token_endpoint_auth_method": "client_secret_post",
    "grant_types": ["authorization_code", "refresh_token"]
  }'

Schritt 3: die Werte

Feld in Gemini EnterpriseWert
MCP Server URLhttps://mcp.gscwizard.com/mcp
AuthentifizierungOAuth 2.0
Authorization URLhttps://tool.gscwizard.com/oauth/authorize
Token URLhttps://tool.gscwizard.com/api/oauth/token
Client-ID und SecretAus der Antwort in Schritt 1 (gscwc_ und das Secret)
Scopesmcp:read für reinen Lesezugriff oder mcp:read mcp:write
PKCEAktivieren Sie es überall, wo das Formular die Option anbietet: Der Autorisierungsserver von GSC Wizard setzt PKCE voraus

Die Authorization URL enthält kein /api/, die Token URL schon; beides ist korrekt. Auf dem Weg über die Cloud Console braucht ein Administrator außerdem die Rolle Discovery Engine Editor, muss die Organisationsrichtlinie überschreiben, die benutzerdefinierte MCP-Data-Stores standardmäßig blockiert, und muss die Domains mcp.gscwizard.com und tool.gscwizard.com zulassen. Die Einrichtungsseiten von Google behandeln beide Wege: die Anleitung für die Cloud Console und die Anleitung für die Business Edition.

Option 4: Entwickler

Die Gemini API und Ihre eigenen Agents

Sie bauen einen Agent, statt zu chatten? Das Google Gen AI SDK kann eine MCP-Client-Sitzung direkt in die Tool-Liste übergeben, sodass Gemini GSC Wizard Tools unmittelbar aufruft.

Python: google-genai mit einer MCP-Sitzung

from google import genai
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

URL = "https://mcp.gscwizard.com/mcp"
HEADERS = {"Authorization": "Bearer gscw_live_..."}
MODEL = "gemini-3.1-pro"  # or whichever Gemini model you use

async with streamablehttp_client(URL, headers=HEADERS) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        response = await genai.Client().aio.models.generate_content(
            model=MODEL,
            contents="Which pages on example.com lost the most clicks in the last 28 days?",
            config=genai.types.GenerateContentConfig(tools=[session]),
        )
        print(response.text)

Wenn Sie lieber gar nicht mit MCP arbeiten möchten, stehen dieselben Schlüssel, Scopes und Rate Limits hinter einer reinen REST-Schnittstelle unter https://mcp.gscwizard.com/v1, mit einem generierten OpenAPI-3,1-Dokument unter /v1/openapi.json, das Sie Gemini als Function-Calling-Spezifikation übergeben können.

Außerhalb der USA oder mit einem Arbeitskonto?

Google bietet benutzerdefinierte Apps in der Gemini-App derzeit nur Erwachsenen in den USA mit persönlichen Google-Konten an, daher erscheint die Option bei Ihnen eventuell nicht. Die Antigravity CLI, Gemini Enterprise und die Gemini API sind an diese Regel nicht gebunden. Wenn Sie einem Kollegen nur die Zahlen geben möchten, funktioniert ein geteilter Berichtslink oder ein CSV-Export aus GSC Wizard in jedem Chat.

Connector-Plattformen wie Windsor.ai und Supermetrics

Fragen Sie Gemini, wie man die Search Console verbindet, nennt es oft Daten-Connector-Plattformen wie Windsor.ai und Supermetrics. Sie lösen ein anderes Problem, die Wahl hängt also davon ab, was Sie brauchen.

Eine Connector-Plattform passt, wenn

  • die Search Console eine von einem Dutzend Werbe- und Marketingquellen ist, die Sie bereits an einer Stelle zusammenführen.
  • Sie einheitliches Reporting über Werbeplattformen, Analytics und Search Console wollen.
  • Ihr Team in Tabellen oder einem BI-Tool arbeitet und Gemini nur eine Ergänzung ist.

GSC Wizard passt, wenn

  • Sie SEO-Analysen wollen, etwa zu Content Decay, Kannibalisierung, CTR-Kurven und Chancenbewertung, nicht nur Rohzeilen.
  • die Analyse serverseitig auf dem vollständigen Search-Console-Datensatz laufen soll, sodass Gemini ein fertiges Ergebnis liest.
  • Sie eine MCP-URL wollen, die auch in ChatGPT, Claude, Grok und Copilot Studio funktioniert.

Einen direkten Vergleich von Reporting- und Pipeline-Tools finden Sie in meiner Übersicht der besten SEO-Reporting-Tools und im Leitfaden zu Connectors für Search-Console-Daten.

Natürliche Sprache rein, fertige Antworten raus

Was Sie nach dem Verbinden fragen können

Jede Analyse läuft auf dem Server gegen das Data Warehouse, sodass der Assistent ein fertiges Ergebnis liest, statt mit rohen Zeilen zu rechnen.

„Gib mir eine Leistungsübersicht für example.com“ „Was sind diesen Monat meine Top-Suchanfragen und -Seiten?“ „Welche Suchanfragen haben im Vergleich zum Vormonat Rankings gewonnen oder verloren?“ „Finde Seiten, die an Traffic verlieren“ „Wo kannibalisieren sich meine Keywords?“ „Zeig mir meine Kurve aus CTR und Position“ „Erstelle einen vollständigen SEO-Bericht“ „Prüfe https://example.com/pricing in Google“ „Welche Seiten stehen kurz vor Seite eins?“ „Reiche diese URLs bei IndexNow ein“
Dieselben Daten, andere Assistenten

Sie verbinden ein anderes KI-Tool?

Eine Search-Console-Verbindung, jeder Assistent. Wählen Sie Ihren Client und folgen Sie der Schritt-für-Schritt-Anleitung.

Siehe auch die Übersicht zum Google Search Console MCP, den GA4 MCP, den Yandex Webmaster MCP, den Merchant Center MCP, die ChatGPT-App (in ChatGPT installieren), die Meta-Muse-Connectors für Search Console und Google Analytics, unseren Überblick über die besten SEO-MCP-Server und den Leitfaden 2026 zu ChatGPT-Connectors für Search-Console-Daten.

Häufig gestellte Fragen

Kann sich die Gemini-App mit der Google Search Console verbinden?

Ja, wenn Sie die Voraussetzungen von Google erfüllen: Sie sind mindestens 18 Jahre alt und in den USA, mit einem persönlichen Google-Konto angemeldet (nicht mit einem Arbeits- oder Schulkonto), nutzen Englisch und haben Keep Activity aktiviert. Öffnen Sie gemini.google.com, gehen Sie zu Settings und dann zu Connected Apps, klicken Sie auf Add a custom app und geben Sie https://mcp.gscwizard.com/mcp ein. Gemini registriert sich selbst beim Server und führt Sie durch eine Anmeldung bei GSC Wizard. Wenn Sie diese Voraussetzungen nicht erfüllen, nutzen Sie die Antigravity CLI, Gemini Enterprise oder die Gemini API.

Warum sehe ich „Add a custom app“ in meiner Gemini-App nicht?

Google bietet benutzerdefinierte Apps derzeit nur Erwachsenen in den USA an, nur mit persönlichen Google-Konten, nur auf Englisch und nur mit aktiviertem Keep Activity, und Sie fügen sie in der Web-App unter gemini.google.com hinzu. Wenn Sie sich außerhalb der USA befinden oder ein Arbeits- oder Schulkonto nutzen, erscheint die Option nicht. Nutzen Sie stattdessen die Antigravity CLI, Gemini Enterprise oder die Gemini API.

Akzeptiert Gemini Enterprise einen API-Schlüssel?

Nein. Google dokumentiert für einen benutzerdefinierten MCP-Server in Gemini Enterprise zwei Authentifizierungsoptionen, No authentication und OAuth 2.0, und keine davon nimmt einen statischen Authorization-Header entgegen. Verbinden Sie GSC Wizard per OAuth 2.0 mit einer Client-ID und einem Secret, die für die Redirect-URL von Gemini Enterprise erstellt wurden.

Unterstützt die Antigravity CLI Remote-MCP-Server mit Authentifizierung?

Ja. Fügen Sie einen Eintrag mit serverUrl und einem headers-Objekt zu ~/.gemini/config/mcp_config.json hinzu (oder zu .agents/mcp_config.json innerhalb eines Projekts). Bei Servern, die dynamische Client-Registrierung unterstützen, wie GSC Wizard, können Sie die Header weglassen und sich stattdessen in den Agent-Einstellungen per OAuth authentifizieren.

Ist die Gemini CLI noch eine Option?

Nur für einige Konten. Google hat die Gemini CLI für kostenlose Einzelkonten sowie Google-AI-Pro- und Ultra-Einzelkonten am 18. Juni 2026 eingestellt und verweist diese Nutzer auf die Antigravity CLI. Die Gemini CLI bleibt für Enterprise-Kunden und zahlende API-Key-Nutzer verfügbar, und für sie registriert gemini mcp add mit --transport http und --header weiterhin GSC Wizard.

Sind die Daten gesampelt oder begrenzt wie bei einem Search-Console-Export?

Nein. Lesezugriffe werden aus einem ClickHouse-Warehouse bedient, das den vollständigen Zeilensatz enthält, daher gibt es keine Zeilenlimits wie beim Export und kein GSC-API-Paging. Das Warehouse hinkt etwa zwei Tage hinterher, und jede Antwort nennt das Datum, bis zu dem die Daten final sind.

Was kann Gemini nach dem Verbinden tun?

Alles, was der MCP bereitstellt: Suchanalyse, Top-Suchanfragen und -Seiten, Ranking-Veränderungen, Content Decay und Kannibalisierung, CTR-Kurven, Chancenbewertung, URL-Prüfung im Bulk, Indexierungs-Tracking, IndexNow-Einreichungen, Bing-Webmaster-Daten, GA4-Messwerte und vollständige SEO-Berichte.

Kostet es etwas?

API-Schlüssel sind für jedes GSC Wizard Konto kostenlos, und die kostenlose Stufe arbeitet über die GSC API. Abonnenten erhalten die schnelle, vom Warehouse gestützte Abfrage, die Analysen über den vollständigen Datensatz erst praktikabel macht. Details finden Sie auf der Preisseite.

Richten Sie Gemini auf Ihre Search-Console-Daten

Erstellen Sie einen kostenlosen API-Schlüssel, fügen Sie Ihrer Gemini-Konfiguration einen Eintrag hinzu und fragen Sie in natürlicher Sprache nach Ihrer Website.

Search-Console-Tipps per E-Mail

Praxisnahe GSC- und GA4-Workflows, Produktneuigkeiten und SEO-Experimente. Kein Spam, jederzeit abbestellbar.