--- title: "Google Search Console MCP: jak podłączyłem GSC do Claude" description: "Jak podłączyłem Google Search Console do Claude przez serwer MCP: konto usługi, instalacja na Windows, dwa błędy po drodze i znaleziska na żywej stronie." url: "https://it-deweloper.pl/pl/blog/google-search-console-mcp" date: "2026-09-14T15:04:50+00:00" language: "pl-PL" --- [Przejdź do głównej treści](#tm-main) - [ Główna](https://it-deweloper.pl/pl "Strona główna studia internetowego IT Deweloper") - [Kontakt](https://it-deweloper.pl/pl/contact "Kontakt ze studiem IT Deweloper") - [ +48 731 190 041](tel:+48731190041 "Telefon") - [ office@it-deweloper.pl](mailto:office@it-deweloper.pl "E-mail") - [ Nowogródzka 4A, Białystok, Polska](https://maps.app.goo.gl/BNjvryytwRyv4omA7 "Adres") - [ WhatsApp](https://wa.me/48731190041 "WhatsApp") - [ Telegram](https://t.me/+48731190041 "Telegram") - [Koszt](https://it-deweloper.pl/pl/cost "Taryfy i koszt usług") - [CennikOrientacyjne ceny tworzenia stron internetowych](https://it-deweloper.pl/pl/cost/pricing "Ceny tworzenia stron internetowych") - [KalkulatorSamodzielna kalkulacja online](https://it-deweloper.pl/pl/cost/calculator "Oblicz koszt strony internetowej online") - [BriefOtrzymaj dokładną wycenę projektu](https://it-deweloper.pl/pl/cost/brief "Wypełnij brief na budowę strony internetowej") - [Rozwiązania](https://it-deweloper.pl/pl/web "Rozwiązania IT Deweloper w tworzeniu stron internetowych") - [Etapy pracy](https://it-deweloper.pl/pl/web/process "Etapy i terminy tworzenia strony") - [SEO](https://it-deweloper.pl/pl/web/seo "Pozycjonowanie stron: optymalizacja, linki, pozycje w Google") - [GEO](https://it-deweloper.pl/pl/web/geo "Optymalizacja GEO: promocja strony w odpowiedziach ChatGPT, Gemini i Perplexity") - [SI](https://it-deweloper.pl/pl/web/ai) - [Portfolio](https://it-deweloper.pl/pl/portfolio "Portfolio i przykłady realizacji") - [O nas](https://it-deweloper.pl/pl/about "O założycielu studia — Wiktor Parchimczyk") - [FAQ](https://it-deweloper.pl/pl/faq "Częste pytania o tworzenie stron internetowych") - [Blog](https://it-deweloper.pl/pl/blog "Artykuły o tworzeniu i promocji stron internetowych") - [ Русский ](https://it-deweloper.pl/ru/blog/google-search-console-mcp) - [ Polski ](https://it-deweloper.pl/pl/blog/google-search-console-mcp) - [ Беларуская ](https://it-deweloper.pl/be/blog/google-search-console-mcp) - [ English ](https://it-deweloper.pl/en/blog/google-search-console-mcp) - ![](https://it-deweloper.pl/templates/yootheme/assets/images/language.svg) Polski - [ Русский ](https://it-deweloper.pl/ru/blog/google-search-console-mcp) - [ Polski ](https://it-deweloper.pl/pl/blog/google-search-console-mcp) - [ Беларуская ](https://it-deweloper.pl/be/blog/google-search-console-mcp) - [ English ](https://it-deweloper.pl/en/blog/google-search-console-mcp) [ ![IT-Deweloper](https://it-deweloper.pl/images/Faviocon.svg)![IT-Deweloper](https://it-deweloper.pl/images/Logo-light.svg)](https://it-deweloper.pl/pl) [ Menu ](#tm-dialog) - [ Główna](https://it-deweloper.pl/pl "Strona główna studia internetowego IT Deweloper") - [Kontakt](https://it-deweloper.pl/pl/contact "Kontakt ze studiem IT Deweloper") - [ +48 731 190 041](tel:+48731190041 "Telefon") - [ office@it-deweloper.pl](mailto:office@it-deweloper.pl "E-mail") - [ Nowogródzka 4A, Białystok, Polska](https://maps.app.goo.gl/BNjvryytwRyv4omA7 "Adres") - [ WhatsApp](https://wa.me/48731190041 "WhatsApp") - [ Telegram](https://t.me/+48731190041 "Telegram") - [Koszt](https://it-deweloper.pl/pl/cost "Taryfy i koszt usług") - [CennikOrientacyjne ceny tworzenia stron internetowych](https://it-deweloper.pl/pl/cost/pricing "Ceny tworzenia stron internetowych") - [KalkulatorSamodzielna kalkulacja online](https://it-deweloper.pl/pl/cost/calculator "Oblicz koszt strony internetowej online") - [BriefOtrzymaj dokładną wycenę projektu](https://it-deweloper.pl/pl/cost/brief "Wypełnij brief na budowę strony internetowej") - [Rozwiązania](https://it-deweloper.pl/pl/web "Rozwiązania IT Deweloper w tworzeniu stron internetowych") - [Etapy pracy](https://it-deweloper.pl/pl/web/process "Etapy i terminy tworzenia strony") - [SEO](https://it-deweloper.pl/pl/web/seo "Pozycjonowanie stron: optymalizacja, linki, pozycje w Google") - [GEO](https://it-deweloper.pl/pl/web/geo "Optymalizacja GEO: promocja strony w odpowiedziach ChatGPT, Gemini i Perplexity") - [SI](https://it-deweloper.pl/pl/web/ai) - [Portfolio](https://it-deweloper.pl/pl/portfolio "Portfolio i przykłady realizacji") - [O nas](https://it-deweloper.pl/pl/about "O założycielu studia — Wiktor Parchimczyk") - [FAQ](https://it-deweloper.pl/pl/faq "Częste pytania o tworzenie stron internetowych") - [Blog](https://it-deweloper.pl/pl/blog "Artykuły o tworzeniu i promocji stron internetowych") [ Blog studia IT Deweloper ](https://it-deweloper.pl/index.php?option=com_content&view=category&id=33&lang=pl-PL "Blog studia IT Deweloper") # Google Search Console MCP: jak podłączyłem GSC do Claude We wrześniu 2026 roku podłączyłem Google Search Console swojej strony do Claude przez serwer MCP. Powód był przyziemny: w indeksie wisiały śmieciowe adresy, a ręczne dochodzenie, skąd się wzięły, nie brzmiało zachęcająco. Poniżej cała droga — od wyboru sposobu autoryzacji, przez dwa błędy naprawione po drodze, po to, co wyszło na działającej stronie. To nie jest ranking „najlepszych serwerów MCP”. Jeden serwer, jeden komputer z Windows, strona w czterech językach i szczere wrażenia z pierwszych dni używania. --- ![Search Console, serwer MCP i asystent AI połączone w łańcuch na ekranie komputera](https://it-deweloper.pl/images/blog/google-search-console-mcp-cover.webp#joomlaImage://local-images/blog/google-search-console-mcp-cover.webp?width=1200&height=1200) ## Serwer MCP — co to jest, w dwóch akapitach MCP (Model Context Protocol) to otwarty protokół, przez który asystent AI wywołuje zewnętrzne narzędzia. Serwer MCP jest pośrednikiem: z jednej strony rozmawia z asystentem, z drugiej odpytuje API konkretnej usługi. W przypadku Search Console oznacza to, że Claude sam pobiera raport zapytań, sprawdza adres URL albo porównuje okresy, zamiast prosić mnie o eksport do CSV i wklejenie go do czatu. Serwer działa lokalnie, na tym samym komputerze co Claude Desktop lub Claude Code, i komunikuje się z asystentem przez standardowe wejście i wyjście. Osobny hosting nie jest potrzebny. ## Który serwer wybrałem i co sprawdziłem przed instalacją Postawiłem na **Google Search Console MCP** — pakiet Pythona `gsc-mcp-tools`. Przesądziły trzy rzeczy: - **Zakres.** 61 narzędzi: raporty Search Analytics, sprawdzanie URL, mapy witryny, Indexing API, a do tego GA4, dane CrUX, PageSpeed oraz audyty danych strukturalnych, hreflang, nagłówków i linkowania wewnętrznego. - **Konto usługi.** Można obejść się bez logowania w przeglądarce, co przy lokalnym serwerze działającym tygodniami jest po prostu wygodniejsze. - **Klient konsolowy w zestawie.** Każde narzędzie jest dostępne także jako polecenie `gsc-cli`. Przydało się, gdy Claude jeszcze nie widział nowego serwera. Przed instalacją sprawdziłem to samo, co przy każdym serwerze MCP: czy kod jest otwarty, jaka jest licencja, jakie zależności i dokąd program łączy się w sieci. Licencja MIT, ruch wychodzi wyłącznie do API Google, IndexNow i na sprawdzane strony, a tokeny leżą w lokalnych plikach. Dlaczego nie warto pomijać takiej weryfikacji, pisałem w tekście [o bezpieczeństwie narzędzi AI](https://it-deweloper.pl/pl/blog/ai-tool-security-check). ## Krok 1. Autoryzacja: konto usługi zamiast OAuth Pakiet ma dwa tryby. OAuth to zwykłe logowanie w przeglądarce na własne konto Google. Konto usługi to techniczny użytkownik projektu Google Cloud z kluczem JSON: nie trzeba się logować, a serwer nie zależy od ważności tokenów OAuth. Do lokalnego serwera wybrałem to drugie. 1. W projekcie Google Cloud włączyć **Google Search Console API**. Do wysyłania adresów i danych GA4 — dodatkowo **Web Search Indexing API** i **Google Analytics Data API**. 2. Utworzyć konto usługi i pobrać klucz JSON. 3. Nadać dostęp w samej Search Console: *Ustawienia → Użytkownicy i uprawnienia → Dodaj użytkownika* i wpisać adres konta usługi. Najmniej oczywisty jest punkt trzeci. Role w Google Cloud nie mają żadnego wpływu na Search Console: dopóki adres nie trafi na listę użytkowników usługi, każde wywołanie kończy się błędem 403 — nawet z bezbłędnym kluczem. API do tego kroku nie ma, zostaje formularz i właściciel strony. Nadałem uprawnienia „Pełne”: wystarczają do raportów i sprawdzania URL. Poziom „Właściciel” jest potrzebny tylko do Indexing API i bez powodu lepiej go nie przyznawać. Trochę czasu zaoszczędziłem, bo konto usługi już miałem — założyłem je wcześniej dla Google Analytics. Jedno konto może działać w kilku usługach Google, a dostęp w każdej nadaje się osobno. Klucz trzymam poza folderami synchronizowanymi z chmurą, bo w praktyce to hasło do danych. ## Krok 2. Instalacja — i pierwsza pułapka: zabrakło miejsca Instaluję przez pipx, żeby pakiet miał własne, odizolowane środowisko: ``` python -m pipx install gsc-mcp-tools ``` Instalacja przerwała się błędem `No space left on device`. Dysk systemowy C: był zapchany niemal do końca — zostało około 200 MB, a pipx domyślnie zakłada środowisko właśnie tam. Rozwiązanie to przeniesienie katalogów pipx na inny dysk przed instalacją: ``` $env:PIPX_HOME = "D:\pipx" $env:PIPX_BIN_DIR = "D:\pipx\bin" python -m pipx install gsc-mcp-tools ``` Środowisko zajęło około 270 MB. W katalogu `bin` pojawiły się trzy programy: `gsc-mcp` — serwer, `gsc-mcp-tools` — ten sam serwer pod nazwą pakietu, oraz `gsc-cli` — klient konsolowy. ## Krok 3. Rejestracja w Claude Code Klucz przekazuje się przez zmienne środowiskowe. W PowerShellu: ``` $k = "C:\keys\gsc.json" claude mcp add gsc -s user ` -e GSC_SKIP_OAUTH=true ` -e "GSC_SERVICE_ACCOUNT_PATH=$k" ` -- D:\pipx\bin\gsc-mcp.exe ``` Flaga `-s user` zapisuje serwer w konfiguracji użytkownika, a nie w pliku projektu. U mnie ma to znaczenie: folder projektu synchronizuje się z chmurą, a ścieżki do klucza nie ma tam po co trzymać. Dla narzędzi GA4 w tym samym poleceniu dopisuje się `-e GA4_PROPERTY_ID=…`. ``` claude mcp list ``` Przy `gsc` pojawił się status „Connected”. I druga nieoczywistość: w już otwartej sesji nowych narzędzi nie ma. Lista ładuje się przy starcie sesji, więc po dodaniu serwera trzeba otworzyć nową. Poza tym „Connected” oznacza tylko, że proces się uruchamia i odpowiada na handshake — a nie, że uprawnienia w Search Console są już nadane. ## Krok 4. Test bez Claude — i błąd w kliencie Żeby nie czekać na nową sesję, postanowiłem sprawdzić dostęp klientem konsolowym z tego samego pakietu: ``` gsc-cli list ``` Wyłożył się, zanim w ogóle połączył się z Google: `ValueError: badly formed help string`. Ślad stosu pokazał, że klient bierze pierwszą linijkę opisu każdego narzędzia i przekazuje ją do `argparse` jako tekst pomocy. W jednym z opisów jest znak `%`, a nowy `argparse` (u mnie Python 3.14) sprawdza takie teksty od razu przy tworzeniu poleceń i traktuje procent jak początek szablonu formatowania. Wystarczyła jedna poprawka w `gsc_mcp/cli.py` — zamiana procentu na podwójny przed przekazaniem: ``` help=help_text.replace("%", "%%") ``` Sam serwer MCP nie był dotknięty, psuł się tylko klient. Poprawka siedzi jednak w zainstalowanym pakiecie i zniknie przy aktualizacji, więc takie rzeczy lepiej zgłaszać autorowi. Jeszcze jeden szczegół: parametry-listy podaje się, powtarzając flagę, a nie po przecinku. Ciąg z przecinkami nie wywołuje błędu, tylko po cichu staje się jednym „adresem”: ``` gsc-cli batch-url-inspection ` --site https://example.com/ ` --urls https://example.com/a ` --urls https://example.com/b ``` Po poprawce polecenie `gsc-cli list-properties` zwróciło moją stronę z uprawnieniem `siteFullUser` — dostęp działa. ## Co wyszło na działającej stronie **Śmieciowe adresy.** Google wciąż trzymał osiem zbędnych URL: `/ru?Itemid=232` i sąsiednie — pozostałości dawno usuniętych pozycji menu — oraz dwa stare adresy w formacie `/ru/component/content/article/2-…?catid=14` należące do dwóch nieopublikowanych od dawna artykułów z 2019 i 2021 roku. Wszystkie osiem zwraca teraz 410 Gone. Ze starymi adresami była pouczająca historia. Reguła przekierowania ustawiona na oryginalny adres w ogóle nie działała. Okazało się, że Joomla sama przechwytuje stary format `/component/content/article/…` i zwraca 301 na pośredni `?view=article&id=…` — i dopiero ten drugi adres naprawdę odpowiada 404. Regułę trzeba było założyć właśnie na niego. Przy okazji znalazł się błąd w konektorze MCP dla Joomli: narzędzie do tworzenia przekierowań zapisywało kod odpowiedzi w złym polu. **Sprawdzanie URL.** Dla takich adresów z parametrami narzędzie zwróciło `NEUTRAL` i puste pola. To nie błąd wywołania — Google po prostu nie ma dla nich osobnych danych. Pakiet oznacza je jednak kategorią `fetch_error`, co wprowadza w błąd, więc lepiej patrzeć na same pola. Dla zwykłej strony to samo narzędzie zwróciło „PASS”, datę ostatniego skanowania i adres kanoniczny. **Szybkie wygrane.** Narzędzie `quick_wins` pokazało, że strona główna jest średnio na 8. pozycji, ale w cztery tygodnie przy 295 wyświetleniach dostała jedno kliknięcie. Oczekiwany CTR dla takiej pozycji to około 3 %, rzeczywisty — 0,3 %. Najbliższe zadanie jest więc jasne: tytuł i opis w wynikach wyszukiwania. ## Co się sprawdziło, a co nie - **Działa od razu:** porównanie okresów, wyszukiwanie fraz, które straciły ruch, szybkie wygrane, zbiorcze sprawdzanie URL, audyt mapy witryny i techniczny audyt strony. Odpowiedź przychodzi w kilka sekund, a Claude sam dobiera narzędzie do pytania. - **Wymaga przygotowania:** narzędzia GA4 potrzebują dostępu konta usługi w Google Analytics, a dane CrUX — osobnego klucza API i odpowiedniego ruchu. - **Z zastrzeżeniami:** Indexing API jest oficjalnie przeznaczone tylko dla stron z ofertami pracy i transmisjami, a limit to 200 zapytań dziennie. Dla zwykłych podstron nie warto na nim polegać. - **Zawsze pamiętać:** dane Search Console mają 2–3 dni opóźnienia, a mała strona ma ich po prostu niewiele. ## Krótka lista kontrolna 1. Włączyć Google Search Console API w projekcie Google Cloud. 2. Utworzyć konto usługi, pobrać klucz JSON i trzymać go poza folderami w chmurze. 3. Dodać adres konta w Search Console z uprawnieniami „Pełne”. 4. Zainstalować `gsc-mcp-tools` przez pipx; przy braku miejsca przenieść `PIPX_HOME`. 5. Zarejestrować serwer poleceniem `claude mcp add` w zakresie użytkownika. 6. Sprawdzić dostęp poleceniem `gsc-cli list-properties` i otworzyć nową sesję Claude. Jeśli nie masz ochoty przechodzić tej drogi samodzielnie, możemy [zintegrować Google Search Console z asystentem AI za Ciebie](https://it-deweloper.pl/pl/web/ai/google-search-console-ai) — na Twoim komputerze albo w Twojej chmurze. *Victor Parhimchik, założyciel studia internetowego IT Deweloper* 14 wrzesień 2026 | [Victor Parhimchik](https://it-deweloper.pl/index.php?option=com_contact&view=contact&id=1&catid=4) | [Blog studia IT Deweloper](https://it-deweloper.pl/index.php?option=com_content&view=category&id=33) ![](https://it-deweloper.pl/media/yootheme/cache/dc/background-square-01-dcdf75df.png?src=images/yootheme/demo/background-square-01.png&thumbnail=600,600,&hash=2dd80327) ![](https://it-deweloper.pl/images/yootheme/demo/background-square-02.png) ![](https://it-deweloper.pl/media/yootheme/cache/00/background-square-02-008babe7.png?src=images/yootheme/demo/background-square-02.png&thumbnail=1100,1100,&hash=b5aad0c1) ![](https://it-deweloper.pl/media/yootheme/cache/83/background-square-03-83a325b2.png?src=images/yootheme/demo/background-square-03.png&thumbnail=700,700,&hash=37b48e31) ![](https://it-deweloper.pl/media/yootheme/cache/8a/background-square-04-8a34f69f.png?src=images/yootheme/demo/background-square-04.png&thumbnail=950,950,&hash=7e1440a8) ## Stwórz swoją stronę Dowiedz się, ile kosztuje stworzenie Twojej strony internetowej [ Cennik ](https://it-deweloper.pl/index.php?Itemid=266&lang=pl-PL) ![](https://it-deweloper.pl/media/yootheme/cache/3c/background-square-01-3c44c74f.png?src=images/yootheme/demo/background-square-01.png&thumbnail=900,900,&hash=72c31958) ![](https://it-deweloper.pl/media/yootheme/cache/cb/background-square-03-cbb341a0.png?src=images/yootheme/demo/background-square-03.png&thumbnail=600,600,&hash=6e9dde93) ### [ Kontakt ](https://it-deweloper.pl/index.php?Itemid=271&lang=pl-PL) Studio internetowe IT Deweloper tworzenie stron internetowych, Polska. 5423493188 SEOAIReklamaWebSMM ### Adres Nowogródzka 4A Białystok, 15-490, PL [ ### Telefon +48 731 190 041 ](tel:+48731190041) [ ### E-mail Ten adres pocztowy jest chroniony przed spamowaniem. Aby go zobaczyć, konieczne jest włączenie w przeglądarce obsługi JavaScript. ](mailto:office@it-deweloper.pl) [ ### WhatsApp ](https://wa.me/48731190041) [ ### Telegram ](https://t.me/+48731190041) Godziny pracy: - Poniedziałek 0900–1800 - Wtorek 0900–1800 - Środa 0900–1800 - Czwartek 0900–1800 - Piątek 0900–1800 - Sobota 0900–1600 - Niedziela nieczynne ![IT Deweloper](https://it-deweloper.pl/images/Logo.webp) Tworzenie stron może być ciekawe! Nasze media społecznościowe z treściami o budowie stron. - [](https://www.facebook.com/ITdeweloper) - [](https://www.linkedin.com/company/it-deweloper) - [Portfolio](https://it-deweloper.pl/index.php?Itemid=268&lang=pl-PL) - [Kontakt](https://it-deweloper.pl/index.php?Itemid=271&lang=pl-PL) - [O nas](https://it-deweloper.pl/index.php?Itemid=265&lang=pl-PL) **it-deweloper** — studio tworzenia stron internetowych. Projektujemy i tworzymy nowoczesne strony i sklepy internetowe. © [it-deweloper](https://it-deweloper.pl/). Wszelkie prawa zastrzeżone. [Polityka prywatności](https://it-deweloper.pl/index.php?Itemid=314&lang=pl)