GSC MCP für Codex

Google Search Console in OpenAI Codex

Codex liest bereits Ihren Code. Geben Sie ihm auch Ihre Suchdaten. Der GSC Wizard MCP-Server ist ein gehosteter Model-Context-Protocol-Endpunkt, der Codex Ihre Daten aus der Search Console, Bing Webmaster und GA4 übergibt. So sieht der Agent, der Ihre Templates bearbeitet, auch, welche Seiten Klicks verlieren, für welche Suchanfragen eine Seite rankt und ob eine URL indexiert ist.

Ein Befehl, kein lokaler Server, kein Google-Cloud-Projekt. Es funktioniert in der Codex CLI, der IDE-Erweiterung und der Desktop-App, die alle dieselbe ~/.codex/config.toml lesen.

codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp
codex mcp login gsc-wizard
Endpunkt
https://mcp.gscwizard.com/mcp
Transport
Streamable HTTP
Auth
OAuth (codex mcp login) or Bearer key
Tools
112 · GSC, Bing, GA4

Kostenlos testen, ohne Kreditkarte. Der MCP-Zugang ist in jedem Tarif enthalten.

01

Warum die Search Console in Codex gehört

Die meisten SEO-Fixes enden als Codeänderung: ein Title-Template, ein Canonical-Tag, eine Redirect-Map, ein Sitemap-Generator, ein Block mit internen Links. In einem Chat-Assistenten analysieren Sie die Daten und kopieren das Ergebnis dann in Ihren Editor. In Codex passieren Analyse und Änderung in derselben Sitzung, im selben Repository.

Daten direkt neben dem Diff

Codex kann nachschlagen, für welche Suchanfragen eine Seite Klicks erhält, bevor es deren Title umschreibt, statt Keywords zu raten.

Die Analyse läuft serverseitig

Content Decay, Kannibalisierung, CTR-Kurven und die Bewertung von Chancen berechnet der Server. Codex erhält Schlussfolgerungen und die zugrunde liegenden Zeilen, keinen Rohexport, auf dem es rechnen müsste.

Mehr Verlauf als die API

Die meisten Lesezugriffe kommen aus dem Warehouse von GSC Wizard mit Ihren gespeicherten Daten. Es reicht über das 16-Monats-Fenster von Google hinaus und vermeidet das Zeilen-Sampling der API.

02

Einrichtung in drei Schritten

  1. 1

    Properties verbinden

    Erstellen Sie ein GSC Wizard Konto, melden Sie sich mit Google an und wählen Sie die Search-Console-Properties aus, die Codex sehen soll. Codex kann nur Properties lesen, die hier verbunden sind.

  2. 2

    Server zu Codex hinzufügen

    In einem beliebigen Terminal:

    codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp

    Das schreibt eine Tabelle [mcp_servers.gsc-wizard] in die Datei ~/.codex/config.toml. Sie können den Block auch von Hand schreiben.

  3. 3

    Anmelden und prüfen

    Führen Sie den OAuth-Login aus, der Ihren Browser auf dem Einwilligungsbildschirm von GSC Wizard öffnet. Starten Sie dann Codex und geben Sie /mcp ein, um zu prüfen, ob die Tools aufgelistet sind.

    codex mcp login gsc-wizard
    codex
    > /mcp
    > List my Search Console sites and show clicks for the last 28 days.
03

Der config.toml-Block

Wenn Sie Ihre Codex-Konfiguration in einem Dotfiles-Repository pflegen oder einschränken möchten, was der Agent erreichen kann, bearbeiten Sie ~/.codex/config.toml direkt.

Minimal (OAuth)

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"

API-Schlüssel aus einer Umgebungsvariable

bearer_token_env_var benennt die Variable; Codex sendet ihren Wert als Authorization: Bearer. Der Schlüssel selbst steht nie in der Konfigurationsdatei.

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"
export GSCW_API_KEY="gscw_live_..."

Fokussiert: nur die Tools, die eine Aufgabe braucht

Jede Tool-Definition kostet bei jedem Durchlauf Kontext. Für einen Coding-Agenten, der nur Leistung und Indexierung prüfen muss, hält eine Allowlist die Sitzung schlank und begrenzt, was eine Prompt Injection in abgerufenen Inhalten erreichen könnte.

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"
enabled_tools = [
  "list_sites",
  "get_site_summary",
  "query_top_pages",
  "get_page_performance",
  "get_query_performance",
  "find_decaying_content",
  "analyze_cannibalization",
  "inspect_url",
  "list_sitemaps"
]
tool_timeout_sec = 120

Analyse-Tools über lange Zeiträume können länger dauern als eine einfache Abfrage. Ein großzügiger Wert für tool_timeout_sec verhindert, dass Codex einen Aufruf abbricht, den der Server noch beantwortet. Setzen Sie enabled = false, um den Server abzuschalten, ohne den Block zu löschen.

