GSC-Magic-Doku

Was ist GSC Magic

GSC Magic ist ein gehosteter MCP-Server. Du meldest dich einmal an, fügst deinem KI-Client eine URL hinzu, und der Agent kann deine Suchdaten direkt lesen, statt mit CSV-Exporten und Screenshots zu arbeiten.

Nebenbei zeigt dir das Dashboard unter app.gscmagic.com dieselben Daten als Diagramme, speichert eine Historie, die länger reicht als Googles 16 Monate, verschickt Alerts und protokolliert alles, was deine Agenten tun.

Schnellstart

1. Konto erstellen. Öffne das Dashboard und fahre mit Google fort, oder lege ein Konto mit E-Mail und Passwort an (die Adresse bestätigst du per E-Mail). Nutze das Google-Konto, dem deine Search-Console-Properties gehören.
2. Zugriff erlauben. Bei der ersten Anmeldung fragt Google einmal nach Search Console (Lesen und Schreiben) und schreibgeschütztem Google Analytics 4. Schreib-Tools gibt es nur in Pro und Agency, und du kannst sie unter Settings → Write access abschalten.
3. Websites importieren. Wähle auf dem Bildschirm „Welcome“ die Properties aus, die du hinzufügen willst. GSC Magic zeigt die meistbesuchten zuerst und berücksichtigt das Website-Limit deines Tarifs. Bing-Websites und GA4-Properties mit demselben Host werden automatisch verknüpft.
4. KI-Client verbinden. Folge unten den Hinweisen unter KI-Clients. Der Endpunkt lautet https://mcp.gscmagic.com/mcp.
5. Etwas fragen. Starte mit „Liste meine Websites in GSC Magic auf.“ Probiere dann einen Prompt aus den Beispiel-Prompts.

Die Seite Connect im Dashboard enthält dieselben Anleitungen, mit Ein-Klick-Buttons und einem Verbindungstest.

KI-Clients

Der Endpunkt ist überall derselbe:

https://mcp.gscmagic.com/mcp

Clients mit OAuth-Unterstützung melden dich über eine GSC-Magic-Seite an. Für Clients ohne OAuth nutzt du ein Zugriffstoken.

Claude (claude.ai, Desktop und Mobil)

1. Nutze Add to Claude: Der Button öffnet GSC Magic im Connector-Verzeichnis von Claude. Oder öffne Customize → Connectors → Add custom connector, nenne ihn GSC Magic und füge den Endpunkt ein.
2. Klicke neben GSC Magic auf Connect, fahre mit Google (oder E-Mail) fort und erlaube den Zugriff.
3. Aktiviere GSC Magic in einem neuen Chat unter + → Connectors und frag: „Liste meine Websites in GSC Magic auf.“

In Team- und Enterprise-Tarifen kann nur ein Owner den Connector hinzufügen (Organization settings → Connectors → Add → Custom); Mitglieder klicken danach selbst auf Connect. Im Web hinzugefügte Connectors erscheinen auch in den Desktop- und Mobil-Apps.

ChatGPT

1. Öffne auf chatgpt.com Plugins, klicke auf + und wähle Add custom MCP server. Der Entwicklermodus ist nicht nötig.
2. Nenne ihn GSC Magic, füge die Server-URL von oben ein und wähle OAuth. Lass Client-ID und Secret leer, akzeptiere die Risikowarnung und klicke auf Create.
3. Melde dich mit Google (oder mit deiner GSC-Magic-E-Mail und deinem Passwort) an, wenn ChatGPT die GSC-Magic-Seite öffnet, tippe dann in einem neuen Chat @ und wähle GSC Magic aus.

Benutzerdefinierte MCP-Server brauchen einen kostenpflichtigen ChatGPT-Tarif; in Business können nur Workspace-Owner und -Admins einen hinzufügen. ChatGPT hat kein Feld für einen eigenen Header und kann deshalb kein Zugriffstoken verwenden. Zeigt dein Konto noch den älteren Ablauf <em>Settings → Apps → Create app</em>, verwende dort denselben Namen, dieselbe URL und dieselben OAuth-Einstellungen.

Claude Code

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

Gib dann /mcp ein, wähle gsc-magic und dann Authenticate. Mit einem Token statt Browser-Anmeldung:

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

Cursor

Füge dies in ~/.cursor/mcp.json ein und klicke dann in Settings → MCP neben gsc-magic auf Connect:

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp"
    }
  }
}

Ältere Cursor-Versionen beenden die Anmeldung über cursor://, was GSC Magic nicht akzeptiert. Nutze dort ein Token:

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp",
      "headers": {
        "Authorization": "Bearer gsm_YOUR_TOKEN"
      }
    }
  }
}

VS Code, Windsurf und andere

Jeder Client, der Remote-MCP über Streamable HTTP spricht, funktioniert. Gib ihm den Endpunkt und, falls er kein OAuth kann, diesen Request-Header:

Authorization: Bearer gsm_YOUR_TOKEN

Auf der Connect-Seite des Dashboards findest du fertige Snippets für VS Code, Windsurf, Hermes Agent, OpenClaw, Grok und DeepSeek.

Zugriffstoken

Ein Zugriffstoken (gsm_…) lässt einen Client ohne Browser-Anmeldung eine Verbindung aufbauen. Es eignet sich für Skripte, Automatisierungstools und Clients ohne OAuth.

• Erstelle eines im Dashboard unter Connect → Access tokens (Workspace-Owner oder Admin). Das vollständige Token wird nur einmal angezeigt. Speichere es in der Konfiguration des Clients, niemals in einem Chat.
• Token laufen standardmäßig nach 365 Tagen ab. Du kannst eine andere Laufzeit bis zu 730 Tagen wählen, oder keine.
• Setze den Haken bei Read-only, damit ein Token nicht schreiben kann, egal was dein Tarif erlaubt.
• Ein Token funktioniert nur am MCP-Endpunkt, nicht an der Dashboard-API, und lässt sich jederzeit widerrufen. Der Widerruf wirkt sofort.
• Mit dem Button Test connection auf der Connect-Seite prüfst du, ob Endpunkt und Token funktionieren.

