GSC Magic-docs

Wat is GSC Magic

GSC Magic is een gehoste MCP-server. Je logt één keer in, voegt één URL toe aan je AI-client en de agent kan je zoekdata rechtstreeks lezen, in plaats van te werken met CSV-exports en screenshots.

Daarnaast toont het dashboard op app.gscmagic.com dezelfde data als grafieken, bewaart het historie die verder reikt dan de 16 maanden van Google, verstuurt het alerts en logt het alles wat je agents doen.

Snelstart

1. Maak je account aan. Open het dashboard en ga verder met Google, of maak een account met e-mail en wachtwoord (je bevestigt het adres per e-mail). Gebruik het Google-account dat eigenaar is van je Search Console-properties.
2. Geef toegang. Bij de eerste login vraagt Google eenmalig om Search Console (lezen en schrijven) en alleen-lezen Google Analytics 4. Schrijftools worden alleen aangeboden op Pro en Agency, en je kunt ze uitzetten in Settings → Write access.
3. Importeer je sites. Kies op het scherm “Welcome” de properties die je wilt toevoegen. GSC Magic toont de drukste eerst en houdt rekening met de sitelimiet van je plan. Bing-sites en GA4-properties met dezelfde host worden automatisch gekoppeld.
4. Verbind je AI-client. Volg hieronder AI-clients. Het endpoint is https://mcp.gscmagic.com/mcp.
5. Stel een vraag. Begin met “Toon mijn sites in GSC Magic.” Probeer daarna een prompt uit Voorbeeldprompts.

De pagina Connect in het dashboard bevat dezelfde instructies, met knoppen voor één klik en een verbindingstest.

AI-clients

Het endpoint is overal hetzelfde:

https://mcp.gscmagic.com/mcp

Clients die OAuth ondersteunen, laten je inloggen via een GSC Magic-pagina. Voor clients die dat niet doen, gebruik je een toegangstoken.

Claude (claude.ai, desktop en mobiel)

1. Gebruik Add to Claude: dat opent GSC Magic in de connectorcatalogus van Claude. Of open Customize → Connectors → Add custom connector, noem hem GSC Magic en plak het endpoint.
2. Klik op Connect naast GSC Magic, ga verder met Google (of e-mail) en geef toegang.
3. Schakel GSC Magic in een nieuwe chat in via + → Connectors en vraag: “Toon mijn sites in GSC Magic.”

Op Team- en Enterprise-plannen kan alleen een Owner de connector toevoegen (Organization settings → Connectors → Add → Custom); leden klikken daarna zelf op Connect. Connectors die je op het web toevoegt, verschijnen ook in de desktop- en mobiele apps.

ChatGPT

1. Open op chatgpt.com Plugins, klik op + en kies Add custom MCP server. Developer mode is niet nodig.
2. Noem hem GSC Magic, plak de server-URL hierboven en kies OAuth. Laat client-ID en secret leeg, accepteer de risicowaarschuwing en klik op Create.
3. Log in met Google (of met je e-mailadres en wachtwoord van GSC Magic) zodra ChatGPT de GSC Magic-pagina opent, typ daarna @ in een nieuwe chat en kies GSC Magic.

Aangepaste MCP-servers vragen een betaald ChatGPT-plan; op Business kunnen alleen workspace-eigenaren en -beheerders er een toevoegen. ChatGPT heeft geen veld voor een aangepaste header en kan dus geen toegangstoken gebruiken. Toont je account nog de oudere flow <em>Settings → Apps → Create app</em>, gebruik daar dan dezelfde naam, URL en OAuth-instellingen.

Claude Code

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

Typ daarna /mcp, kies gsc-magic en kies Authenticate. Met een token in plaats van inloggen via de browser:

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

Cursor

Voeg dit toe aan ~/.cursor/mcp.json en klik daarna op Connect naast gsc-magic in Settings → MCP:

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

Oudere Cursor-versies ronden het inloggen af op cursor://, wat GSC Magic niet accepteert. Gebruik daar een token:

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

VS Code, Windsurf en andere

Elke client die remote MCP via Streamable HTTP spreekt, werkt. Geef hem het endpoint en, als hij geen OAuth kan, deze request-header:

Authorization: Bearer gsm_YOUR_TOKEN

De Connect-pagina van het dashboard toont kant-en-klare snippets voor VS Code, Windsurf, Hermes Agent, OpenClaw, Grok en DeepSeek.

Toegangstokens

Met een toegangstoken (gsm_…) kan een client verbinden zonder in te loggen via de browser. Handig voor scripts, automatiseringstools en clients zonder OAuth.

• Maak er een aan in het dashboard onder Connect → Access tokens (workspace-eigenaar of beheerder). Het volledige token wordt één keer getoond. Bewaar het in de eigen configuratie van de client, nooit in een chat.
• Tokens verlopen standaard na 365 dagen. Je kunt een andere looptijd kiezen tot 730 dagen, of geen.
• Vink Read-only aan om een token niets te laten kunnen schrijven, wat je plan ook toestaat.
• Een token werkt alleen op het MCP-endpoint, niet op de dashboard-API, en kan op elk moment worden ingetrokken. Intrekken werkt direct.
• Met de knop Test connection op de Connect-pagina controleer je of een endpoint en token werken.

