Slik kobler du Google Search Console til Claude Code med MCP

Koble Claude Code til Google Search Console med en ekstern MCP-server, test autentiseringen og kjør ekte SEO-sjekker fra terminalen.

TL;DR

Du kan gi Claude Code tilgang til Google Search Console-dataene dine ved å legge til en MCP-server med autentisering. For GSC Magic kjører du claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp, åpner /mcp, godkjenner tilkoblingen og ber Claude liste opp eiendommene du har tilgang til. Kjør en liten, skrivebeskyttet spørring før du stoler på en større SEO-revisjon.

Hvorfor koble Search Console til en kodeassistent?

Claude Code er nyttig når SEO-arbeidet berører selve nettstedet. Du kan gå gjennom maler, rette omdirigeringer, endre sidetitler, teste en build og se over et områdekart i det samme utviklingsmiljøet. Men kildekoden kan ikke fortelle deg hvilken side som mistet 300 Google-klikk forrige uke.

Uten tilgang til Search Console kan en assistent se på en side og komme med fornuftige forslag. Den kan ikke skille mellom et høyt prioritert problem og noe ingen søker etter. Det skillet betyr mye når tiden er knapp.

En MCP-tilkobling gir deg en manglende kilde til belegg. Du kan be Claude Code finne de berørte URL-ene i Search Console, sammenligne dem med malene i den lokale koden og forberede kodeendringer som bygger på en faktisk undersøkelse.

Denne guiden dekker arbeidsflyten i terminalen med Claude Code, ikke den vanlige connectoren i Claude på nett. Jobber du mest i nettleseren, kan du bruke vår oppsettguide for Claude og Search Console.

Dette trenger du før du kjører en kommando

Du trenger Claude Code installert og fungerende i en terminal, en Google-konto med tilgang til Search Console-eiendommen du vil bruke, og en MCP-server som kan hente dataene fra den eiendommen. Serveren kan være selvhostet eller ekstern.

Trinnene under bruker GSC Magics hostede endepunkt. Ifølge dokumentasjonen til GSC Magic godtar det Streamable HTTP som transport og støtter innlogging med OAuth eller et tilgangstoken. Kontoen din må være opprettet og tjenesten tilgjengelig. At URL-en er gyldig, betyr ikke automatisk at autentiseringen har lykkes.

Begynn med å bekrefte at Claude Code selv kjører. Åpne det i et vanlig prosjekt og sjekk at du kan skrive inn prompter. Du trenger ikke klone hele produksjonsnettstedet bare for å teste en skrivebeskyttet tilkobling til Search Console.

Avgjør før du kobler til om arbeidet gjelder ett nettsted eller flere. Det er lett å velge feil Search Console-eiendom når en Google-konto har tilgang til kundenettsteder, staging-domener og gamle URL-prefikseiendommer.

Steg 1: legg til det eksterne MCP-endepunktet

Åpne terminalen og kjør denne kommandoen:

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

Slik leser du den. claude mcp add registrerer en server i Claude Code. Transporten http angir at det er en ekstern MCP-tjeneste og ikke en lokal kjørbar fil. --scope user gjør connectoren tilgjengelig i konfigurasjonen på brukernivå. Det korte navnet gsc-magic er bare identifikatoren du ser i verktøylisten.

URL-en er det eksterne endepunktet som er dokumentert for GSC Magic. Det er ikke URL-en til Search Console-eiendommen din, områdekartet til nettstedet ditt eller et Google API-endepunkt.

Hvorfor bruke omfanget user? Hvis du gjør SEO-arbeid på tvers av flere lokale prosjekter, er en tilkobling på brukernivå praktisk. For et delt repositorium eller et sensitivt kundemiljø bør du lese reglene for konfigurasjonsomfang i Claude Code og teamets retningslinjer før du legger til eksterne integrasjoner.

Generell veiledning om MCP-kommandoen og transporter finner du i Anthropics dokumentasjon for Claude Code. Sjekk den hvis et CLI-alternativ endrer seg i en nyere versjon.

Steg 2: autentiser i Claude Code

Start Claude Code og skriv:

/mcp

Velg serveren gsc-magic. Hvis klienten tilbyr handlingen Authenticate, følger du den og fullfører innloggingen i nettleseren. Bruk Google-kontoen som har riktige tillatelser på Search Console-eiendommen.

Send aldri Google-passordet, OAuth-autorisasjonskoden eller et tilgangstoken som en vanlig chatmelding. Autentisering er et eget steg som klienten og serveren tar seg av. Hvis nettleseren åpnes, men godkjenningen aldri fullføres, går du tilbake til MCP-menyen og sjekker tilkoblingsstatusen før du prøver på nytt.

Noen miljøer kan ikke fullføre OAuth i nettleseren. I slike tilfeller dokumenterer GSC Magic personlige tilgangstokener under Connect → Access tokens i dashbordet. En tokenbasert tilkobling bruker en header, for eksempel:

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

Dette er en mal, ikke en fungerende legitimasjon. Bytt ut plassholderen i en sikker lokal konfigurasjon, og sjekk den aldri inn i Git. Trenger du bare analyse- og indekseringsrapporter, oppretter du et skrivebeskyttet token. Plattformens dokumentasjon forklarer utløp, tilbakekalling og tillatelser for tokener.

