Błędy konfiguracji Search Console MCP i poprawki

Jak naprawić błędy społecznościowych serwerów Google Search Console MCP: API not enabled, 403, sc-domain, access blocked, invalid_grant, spawn uvx ENOENT.

Autor: Denis Veisllari

Większość błędów Google Search Console MCP ma pięć źródeł: projekt Google Cloud, usługę w Search Console, ekran zgody OAuth, plik z danymi uwierzytelniającymi i konfigurację klienta AI. Znajdź poniżej swój komunikat błędu, popraw ten jeden krok i uruchom klienta ponownie. Jeśli wolisz całkiem pominąć Google Cloud, ostatnia sekcja pokazuje drogę, która wymaga tylko logowania przez Google.

Google nie opublikował oficjalnego serwera MCP dla Search Console. Jego repozytorium MCP obejmuje Google Analytics, BigQuery, Maps i inne usługi, ale nie Search Console, więc każdy serwer Search Console, który możesz zainstalować, to projekt społecznościowy. Dwa najczęściej używane to mcp-gsc (instalowany jako mcp-search-console) i mcp-server-gsc. Opisane niżej błędy dotyczą obu i większości pozostałych.

Szybkie wyszukiwanie

Co widziszPrawdopodobna przyczynaPrzejdź do
"has not been used in project ... before or it is disabled"Search Console API jest wyłączone w tym projekcie CloudAPI nie jest włączone
403 "User does not have sufficient permission for site"Konto usługi nie jest dodane do usługi albo zły URLBłędy uprawnień
"is not a verified Search Console site in this account"Pomylona usługa domeny z usługą z prefiksem URLZły format usługi
"Failed to add user: email not found" w Search ConsoleBłąd Google przy nowych kontach usługiNie znaleziono e-maila
"Access blocked" lub "Error 403: access_denied" na ekranie GoogleAplikacja OAuth w trybie Testing, nie jesteś testeremBłędy ekranu OAuth
invalid_grant mniej więcej tydzień po tym, jak działałoTokeny odświeżania w trybie Testing wygasają po 7 dniachDziała, a potem przestaje
"Error 400: redirect_uri_mismatch"Użyto klienta Web tam, gdzie potrzebny jest klient DesktopBłędy ekranu OAuth
"Service account credentials file not found"Ścieżka względna albo zły pakietPlik z danymi uwierzytelniającymi
spawn uvx ENOENT lub spawn npx ENOENTKlient nie może znaleźć poleceniaBłędy klienta
Nie pojawiają się żadne narzędzia i nie powstaje żaden logPython starszy niż 3.11Błędy klienta
Liczby nie zgadzają się z panelem Search ConsoleOpóźnienie danych, limity wierszy, zanonimizowane zapytaniaLiczby się nie zgadzają

API nie jest włączone

Błąd to 403 z informacją, że Google Search Console API "has not been used in project", a po nim numer projektu, często z linkiem do włączenia API.

API musi być włączone w tym samym projekcie Cloud, do którego należy Twój klient OAuth lub konto usługi. Typowy błąd to włączenie go w innym projekcie.

  1. Porównaj numer projektu w komunikacie z projektem z pliku JSON z danymi uwierzytelniającymi.
  2. W Google Cloud otwórz w tym projekcie APIs & Services > Library i włącz Google Search Console API.
  3. Odczekaj kilka minut i spróbuj ponownie. Google podaje, że nowe ustawienia mogą potrzebować chwili, by dotrzeć do jego systemów.

Błędy uprawnień

Błąd to 403 "User does not have sufficient permission for site". Sprawdzanie adresu URL zwraca zamiast tego "The caller does not have permission".

Utworzenie konta usługi nie daje mu żadnego dostępu do Search Console. Jego adres e-mail trzeba dodać dokładnie do tej usługi, o którą pytasz.

  1. Otwórz klucz JSON konta usługi i skopiuj wartość client_email.
  2. W Search Console otwórz Settings > Users and permissions > Add user, wklej adres i nadaj uprawnienie Full.
  3. Jeśli logujesz się przez OAuth, użyj konta Google, które już widzi tę usługę w Search Console.

Jeśli konto ma dostęp, a nadal dostajesz 403, prawdopodobnie zły jest ciąg znaków usługi. Przeczytaj następną sekcję.

Zły format usługi

Błąd to "'sc-domain:example.com' is not a verified Search Console site in this account" albo ten sam 403 co wyżej.

Search Console ma dwa rodzaje usług, a API oczekuje dokładnego ciągu znaków dla tej, którą masz:

  • Usługa domeny: sc-domain:example.com
  • Usługa z prefiksem URL: pełny URL z protokołem i ukośnikiem na końcu, na przykład https://www.example.com/

