Przejdź do treści

Google Search Console MCP: jak połączyć Search Console z AI

Maciej Sala

Founder StriveLab

10 min czytaniaAktualizacja

Szybka odpowiedź: jak połączyć Google Search Console z AI przez MCP?

  • Serwer MCP daje modelowi dostęp do Search Console API, więc asystent sam pobiera dane o frazach, stronach i pozycjach.
  • Darmowa droga to własny klient OAuth w Google Cloud i serwer mcp-gsc uruchamiany przez uvx.
  • Bez lokalnej konfiguracji połączysz konto przez gotowy konektor, czyli Adzviser albo Windsor.ai.
  • Model widzi tylko pobrane wiersze, więc przed analizą sprawdź, ile danych faktycznie dostał.

Czym jest Google Search Console MCP?

to otwarty standard, przez który asystent AI wywołuje zewnętrzne narzędzia. Serwer MCP dla udostępnia modelowi funkcje w rodzaju list_properties, get_search_analytics czy inspect_url_enhanced, a model decyduje, kiedy je wywołać, dostaje surowe dane i dopiero na nich pracuje dalej. Sam standard szerzej opisuję w artykule co to jest MCP.

Opisane rozwiązania to kod firm trzecich korzystający z publicznego Search Console . Różnią się tym, kto hostuje serwer i kto trzyma tokeny. Jeśli dopiero poznajesz samo narzędzie, zacznij od artykułu o tym, czym jest Google Search Console i do czego służy.

Diagram
Dwa warianty połączenia: serwer MCP u dostawcy albo na Twoim komputerze

Opcja 1: darmowy serwer MCP do Search Console (mcp-gsc)

Jednym z popularnych otwartoźródłowych serwerów jest mcp-gsc (licencja MIT, pakiet mcp-search-console), który udostępnia około 20 narzędzi. Opis możliwości powstał na podstawie kodu repozytorium z 1 listopada 2026 roku, dlatego przed instalacją warto sprawdzić aktualną wersję pakietu. Serwer udostępnia analitykę wyszukiwania z filtrami, porównanie okresów, inspekcję URL-i (także wsadową), listę i zarządzanie nimi. Działa przy tym z klientami, które uruchamiają lokalne serwery MCP, czyli Claude Desktop, Claude Code, Cursor, Codex czy Gemini CLI.

Serwer i Search Console API są bezpłatne, chociaż samo API ma limity wykorzystania. Własny projekt Google Cloud służy tu do konfiguracji . Dodam jeszcze, że poniższe polecenia i ścieżki oparte są na macOS, na którym pracuję.

Krok 1: jak utworzyć klienta OAuth w Google Cloud?

  1. W Google Cloud Console utwórz projekt.
  2. Włącz Google Search Console API.
  3. Skonfiguruj ekran zgody OAuth (Google Auth Platform → Branding / Audience). Typ użytkownika: External. Internal wybierz tylko dla aplikacji należącej do organizacji Google Workspace lub Cloud Identity i używanej wyłącznie wewnątrz niej.
  4. W Audience → Test users dodaj adres Google, który ma dostęp do Search Console.
  5. W Credentials → Create Credentials → OAuth client ID wybierz typ Desktop app. Plik takiego klienta ma w środku klucz "installed", a nie "web".
  6. Pobierz plik JSON i zapisz go w stałym miejscu, np. ~/.config/gsc/client_secrets.json.

Krok 2: jak zainstalować uv?

Serwer uruchamia się przez uvx, który sam pobiera właściwą wersję Pythona i zależności:

Terminal
Code
curl -LsSf https://astral.sh/uv/install.sh | sh

Krok 3: jak podłączyć serwer MCP do Claude Code i Claude Desktop?

Claude Code (dostępne we wszystkich projektach):

Terminal
Code
claude mcp add gsc --scope user \
  -e GSC_OAUTH_CLIENT_SECRETS_FILE=/Users/twoj-login/.config/gsc/client_secrets.json \
  -- uvx mcp-search-console

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

