Google Search Console mit Claude Code verbinden: MCP-Anleitung

Warum die Search Console mit einem Coding-Assistenten verbinden?

Claude Code ist nützlich, wenn die SEO-Arbeit die Website selbst betrifft. In derselben Entwicklungsumgebung kannst du Templates prüfen, Weiterleitungen korrigieren, Seitentitel ändern, einen Build testen und eine Sitemap durchsehen. Dein Quellcode verrät dir aber nicht, welche Seite in der letzten Woche 300 Google-Klicks verloren hat.

Ohne Zugriff auf die Search Console kann ein Assistent eine Seite ansehen und vernünftige Vorschläge machen. Er kann aber nicht unterscheiden, ob etwas ein dringendes Problem ist oder ob schlicht niemand danach sucht. Dieser Unterschied zählt, wenn deine Zeit begrenzt ist.

Eine MCP-Verbindung liefert die fehlende Beweisquelle. Du kannst Claude Code die betroffenen URLs aus der Search Console ermitteln lassen, sie mit den lokalen Seiten-Templates abgleichen und Codeänderungen vorbereiten, die auf einer echten Untersuchung beruhen.

Dieser Leitfaden behandelt den Terminal-Workflow mit Claude Code, nicht den gewöhnlichen Connector der Claude-Website. Arbeitest du überwiegend im Browser, nutze unsere Anleitung zur Einrichtung der Search Console in Claude.

Was du brauchst, bevor du einen Befehl ausführst

Du brauchst eine funktionierende Installation von Claude Code im Terminal, ein Google-Konto mit Zugriff auf die gewünschte Search-Console-Property und einen MCP-Server, der die Daten dieser Property beziehen kann. Der Server kann selbst gehostet oder remote sein.

Die folgenden Schritte verwenden den gehosteten Endpunkt von GSC Magic. Laut der Dokumentation von GSC Magic akzeptiert er den Transport Streamable HTTP und unterstützt die Anmeldung per OAuth oder ein Zugriffstoken. Dein Konto muss freigeschaltet und der Dienst erreichbar sein; eine gültige URL allein bedeutet noch nicht, dass die Authentifizierung gelungen ist.

Vergewissere dich zuerst, dass Claude Code selbst läuft. Öffne es in einem gewöhnlichen Projekt und prüfe, ob du Prompts eingeben kannst. Du musst nicht deine komplette Produktiv-Website klonen, nur um eine lesende Search-Console-Verbindung zu testen.

Entscheide vor dem Verbinden, ob du für eine Website oder für mehrere arbeitest. Hat ein Google-Konto Zugriff auf Kunden-Websites, Staging-Domains und alte URL-Präfix-Properties, ist es leicht, die falsche Search-Console-Property auszuwählen.

Schritt 1: den Remote-MCP-Endpunkt hinzufügen

Öffne dein Terminal und führe diesen Befehl aus:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

So liest du ihn: claude mcp add registriert einen Server in Claude Code. Der Transport http kennzeichnet einen entfernten MCP-Dienst statt einer lokalen ausführbaren Datei. --scope user macht den Connector in deiner Konfiguration auf Benutzerebene verfügbar. Der Kurzname gsc-magic ist nur die Kennung, die du in deiner Tool-Liste siehst.

Die URL ist der dokumentierte Remote-Endpunkt von GSC Magic. Sie ist weder die URL deiner Search-Console-Property noch die Sitemap deiner Website noch ein Google-API-Endpunkt.

Warum der Scope „user“? Arbeitest du in mehreren lokalen Projekten an SEO, ist eine Verbindung auf Benutzerebene praktisch. Bei einem gemeinsam genutzten Repository oder einer sensiblen Kundenumgebung solltest du vor dem Hinzufügen externer Integrationen die Regeln von Claude Code zu Konfigurationsbereichen und die Richtlinie deines Teams prüfen.

Allgemeine Hinweise zum MCP-Befehl und zu den Transporten findest du in der Dokumentation von Anthropic zu Claude Code. Schau dort nach, falls sich eine CLI-Option in einer neueren Version ändert.

