Chyby při nastavení Search Console MCP a opravy

Opravy chyb komunitních MCP serverů pro Google Search Console: API not enabled, 403, sc-domain, access blocked, invalid_grant, spawn uvx ENOENT.

Autor: Denis Veisllari

Většina chyb Google Search Console MCP pochází z pěti míst: z projektu v Google Cloud, ze služby v Search Console, z obrazovky souhlasu OAuth, ze souboru s přihlašovacími údaji a z konfigurace AI klienta. Najdi níže svou chybovou hlášku, oprav ten jeden krok a restartuj klienta. Pokud chceš Google Cloud úplně vynechat, poslední sekce ukazuje cestu, která potřebuje jen přihlášení přes Google.

Google oficiální MCP server pro Search Console nezveřejnil. Jeho repozitář MCP pokrývá Google Analytics, BigQuery, Maps a další, ale ne Search Console, takže každý server pro Search Console, který si můžeš nainstalovat, je komunitní projekt. Dva nejpoužívanější jsou mcp-gsc (instaluje se jako mcp-search-console) a mcp-server-gsc. Chyby níže platí pro oba i pro většinu ostatních.

Rychlé vyhledání

Co vidíšPravděpodobná příčinaPřejdi na
"has not been used in project ... before or it is disabled"Search Console API je v tom projektu Cloud vypnutéAPI není zapnuté
403 "User does not have sufficient permission for site"Servisní účet není přidaný ke službě, nebo špatná URLChyby oprávnění
"is not a verified Search Console site in this account"Záměna doménové služby a služby s předponou URLŠpatný formát služby
"Failed to add user: email not found" v Search ConsoleChyba Googlu u nových servisních účtůE-mail nenalezen
"Access blocked" nebo "Error 403: access_denied" na obrazovce GoogluAplikace OAuth v režimu Testing, nejsi testovací uživatelChyby obrazovky OAuth
invalid_grant zhruba týden poté, co vše fungovaloObnovovací tokeny v režimu Testing vyprší po 7 dnechFunguje, pak přestane
"Error 400: redirect_uri_mismatch"Použitý klient Web tam, kde je potřeba klient DesktopChyby obrazovky OAuth
"Service account credentials file not found"Relativní cesta nebo špatný balíčekSoubor s přihlašovacími údaji
spawn uvx ENOENT nebo spawn npx ENOENTKlient nemůže najít příkazChyby klienta
Neobjeví se žádné nástroje a nevznikne žádný logPython starší než 3.11Chyby klienta
Čísla nesedí s přehledem v Search ConsoleZpoždění dat, limity řádků, anonymizované dotazyČísla nesedí

API není zapnuté

Chyba je 403 s hláškou, že Google Search Console API "has not been used in project", následovaná číslem projektu, často s odkazem na jeho zapnutí.

API musí být zapnuté ve stejném projektu Cloud, kterému patří tvůj OAuth klient nebo servisní účet. Obvyklá chyba je zapnout ho v jiném projektu.

  1. Porovnej číslo projektu v chybě s projektem ve tvém JSON souboru s přihlašovacími údaji.
  2. V Google Cloud otevři v tom projektu APIs & Services > Library a zapni Google Search Console API.
  3. Počkej pár minut a zkus to znovu. Google uvádí, že nová nastavení se do jeho systémů můžou chvíli propisovat.

Chyby oprávnění

Chyba je 403 "User does not have sufficient permission for site". Kontrola URL místo toho hlásí "The caller does not have permission".

Vytvořením servisního účtu nezískáš žádný přístup k Search Console. Jeho e-mail musíš přidat přesně k té službě, na kterou se ptáš.

  1. Otevři JSON klíč servisního účtu a zkopíruj hodnotu client_email.
  2. V Search Console otevři Settings > Users and permissions > Add user, vlož e-mail a dej mu oprávnění Full.
  3. Pokud se přihlašuješ přes OAuth, použij účet Google, který tu službu v Search Console už vidí.

Pokud účet přístup má a pořád dostáváš 403, je nejspíš špatně řetězec služby. Přečti si další sekci.

Špatný formát služby

Chyba je "'sc-domain:example.com' is not a verified Search Console site in this account", nebo stejná 403 jako výše.