claude_desktop_config.json
Code
{
  "mcpServers": {
    "gsc": {
      "command": "/Users/twoj-login/.local/bin/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/Users/twoj-login/.config/gsc/client_secrets.json"
      }
    }
  }
}

W Claude Desktop podaj pełną ścieżkę do uvx (sprawdzisz ją przez which uvx). Aplikacje GUI mogą mieć inny PATH niż terminal, więc samo uvx może zakończyć się błędem spawn uvx ENOENT.

Krok 4: jak zalogować się do Google i sprawdzić połączenie?

Przy pierwszym wywołaniu narzędzia serwer otwiera przeglądarkę z logowaniem Google, a token zapisuje lokalnie. Jako test poproś model o listę usług w Search Console.

Sprawdź usługę. Wywołaj list_properties i wybierz dokładny identyfikator: format sc-domain:example.com obejmuje całą domenę wraz z subdomenami, natomiast https://example.com/ dotyczy konkretnej usługi z prefiksem URL.

Uprawnienia i zapis. Przetestowany moduł mcp-gsc wymaga zakresu webmasters (a nie tylko ograniczonego webmasters.readonly), dlatego wszelkie operacje modyfikujące dane zatwierdzaj świadomie w kliencie AI. Flaga GSC_ALLOW_DESTRUCTIVE domyślnie blokuje krytyczne akcje, takie jak dodawanie i usuwanie usług czy kasowanie map witryny, przy czym samo zgłaszanie sitemap pozostaje dostępne. Na koniec pamiętaj, aby pod żadnym pozorem nie dodawać pliku token.json do repozytorium.

Najczęstsze błędy przy konfiguracji serwera MCP dla Search Console

Instrukcja jest w zasadzie prosta, ale w praktyce trafiłem na kilka problemów, które łatwo pomylić z błędem samego serwera.

  • Is a directory zamiast pliku. Jeśli podczas przygotowywania struktury użyjesz polecenia mkdir -p z pełną ścieżką do pliku JSON, w jego miejscu powstanie katalog o nazwie client_secrets.json. W efekcie serwer wygeneruje błąd [Errno 21] Is a directory. Aby to naprawić, usuń ten katalog za pomocą rmdir, a następnie przenieś pobrany plik we właściwe miejsce przy użyciu mv.

  • Pobrany plik ma inną nazwę. Google zapisuje go jako client_secret_<długi-identyfikator>.apps.googleusercontent.com.json. Polecenie mv ~/Downloads/client_secrets.json … nic nie przeniesie, a serwer zgłosi brak pliku.

  • Error 403: access_denied przy logowaniu. Jedną z przyczyn może być uruchomienie aplikacji w trybie External z projektem na etapie Testing, gdy Twojego konta nie ma na liście testerów. Aby to naprawić, dodaj swój adres w zakładce Audience → Test users. Jeśli błąd nadal występuje, zweryfikuj szczegóły odmowy oraz polityki swojej organizacji.

  • Ostrzeżenie o niezweryfikowanej aplikacji powszechnie pojawia się podczas korzystania z własnych, osobistych integracji. W takim przypadku kontynuuj proces dopiero po upewnieniu się, że tożsamość aplikacji oraz zakres żądanych uprawnień są całkowicie poprawne.

  • Token co tydzień przestaje działać. Dla aplikacji External w Testing z uprawnieniami GSC wygasa po 7 dniach. Przejdź przez Audience → Publish app do Production i wykonaj ponowną autoryzację.

  • Pierwsze wywołanie „wisi” i się przerywa. Serwer czeka na zakończenie procesu logowania w przeglądarce. Jeśli upłynie limit czasu (timeout) i lokalny nasłuch (listener) zostanie zamknięty, przekierowanie z powrotem na localhost zakończy się błędem. W takiej sytuacji musisz uruchomić autoryzację od nowa i skorzystać z nowej sesji, bo dokończenie starego przekierowania nie przywróci już działania listenera.

Opcja 2: Adzviser, płatny konektor Search Console do ChatGPT i Claude