Schritt 2: in Claude Code authentifizieren

Starte Claude Code und gib ein:

/mcp

Wähle den Server gsc-magic. Bietet der Client die Aktion Authenticate an, folge ihr und schließe die Anmeldung im Browser ab. Verwende das Google-Konto, das die passenden Berechtigungen für die Search-Console-Property hat.

Sende dein Google-Passwort, den OAuth-Autorisierungscode oder ein Zugriffstoken niemals als gewöhnliche Chatnachricht. Die Authentifizierung ist ein eigener Schritt, den Client und Server übernehmen. Öffnet sich der Browser, ohne dass die Autorisierung abgeschlossen wird, geh zurück ins MCP-Menü und prüfe den Verbindungsstatus, bevor du es erneut versuchst.

In manchen Umgebungen lässt sich die OAuth-Anmeldung im Browser nicht abschließen. Für diesen Fall dokumentiert GSC Magic persönliche Zugriffstoken unter Connect → Access tokens im Dashboard. Eine Verbindung mit Token nutzt einen Header, zum Beispiel:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

Das ist eine Vorlage, keine funktionierenden Zugangsdaten. Ersetze den Platzhalter in einem sicheren lokalen Konfigurationsablauf und committe ihn nicht in Git. Brauchst du nur Analytics- und Indexierungs-Reports, erstelle ein schreibgeschütztes Token. Die Dokumentation der Plattform erklärt Ablauf, Widerruf und Berechtigungen von Token.

Schritt 3: prüfen, ob die Verbindung funktioniert

Beginne nicht mit „Auditiere meine gesamte Website und behebe alles“. Bitte um eine Antwort, die du nachprüfen kannst.

Liste die Google-Search-Console-Properties auf, auf die diese Verbindung zugreifen kann. Nenne die genauen Property-Kennungen und, falls verfügbar, die Berechtigungsstufen. Analysiere keine Property, bevor ich sie ausgewählt habe.

Das prüft mehrere Dinge auf einmal: Der Client findet die Tools des Servers, der Server kann sich bei Google authentifizieren, und dein Google-Konto sieht mindestens eine Property.

Wähle die genaue Property-Kennung aus, die du brauchst. Eine Property im Format sc-domain:example.com kann Subdomains einschließen. Eine URL-Präfix-Property wie https://www.example.com/ deckt eine engere Menge von URLs ab. Eine unbemerkte Abweichung kann einen Traffic-Vergleich falsch aussehen lassen, obwohl das Tool einwandfrei arbeitet.

Ist die Liste leer, prüfe zuerst dein Google-Konto und die Property-Berechtigungen. Nimm nicht gleich an, dass der Server defekt ist.

Schritt 4: einen ersten nützlichen SEO-Vergleich ausführen

Eine gute erste Aufgabe ist eng gefasst, messbar und leicht zu wiederholen:

Vergleiche für die gewählte Search-Console-Property die letzten 28 vollständigen Berichtstage mit den 28 Tagen davor. Zeig die genauen Zeiträume sowie Gesamtklicks, Impressionen und CTR und liste dann die zehn Seiten mit den größten absoluten Klickverlusten auf. Verwende Search-Console-Daten, keine Schätzungen. Kennzeichne mögliche Erklärungen als Hypothesen.

Diesen Report kannst du in der Leistungsansicht der Search Console gegenprüfen. Weichen die Summen ab, kontrolliere Aggregationsoptionen, Zeitzonen, Suchtypen und ob die Daten endgültig sind. Google zählt Klicks und Impressionen nach den eigenen Berichtsdefinitionen, nicht nach den Sitzungsregeln von GA4.

Bitte Claude Code anschließend, eine Seite genauer zu untersuchen:

Vergleiche für die URL mit dem größten Verlust ihre zehn wichtigsten Suchanfragen zwischen den Zeiträumen. Gruppiere wesentliche Veränderungen nach Gerät und Land. Sag mir, welche Beobachtungen eine Untersuchung des Seiten-Templates rechtfertigen und welche nicht.

