Dokumentation för GSC Magic

Vad är GSC Magic

GSC Magic är en hostad MCP-server. Du loggar in en gång, lägger till en URL i din AI-klient, och agenten kan läsa dina sökdata direkt i stället för att utgå från CSV-exporter och skärmbilder.

Dessutom visar dashboarden på app.gscmagic.com samma data som diagram, sparar en historik som är längre än Googles 16 månader, skickar aviseringar och loggar allt som dina agenter gör.

Snabbstart

1. Skapa ditt konto. Öppna dashboarden och fortsätt med Google, eller skapa ett konto med e-post och lösenord (du bekräftar adressen via e-post). Använd det Google-konto som äger dina egendomar i Search Console.
2. Ge åtkomst. Vid första inloggningen ber vi Google en enda gång om åtkomst till Search Console (läsa och skriva) och skrivskyddad Google Analytics 4. Skrivverktyg erbjuds bara i Pro och Agency, och du kan stänga av dem i Settings → Write access.
3. Importera dina webbplatser. På skärmen ”Welcome” väljer du vilka egendomar som ska läggas till. GSC Magic visar de mest trafikerade först och respekterar planens gräns för antal webbplatser. Bing-webbplatser och GA4-egendomar med samma värdnamn kopplas automatiskt.
4. Anslut din AI-klient. Följ avsnittet AI-klienter nedan. Slutpunkten är https://mcp.gscmagic.com/mcp.
5. Ställ en fråga. Börja med ”Lista mina webbplatser i GSC Magic.” Prova sedan en prompt från Exempelprompter.

Sidan Connect i dashboarden har samma instruktioner, med knappar för ett klick och ett anslutningstest.

AI-klienter

Slutpunkten är densamma överallt:

https://mcp.gscmagic.com/mcp

Klienter som stöder OAuth loggar in dig via en sida hos GSC Magic. För klienter som inte gör det använder du en åtkomsttoken.

Claude (claude.ai, skrivbord och mobil)

1. Använd Add to Claude: den öppnar GSC Magic i Claudes connectorkatalog. Eller öppna Customize → Connectors → Add custom connector, döp den till GSC Magic och klistra in slutpunkten.
2. Klicka på Connect bredvid GSC Magic, fortsätt med Google (eller e-post) och ge åtkomst.
3. Aktivera GSC Magic under + → Connectors i en ny chatt och fråga ”Lista mina webbplatser i GSC Magic.”

I planerna Team och Enterprise kan bara en Owner lägga till connectorn (Organization settings → Connectors → Add → Custom), och medlemmarna klickar sedan på Connect själva. Connectors som läggs till på webben visas i appen för skrivbordet och i mobilappen.

ChatGPT

1. Öppna Plugins på chatgpt.com, klicka på + och välj Add custom MCP server. Developer mode behövs inte.
2. Döp den till GSC Magic, klistra in serverns URL ovan och välj OAuth. Lämna klient-ID och hemlighet tomma, godkänn riskvarningen och klicka på Create.
3. Logga in med Google (eller med din e-postadress och ditt lösenord hos GSC Magic) när ChatGPT öppnar sidan för GSC Magic, skriv sedan @ i en ny chatt och välj GSC Magic.

Anpassade MCP-servrar kräver en betald ChatGPT-plan, och i Business kan bara arbetsytans ägare och admins lägga till dem. ChatGPT har inget fält för en anpassad rubrik och kan därför inte använda en åtkomsttoken. Om ditt konto fortfarande visar det äldre flödet <em>Settings → Apps → Create app</em> använder du samma namn, URL och OAuth-inställningar där.

Claude Code

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

Skriv sedan /mcp, välj gsc-magic och välj Authenticate. Med en token i stället för inloggning i webbläsaren:

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

Cursor

Lägg till detta i ~/.cursor/mcp.json och klicka sedan på Connect bredvid gsc-magic i Settings → MCP:

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

Äldre versioner av Cursor avslutar inloggningen på cursor://, vilket GSC Magic inte accepterar. Använd en token där:

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

VS Code, Windsurf och andra

Alla klienter som talar fjärr-MCP över Streamable HTTP fungerar. Ge den slutpunkten och, om den inte klarar OAuth, den här förfrågningsrubriken:

Authorization: Bearer gsm_YOUR_TOKEN

Sidan Connect i dashboarden listar färdiga kodsnuttar för VS Code, Windsurf, Hermes Agent, OpenClaw, Grok och DeepSeek.

Åtkomsttoken

En åtkomsttoken (gsm_…) låter en klient ansluta utan inloggning i webbläsaren. Den passar skript, automationsverktyg och klienter utan OAuth.

