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.
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?
- W Google Cloud Console utwórz projekt.
- Włącz Google Search Console API.
- 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.
- W Audience → Test users dodaj adres Google, który ma dostęp do Search Console.
- W Credentials → Create Credentials → OAuth client ID wybierz typ Desktop app. Plik takiego klienta ma w środku klucz
"installed", a nie"web". - 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:
Krok 3: jak podłączyć serwer MCP do Claude Code i Claude Desktop?
Claude Code (dostępne we wszystkich projektach):
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.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 directoryzamiast pliku. Jeśli podczas przygotowywania struktury użyjesz poleceniamkdir -pz pełną ścieżką do pliku JSON, w jego miejscu powstanie katalog o nazwieclient_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życiumv.Pobrany plik ma inną nazwę. Google zapisuje go jako
client_secret_<długi-identyfikator>.apps.googleusercontent.com.json. Poleceniemv ~/Downloads/client_secrets.json …nic nie przeniesie, a serwer zgłosi brak pliku.Error 403: access_deniedprzy 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
localhostzakoń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):
| Plan | Kwota miesięcznie | Źródła danych |
|---|---|---|
| Starter | około 190 zł (48,99 USD) | 3 dowolne |
| Growth | około 580 zł (148,99 USD) | 7 dowolnych |
| Enterprise | indywidualnie | wszystkie |
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):
| Plan | Miesięcznie | Rocznie (za miesiąc) | Źródła / konta |
|---|---|---|---|
| Forever Free | 0 zł | 0 zł | 1 źródło, 1 konto |
| Basic | około 90 zł (23 USD) | około 75 zł (19 USD) | 3 źródła, 75 kont |
| Standard | okoł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) | Adzviser | Windsor.ai | |
|---|---|---|---|
| Koszt dla samego GSC | 0 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 danych | tylko GSC | 40+ | 350+ |
| Claude / ChatGPT w przeglądarce | nie w opisanym wariancie lokalnym | tak | tak |
| Inspekcja URL-i | tak, także wsadowo | brak informacji na stronie produktu | nie |
| Kto trzyma tokeny Google | Ty, lokalnie | dostawca | dostawca |
| Czas konfiguracji | 20–40 minut za pierwszym razem | kilka minut | kilka 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:
CodeSpadki kliknięć. Stały monitoring takich spadków opisuję w artykule o wykrywaniu anomalii SEO. Prompt:
CodeFrazy 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:
CodeStan 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
Przykładowy prompt do porównania okresów (pamiętaj o podmianie domeny i dat):
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.