04

OAuth oder API-Schlüssel

OAuth über codex mcp login

Ideal für interaktives Arbeiten auf Ihrem eigenen Rechner. Codex findet den Authorization Server, registriert sich selbst und öffnet eine Anmeldung im Browser. Kein Schlüssel, den Sie kopieren, speichern oder rotieren müssen. Die Freigabe umfasst lesende und schreibende Tools, und Sie können sie in Ihrem GSC Wizard Konto widerrufen.

gscw_live_-Schlüssel mit begrenztem Scope

Ideal für codex exec, CI-Pipelines, Cloud-Aufgaben und alles ohne Browser. Erstellen Sie einen unter Konto → API-Schlüssel in GSC Wizard; er wird einmal angezeigt und nur als Hash gespeichert.

Verwenden Sie für Agenten einen Schlüssel mit Lese-Scope. Ein Lese-Schlüssel kann keines der 32 Mutations-Tools aufrufen, etwa submit_sitemap, submit_indexnow_urls oder add_site. Die Prüfung läuft auf dem Server, bevor das Tool ausgeführt wird, ein Agent lässt sich also nicht daran vorbeireden. Google-Zugangsdaten erreichen Codex überhaupt nicht: Der Server hält sie, und Codex besitzt nur Zugangsdaten für GSC Wizard.

05

Was Sie Codex fragen können

Nützliche Prompts verbinden die Suchdaten mit dem Repository, das Codex geöffnet hat.

Titles mit echten Suchanfragedaten verbessern

„Finde Seiten auf example.com, die auf den Positionen 4 bis 15 ranken und eine CTR unter der Kurve haben. Suche für jede davon in diesem Repository das Template oder die Content-Datei, die ihren Title setzt, und schlage einen Title vor, der ihre wichtigste Suchanfrage enthält.“

Eine Migration prüfen, bevor Sie sie ausliefern

„Vergleiche die URLs, die dieser Branch entfernt oder umbenennt, mit den 500 Seiten mit den meisten Klicks der letzten 90 Tage. Liste jede URL mit Traffic auf, für die es in redirects.json keine Weiterleitung gibt.“

Content zum Aktualisieren finden

„Führe eine Decay-Analyse für den Bereich /blog/ durch, öffne dann die fünf Beiträge mit dem stärksten Rückgang in content/ und entwirf für jeden einen Aktualisierungsplan anhand der Suchanfragen, die sie verloren haben.“

Kannibalisierung im Code beheben

„Finde Suchanfragen, bei denen zwei oder mehr unserer Seiten konkurrieren. Prüfe für jedes Paar die internen Links und Canonicals in den Templates und schlage vor, welche Seite gewinnen sollte.“

Indexierung nach einem Deployment prüfen

„Prüfe die zehn URLs, die im letzten Commit hinzugekommen sind, und sage mir, welche noch nicht indexiert sind, samt Begründung von Google.“

Codex einmal Bescheid geben, in AGENTS.md

Codex liest AGENTS.md zu Beginn einer Sitzung. Ein paar Zeilen dort ersparen es Ihnen, die Property und die Hausregeln in jedem Prompt zu wiederholen.

## Search data
- Search Console property: sc-domain:example.com (use the gsc-wizard MCP tools).
- Before changing a title, meta description or URL, look up the page's
  current queries with get_page_performance and keep its top query in the title.
- Treat the last 3 days as incomplete; report settledThrough with any numbers.
- Never call submit_sitemap or submit_indexnow_urls without asking first.
06

Tools, die Codex aufrufen kann

128 Tools stehen jedem Konto zur Verfügung. Jedes liefert MCP-Annotationen wie readOnlyHint und destructiveHint, sodass Codex Lese- von Schreibzugriffen unterscheiden kann, wenn es entscheidet, ob es um Freigabe bittet.

Gruppe Typische Tools Scope
Suchanalysequery_search_analytics, query_top_queries, query_top_pages, get_page_performanceLesen
Analysefind_decaying_content, analyze_cannibalization, analyze_ctr_curve, score_opportunitiesLesen
Erkennungdetect_anomalies, detect_change_points, get_ranking_changes, forecast_trafficLesen
Indexierung & Onpageinspect_url, bulk_inspect_urls, list_sitemaps, audit_onpage_seoLesen
Weitere QuellenBing Webmaster, GA4 (einschließlich LLM-Referral-Traffic), Core Web VitalsLesen
Mutationensubmit_sitemap, submit_indexnow_urls, create_annotation, create_topic_clusterSchreiben

Datumsangaben sind bei jedem Tool optional: Fehlt ein Zeitraum, gelten standardmäßig die letzten 28 vollständigen Tage, sodass Codex das heutige Datum nie kennen muss. Tools mit Zeilenlimit liefern einen Paginierungsblock, der angibt, ob es weitere Zeilen gibt, damit der Agent eine abgeschnittene Liste nicht für eine vollständige hält. Den vollständigen Katalog mit Argumenten finden Sie unter mcp.gscwizard.com, die Protokolldetails in der Server-Referenz.