• Skapa en i dashboarden under Connect → Access tokens (arbetsytans ägare eller admin). Hela token visas bara en gång. Spara den i klientens egen konfiguration, aldrig i en chatt.
• Token går som standard ut efter 365 dagar. Du kan välja en annan livslängd på upp till 730 dagar, eller ingen alls.
• Kryssa i Read-only så att en token inte kan skriva, oavsett vad din plan tillåter.
• En token fungerar bara mot MCP-slutpunkten, inte mot dashboardens API, och kan återkallas när som helst. Återkallelsen gäller direkt.
• Knappen Test connection på sidan Connect kontrollerar att en slutpunkt och en token fungerar.

Datakällor

Ansluten är inte detsamma som kopplad. Åtkomst till GA4 eller en Bing-nyckel gör bara att egendomar går att hitta. För att se data på sidan Overview kopplar du en GA4-egendom och en Bing-webbplats till varje webbplats under Sites. Sources visar hur många webbplatser som är kopplade.

Varje källa har Reconnect och Disconnect. När du kopplar från GA4 slutar GSC Magic läsa det och tar bort de GA4-rader vi har lagrat. Din Google-anslutning och Search Console påverkas inte.

Dashboard

Historik. När du har lagt till en webbplats fyller GSC Magic på upp till 16 månaders dagliga data bakåt (14 dagar i Free) och uppdaterar sedan var sjätte timme. Om du byter till en högre plan hämtas de äldre månaderna in. Du kan exportera eller radera din lagrade historik när som helst.

Aviseringar och sammanfattning

I Pro och Agency kontrollerar GSC Magic dina webbplatser efter varje synkronisering och skickar e-post när något behöver uppmärksamhet. Leveransen sker via e-post till arbetsytans ägare. Varje meddelande har en länk för att avregistrera sig.

• Trafikfall: en sida har förlorat en stor andel av sina klick (30 % som standard).
• Indexering: en sida som hade trafik har slutat visas.
• Kannibalisering: två av dina sidor har börjat dela på en sökfråga.
• Ranking: en viktig sökfråga har tappat flera positioner.
• AI-trafik: sessioner från AI-assistenter har ökat kraftigt (kräver GA4).

Du kan redigera tröskelvärden, stänga av regler och radera dem (med Ångra under några sekunder). En veckosammanfattning ger en överblick över dina webbplatser. I Free visar kortet What changed i Overview en förhandsvisning av vad reglerna skulle hitta. Varje fynd rapporteras en gång per vecka.

Exempelprompter

Ersätt example.com med din webbplats. Din agent väljer rätt verktyg själv.

Fler idéer finns i promptbiblioteket.

Verktygsreferens

Verktyg som är markerade med skriv ändrar något hos Google, Bing eller IndexNow. De erbjuds bara agenten i Pro och Agency när skrivläge är på i Settings (det slås på när Google beviljar fullständig åtkomst till Search Console vid inloggningen) och källan tillåter det. Allt annat är skrivskyddat.

Planer och gränser

• 7 dagars Pro-test för nya konton, utan kort. När det tar slut går kontot tillbaka till Free. Ett test per e-postadress.
• Varje anrop till ett verktyg räknas, även de som misslyckas. Den dagliga gränsen återställs vid midnatt UTC.
• Om en plan upphör och du har fler webbplatser än den nya planen tillåter frågar dashboarden vilka du vill behålla, och MCP-slutpunkten pausas tills du har valt.
• Betalningar och fakturor hanteras av Polar. Du kan säga upp när som helst, och planen förblir aktiv till slutet av den period du har betalat för.

Team och roller

Agency-planen inkluderar fem platser, ägaren inräknad. Alla arbetar i ägarens arbetsyta med ägarens data och plan.

Kundgrupper begränsar en person till utvalda webbplatser. En medlem eller admin i en grupp ser bara de webbplatserna i dashboarden, i aviseringar och via MCP, och ingenting annat. Underdomäner räknas som separata webbplatser, så du kan ge a.com till en kund och blog.a.com till en annan. Inbjudningar skickas via e-post och gäller i sju dagar.

Säkerhet och integritet

• Inloggningsuppgifter för Google och Bing krypteras i vila. Åtkomsttoken lagras bara som hashvärden.
• Din agent ser bara data från konton som du har anslutit, begränsade till din arbetsyta och din roll.
• Free-konton är skrivskyddade. I Pro och Agency är skrivverktygen tillgängliga tills ägaren stänger av skrivläget i Settings. Medlemmar är alltid skrivskyddade och varje token kan tvingas till skrivskyddat.
• Sessioner löper ut efter 14 inaktiva dagar. Känsliga åtgärder som att radera ditt konto kräver en nyligen genomförd inloggning.
• Exportera allt vi har om dig från Settings, eller radera ditt konto och dina data där. Aktiva betalda prenumerationer måste sägas upp först.

Detaljer finns i integritetspolicyn och användarvillkoren. För att rapportera en sårbarhet skriver du till support@gscmagic.com.

Felsökning

Kommer du fortfarande inte vidare? Skriv till support@gscmagic.com och ange vilken klient du använder och felmeddelandet. Ta aldrig med en åtkomsttoken.

Snabba svar