GSC Magic -ohjeet

Mikä GSC Magic on

GSC Magic on pilvessä toimiva MCP-palvelin. Kirjaudut kerran, lisäät yhden URL-osoitteen tekoälysovellukseesi, ja agentti voi lukea hakudataasi suoraan CSV-vientien ja kuvakaappausten sijaan.

Samalla osoitteessa app.gscmagic.com toimiva hallintapaneeli näyttää saman datan kaavioina, säilyttää Googlen 16 kuukautta pidemmän historian, lähettää hälytyksiä ja kirjaa kaiken, mitä agenttisi tekevät.

Pikaopas

1. Luo tili. Avaa hallintapaneeli ja jatka Googlella tai luo tili sähköpostilla ja salasanalla (vahvistat osoitteen sähköpostitse). Käytä Google-tiliä, joka omistaa Search Console -resurssisi.
2. Salli pääsy. Ensimmäinen kirjautuminen pyytää Googlelta kerran oikeudet Search Consoleen (luku ja kirjoitus) ja vain luku -tilaiseen Google Analytics 4:ään. Kirjoitustyökaluja tarjotaan vain Pro- ja Agency-paketeissa, ja voit kytkeä ne pois kohdassa Settings → Write access.
3. Tuo sivustosi. Valitse lisättävät resurssit Welcome-näkymässä. GSC Magic näyttää vilkkaimmat ensin ja noudattaa pakettisi sivustorajaa. Bing-sivustot ja GA4-resurssit, joilla on sama isäntänimi, linkitetään automaattisesti.
4. Yhdistä tekoälysovelluksesi. Seuraa alla olevaa kohtaa Tekoälysovellukset. Päätepiste on https://mcp.gscmagic.com/mcp.
5. Kysy jotain. Aloita pyynnöllä ”Listaa sivustoni GSC Magic -työkalulla.” Kokeile sitten kehotetta kohdasta Esimerkkikehotteet.

Hallintapaneelin Connect-sivulla on samat ohjeet, yhden napsautuksen painikkeilla ja yhteystestillä.

Tekoälysovellukset

Päätepiste on kaikkialla sama:

https://mcp.gscmagic.com/mcp

OAuthia tukevat asiakasohjelmat kirjaavat sinut sisään GSC Magic -sivun kautta. Jos asiakasohjelma ei tue OAuthia, käytä käyttöoikeustunnusta.

Claude (claude.ai, työpöytä ja mobiili)

1. Käytä Add to Claude -painiketta: se avaa GSC Magicin Clauden liitinhakemistossa. Tai avaa Customize → Connectors → Add custom connector, anna nimeksi GSC Magic ja liitä päätepiste.
2. Napsauta kohdan GSC Magic vieressä Connect, jatka Googlella (tai sähköpostilla) ja salli pääsy.
3. Ota uudessa keskustelussa GSC Magic käyttöön kohdasta + → Connectors ja pyydä: ”Listaa sivustoni GSC Magic -työkalulla.”

Team- ja Enterprise-paketeissa vain Owner voi lisätä liittimen (Organization settings → Connectors → Add → Custom); jäsenet napsauttavat sen jälkeen itse Connect. Verkossa lisätyt liittimet näkyvät työpöytä- ja mobiilisovelluksissa.

ChatGPT

1. Avaa chatgpt.com-sivustolla Plugins, napsauta + ja valitse Add custom MCP server. Developer mode -tilaa ei tarvita.
2. Anna nimeksi GSC Magic, liitä yllä oleva palvelimen URL ja valitse OAuth. Jätä client ID ja secret tyhjiksi, hyväksy riskivaroitus ja napsauta Create.
3. Kirjaudu Googlella (tai GSC Magic -sähköpostillasi ja -salasanallasi), kun ChatGPT avaa GSC Magic -sivun, kirjoita sitten uuteen keskusteluun @ ja valitse GSC Magic.