Hier wird ein Coding-Assistent nützlich. Hat die Seite auf Mobilgeräten an Sichtbarkeit verloren, könntest du die mobile Navigation, das responsive Layout und das Rendering prüfen. Hat sie bei einer schmalen Gruppe von Suchanfragen Impressionen verloren, schaust du dir Inhalt und interne Links der Seite an. Lass das Modell aber keine Korrelation als Beweis behandeln.

Schritt 5: die Daten mit dem Code deiner Website verknüpfen

Angenommen, die Search Console zeigt eine wichtige Produkt-URL mit sinkender Klickrate. Bitte Claude Code, die Route oder das Template zu finden, das für HTML-Titel, Beschreibung und Überschriften der Seite zuständig ist.

Eine sinnvolle Reihenfolge sieht so aus:

1. Such die Seite oder das Template in deinem Projekt.
2. Sieh dir den vorhandenen Titel, die Canonical-URL, die Überschriftenstruktur und den Hauptinhalt an.
3. Lies die Suchanfragen, die zu Impressionen für die Seite geführt haben.
4. Schlag eine begrenzte Verbesserung vor, die zum tatsächlichen Inhalt der Seite passt.
5. Zeig einen Diff, bevor du Änderungen vornimmst.
6. Führe deinen üblichen Build und deine Tests aus.
7. Halte das Datum des Deployments fest, damit du später vergleichen kannst.

Nicht jede Seite mit niedriger CTR braucht einen neuen Titel. Eine Seite kann für breite informationsorientierte Suchanfragen ranken, bei denen kaum Klickabsicht besteht, oder ihre durchschnittliche Position hat sich verändert. Nutze die Anleitung zur Analyse niedriger CTR, bevor du Metadaten anhand einer einzigen Zahl umschreibst.

Sag Claude Code nie, es solle Seiten löschen oder weiterleiten, nur weil zwei URLs sich eine Suchanfrage teilen. Das kann mehr Schaden anrichten als das ursprüngliche Problem.

So baust du einen wiederholbaren Wochen-Workflow

Du kannst den Analyse-Prompt in deinen Notizen oder im internen Runbook deines Projekts ablegen. Claude Code muss sich nicht an die vorige Unterhaltung erinnern, wenn der Prompt die Parameter des Reports festlegt.

Fordere jedes Mal dieselben vollständigen 7- oder 28-Tage-Zeiträume an und nenne die gewählte Property. Der Assistent soll eine Tabelle mit URL, Klicks in beiden Zeiträumen, absoluter Veränderung, relativer Veränderung und dem größten Beitrag auf Suchanfragen-Ebene zurückgeben. Halte die erste Version rein lesend.

Lass dir nach dem Report einen Aktionsplan mit höchstens drei Punkten erstellen. Ein brauchbarer Punkt hat ein beobachtetes Signal, eine vorgeschlagene Prüfung, eine verantwortliche Person und eine Möglichkeit, das Ergebnis zu messen.

Zum Beispiel: „Die Dokumentationsseite hat 120 Klicks verloren, vor allem bei Suchanfragen zur Einrichtung auf dem Desktop. Prüfe, ob die Seite die Anleitung für die aktuelle Version der Integration noch korrekt beantwortet; aktualisiere nur, wenn der Inhalt veraltet ist.“ Das ist viel konkreter als „Verbessere die Inhaltsqualität.“

Wenn du Skripte oder Agenten zeitgesteuert laufen lässt, kontrolliere wiederholte Aufrufe und beachte die Kontingente der Search Console API. Für ein wöchentliches Reporting sollten keine Hunderte doppelter Anfragen nötig sein.

Häufige Probleme beheben

Meldet der Assistent einen Tool-Fehler, lies die eigentliche Fehlermeldung, bevor du einen anderen Prompt probierst. Eine umformulierte Anfrage behebt weder ein widerrufenes Token noch eine Website, auf die dein Konto nicht zugreifen kann.

