Ha SEO-sként használod a Claude Desktopot, előbb-utóbb eljutsz oda, hogy nem csak cikkeket akarsz íratni vele, hanem valódi adatokhoz is hozzá szeretnéd kötni. A Google Search Console az egyik leghasznosabb forrás erre – és van egy nyílt forráskódú MCP szerver, ami pont ezt csinálja meg.
Ez a cikk végigvezet az egész telepítési folyamaton: a Google Cloud beállítástól a Claude Desktop konfigig. Nem kell hozzá programozói tudás, csak egy kis türelem az első alkalommal.
Tartalomjegyzék
Mi az az MCP és miért érdekes SEO-soknak?
Az MCP (Model Context Protocol) egy olyan protokoll, amivel Claude Desktop külső eszközökhöz, adatforrásokhoz tud kapcsolódni. Ahelyett, hogy kimásolnád a GSC adataidat egy táblázatba, majd beillesztenéd Claude-ba, az MCP szerver ezt az adatkapcsolatot állandóvá teszi – Claude közvetlenül lekérdezi, amit kell.
A mcp-gsc repo ezt valósítja meg: 19 tool érhető el rajta keresztül, köztük keresési analitika lekérdezés, URL inspection, sitemap kezelés, időszak-összehasonlítás. Gyakorlatilag mindaz, amit a GSC webes felületén csinálnál, most természetes nyelvű kérdésekkel is elérhető. Megkérdezheted például, hogy „melyek azok a kulcsszavaim, ahol 11-20. pozíción vagyok, de magas az impresszió és alacsony a CTR” – és Claude lekéri az adatot, majd rögtön értelmezi is.
Mielőtt elkezded: a mappastruktúráról
Ha most kezded el bővíteni a Claude Desktop MCP szervereit, érdemes rögtön rendesen felépíteni a könyvtárstruktúrát. A legtöbb ember ezt utólag bánja meg.
A legjobb hely erre a ~/Developer/mcp-servers/ mappa. Ez a macOS-en „hivatalos” fejlesztői könyvtár (nem iCloud, nem Documents), és fontos, hogy ne tedd iCloud Drive vagy Synology Drive vagy Dropbox stb.. alá – a Python virtuális környezet több tízezer kis fájlból áll, amit a szinkron kliensek folyamatosan megpróbálnának szinkronizálni, ami lelassítja a gépet és értelmetlen hálózati forgalmat generál.
mkdir -p ~/Developer/mcp-servers
cd ~/Developer/mcp-servers
git clone https://github.com/AminForou/mcp-gsc.git
Ha később más MCP szervert is telepítesz, mind ide kerüljön – így mindig tudod, hol keresd őket.
Google Cloud Console beállítás
Ez az a rész, ami elsőre ijesztőnek tűnik, de valójában egyszer kell csak megcsinálni. A lényeg: létre kell hoznod egy OAuth klienst, amivel a szerver a Google API-hoz hozzáférhet.
Miért OAuth és nem service account?
Az mcp-gsc kétféle hitelesítést támogat: OAuth-t és service account-ot. Az OAuth az egyszerűbb választás a legtöbb SEO-s számára, ezért ezt javaslom.
A különbség lényege az, hogy kinek a nevében fér hozzá az eszköz az adathoz. OAuth esetén a saját Google-fiókodba jelentkezel be egyszeri engedélyezéssel, és a szerver pontosan azokhoz a GSC property-khez fér hozzá, amelyekhez neked is van hozzáférésed – semmi extra beállítás nem kell.
Service account esetén viszont egy robot-fiókot kapsz egy saját e-mail címmel, amit minden egyes GSC property-hez külön hozzá kell adni a Search Console beállításaiban. Ha több ügyfeled van, ez azt jelenti, hogy property-nként el kell végezned ezt a műveletet – ami jóval több munkával jár. A service account akkor éri meg, ha automatizált szkripteket futtatsz szerver oldalon, emberi felügyelet nélkül, de Claude Desktop mellé ez felesleges bonyolítás.
A Google Cloud projekt beállítása
- Nyisd meg a Google Cloud Console-t, és hozz létre egy új projektet (pl.
claude-google-search-console). - Engedélyezd a Search Console API-t: APIs & Services → Library → „Google Search Console API” → Enable.
- Menj a Google Auth Platform részbe (vagy a régebbi felületen: APIs & Services → OAuth consent screen).
- Töltsd ki az App Information részt: app name, support email. Az Audience lépésnél válaszd az External opciót – ez normális, ha nem Google Workspace-fiókot használsz.
- A Contact Information lépésnél add meg az e-mail címedet, majd kattints a Create gombra.
- Ezután menj a Clients fülre, és hozz létre egy új OAuth klienst: Create client → Application type: Desktop app → Name: pl.
Claude Desktop→ Create. - Töltsd le a generált JSON fájlt.
Egy dolgot ne felejts el: az app „tesztelés” módban indul, ami azt jelenti, hogy csak az általad engedélyezett tesztelők tudják használni. Menj az Audience fülre, és add hozzá a saját Gmail-címedet a Test users listához – különben az első bejelentkezésnél „access denied” hibát kapsz.
Telepítés: Python és a virtuális környezet
Az mcp-gsc szerver Pythonban íródott, ezért szükséged van Pythonra és az uv nevű csomagkezelőre. Az uv egy modern, gyors alternatíva a hagyományos pip-hez – a repo ezt ajánlja, és valóban egyszerűbb vele dolgozni.
Ha nincs telepítve az uv, egy paranccsal pótolható:
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.zshrc
Utána navigálj a repo mappájába, és hozd létre a virtuális környezetet:
cd ~/Developer/mcp-servers/mcp-gsc
uv venv .venv
source .venv/bin/activate
uv pip install -r requirements.txt
A .venv mappa a projekt összes Python függőségét tartalmazza, el van szigetelve a rendszer többi Python csomagjától. Amikor a telepítés lefut, valami ilyesmit kell látnod a prompt elején: (.venv) – ez jelzi, hogy a virtuális környezet aktív.
A letöltött JSON fájlt (a neve valami ilyesmi lesz: client_secret_9177...apps.googleusercontent.com.json) másold be a repo mappájába, és nevezd át egyszerűre:
mv ~/Downloads/client_secret_*.apps.googleusercontent.com.json ~/Developer/mcp-servers/mcp-gsc/client_secrets.json
Claude Desktop konfigurálása
A Claude Desktop egy JSON konfigfájlból olvassa be, hogy milyen MCP szervereket indítson el. A fájl helye macOS-en:
~/Library/Application Support/Claude/claude_desktop_config.json
Nyisd meg egy szövegszerkesztővel (pl. nano-val terminálból), és add hozzá a mcpServers blokkhoz a következőt:
"gscServer": {
"command": "/Users/teneved/Developer/mcp-servers/mcp-gsc/.venv/bin/python",
"args": ["/Users/teneved/Developer/mcp-servers/mcp-gsc/gsc_server.py"],
"env": {
"GSC_OAUTH_CLIENT_SECRETS_FILE": "/Users/teneved/Developer/mcp-servers/mcp-gsc/client_secrets.json"
}
}
Fontos: a command mezőben a .venv-en belüli Python binárisra kell mutatni, nem a rendszer Python-jára. Ha más MCP szerver már van a configban, a gscServer blokkot a meglévők mellé kell beilleszteni, nem felülírni az egész fájlt.
Mentés után indítsd újra a Claude Desktopot teljesen (Command+Q, majd újranyitás). Első indításkor megnyílik a böngésző, és a Google bejelentkezési oldalán engedélyezned kell a hozzáférést – ez az egyszeri OAuth flow, utána a token el lesz mentve.
Ha az újraindítás után „Server disconnected” hibát látsz, érdemes terminálból manuálisan is lefuttatni a szervert, hogy láthasd a pontos hibaüzenetet:
/Users/teneved/Developer/mcp-servers/mcp-gsc/.venv/bin/python /Users/teneved/Developer/mcp-servers/mcp-gsc/gsc_server.py
Mire használható a gyakorlatban?
Ha minden rendben van, a Claude Desktop tools listájában megjelenik a gscServer és az alatta elérhető eszközök. Néhány hasznos prompt, amivel azonnal el tudsz indulni:
- „Listázd az összes GSC property-t a fiókban” – gyors áttekintés, hogy minden property elérhető-e
- „Mutasd a valamilyenwebaruhazneve.hu keresési teljesítményét az elmúlt 28 napban” – kattintás, megjelenés, CTR, átlagpozíció
- „Hasonlítsd össze január és február teljesítményét” – trend azonosítás
- „Melyek azok a kulcsszavak, ahol 11-20. pozíción vagyok és magas az impresszió?” – quick win lehetőségek feltárása
- „Ellenőrizd, hogy ezek az URL-ek indexelve vannak-e” – több URL egyszerre
Claude nemcsak lekéri az adatot, hanem azonnal értelmezi és vizualizálja is – chart-okat, összehasonlításokat, akciótervet is kér rajta keresztül, ha úgy fogalmazod meg a promptot.
Az mcp-gsc szerver tehát nem egy adatexport eszköz, hanem egy párbeszéd-alapú SEO elemzési felület. Ha megszokod, hogy a GSC kérdéseidet ide teszed fel, hamar rájössz, hogy sokkal gyorsabb választ kapsz, mint a webes felületen keresgélve.
GYIK
Kell programozói tudás a telepítéshez?
Nem kell. Néhány terminálparancsot be kell gépelni, de ezek copy-paste szintű műveletek – semmi olyat nem kell értened, amit itt ne magyaráznának el. Ha valaha csináltál már bármit terminálban, ez nem lesz nehezebb annál.
Miért kell Google Cloud projekt, ha csak a saját GSC adatomhoz akarok hozzáférni?
A Google API-k így működnek: minden alkalmazásnak, ami a Google adataihoz hozzáfér, regisztrálnia kell magát a Cloud Console-ban. Ez egy biztonsági mechanizmus – te hozod létre a „kapukulcsot”, amit aztán a saját gépeden futó szerver használ. Más nem fér hozzá az adataidhoz ezzel a kulccsal.
Biztonságos ez? A GSC adataim kikerülhetnek?
A szerver lokálisan fut a gépeden, nem egy külső szerveren. Az OAuth token is helyben tárolódik. Az adatok nem hagyják el a saját környezetedet – Claude Desktop és az MCP szerver közötti kommunikáció a gépen belül zajlik.
Mi a különbség az mcp-gsc és a már beépített gscServer connector között?
A claude.ai webes felületen van egy beépített GSC connector, de a Claude Desktop MCP szerver önálló, és más jogosultságokkal működik. Az mcp-gsc előnye, hogy a teljes API-t eléri, beleértve az URL inspection és sitemap funkciókat is, amik a beépített connectorban korlátozottabbak lehetnek.
Frissíteni kell majd a szervert?
Igen, alkalmanként. A ~/Developer/mcp-servers/mcp-gsc mappában egy git pull paranccsal frissítheted a repo-t, utána a .venv-ben uv pip install -r requirements.txt paranccsal a függőségeket is.
Szójegyzék
MCP (Model Context Protocol) – Anthropic által fejlesztett protokoll, amivel Claude Desktop külső adatforrásokhoz és eszközökhöz csatlakozhat. Az MCP szerver egy lokálisan futó közvetítő réteg a Claude és a külső API között.
OAuth – Nyílt hitelesítési szabvány, amivel egy alkalmazás a felhasználó nevében, de jelszava nélkül férhet hozzá külső szolgáltatásokhoz. Az egyszeri bejelentkezés után tokent kap, amit eltárol és újra felhasznál.
Service account – Google által generált robot-fiók, amely saját e-mail címmel rendelkezik. Automatizált folyamatokhoz hasznos, de manuálisan kell hozzárendelni minden adatforráshoz.
Virtual environment (.venv) – Izolált Python környezet, amiben a projekt függőségei a rendszer többi Python csomagjától elkülönítve telepíthetők. Így különböző projektek eltérő verziójú csomagokat használhatnak egymás zavarása nélkül.
uv – Modern Python csomagkezelő és környezetkezelő eszköz, amely gyorsabb és megbízhatóbb alternatívája a hagyományos pip+venv kombinációnak.
GSC (Google Search Console) – Google ingyenes eszköze, amivel nyomon követheted, hogyan jelenik meg a weboldalad a Google keresési eredményekben: kattintások, megjelenések, pozíciók, indexelési állapot, crawl hibák.