Mukautetut MCP-palvelimet vaativat maksullisen ChatGPT-paketin; Business-paketissa vain työtilan omistajat ja ylläpitäjät voivat lisätä niitä. ChatGPT:ssä ei ole kenttää mukautetulle otsikolle, joten se ei voi käyttää käyttöoikeustunnusta. Jos tililläsi näkyy yhä vanhempi <em>Settings → Apps → Create app</em> -kulku, käytä siellä samaa nimeä, URL-osoitetta ja OAuth-asetuksia.

Claude Code

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

Kirjoita sitten /mcp, valitse gsc-magic ja valitse Authenticate. Jos käytät selainkirjautumisen sijaan tunnusta:

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

Cursor

Lisää tämä tiedostoon ~/.cursor/mcp.json ja napsauta sitten Connect kohdan gsc-magic vieressä sivulla Settings → MCP:

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

Vanhemmat Cursor-versiot päättävät kirjautumisen osoitteeseen cursor://, jota GSC Magic ei hyväksy. Käytä niissä tunnusta:

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

VS Code, Windsurf ja muut

Mikä tahansa asiakasohjelma, joka osaa etä-MCP:n Streamable HTTP:n yli, toimii. Anna sille päätepiste ja, jos se ei osaa OAuthia, tämä pyyntöotsikko:

Authorization: Bearer gsm_YOUR_TOKEN

Hallintapaneelin Connect-sivulla on valmiit koodinpätkät VS Codelle, Windsurfille, Hermes Agentille, OpenClawille, Grokille ja DeepSeekille.

Käyttöoikeustunnukset

Käyttöoikeustunnus (gsm_…) antaa asiakasohjelman yhdistää ilman selainkirjautumista. Se sopii skripteille, automaatiotyökaluille ja asiakasohjelmille, joissa ei ole OAuthia.

• Luo se hallintapaneelissa kohdassa Connect → Access tokens (työtilan omistaja tai ylläpitäjä). Koko tunnus näytetään kerran. Tallenna se asiakasohjelman omaan konfiguraatioon, älä koskaan chattiin.
• Tunnukset vanhenevat oletuksena 365 päivän kuluttua. Voit valita toisen käyttöiän aina 730 päivään asti tai ei lainkaan.
• Rastita Read-only, jos haluat tehdä tunnuksesta kirjoituskyvyttömän pakettisi sallimasta huolimatta.
• Tunnus toimii vain MCP-päätepisteessä, ei hallintapaneelin API:ssa, ja sen voi perua milloin tahansa. Peruutus tulee voimaan heti.
• Connect-sivun Test connection -painike tarkistaa, että päätepiste ja tunnus toimivat.

Datalähteet

Yhdistetty ei tarkoita linkitettyä. Pääsy GA4:ään tai Bing-avain vain tekee resurssit löydettäviksi. Nähdäksesi datan Overview-sivulla linkitä GA4-resurssi ja Bing-sivusto kuhunkin sivustoon kohdassa Sites. Sources näyttää, kuinka moni sivusto on linkitetty.

Jokaisella lähteellä on Reconnect ja Disconnect. GA4:n irrottaminen estää GSC Magic -palvelua lukemasta sitä ja poistaa tallentamamme GA4-rivit; Google-yhteytesi ja Search Console pysyvät ennallaan.

Hallintapaneeli

Historia. Kun olet lisännyt sivuston, GSC Magic täyttää jopa 16 kuukautta päiväkohtaista dataa taaksepäin (Free-paketissa 14 päivää) ja päivittää sen sitten kuuden tunnin välein. Paketin päivittäminen tuo mukaan vanhemmat kuukaudet. Voit viedä tai poistaa tallennetun historiasi milloin tahansa.

Hälytykset ja yhteenveto

Pro- ja Agency-paketeissa GSC Magic tarkistaa sivustosi jokaisen synkronoinnin jälkeen ja lähettää sähköpostia, kun jokin vaatii huomiota. Viestit menevät työtilan omistajalle sähköpostitse. Jokaisessa viestissä on linkki, jolla viestit voi lopettaa.

• Liikenteen lasku: sivu menetti suuren osan napsautuksistaan (oletuksena 30 %).
• Indeksointi: sivu, jolla oli liikennettä, lakkasi näkymästä.
• Kannibalisaatio: kaksi sivuasi alkoi jakaa kyselyn.
• Sijoitus: tärkeä kysely putosi useita sijainteja.
• Tekoälyliikenne: tekoälyavustajien istunnot hyppäsivät (vaatii GA4:n).