Googles Referenz zur Search Analytics API dokumentiert Datumsgrenzen, Dimensionen, Limits und Aggregation. Wer diese Grenzen kennt, vermeidet erstaunlich viele falsche SEO-Diagnosen.

Berechtigungen und Sicherheit, wenn Code und Suchdaten zusammenkommen

Die Verbindung von Search-Console-Daten mit einem Coding-Assistenten ist mächtig, weil der Assistent möglicherweise auch Zugriff auf das Dateisystem hat. Genau deshalb solltest du Untersuchung und Umsetzung trennen.

Behandle Reporting-Tools nach Möglichkeit als schreibgeschützt. Lass dir Codeänderungen als Diff vorschlagen und prüfe sie, bevor der Assistent etwas schreibt oder deployt. Nutze deinen normalen Git-Workflow und deine üblichen Prüfungen. Arbeitest du mit Kunden-Properties, kombiniere die Daten unabhängiger Kunden nicht in einem Report.

GSC Magic dokumentiert schreibgeschützte Token und eine getrennte Steuerung für den Schreibmodus. Die Google-Search-Console-Tools umfassen das Lesen von Analytics-Daten und des Status indexierter URLs, während administrative Aktionen wie das Einreichen einer Sitemap eine stärkere Berechtigung erfordern. Diese Trennung ist wichtiger als die Zahl der Tools, die ein Connector auflistet.

Denk daran, dass die URL Inspection API von Google keine Indexierung beantragt. Ihre Ergebnisse zur indexierten Version unterscheiden sich von einem Live-Test der URL. Die separate Google Indexing API unterstützt nur eingeschränkte Inhaltstypen und taugt nicht als Abkürzung für gewöhnliche Seiten.

Häufig gestellte Fragen

Kann Claude Code ohne MCP direkt auf die Google Search Console zugreifen?

Standardmäßig nicht. Du bräuchtest einen anderen autorisierten Weg, etwa ein eigenes API-Skript oder einen importierten Export. MCP ist ein Standardweg, solche Aufrufe als Tools bereitzustellen, die Claude Code nutzen kann.

Ist das dieselbe Einrichtung wie bei Claude im Web?

Nein. Claude Code nutzt eine MCP-Konfiguration, die über die CLI verwaltet wird. Die Claude-Web-App hat eine eigene Oberfläche für Connectors. Die Datenquelle kann dieselbe sein, die Schritte zur Verbindung unterscheiden sich aber.

Kann Claude Code technische SEO-Probleme automatisch beheben?

Es kann dir helfen, Dateien zu bearbeiten, auf die es zugreifen darf, aber Belege aus der Search Console beweisen nicht, dass jede vorgeschlagene Änderung richtig ist. Prüfe Diffs, teste Builds und lass das Deployment von einem Menschen freigeben.

Kennt der Agent meine Google-Conversions?

Nur wenn du eine passende Analytics-Quelle autorisierst. Die Search Console berichtet Klicks und Impressionen in der Suche; für Sitzungen und Schlüsselereignisse brauchst du GA4.

Mit welcher Aufgabe sollte ich anfangen?

Beginne mit dem Vergleich zweier vollständiger 28-Tage-Zeiträume und den zehn Seiten mit den größten Klickverlusten. Diese Zahlen kannst du bestätigen, bevor Codeänderungen ins Spiel kommen.

Fazit für die Praxis

Claude Code spielt seine Stärke aus, wenn es als Brücke zwischen gemessenem Suchverhalten und der Website dient, die du tatsächlich verbessern kannst. Nutze den Connector, um ein Problem zu erkennen, die Codebasis, um es zu untersuchen, und deinen normalen Review-Prozess, um Änderungen sicher umzusetzen.

Möchtest du die aktuell dokumentierten Tools, Token-Optionen und Verbindungsmöglichkeiten genau kennen, lass die Dokumentation von GSC Magic beim Konfigurieren deines Clients geöffnet. Anregungen für weitere Analysen findest du in unseren 25 Prompts für SEO-Agenten.