07

Fehlerbehebung

/mcp listet gsc-wizard nicht auf

Führen Sie codex mcp list aus, um zu prüfen, ob der Eintrag existiert, und kontrollieren Sie, dass der Block in ~/.codex/config.toml ein url-Eintrag und kein command-Eintrag ist. Starten Sie Codex nach dem Bearbeiten der Datei neu; die Konfiguration wird beim Start gelesen.

Jeder Aufruf liefert 401 unauthorized

Mit Schlüssel: Die in bearer_token_env_var genannte Variable muss in der Shell exportiert sein, die Codex gestartet hat, und den vollständigen gscw_live_-Schlüssel enthalten. Mit OAuth: Führen Sie codex mcp login gsc-wizard erneut aus. In beiden Fällen braucht das Konto eine aktive Testphase oder ein Abonnement und mindestens eine verbundene Search-Console-Property.

Ein Schreib-Tool wird abgelehnt

Das ist der Lese-Scope, der seine Aufgabe erfüllt. Wenn Codex tatsächlich Sitemaps oder IndexNow-URLs einreichen soll, erstellen Sie einen Schlüssel mit Schreib-Scope oder nutzen Sie den OAuth-Login, und halten Sie diese Zugangsdaten aus unbeaufsichtigten Läufen heraus.

Aufrufe laufen bei großen Properties in ein Timeout

Erhöhen Sie tool_timeout_sec für den Server und grenzen Sie die Anfrage ein: Ein Pfadfilter oder ein kürzerer Zeitraum wird schneller beantwortet als eine Abfrage über die ganze Website und sechzehn Monate.

Zahlen weichen von der Search-Console-Oberfläche ab

Prüfen Sie settledThrough und dataSource in der Antwort. Der Standardzeitraum endet am letzten vollständigen Tag, während die Oberfläche die unvollständigen jüngsten Tage einbezieht.

08

Häufig gestellte Fragen

Unterstützt Codex entfernte MCP-Server wie GSC Wizard?

Ja. Codex unterstützt Streamable-HTTP-MCP-Server, die mit einer url in ~/.codex/config.toml konfiguriert oder mit codex mcp add --url hinzugefügt werden. Der GSC Wizard Server läuft unter https://mcp.gscwizard.com/mcp, Sie müssen also nichts lokal installieren oder ausführen.

Sollte ich bei Codex OAuth oder einen API-Schlüssel verwenden?

Für die interaktive Nutzung führt codex mcp login den OAuth-Ablauf in Ihrem Browser aus und erfordert keinen Umgang mit Schlüsseln. Für codex exec, CI-Jobs und andere unbeaufsichtigte Läufe verwenden Sie einen gscw_live_-API-Schlüssel mit Lese-Scope, der in einer Umgebungsvariable liegt und über bearer_token_env_var referenziert wird, damit das Secret nie in der config.toml landet.

Teilen sich die Codex CLI, die IDE-Erweiterung und die App die MCP-Einrichtung?

Ja. Sie lesen dieselbe ~/.codex/config.toml. Wenn Sie gsc-wizard einmal hinzufügen, steht es daher im Terminal, in der IDE-Erweiterung und in der Desktop-App zur Verfügung.

Kann Codex etwas in meiner Search Console ändern?

Nur mit Zugangsdaten mit Schreib-Scope. Ein API-Schlüssel mit Lese-Scope kann keines der 32 Mutations-Tools aufrufen (etwa submit_sitemap oder submit_indexnow_urls); die Prüfung läuft auf dem Server, bevor das Tool ausgeführt wird. Zusätzlich können Sie die Tool-Liste im Client mit enabled_tools in der config.toml einschränken.

Wie viele Tools erhält Codex?

128 Tools stehen jedem Konto zur Verfügung und decken Search-Console-Leistung, Analyse, Indexierung, Bing Webmaster, Yandex Webmaster, GA4 und Google Merchant Center ab. Alle zu senden kostet bei jedem Durchlauf Kontext, daher führen die meisten Codex-Setups in enabled_tools nur die Tools auf, die eine Aufgabe braucht.

Kostet es etwas?

Der MCP-Zugang ist in den GSC Wizard Tarifen und in der kostenlosen Testphase enthalten, die keine Kreditkarte erfordert. Die Nutzung von Codex rechnet OpenAI wie gewohnt ab. Siehe Preise.

Verwandte Themen

Geben Sie Codex Ihre Suchdaten

Verbinden Sie eine Property, führen Sie einen Befehl aus und lassen Sie den Agenten, der Ihre Website bearbeitet, sehen, wie sie in der Suche abschneidet.

Search-Console-Tipps per E-Mail

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