Adzviser to konektor danych marketingowych, a Search Console jest tam jednym z ponad 40 źródeł, obok Google Ads, , Meta Ads czy Shopify, więc możliwości analityczne ma znacznie szersze. Dane mogą trafić m.in. do ChatGPT, Claude, Looker Studio czy , a MCP jest dostępny we wszystkich planach. Niestety, problemem jest dość wysoka cena:

Cennik (weryfikacja: 1 listopada 2026, kurs około 3,90 zł za dolara):

PlanKwota miesięcznieŹródła danych
Starterokoło 190 zł (48,99 USD)3 dowolne
Growthokoło 580 zł (148,99 USD)7 dowolnych
Enterpriseindywidualniewszystkie

Ceny są niższe, jeśli kupisz abonament na rok z góry. Na początek Adzviser proponuje trial, który trwa 14 dni i kosztuje około 4 zł (0,99 USD).

Opcja 3: Windsor.ai, darmowy konektor Search Console do Claude i ChatGPT

Windsor.ai działa podobnie do Adzvisera, ponieważ to hostowany serwer MCP (mcp.windsor.ai) z ponad 350 źródłami, dostępny w katalogu konektorów Claude i jako aplikacja w ChatGPT.

Cennik (weryfikacja: 1 listopada 2026, kurs około 3,90 zł za dolara):

PlanMiesięcznieRocznie (za miesiąc)Źródła / konta
Forever Free0 zł0 zł1 źródło, 1 konto
Basicokoło 90 zł (23 USD)około 75 zł (19 USD)3 źródła, 75 kont
Standardokoło 460 zł (118 USD)około 390 zł (99 USD)7 źródeł, 75 kont

Darmowy plan po 30-dniowym trialu pozwala podpiąć jedno konto jednego źródła, co na jedną usługę Search Console w zupełności wystarczy. Windsor sam przyznaje na stronie opisującej konektor, że jego integracja z GSC przez MCP działa tylko do odczytu i nie obejmuje , czyli nie sprawdzisz nim stanu indeksowania konkretnego URL-a. Jeśli tego potrzebujesz, użyj dodatkowo Search Console albo serwera, który udostępnia URL Inspection API.

Jakie limity ma Search Console API przy pracy z AI?

Search Analytics API nie ma parametru dowolnego sortowania po metrykach, więc wyniki zwraca malejąco według kliknięć, a przy grupowaniu po dacie rosnąco według daty. Jedno zapytanie zwraca maksymalnie 25 000 wierszy, a kolejne strony pobierasz przez startRow.

„Top 10 fraz według wyświetleń” wymaga więc sortowania po pobraniu danych. Pobierz wszystkie dostępne strony odpowiedzi, połącz wyniki i dopiero wtedy sortuj. To nadal nie jest pełny zbiór danych GSC, bo API zwraca najważniejsze wiersze, a fraz ukrytych ze względów prywatności nie odzyskasz.

W sprawdzonym mcp-gsc get_search_analytics ma limit 500 wierszy, a get_advanced_search_analytics obsługuje row_limit do 25 000 i start_row.

Dane finalne są zwykle dostępne z opóźnieniem 2–3 dni, ale nie jest to gwarantowany termin. Do stabilnych porównań wybierz data_state: "final".

mcp-gsc, Adzviser czy Windsor.ai: co wybrać?

mcp-gsc (open source)AdzviserWindsor.ai
Koszt dla samego GSC0 złod około 190 zł/mies. (48,99 USD)0 zł (1 konto) lub około 90 zł/mies. (23 USD); około 75 zł przy płatności rocznej (19 USD)
Inne źródła danychtylko GSC40+350+
Claude / ChatGPT w przeglądarcenie w opisanym wariancie lokalnymtaktak
Inspekcja URL-itak, także wsadowobrak informacji na stronie produktunie
Kto trzyma tokeny GoogleTy, lokalniedostawcadostawca
Czas konfiguracji20–40 minut za pierwszym razemkilka minutkilka minut