http i https to różne usługi, podobnie jak www i sama domena. Nie zgaduj. Poproś agenta, żeby uruchomił narzędzie serwera wypisujące witryny, i skopiuj adres witryny dokładnie w takiej postaci, w jakiej wróci.

Search Console nie znajduje adresu e-mail konta usługi

Gdy dodajesz konto usługi jako użytkownika, Search Console odpowiada "Failed to add user: email not found."

To problem po stronie Google z nowo utworzonymi kontami usługi, a nie Twój błąd. Pierwsze zgłoszenia pojawiły się około kwietnia 2026, problem wrócił we wrześniu 2026 i dotyczy też Google Analytics. Google go potwierdził, ale nie podał terminu poprawki. Użytkownicy zgłaszają trzy obejścia:

  • Odczekaj od kilku godzin do doby i dodaj użytkownika ponownie.
  • Dodaj użytkownika przez API zamiast przez ekran Search Console.
  • Użyj OAuth zamiast konta usługi, jeśli Twój serwer to obsługuje.

Błędy ekranu OAuth

"Access blocked" z "Error 403: access_denied". Twój ekran zgody jest w trybie Testing, a konto Google, którym się logujesz, nie jest użytkownikiem testowym. W Google Cloud otwórz Google Auth Platform > Audience > Test users i dodaj własny adres.

"Google hasn't verified this app". Ten komunikat pojawia się, gdy niezweryfikowana aplikacja prosi o dostęp do Search Console. Jeśli projekt Cloud założyłeś sam i tylko Ty z niego korzystasz, możesz przejść dalej mimo ostrzeżenia. Weryfikacja ma znaczenie tylko wtedy, gdy udostępniasz aplikację innym osobom.

"Error 400: redirect_uri_mismatch". Utworzyłeś klienta OAuth typu "Web application", a serwery lokalne logują się przez adres pętli zwrotnej, taki jak http://localhost z losowym portem. Utwórz nowego klienta OAuth typu Desktop app, pobierz jego plik JSON i wskaż go serwerowi. W mcp-gsc służy do tego ustawienie GSC_OAUTH_CLIENT_SECRETS_FILE.

Działało, a po tygodniu przestało

Błąd to invalid_grant, zwykle "Token has been expired or revoked."

Google unieważnia tokeny odświeżania po 7 dniach, gdy ekran zgody zewnętrznej aplikacji jest nadal w trybie Testing. Tokeny wygasają też, gdy cofniesz dostęp albo nie używasz ich przez sześć miesięcy.

  1. W Google Cloud ustaw status publikacji ekranu zgody na In production. Do użytku prywatnego aplikacja może pozostać niezweryfikowana.
  2. Usuń plik z tokenem zapisany przez serwer.
  3. Zaloguj się ponownie.

Jeśli używasz mcp-gsc, zaktualizuj go. Wersje starsze niż 0.4.2 mogły nie odświeżać tokenów tylko do odczytu i usuwać plik z tokenem.

Nie znaleziono pliku z danymi uwierzytelniającymi

Błąd to "Service account credentials file not found."

  • Ścieżka względna. Narzędzia takie jak uvx uruchamiają serwer z folderu cache, więc ścieżka w rodzaju ./key.json prowadzi donikąd. Podaj w konfiguracji klienta pełną ścieżkę. W Windows podwój ukośniki wsteczne: C:\\Users\\you\\key.json.
  • Zły pakiet. Dla mcp-gsc zainstaluj mcp-search-console, a nie niezwiązany z nim pakiet mcp-gsc z PyPI. Uruchamiaj go jako uvx mcp-search-console@latest, żeby mieć aktualną wersję.
  • Zły plik w złym ustawieniu. Klucz konta usługi zawiera "type": "service_account" i client_email. Plik klienta OAuth zaczyna się od klucza installed lub web. Każdy trafia do własnego ustawienia; mcp-gsc używa GSC_CREDENTIALS_PATH dla pierwszego i GSC_OAUTH_CLIENT_SECRETS_FILE dla drugiego, a mcp-server-gsc używa GOOGLE_APPLICATION_CREDENTIALS.

Klient nie może uruchomić serwera

spawn uvx ENOENT lub spawn npx ENOENT. Aplikacje desktopowe nie wczytują zmiennej PATH z Twojego terminala, więc nie mogą znaleźć polecenia. Wpisz pełną ścieżkę w "command". Uzyskasz ją przez which uvx w macOS lub Linuksie albo where uvx w Windows. Dla npx w Windows użyj "command": "cmd" z argumentami ["/c", "npx", "-y", ...].