Search Console má dva druhy služeb a API chce přesný řetězec pro tu, kterou máš:

  • Doménová služba: sc-domain:example.com
  • Služba s předponou URL: celá URL s protokolem a lomítkem na konci, například https://www.example.com/

http a https jsou různé služby, stejně jako www a holá doména. Nehádej. Požádej agenta, ať spustí nástroj serveru pro výpis webů, a zkopíruj adresu webu přesně tak, jak se vrátí.

Search Console nenajde e-mail servisního účtu

Když přidáváš servisní účet jako uživatele, Search Console odpoví "Failed to add user: email not found."

Je to problém Googlu s nově vytvořenými servisními účty, ne tvoje chyba. Poprvé se objevil kolem dubna 2026, vrátil se v září 2026 a týká se i Google Analytics. Google ho uznal, ale termín opravy neuvedl. Uživatelé hlásí tři obejití:

  • Počkej několik hodin až den a přidej uživatele znovu.
  • Přidej uživatele přes API místo obrazovky Search Console.
  • Použij OAuth místo servisního účtu, pokud to tvůj server podporuje.

Chyby obrazovky OAuth

"Access blocked" s "Error 403: access_denied". Tvoje obrazovka souhlasu je v režimu Testing a účet Google, kterým ses přihlásil, není testovací uživatel. V Google Cloud otevři Google Auth Platform > Audience > Test users a přidej vlastní adresu.

"Google hasn't verified this app". Tohle se ukáže, když neověřená aplikace žádá o přístup k Search Console. Pokud jsi projekt Cloud vytvořil sám a používáš ho jen ty, můžeš varování přeskočit. Ověření je důležité, jen když aplikaci dáváš dalším lidem.

"Error 400: redirect_uri_mismatch". Vytvořil jsi OAuth klienta typu "Web application", ale lokální servery se přihlašují přes loopback adresu, například http://localhost s náhodným portem. Vytvoř nového OAuth klienta typu Desktop app, stáhni jeho JSON a nasměruj na něj server. U mcp-gsc je to nastavení GSC_OAUTH_CLIENT_SECRETS_FILE.

Fungovalo to a po týdnu to přestalo

Chyba je invalid_grant, obvykle "Token has been expired or revoked."

Google ruší obnovovací tokeny po 7 dnech, pokud je obrazovka souhlasu externí aplikace pořád v režimu Testing. Tokeny zaniknou také, když přístup odvoláš nebo je šest měsíců nepoužiješ.

  1. V Google Cloud nastav stav publikování obrazovky souhlasu na In production. Pro osobní použití může zůstat neověřená.
  2. Smaž soubor s tokenem, který server uložil.
  3. Přihlas se znovu.

Pokud používáš mcp-gsc, aktualizuj ho. Verze starší než 0.4.2 nemusely obnovit tokeny jen pro čtení a mazaly soubor s tokenem.

Soubor s přihlašovacími údaji nebyl nalezen

Chyba je "Service account credentials file not found."

  • Relativní cesta. Nástroje jako uvx spouštějí server ze složky cache, takže cesta jako ./key.json nikam nevede. V konfiguraci klienta použij úplnou cestu. Ve Windows zdvoj zpětná lomítka: C:\\Users\\you\\key.json.
  • Špatný balíček. Pro mcp-gsc nainstaluj mcp-search-console, ne nesouvisející balíček mcp-gsc na PyPI. Spouštěj ho jako uvx mcp-search-console@latest, ať máš aktuální verzi.
  • Špatný soubor ve špatném nastavení. Klíč servisního účtu obsahuje "type": "service_account" a client_email. Soubor OAuth klienta začíná klíčem installed nebo web. Každý patří do vlastního nastavení; mcp-gsc používá GSC_CREDENTIALS_PATH pro první a GSC_OAUTH_CLIENT_SECRETS_FILE pro druhý, mcp-server-gsc používá GOOGLE_APPLICATION_CREDENTIALS.

Klient nemůže spustit server

spawn uvx ENOENT nebo spawn npx ENOENT. Desktopové aplikace nenačítají PATH z tvého terminálu, takže příkaz nenajdou. Do "command" dej úplnou cestu. Zjistíš ji příkazem which uvx na macOS nebo Linuxu, nebo where uvx ve Windows. Pro npx ve Windows použij "command": "cmd" s argumenty ["/c", "npx", "-y", ...].

