GSC Magic-dokumentasjon

Hva er GSC Magic

GSC Magic er en hostet MCP-server. Du logger inn én gang, legger til én URL i AI-klienten din, og agenten kan lese søkedataene dine direkte i stedet for å jobbe med CSV-eksporter og skjermbilder.

Underveis viser dashbordet på app.gscmagic.com de samme dataene som diagrammer, beholder en historikk som er lengre enn Googles 16 måneder, sender varsler og logger alt agentene dine gjør.

Hurtigstart

1. Opprett kontoen din. Åpne dashbordet og fortsett med Google, eller opprett en konto med e-post og passord (du bekrefter adressen via e-post). Bruk Google-kontoen som eier Search Console-eiendommene dine.
2. Gi tilgang. Den første innloggingen ber Google én gang om tilgang til Search Console (lese og skrive) og skrivebeskyttet Google Analytics 4. Skriveverktøy tilbys bare på Pro og Agency, og du kan slå dem av i Settings → Write access.
3. Importer nettstedene dine. På Welcome-skjermen velger du eiendommene som skal legges til. GSC Magic viser de mest trafikkerte først og respekterer nettstedsgrensen i planen din. Bing-nettsteder og GA4-eiendommer med samme vertsnavn knyttes automatisk til nettstedet.
4. Koble til AI-klienten din. Følg AI-klienter nedenfor. Endepunktet er https://mcp.gscmagic.com/mcp.
5. Spør om noe. Begynn med «List opp nettstedene mine i GSC Magic.» Prøv deretter en prompt fra Eksempelprompter.

Siden Connect i dashbordet har de samme instruksjonene, med knapper som gjør det med ett klikk og en tilkoblingstest.

AI-klienter

Endepunktet er det samme overalt:

https://mcp.gscmagic.com/mcp

Klienter som støtter OAuth, logger deg inn via en GSC Magic-side. For klienter som ikke gjør det, bruker du et tilgangstoken.

Claude (claude.ai, skrivebord og mobil)

1. Bruk Add to Claude: den åpner GSC Magic i Claudes connector-katalog. Eller åpne Customize → Connectors → Add custom connector, gi den navnet GSC Magic og lim inn endepunktet.
2. Klikk Connect ved siden av GSC Magic, fortsett med Google (eller e-post) og gi tilgang.
3. Aktiver GSC Magic i en ny chat under + → Connectors og spør «List opp nettstedene mine i GSC Magic.»

På Team- og Enterprise-planer kan bare en Owner legge til connectoren (Organization settings → Connectors → Add → Custom). Medlemmene klikker deretter selv på Connect. Connectorer som er lagt til på nett, vises i skrivebords- og mobilappene.

ChatGPT

1. Åpne Plugins på chatgpt.com, klikk på + og velg Add custom MCP server. Utviklermodus trengs ikke.
2. Gi den navnet GSC Magic, lim inn server-URL-en over og velg OAuth. La klient-ID og hemmelighet stå tomme, godta risikovarselet og klikk på Create.
3. Logg inn med Google (eller med e-postadressen og passordet ditt hos GSC Magic) når ChatGPT åpner GSC Magic-siden, skriv deretter @ i en ny chat og velg GSC Magic.

Egendefinerte MCP-servere krever en betalt ChatGPT-plan, og på Business kan bare eiere og administratorer av arbeidsområdet legge dem til. ChatGPT har ikke noe felt for en egendefinert header, så den kan ikke bruke et tilgangstoken. Hvis kontoen din fortsatt viser den eldre flyten <em>Settings → Apps → Create app</em>, bruker du samme navn, URL og OAuth-innstillinger der.

Claude Code

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

Skriv deretter /mcp, velg gsc-magic og velg Authenticate. Med et token i stedet for innlogging i nettleseren:

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

Cursor

Legg dette til i ~/.cursor/mcp.json, og klikk deretter Connect ved siden av gsc-magic i Settings → MCP:

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

Eldre Cursor-versjoner fullfører innloggingen på cursor://, som GSC Magic ikke godtar. Bruk et token der:

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

VS Code, Windsurf og andre

Alle klienter som snakker ekstern MCP over Streamable HTTP, fungerer. Gi dem endepunktet og, hvis de ikke støtter OAuth, denne forespørselsheaderen:

Authorization: Bearer gsm_YOUR_TOKEN

Siden Connect i dashbordet lister ferdige kodebiter for VS Code, Windsurf, Hermes Agent, OpenClaw, Grok og DeepSeek.

Tilgangstokener

Et tilgangstoken (gsm_…) lar en klient koble til uten innlogging i nettleseren. Det passer for skript, automatiseringsverktøy og klienter uten OAuth.