Granice API. URL Inspection odczytuje stan wersji znanej Google; nie uruchamia testu live ani żądania indeksacji. Limit wynosi 2000 inspekcji dziennie i 600 na minutę na usługę. Publiczne Search Console API nie udostępnia pełnej listy wykluczonych URL-i z raportu indeksowania, raportu linków, ręcznych działań ani Core Web Vitals. Do tych analiz potrzebujesz panelu GSC lub innych źródeł danych.

Jakie pytania zadawać AI o dane z Search Console?

Zadaj modelowi kilka zapytań, które po podpięciu narzędzia oszczędzają najwięcej czasu. Poniżej daję kilka przykładów, które mogą być punktem zaczepienia do dalszej pracy. Inne zastosowania opisuję w artykule o wykorzystaniu AI w SEO.

  • Frazy z potencjałem. Wynik to kandydaci do analizy intencji, tytułów i wyników wyszukiwania. Prompt:

    Code
    Frazy z ponad 100 wyświetleniami, pozycją 8–20 i CTR poniżej 1% w ostatnich 28 dniach. Pogrupuj je tematycznie.
    
  • Spadki kliknięć. Stały monitoring takich spadków opisuję w artykule o wykrywaniu anomalii SEO. Prompt:

    Code
    Porównaj ostatnie 28 dni z poprzednimi 28. Które strony straciły najwięcej kliknięć i na jakich frazach?
    
  • Frazy na kilku adresach. To punkt wyjścia do sprawdzenia , ale pamiętaj, że kilka URL-i dla frazy nie musi oznaczać, że dochodzi do szkodliwej konkurencji między stronami. Prompt:

    Code
    Które frazy rankują na więcej niż jednym URL-u?
    
  • Stan indeksowania. Działa tylko tam, gdzie serwer ma inspekcję URL-i. Jak z takich odpowiedzi zbudować zestawienie niezindeksowanych adresów, opisuję w artykule o tym, dlaczego Google nie indeksuje strony. Prompt:

    Code
    Sprawdź status indeksowania tych 10 URL-i.
    

Przykładowy prompt do porównania okresów (pamiętaj o podmianie domeny i dat):

Code
Dla `sc-domain:example.com` porównaj 1–28 października 2026 z 3–30 września 2026 na danych `final`. Pobierz tabelę `page,query` ze wszystkich dostępnych stron odpowiedzi i scal partie przed sortowaniem. Wskaż pary strona–fraza z największą utratą kliknięć i podaj liczbę pobranych wierszy. Oddziel wyniki od hipotez SEO.

Gdy chcesz od danych przejść do zmian w kodzie strony, zajrzyj do artykułu o agentach AI i audycie SEO w repozytorium. Dane o konkurencji dołożysz przez Senuto MCP. Jeśli raporty i alerty z tych danych mają powstawać bez Twojego udziału, zobacz automatyzację SEO i marketingu.

Raporty, treści i monitoring SEO w n8n, z agentami AI i kontrolą człowieka.
Automatyzacja SEO i marketingu

Często zadawane pytania

Czy Google ma oficjalny serwer MCP dla Search Console?

Na dzień weryfikacji nie znalazłem oficjalnego serwera Google dla Search Console. Opisane rozwiązania korzystają z publicznego Search Console API i są rozwijane przez firmy trzecie lub społeczność.

Czy da się podłączyć Search Console do AI za darmo?

Tak. Serwer mcp-gsc i Search Console API są bezpłatne. Opisany wariant lokalny wymaga klienta desktopowego lub CLI. Windsor.ai oferuje plan Free dla jednego użytkownika, źródła i konta, z ograniczeniem historii; konektor GSC nie obsługuje inspekcji URL-i. Dostęp do modelu AI może być osobno płatny.

Dlaczego token Google przestaje działać po tygodniu?

Aplikacja External w trybie Testing z uprawnieniami Search Console otrzymuje refresh token ważny 7 dni. Przejście do Production usuwa to ograniczenie, ale token nadal może utracić ważność, np. po cofnięciu dostępu, sześciu miesiącach nieużywania lub przekroczeniu limitu tokenów. Dla osobistego użytku Google przewiduje wyjątek od weryfikacji aplikacji.