Datenquellen

Verbunden heißt nicht verknüpft. Der Zugriff auf GA4 oder ein Bing-Key macht Properties nur auffindbar. Damit die Overview-Seite Daten zeigt, verknüpfe unter Sites pro Website eine GA4-Property und eine Bing-Website. Sources zeigt, wie viele Websites verknüpft sind.

Jede Quelle hat Reconnect und Disconnect. Wenn du GA4 trennst, liest GSC Magic es nicht mehr und entfernt die gespeicherten GA4-Zeilen; deine Google-Verbindung und die Search Console bleiben unverändert.

Dashboard

Historie. Nachdem du eine Website hinzugefügt hast, füllt GSC Magic bis zu 16 Monate tägliche Daten nach (in Free 14 Tage) und aktualisiert sie dann alle sechs Stunden. Ein Upgrade holt die älteren Monate nach. Du kannst deine gespeicherte Historie jederzeit exportieren oder löschen.

Alerts und Wochenübersicht

In Pro und Agency prüft GSC Magic deine Websites nach jeder Synchronisierung und schickt dir eine E-Mail, wenn etwas Aufmerksamkeit braucht. Die Zustellung erfolgt per E-Mail an den Workspace-Owner. Jede Nachricht enthält einen Abmeldelink.

• Traffic-Einbruch: Eine Seite hat einen großen Teil ihrer Klicks verloren (standardmäßig 30 %).
• Indexierung: Eine Seite, die Traffic hatte, erscheint nicht mehr.
• Kannibalisierung: Zwei deiner Seiten teilen sich plötzlich eine Suchanfrage.
• Ranking: Eine wichtige Suchanfrage ist um mehrere Positionen gefallen.
• KI-Traffic: Sitzungen von KI-Assistenten sind sprunghaft gestiegen (braucht GA4).

Du kannst Schwellenwerte bearbeiten, Regeln ausschalten und löschen (mit Undo für ein paar Sekunden). Eine Wochenübersicht fasst deine Websites zusammen. In Free zeigt die Karte What changed der Overview vorab, was diese Regeln finden würden. Jeder Fund wird einmal pro Woche gemeldet.

Beispiel-Prompts

Ersetze example.com durch deine Website. Welche Tools nötig sind, wählt dein Agent selbst.

Mehr Ideen findest du in der Prompt-Bibliothek.

Tool-Referenz

Mit Schreiben markierte Tools ändern etwas in Google, Bing oder IndexNow. Sie werden dem Agenten nur in Pro und Agency angeboten, solange der Schreibmodus in den Settings eingeschaltet ist (er ist automatisch an, sobald Google bei der Anmeldung vollen Search-Console-Zugriff gewährt) und die Quelle es zulässt. Alles andere ist schreibgeschützt.

Tarife und Limits

• 7 Tage Pro testen für neue Konten, ohne Kreditkarte. Danach fällt das Konto auf Free zurück. Eine Testphase pro E-Mail-Adresse.
• Jeder Tool-Aufruf zählt, auch fehlgeschlagene. Das Tageslimit wird um Mitternacht UTC zurückgesetzt.
• Endet ein Tarif und du hast mehr Websites, als der neue Tarif erlaubt, fragt das Dashboard, welche du behalten willst, und der MCP-Endpunkt pausiert, bis du dich entscheidest.
• Zahlungen und Rechnungen laufen über Polar. Jederzeit kündbar; der Tarif bleibt bis zum Ende des bezahlten Zeitraums aktiv.

Teams und Rollen

Der Agency-Tarif enthält fünf Plätze, den Owner eingerechnet. Alle arbeiten im Workspace, mit den Daten und im Tarif des Owners.

Kundengruppen beschränken eine Person auf ausgewählte Websites. Ein Member oder Admin in einer Gruppe sieht nur diese Websites, im Dashboard, in Alerts und über MCP, und sonst nichts. Subdomains zählen als eigene Websites, du kannst also a.com einem Kunden und blog.a.com einem anderen zuweisen. Einladungen werden per E-Mail verschickt und sind sieben Tage gültig.

Sicherheit und Datenschutz

• Google- und Bing-Zugangsdaten sind im Ruhezustand verschlüsselt. Zugriffstoken werden nur als Hashes gespeichert.
• Dein Agent sieht nur Daten aus Konten, die du verbunden hast, begrenzt auf deinen Workspace und deine Rolle.
• Free-Konten sind schreibgeschützt. In Pro und Agency sind Schreib-Tools verfügbar, bis der Owner den Schreibmodus in den Settings abschaltet; Mitglieder sind immer schreibgeschützt, und jedes Token lässt sich auf schreibgeschützt festlegen.
• Sitzungen laufen nach 14 Tagen Inaktivität ab. Sensible Aktionen wie das Löschen deines Kontos erfordern eine aktuelle Anmeldung.
• Exportiere alles, was wir über dich speichern, unter Settings, oder lösche dort dein Konto samt Daten. Aktive kostenpflichtige Abos müssen vorher gekündigt werden.

Details stehen in der Datenschutzerklärung und in den Nutzungsbedingungen. Eine Sicherheitslücke meldest du an support@gscmagic.com.

Fehlerbehebung

Immer noch nicht gelöst? Schreib an support@gscmagic.com und nenne den verwendeten Client und die Fehlermeldung. Schick niemals ein Zugriffstoken mit.

Kurze Antworten