Žádné nástroje, žádný log. mcp-gsc potřebuje Python 3.11 nebo novější a na starších verzích tiše selže. Spouštěj ho přes uvx, který vhodný Python vybere sám, nebo nainstaluj Python 3.12.

Změny konfigurace nic nedělají. Zkontroluj, jestli v JSON nejsou čárky na konci a neescapovaná zpětná lomítka, pak aplikaci úplně ukonči a znovu otevři. Na Macu nestačí zavřít okno; použij Cmd+Q.

Kde najdeš logy:

  • Claude Desktop na macOS: ~/Library/Logs/Claude. mcp.log obsahuje selhání připojení a mcp-server-<name>.log chyby samotného serveru.
  • Claude Desktop ve Windows: %APPDATA%\Claude\logs.
  • Claude Code: spusť claude mcp get <name> pro zobrazení chyby, nebo /mcp uvnitř relace.
  • Cursor: otevři panel Output a vyber MCP Logs.

Ještě jedno omezení: lokální servery běží jen v desktopových a terminálových aplikacích. Nefungují na claude.ai v prohlížeči ani v ChatGPT, které potřebují vzdálený server.

Čísla nesedí s přehledem

Nejsou to chyby, ale stojí za většinou hlášení typu „agent se spletl“.

  • Zpoždění. Data ze Search Console obvykle dorazí po dvou až třech dnech a nejnovější dny se ještě můžou měnit. Některé servery žádají jen konečná data, takže poslední dny u nich vypadají prázdné.
  • Limity řádků. Jeden požadavek na API vrátí nejvýš 25 000 řádků a Google zpřístupní nejvýš 50 000 řádků denně na typ vyhledávání. Dotazy z dlouhého chvostu se na velkém webu oříznou.
  • Chybějící dotazy. Vzácné a osobní dotazy se vynechávají, takže součet řádků dotazů nikdy nedá celkový počet kliknutí. Pro přesné součty si řekni o data bez dimenze dotazu nebo stránky.
  • Rozdílné součty. Graf sčítá podle služby a tabulka podle stránky, takže se můžou lišit. Zkontroluj i rozsah dat; hodinová data jsou v tichomořském čase.
  • Kvóty. Kontrola URL dovoluje 2 000 kontrol denně na web, takže hromadná kontrola velkého webu se zastaví v půlce. Search Analytics dovoluje 1 200 dotazů za minutu na web.

Vynech Google Cloud úplně

Každá chyba výše kromě poslední sekce pochází z provozu vlastního projektu v Google Cloud. Google Search Console MCP od zaDojo je hostovaný za tebe: Search Console připojíš v projektu zaDojo běžným přihlášením přes Google a tvůj agent ji čte na adrese https://app.zadojo.com/mcp. Není tu žádný projekt Cloud, API k zapnutí, servisní účet, obrazovka souhlasu ani soubor s přihlašovacími údaji a funguje v claude.ai a ChatGPT i v desktopových klientech.

Čtení ze Search Console, kontrola URL a stav indexace jsou na tarifu Free v zaDojo, který nevyžaduje kartu, zdarma. Stejně tak čtení z Google Analytics a audity webu do 50 stránek. Data o klíčových slovech, konkurenci a viditelnosti v AI čerpají kredity. Srovnání s dalšími bezplatnými možnostmi najdeš v přehledu bezplatných SEO MCP serverů.

Časté otázky

Existuje oficiální MCP server pro Google Search Console? Ne. Google zveřejňuje MCP servery pro Google Analytics a další produkty, ale ne pro Search Console. Každý server pro Search Console je komunitní projekt nebo hostovaná služba.

Mám použít servisní účet, nebo OAuth? Servisní účet se hodí pro server, který běží bez dozoru, ale jeho e-mail musíš přidat ke každé službě. OAuth používá tvůj vlastní účet Google a vidí všechny služby, ke kterým už máš přístup, ale v režimu Testing se musíš každých 7 dní přihlásit znovu, dokud ho nepřepneš na In production.

Proč můj agent vidí jen některé z mých webů? Účet nebo servisní účet, který používá, vidí jen služby, ke kterým byl přidán. Požádej agenta o seznam webů a porovnej ho se Search Console.

Může MCP server pro Search Console změnit můj web? Ne. Tyto servery čtou a spravují data Search Console. Žádný z nich neupravuje tvoje stránky.