Brak narzędzi, brak pliku logu. mcp-gsc wymaga Pythona 3.11 lub nowszego i na starszych wersjach nie działa bez żadnego komunikatu. Uruchamiaj go przez uvx, który sam dobierze odpowiedniego Pythona, albo zainstaluj Pythona 3.12.

Zmiany w konfiguracji nic nie dają. Sprawdź, czy w JSON nie ma przecinków na końcu i nieescapowanych ukośników wstecznych, potem całkowicie zamknij aplikację i otwórz ją ponownie. Na Macu zamknięcie okna nie wystarczy; użyj Cmd+Q.

Gdzie są logi:

  • Claude Desktop w macOS: ~/Library/Logs/Claude. mcp.log zawiera błędy połączenia, a mcp-server-<name>.log błędy samego serwera.
  • Claude Desktop w Windows: %APPDATA%\Claude\logs.
  • Claude Code: uruchom claude mcp get <name>, żeby zobaczyć błąd, albo /mcp w trakcie sesji.
  • Cursor: otwórz panel Output i wybierz MCP Logs.

Jeszcze jedno ograniczenie: serwery lokalne działają tylko w aplikacjach desktopowych i terminalowych. Nie działają w claude.ai w przeglądarce ani w ChatGPT, które wymagają serwera zdalnego.

Liczby nie zgadzają się z panelem

To nie są błędy, ale to od nich pochodzi większość zgłoszeń typu „agent się pomylił”.

  • Opóźnienie. Dane Search Console zwykle docierają po dwóch, trzech dniach, a najnowsze dni mogą się jeszcze zmienić. Niektóre serwery pobierają tylko dane ostateczne, więc ostatnie dni wyglądają u nich na puste.
  • Limity wierszy. Jedno zapytanie do API zwraca najwyżej 25 000 wierszy, a Google udostępnia najwyżej 50 000 wierszy dziennie na typ wyszukiwania. Na dużej witrynie zapytania z długiego ogona zostają ucięte.
  • Brakujące zapytania. Rzadkie i osobiste zapytania są pomijane, więc wiersze zapytań nigdy nie sumują się do łącznej liczby kliknięć. Po dokładne sumy proś o dane bez wymiaru zapytania lub strony.
  • Różne sumy. Wykres sumuje według usługi, a tabela według strony, więc te liczby mogą się różnić. Sprawdź też zakres dat; dane godzinowe są w czasie pacyficznym.
  • Limity wywołań. Sprawdzanie adresów URL pozwala na 2000 sprawdzeń dziennie na witrynę, więc zbiorcze sprawdzanie dużej witryny zatrzymuje się w połowie. Search Analytics pozwala na 1200 zapytań na minutę na witrynę.

Pomiń Google Cloud całkowicie

Każdy błąd powyżej, poza ostatnią sekcją, wynika z prowadzenia własnego projektu Google Cloud. Google Search Console MCP od zaDojo jest hostowany za Ciebie: podłączasz Search Console w projekcie zaDojo zwykłym logowaniem przez Google, a agent czyta dane pod adresem https://app.zadojo.com/mcp. Nie ma projektu Cloud, API do włączenia, konta usługi, ekranu zgody ani pliku z danymi uwierzytelniającymi, a serwer działa w claude.ai i ChatGPT oraz w klientach desktopowych.

Odczyty z Search Console, sprawdzanie adresów URL i stan indeksowania są darmowe w planie Free zaDojo, który nie wymaga karty. Tak samo odczyty z Google Analytics i audyty witryny do 50 stron. Dane o słowach kluczowych, konkurencji i widoczności w AI zużywają kredyty. Porównanie z innymi darmowymi opcjami znajdziesz w zestawieniu darmowych serwerów MCP do SEO.

Najczęstsze pytania

Czy istnieje oficjalny serwer MCP dla Google Search Console? Nie. Google publikuje serwery MCP dla Google Analytics i innych produktów, ale nie dla Search Console. Każdy serwer Search Console to projekt społecznościowy albo usługa hostowana.

Konto usługi czy OAuth? Konto usługi pasuje do serwera, który działa bez nadzoru, ale jego adres e-mail trzeba dodać do każdej usługi. OAuth korzysta z Twojego własnego konta Google i widzi każdą usługę, do której już masz dostęp, ale w trybie Testing musisz logować się ponownie co 7 dni, dopóki nie ustawisz go na In production.

Dlaczego agent widzi tylko część moich witryn? Konto lub konto usługi, którego używa, widzi tylko usługi, do których zostało dodane. Poproś agenta o listę witryn i porównaj ją z Search Console.

Czy serwer Search Console MCP może zmienić moją stronę? Nie. Te serwery czytają dane Search Console i nimi zarządzają. Żaden z nich nie edytuje Twoich stron.