Voit muokata kynnysarvoja, kytkeä sääntöjä pois ja poistaa ne (Undo-mahdollisuus muutaman sekunnin ajan). Viikoittainen yhteenveto tiivistää sivustosi. Free-paketissa Overview’n What changed -kortti esikatselee, mitä nämä säännöt löytäisivät. Jokainen havainto raportoidaan kerran viikossa.

Esimerkkikehotteet

Korvaa example.com omalla sivustollasi. Agenttisi valitsee oikeat työkalut itse.

Lisää ideoita kehotekirjastossa.

Työkaluviite

Merkinnällä kirjoitus merkityt työkalut muuttavat jotain Googlen, Bingin tai IndexNow-palvelun puolella. Ne tarjotaan agentille vain Pro- ja Agency-paketeissa, kun kirjoitustila on päällä kohdassa Settings (se kytkeytyy päälle, kun Google myöntää kirjautumisen yhteydessä täyden pääsyn Search Consoleen) ja lähde sen sallii. Kaikki muu on vain luku -tilaista.

Paketit ja rajat

• 7 päivän Pro-kokeilu uusille tileille, korttia ei tarvita. Kokeilun päätyttyä tili palaa Free-pakettiin. Yksi kokeilu per sähköpostiosoite.
• Jokainen työkalukutsu lasketaan, myös epäonnistuneet. Päiväraja nollautuu UTC-ajan keskiyöllä.
• Jos paketti päättyy ja sivustoja on enemmän kuin uusi paketti sallii, hallintapaneeli kysyy, mitkä säilytetään, ja MCP-päätepiste on tauolla, kunnes valitset.
• Maksut ja laskut hoitaa Polar. Peruuta milloin tahansa; paketti pysyy aktiivisena maksetun jakson loppuun.

Tiimit ja roolit

Agency-paketti sisältää viisi paikkaa omistaja mukaan lukien. Kaikki työskentelevät omistajan työtilassa, datalla ja paketilla.

Asiakasryhmät rajaavat henkilön valittuihin sivustoihin. Ryhmän jäsen tai ylläpitäjä näkee vain nämä sivustot hallintapaneelissa, hälytyksissä ja MCP:n kautta, ei muuta. Aliverkkotunnukset lasketaan erillisiksi sivustoiksi, joten voit antaa a.com-sivuston yhdelle asiakkaalle ja blog.a.com-sivuston toiselle. Kutsut lähetetään sähköpostitse ja ovat voimassa seitsemän päivää.

Tietoturva ja tietosuoja

• Google- ja Bing-tunnukset salataan levossa. Käyttöoikeustunnukset tallennetaan vain tiivisteinä.
• Agenttisi näkee dataa vain yhdistämistäsi tileistä, rajattuna työtilaasi ja rooliisi.
• Free-tilit ovat vain luku -tilassa. Pro- ja Agency-paketeissa kirjoitustyökalut ovat käytettävissä, kunnes omistaja kytkee kirjoitustilan pois kohdassa Settings; jäsenet ovat aina vain luku -tilassa, ja jokaisen tunnuksen voi pakottaa vain luku -tilaan.
• Istunnot vanhenevat 14 käyttämättömän päivän jälkeen. Arkaluonteiset toimet, kuten tilin poistaminen, vaativat tuoreen kirjautumisen.
• Vie kaikki, mitä meillä on sinusta, kohdasta Settings, tai poista tilisi ja datasi siellä. Aktiiviset maksulliset tilaukset on peruttava ensin.

Lisätiedot ovat tietosuojaselosteessa ja käyttöehdoissa. Haavoittuvuudesta ilmoitat kirjoittamalla osoitteeseen support@gscmagic.com.

Vianetsintä

Oletko yhä jumissa? Kirjoita osoitteeseen support@gscmagic.com, kerro käyttämäsi asiakasohjelma ja virheilmoitus. Älä koskaan liitä mukaan käyttöoikeustunnusta.

Pikavastauksia