• Opprett ett i dashbordet under Connect → Access tokens (eier eller admin for arbeidsområdet). Hele tokenet vises bare én gang. Lagre det i klientens egen konfigurasjon, aldri i en chat.
• Tokener utløper etter 365 dager som standard. Du kan velge en annen levetid på opptil 730 dager, eller ingen utløpsdato.
• Kryss av for Read-only for å gjøre et token ute av stand til å skrive, uansett hva planen din tillater.
• Et token fungerer bare på MCP-endepunktet, ikke på dashbord-API-et, og kan tilbakekalles når som helst. Tilbakekallingen trer i kraft umiddelbart.
• Knappen Test connection på Connect-siden sjekker at et endepunkt og et token fungerer.

Datakilder

Tilkoblet er ikke det samme som knyttet. Tilgang til GA4 eller en Bing-nøkkel gjør bare at eiendommer kan oppdages. For å se data på Overview-siden må du knytte en GA4-eiendom og et Bing-nettsted til hvert nettsted under Sites. Sources viser hvor mange nettsteder som er knyttet.

Hver kilde har Reconnect og Disconnect. Hvis du kobler fra GA4, slutter GSC Magic å lese den og fjerner GA4-radene vi har lagret. Google-tilkoblingen din og Search Console forblir som de er.

Dashbord

Historikk. Etter at du har lagt til et nettsted, etterfyller GSC Magic opptil 16 måneder med daglige data (14 dager på Free) og oppdaterer deretter hver sjette time. Oppgraderer du planen, hentes de eldre månedene inn. Du kan eksportere eller slette den lagrede historikken når som helst.

Varsler og oppsummering

På Pro og Agency sjekker GSC Magic nettstedene dine etter hver synkronisering og sender deg en e-post når noe trenger oppmerksomhet. Varslene sendes på e-post til eieren av arbeidsområdet. Hver melding har en lenke for å melde seg av.

• Trafikkfall: en side mistet en stor andel av klikkene sine (30 % som standard).
• Indeksering: en side som hadde trafikk, sluttet å vises.
• Kannibalisering: to av sidene dine begynte å dele et søkeord.
• Rangering: et viktig søkeord falt flere posisjoner.
• AI-trafikk: økter fra AI-assistenter hoppet opp (krever GA4).

Du kan redigere terskler, slå regler av og slette dem (med Angre i noen sekunder). En ukentlig oppsummering sammenfatter nettstedene dine. På Free forhåndsviser kortet What changed på Overview hva disse reglene ville ha funnet. Hvert funn rapporteres én gang per uke.

Eksempelprompter

Bytt ut example.com med nettstedet ditt. Agenten velger riktige verktøy selv.

Flere idéer finner du i promptbiblioteket.

Verktøyreferanse

Verktøy merket skriv endrer noe i Google, Bing eller IndexNow. De tilbys bare agenten på Pro og Agency mens skrivemodus er på i Settings (den slås på når Google gir full tilgang til Search Console ved innlogging), og kilden tillater det. Alt annet er skrivebeskyttet.

Planer og grenser

• 7 dagers Pro-prøveperiode på nye kontoer, uten kort. Når den er over, går kontoen tilbake til Free. Én prøveperiode per e-postadresse.
• Hvert kall til et verktøy teller, også mislykkede. Døgngrensen nullstilles ved midnatt UTC.
• Hvis en plan utløper og du har flere nettsteder enn den nye planen tillater, spør dashbordet hvilke du vil beholde, og MCP-endepunktet settes på pause til du har valgt.
• Betalinger og fakturaer håndteres av Polar. Si opp når som helst. Planen forblir aktiv til slutten av perioden du har betalt for.

Team og roller

Agency-planen inkluderer fem plasser, eieren medregnet. Alle jobber i eierens arbeidsområde, med eierens data og plan.

Kundegrupper begrenser en person til utvalgte nettsteder. Et medlem eller en admin i en gruppe ser bare disse nettstedene i dashbordet, i varsler og via MCP, og ingenting annet. Underdomener regnes som separate nettsteder, så du kan gi a.com til én kunde og blog.a.com til en annen. Invitasjoner sendes på e-post og er gyldige i sju dager.

Sikkerhet og personvern

• Google- og Bing-legitimasjon krypteres ved lagring. Tilgangstokener lagres bare som hasher.
• Agenten din ser bare data fra kontoer du har koblet til, avgrenset til arbeidsområdet og rollen din.
• Gratiskontoer er skrivebeskyttet. På Pro og Agency er skriveverktøy tilgjengelige til eieren slår av skrivemodus i Settings. Medlemmer er alltid skrivebeskyttet, og hvert token kan tvinges til å være skrivebeskyttet.
• Økter utløper etter 14 dagers inaktivitet. Sensitive handlinger, som å slette kontoen din, krever en nylig innlogging.
• Eksporter alt vi har om deg fra Settings, eller slett kontoen og dataene dine der. Aktive betalte abonnementer må sies opp først.

Detaljer finner du i personvernerklæringen og vilkårene. For å melde fra om en sårbarhet, skriv til support@gscmagic.com.

Feilsøking

Står du fortsatt fast? Skriv til support@gscmagic.com med klienten du bruker og feilmeldingen. Ta aldri med et tilgangstoken.

Raske svar