Steg 3: bekreft at tilkoblingen fungerer

Ikke begynn med «revider hele nettstedet og fiks alt». Be om ett svar du kan verifisere.

List opp Google Search Console-eiendommene denne tilkoblingen har tilgang til. Ta med nøyaktige eiendomsidentifikatorer og tillatelsesnivå hvis det er tilgjengelig. Ikke analyser noen eiendom før jeg har valgt den.

Dette sjekker flere ting på én gang: klienten finner verktøyene til serveren, serveren kan autentisere mot Google, og Google-kontoen din ser minst én eiendom.

Velg den nøyaktige eiendomsidentifikatoren du trenger. En eiendom på formen sc-domain:example.com kan omfatte underdomener. En URL-prefikseiendom som https://www.example.com/ dekker et snevrere sett med URL-er. Et uoppdaget misforhold kan få en trafikksammenligning til å se feil ut selv om verktøyet fungerer helt som det skal.

Hvis listen er tom, sjekker du først Google-kontoen og tillatelsene på eiendommen. Ikke anta at serveren er ødelagt.

Steg 4: kjør en nyttig første SEO-sammenligning

En god første oppgave er smal, målbar og lett å gjenta:

For den valgte Search Console-eiendommen: sammenlign de siste 28 hele rapporteringsdagene med de foregående 28 dagene. Vis nøyaktige datointervaller, totalt antall klikk, visninger og CTR, og list deretter de ti sidene med størst absolutt tap av klikk. Bruk data fra Search Console, ikke anslag. Merk mulige forklaringer som hypoteser.

Du kan kontrollere rapporten i ytelsesrapporten i Search Console. Hvis totalene avviker, sjekker du valg av aggregering, tidssoner, søketyper og om dataene er endelige. Google teller klikk og visninger etter sine egne rapporteringsdefinisjoner, ikke etter reglene for økter i GA4.

Be deretter Claude Code gå dypere inn i én side:

For URL-en med størst tap: sammenlign de ti viktigste søkeordene mellom periodene. Grupper vesentlige endringer etter enhet og land. Si hvilke observasjoner som begrunner en undersøkelse av sidemalen, og hvilke som ikke gjør det.

Her blir en kodeassistent virkelig nyttig. Hvis siden mistet synlighet på mobil, kan du se på mobilnavigasjon, responsiv layout og rendering. Hvis siden mistet visninger for en smal gruppe søkeord, kan du se på innholdet og de interne lenkene. Men ikke la modellen behandle korrelasjon som bevis.

Steg 5: knytt dataene til den faktiske nettstedskoden

Anta at Search Console peker ut en viktig produkt-URL med fallende klikkfrekvens. Be Claude Code finne ruten eller malen som er ansvarlig for HTML-tittelen, beskrivelsen og overskriftene på siden.

En fornuftig rekkefølge ser slik ut:

  1. Finn siden eller malen i prosjektet ditt.
  2. Gå gjennom eksisterende tittel, kanonisk URL, overskriftsstruktur og hovedinnhold.
  3. Les søkeordene som ga visninger for siden.
  4. Foreslå en begrenset forbedring som passer til sidens faktiske innhold.
  5. Vis en diff før du gjør endringer.
  6. Kjør den vanlige builden og testene dine.
  7. Noter ned dato for utrulling, så du kan sammenligne senere.

Ikke alle sider med lav CTR trenger en ny tittel. En side kan rangere for brede informasjonssøk med liten klikkintensjon, eller gjennomsnittlig posisjon kan ha endret seg. Bruk analyseguiden for lav CTR før du skriver om metadata ut fra ett enkelt tall.

Be aldri Claude Code om å slette eller omdirigere sider bare fordi to URL-er deler et søkeord. Det kan gjøre mer skade enn det opprinnelige problemet.

Slik bygger du en ukentlig arbeidsflyt du kan gjenta

Du kan lagre analyseprompten i notatene dine eller i prosjektets interne driftshåndbok. Claude Code trenger ikke huske den forrige samtalen hvis prompten angir parametrene for rapporten.

Be om de samme hele vinduene på 7 eller 28 dager hver gang, og ta med den valgte eiendommen. La assistenten returnere en tabell med URL, klikk i hver periode, absolutt endring, relativ endring og søkeordet som bidrar mest. Hold den første versjonen skrivebeskyttet.

Etter rapporten ber du om en handlingsplan begrenset til tre punkter. Et nyttig tiltak har et observert signal, én foreslått kontroll, en ansvarlig og en måte å måle resultatet på.

For eksempel: «Dokumentasjonssiden mistet 120 klikk, mest for søk om oppsett på desktop. Sjekk om siden fortsatt svarer på gjeldende versjon av integrasjonsinstruksjonene, og oppdater bare hvis innholdet er utdatert.» Det er mye mer handlingsrettet enn «Forbedre innholdskvaliteten».

Hvis du planlegger skript eller agenter, må du holde styr på gjentatte kall og respektere kvotene i Search Console API-et. En ukentlig rapport skal ikke trenge hundrevis av dupliserte forespørsler.