Databronnen

Verbonden is niet gekoppeld. Toegang tot GA4 of een Bing-sleutel maakt properties alleen vindbaar. Om data op de pagina Overview te zien, koppel je onder Sites een GA4-property en een Bing-site aan elke site. Sources toont hoeveel sites gekoppeld zijn.

Elke bron heeft Reconnect en Disconnect. Als je GA4 ontkoppelt, stopt GSC Magic met het lezen ervan en verwijdert het de opgeslagen GA4-rijen; je Google-verbinding en Search Console blijven zoals ze zijn.

Dashboard

Historie. Nadat je een site hebt toegevoegd, vult GSC Magic tot 16 maanden aan dagelijkse data aan (14 dagen op Free) en ververst daarna elke zes uur. Een hoger plan haalt de oudere maanden binnen. Je kunt je opgeslagen historie op elk moment exporteren of verwijderen.

Alerts en digest

Op Pro en Agency controleert GSC Magic je sites na elke synchronisatie en mailt je zodra er iets aandacht nodig heeft. Bezorging gaat per e-mail naar de workspace-eigenaar. Elk bericht heeft een afmeldlink.

• Verkeersdaling: een pagina verloor een groot deel van haar klikken (standaard 30 %).
• Indexering: een pagina die verkeer had, verschijnt niet meer.
• Kannibalisatie: twee van je pagina’s beginnen een zoekopdracht te delen.
• Ranking: een belangrijke zoekopdracht zakte meerdere posities.
• AI-verkeer: sessies van AI-assistenten sprongen omhoog (vraagt GA4).

Je kunt drempels aanpassen, regels uitzetten en verwijderen (met een Undo van een paar seconden). Een wekelijkse digest vat je sites samen. Op Free toont de What changed-kaart op Overview een voorproef van wat deze regels zouden vinden. Elke bevinding wordt één keer per week gemeld.

Voorbeeldprompts

Vervang example.com door je site. Je agent kiest zelf de juiste tools.

Meer ideeën in de promptbibliotheek.

Toolreferentie

Tools met het label schrijven wijzigen iets in Google, Bing of IndexNow. Ze worden alleen aan de agent aangeboden op Pro en Agency, zolang de schrijfmodus aan staat in Settings (die gaat aan zodra Google bij het inloggen volledige Search Console-toegang verleent) en de bron het toelaat. Al het andere is alleen-lezen.

Plannen en limieten

• 7 dagen Pro-proef voor nieuwe accounts, zonder creditcard. Daarna keert het account terug naar Free. Eén proefperiode per e-mailadres.
• Elke aanroep van een tool telt mee, ook mislukte. De daglimiet wordt om middernacht UTC gereset.
• Als een plan afloopt en je meer sites hebt dan het nieuwe plan toestaat, vraagt het dashboard welke je wilt houden en staat het MCP-endpoint op pauze tot je kiest.
• Betalingen en facturen worden verwerkt door Polar. Zeg op wanneer je wilt; het plan blijft actief tot het einde van de periode die je hebt betaald.

Teams en rollen

Het Agency-plan bevat vijf seats, de eigenaar meegerekend. Iedereen werkt in de workspace, met de data en het plan van de eigenaar.

Klantgroepen beperken een persoon tot geselecteerde sites. Een lid of beheerder in een groep ziet alleen die sites in het dashboard, in alerts en via MCP, en niets anders. Subdomeinen tellen als aparte sites, dus je kunt a.com aan de ene klant geven en blog.a.com aan een andere. Uitnodigingen worden per e-mail verstuurd en zijn zeven dagen geldig.

Beveiliging en privacy

• Google- en Bing-inloggegevens worden versleuteld opgeslagen. Toegangstokens worden alleen als hash bewaard.
• Je agent ziet alleen data van accounts die je hebt gekoppeld, beperkt tot je workspace en je rol.
• Free-accounts zijn alleen-lezen. Op Pro en Agency zijn schrijftools beschikbaar tot de eigenaar de schrijfmodus uitzet in Settings; leden zijn altijd alleen-lezen en elk token kan op alleen-lezen worden gezet.
• Sessies verlopen na 14 dagen inactiviteit. Gevoelige acties, zoals het verwijderen van je account, vragen een recente login.
• Exporteer alles wat we over je bewaren via Settings, of verwijder daar je account en data. Actieve betaalde abonnementen moeten eerst worden opgezegd.

Details staan in het privacybeleid en de voorwaarden. Een kwetsbaarheid melden? Mail naar support@gscmagic.com.

Problemen oplossen

Kom je er niet uit? Mail naar support@gscmagic.com met de client die je gebruikt en de foutmelding. Voeg nooit een toegangstoken toe.

Snelle antwoorden