Czy dane z Search Console trafiają do dostawcy modelu AI?

Tak, jeśli korzystasz z modelu chmurowego, ponieważ wyniki narzędzi przekazane do rozmowy trafiają do jego dostawcy. Lokalny serwer MCP przechowuje tokeny u Ciebie, ale nie zapewnia lokalnego przetwarzania przez model. Inaczej może wyglądać konfiguracja z modelem uruchomionym lokalnie.

O autorze

Maciej Sala

Maciej Sala — konsultant technologiczny produktów cyfrowych i web developer z bogatym doświadczeniem w marketingu internetowym oraz SEO. Na co dzień pracuje z Reactem, Next.js i TypeScriptem, a ostatnio także z Astro i narzędziami do automatyzacji procesów AI. Sprawnie łączy perspektywę produktową z praktycznym podejściem do kodu. Przez kilka lat był związany z branżą gier wideo jako project manager i game designer. Absolwent historii na Uniwersytecie Jagiellońskim oraz studiów podyplomowych z marketingu internetowego na AGH w Krakowie. Po godzinach trenuje na siłowni, maluje figurki i rozwija własne projekty.

Pomagam przekładać takie tematy na konkretne wdrożenia w frontendzie, SEO, analityce i procesie produktowym.

Skontaktuj się ze mną
LH.pl – Hosting Mango

Biblioteka wiedzy na temat AI

Czytaj dalej

Zobacz więcej wpisów
Google Ads MCP: jak połączyć konto reklamowe z AI

Konto Google Ads to prawdziwa kopalnia danych, w której możemy znaleźć szereg cennych informacji dla Twojego biznesu. Raport wyszukiwanych haseł z ostatniego kwartału, porównanie kampanii przed i po zmianie strategii stawek, lista fraz, na które przepalasz budżet bez konwersji, wszystko to wymaga klikania po interfejsie, eksportów i arkuszy. Dzięki serwerowi MCP możemy zadać te pytania asystentowi AI zwykłym językiem i dostać odpowiedź policzoną na danych z Twojego konta. Pokażę Ci, jak działa oficjalny serwer Google Ads MCP, co trzeba przygotować, jakie są gotowe alternatywy i gdzie kończy się rozsądne zaufanie do AI w kampaniach.

Maciej Sala

Maciej Sala

Founder StriveLab

Google Analytics MCP: GA4 w asystencie AI

Raport w GA4 potrafi zniechęcić każdego, kto nie pracuje z nim codziennie. Eksploracje, wymiary, metryki, segmenty, a na końcu i tak eksport do arkusza, bo potrzebne zestawienie nie mieści się w żadnym gotowym widoku. Serwer MCP do Google Analytics pozwala zadać to samo pytanie asystentowi AI zwykłym językiem i dostać odpowiedź policzoną na danych z Twojej usługi. Pokażę Ci, jak działa oficjalny serwer Google, jak go skonfigurować, jakie pytania zadawać i dlaczego GA4 często widzi tylko część ruchu, który pokazuje Search Console, oraz co to oznacza dla wniosków asystenta.

Maciej Sala

Maciej Sala

Founder StriveLab

Czym jest MCP (Model Context Protocol) i jak działa serwer MCP

Z jednej strony modele LLM stają się coraz lepsze, a z drugiej coraz mniej operują na nieaktualnych lub niepełnych danych. Model Context Protocol MCP to otwarty protokół, przez który aplikacje z modelem językowym – Claude, ChatGPT, Cursor, VS Code czy Twój własny agent – łączą się z danymi i narzędziami z zewnątrz. W artykule wyjaśniam, jak ważnym elementem automatyzacji AI jest serwer MCP, jak działa pod maską i jak podejść do wdrożenia w firmie.

Maciej Sala

Maciej Sala

Founder StriveLab

LH.pl – Cloud Server 1C4G