Feilsøking av vanlige problemer

Dette ser duSannsynlig neste kontroll
Serveren er registrert, men verktøyene manglerÅpne /mcp på nytt og sjekk transport og tilkoblingsstatus
OAuth åpner feil Google-kontoLogg ut av kontoen du ikke ville bruke, og se over identiteten som er godkjent
Verktøyene fungerer, men ingen nettsteder visesKontroller eierskap eller delegert tilgang i Search Console
En spørring returnerer ingen raderSjekk datoer, søketype, filtre og om eiendommen hadde data
En inspeksjonsforespørsel mislykkesSjekk at URL-en hører til eiendommen, tilgangsomfang, leverandørens kvote og om verktøyet er tilgjengelig
En rapport ser inkonsekvent utSammenlign nøyaktige datovinduer og aggregering per side mot per eiendom

Hvis assistenten melder en verktøyfeil, leser du selve feilmeldingen før du prøver en annen prompt. Å formulere spørringen på nytt løser ikke et tilbakekalt token eller et nettsted kontoen din ikke har tilgang til.

Googles referanse for Search Analytics API dokumenterer datogrenser, dimensjoner, begrensninger og aggregering. Å forstå disse grensene forhindrer overraskende mange feil SEO-diagnoser.

Tillatelser og sikkerhet når kode møter søkedata

Å koble Search Console-data til en kodeassistent er kraftig fordi assistenten kanskje også har tilgang til filsystemet. Nettopp derfor bør du holde undersøkelse og gjennomføring adskilt.

Behandle rapporteringsverktøy som skrivebeskyttede så langt det går. Be om forslag til kodeendringer som diff, og gå gjennom dem før assistenten skriver eller ruller ut noe. Bruk den vanlige Git-arbeidsflyten og kontrollene dine. Jobber du med kundeeiendommer, bør du unngå å blande data fra urelaterte kunder i samme rapport.

GSC Magic dokumenterer skrivebeskyttede tokener og egne innstillinger for skrivemodus. Verktøyene for Google Search Console omfatter lesing av analysedata og status for indekserte URL-er, mens administrative handlinger som å sende inn et områdekart krever sterkere tillatelse. Dette skillet er viktigere enn hvor mange verktøy connectoren lister opp.

Husk at Googles URL Inspection API ikke ber om indeksering. Resultatene for den indekserte versjonen er noe annet enn en live URL-test. Det separate Google Indexing API har begrensede innholdstyper som støttes, og bør ikke brukes som snarvei for vanlige sider.

Vanlige spørsmål

Kan Claude Code nå Google Search Console direkte, uten MCP?

Ikke som standard. Du trenger en annen godkjent vei, som et eget API-skript eller en importert eksport. MCP er én standard måte å gjøre disse kallene tilgjengelige som verktøy Claude Code kan bruke.

Er dette det samme oppsettet som Claude på nett?

Nei. Claude Code bruker en MCP-konfigurasjon som administreres fra CLI-et. Claude-appen på nett har sitt eget grensesnitt for connectorer. Datakilden kan være den samme, men trinnene for å koble til er ulike.

Kan Claude Code fikse tekniske SEO-problemer automatisk?

Den kan hjelpe deg å redigere filer den har tillatelse til å åpne, men belegg fra Search Console beviser ikke at hver foreslåtte endring er riktig. Gå gjennom diffene, test builds og krev menneskelig godkjenning før utrulling.

Kjenner agenten konverteringene mine?

Bare hvis du godkjenner en passende analysekilde. Search Console rapporterer klikk og visninger i søk. For økter og nøkkelhendelser trenger du GA4.

Hvilken oppgave bør jeg prøve først?

Begynn med en sammenligning av to hele perioder på 28 dager og de ti sidene med størst tap av klikk. Du kan bekrefte disse tallene før du tar i bruk noen kodeendringer.

Det praktiske resultatet

Claude Code brukes best som en bro mellom målt søkeatferd og nettstedet du faktisk kan forbedre. Bruk connectoren til å finne et problem, kodebasen til å undersøke det og den vanlige gjennomgangsprosessen din til å gjøre endringer på en trygg måte.

Vil du ha de verktøyene, tokenvalgene og tilkoblingsalternativene som er dokumentert akkurat nå, holder du dokumentasjonen til GSC Magic åpen mens du konfigurerer klienten. For idéer til videre analyse kan du bruke våre 25 prompter for SEO-agenter.

, Grunnlegger av GSC Magic

Łukasz bygger GSC Magic, MCP-serveren som gir AI-agenter tilgang til Google Search Console, Bing Webmaster Tools og GA4. Han skriver om hvordan du bruker Search Console-data sammen med Claude, ChatGPT og kodeagenter, og om SEO-arbeidsflytene disse verktøyene gjør mulige.

lukaszblania.comgithub.com/lumizone

Gi agenten din søkedataene dine.

GSC Magic kobler Claude, ChatGPT og Cursor til Google Search Console, Bing og GA4. Gratisplan, 7 dagers Pro-prøveperiode, uten kort.

Start gratis