--- title: "Google Search Console MCP: як я падключыў GSC да Claude" description: "Асабісты досвед падключэння Google Search Console да Claude праз MCP-сервер: сэрвісны акаўнт, устаноўка на Windows, дзве памылкі па дарозе і знаходкі на жывым сайце." url: "https://it-deweloper.pl/be/blog/google-search-console-mcp" date: "2026-09-14T15:03:11+00:00" language: "be-BY" --- [Перайсці да змесціва](#tm-main) - [ Распрацоўка сайтаў](https://it-deweloper.pl/be "Галоўная старонка вэб-студыі IT Deweloper") - [Кошты](https://it-deweloper.pl/be/cost "Тарыфы і кошт паслуг") - [ПрайсПрыкладныя цэны на вэб-распрацоўку](https://it-deweloper.pl/be/cost/pricing "Цэны на распрацоўку сайта") - [КалькулятарСамастойны онлайн-разлік](https://it-deweloper.pl/be/cost/calculator "Разлічыць кошт сайта анлайн") - [БрыфАтрымайце дакладны разлік праекта](https://it-deweloper.pl/be/cost/brief "Запоўніць брыф на распрацоўку сайта") - [Рашэнні](https://it-deweloper.pl/be/web "Рашэнні IT Deweloper у вэб-распрацоўцы") - [Этапы працы](https://it-deweloper.pl/be/web/process "Этапы і тэрміны распрацоўкі сайта") - [SEO](https://it-deweloper.pl/be/web/seo "SEO прасоўванне сайта: аптымізацыя, раскрутка, пазіцыі ў Google") - [GEO](https://it-deweloper.pl/be/web/geo "GEO-аптымізацыя: прасоўванне сайта ў адказах ChatGPT, Gemini і Perplexity") - [ШI](https://it-deweloper.pl/be/web/ai) - [Партфоліа](https://it-deweloper.pl/be/portfolio "Партфоліа і прыклады работ") - [Пра нас](https://it-deweloper.pl/be/about "Пра заснавальніка студыі — Віктар Пархімчык") - [Кантакт](https://it-deweloper.pl/be/contact "Кантакты вэб-студыі IT Deweloper") - [ +48 731 190 041](tel:+48731190041 "Тэлефон") - [ office@it-deweloper.pl](mailto:office@it-deweloper.pl "Электронная пошта") - [ Nowogródzka 4A, Беласток, Польшча](https://maps.app.goo.gl/BNjvryytwRyv4omA7 "Адрас") - [ WhatsApp](https://wa.me/48731190041 "WhatsApp") - [ Telegram](https://t.me/+48731190041 "Telegram") - [FAQ](https://it-deweloper.pl/be/faq "Частыя пытанні пра распрацоўку сайтаў") - [Блог](https://it-deweloper.pl/be/blog "Артыкулы пра распрацоўку і прасоўванне сайтаў") - [ Русский ](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) Беларуская - [ Русский ](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/be) [ Меню ](#tm-dialog) - [ Распрацоўка сайтаў](https://it-deweloper.pl/be "Галоўная старонка вэб-студыі IT Deweloper") - [Кошты](https://it-deweloper.pl/be/cost "Тарыфы і кошт паслуг") - [ПрайсПрыкладныя цэны на вэб-распрацоўку](https://it-deweloper.pl/be/cost/pricing "Цэны на распрацоўку сайта") - [КалькулятарСамастойны онлайн-разлік](https://it-deweloper.pl/be/cost/calculator "Разлічыць кошт сайта анлайн") - [БрыфАтрымайце дакладны разлік праекта](https://it-deweloper.pl/be/cost/brief "Запоўніць брыф на распрацоўку сайта") - [Рашэнні](https://it-deweloper.pl/be/web "Рашэнні IT Deweloper у вэб-распрацоўцы") - [Этапы працы](https://it-deweloper.pl/be/web/process "Этапы і тэрміны распрацоўкі сайта") - [SEO](https://it-deweloper.pl/be/web/seo "SEO прасоўванне сайта: аптымізацыя, раскрутка, пазіцыі ў Google") - [GEO](https://it-deweloper.pl/be/web/geo "GEO-аптымізацыя: прасоўванне сайта ў адказах ChatGPT, Gemini і Perplexity") - [ШI](https://it-deweloper.pl/be/web/ai) - [Партфоліа](https://it-deweloper.pl/be/portfolio "Партфоліа і прыклады работ") - [Пра нас](https://it-deweloper.pl/be/about "Пра заснавальніка студыі — Віктар Пархімчык") - [Кантакт](https://it-deweloper.pl/be/contact "Кантакты вэб-студыі IT Deweloper") - [ +48 731 190 041](tel:+48731190041 "Тэлефон") - [ office@it-deweloper.pl](mailto:office@it-deweloper.pl "Электронная пошта") - [ Nowogródzka 4A, Беласток, Польшча](https://maps.app.goo.gl/BNjvryytwRyv4omA7 "Адрас") - [ WhatsApp](https://wa.me/48731190041 "WhatsApp") - [ Telegram](https://t.me/+48731190041 "Telegram") - [FAQ](https://it-deweloper.pl/be/faq "Частыя пытанні пра распрацоўку сайтаў") - [Блог](https://it-deweloper.pl/be/blog "Артыкулы пра распрацоўку і прасоўванне сайтаў") [ Блог вэб-студыі IT Deweloper ](https://it-deweloper.pl/index.php?option=com_content&view=category&id=20&lang=be-BY "Блог вэб-студыі IT Deweloper") # Google Search Console MCP: як я падключыў GSC да Claude У верасні 2026 года я падключыў Google Search Console свайго сайта да Claude праз MCP-сервер. Нагода была цалкам празаічная: у індэксе віселі смеццевыя адрасы, а высвятляць уручную, адкуль яны ўзяліся, не хацелася. Ніжэй увесь шлях — ад выбару спосабу аўтарызацыі праз дзве памылкі, якія давялося выпраўляць па дарозе, да таго, што знайшлося на жывым сайце. Гэта не падборка «лепшых MCP-сервераў». Адзін сервер, адзін рабочы камп'ютар на Windows, сайт на чатырох мовах — і шчырыя ўражанні пасля першых дзён працы. --- ![Search Console, MCP-сервер і ШІ-памочнік, злучаныя ў ланцужок на экране камп'ютара](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) ## MCP-сервер простымі словамі MCP (Model Context Protocol) — адкрыты пратакол, праз які ШІ-памочнік выклікае знешнія інструменты. MCP-сервер — праграма-пасярэднік: з аднаго боку яна размаўляе з памочнікам, з другога — звяртаецца да API патрэбнага сэрвісу. У выпадку Search Console гэта значыць, што Claude сам запытвае справаздачу па запытах, правярае URL ці параўноўвае перыяды, а не просіць мяне выгрузіць CSV і ўставіць яго ў чат. Сервер запускаецца лакальна, на тым жа камп'ютары, дзе працуе Claude Desktop або Claude Code, і абменьваецца з памочнікам данымі праз стандартны ўвод-вывад. Асобны хостынг для гэтага не патрэбны. ## Які сервер я выбраў і што праверыў да ўстаноўкі Я ўзяў **Google Search Console MCP** — Python-пакет `gsc-mcp-tools`. Вырашылі тры рэчы: - **Ахоп.** 61 інструмент: справаздачы Search Analytics, праверка URL, карты сайта, Indexing API, а зверху — GA4, даныя CrUX, PageSpeed і аўдыты разметкі, hreflang, загалоўкаў і ўнутраных спасылак. - **Сэрвісны акаўнт.** Можна абысціся без уваходу праз браўзер — для лакальнага сервера, які працуе тыднямі, гэта зручней. - **Кансольны кліент у камплекце.** Кожны інструмент даступны яшчэ і як каманда `gsc-cli`. Гэта спатрэбілася, калі Claude яшчэ не бачыў новы сервер. Перад устаноўкай я прайшоўся па тым, што правяраю ў любога MCP-сервера: ці адкрыты код, якая ліцэнзія, якія залежнасці і куды праграма звяртаецца ў сеціве. Ліцэнзія MIT, запыты ідуць толькі ў API Google, у IndexNow і на старонкі сайта, які правяраецца, а токены захоўваюцца ў лакальных файлах. Чаму такую праверку не варта прапускаць, я разбіраў у артыкуле [пра бяспеку ШІ-інструментаў](https://it-deweloper.pl/be/blog/ai-tool-security-check). ## Крок 1. Аўтарызацыя: сэрвісны акаўнт замест OAuth У пакета два рэжымы. OAuth — звыклы ўваход праз браўзер пад сваім акаўнтам Google. Сэрвісны акаўнт — тэхнічны карыстальнік праекта Google Cloud з JSON-ключом: нікуды ўваходзіць не трэба, і сервер не залежыць ад тэрміну дзеяння OAuth-токенаў. Для лакальнага сервера я выбраў другое. 1. У праекце Google Cloud уключыць **Google Search Console API**. Для адпраўкі URL і даных GA4 — яшчэ **Web Search Indexing API** і **Google Analytics Data API**. 2. Стварыць сэрвісны акаўнт і спампаваць JSON-ключ. 3. Выдаць доступ у самой Search Console: *Налады → Карыстальнікі і дазволы → Дадаць карыстальніка*, пазначыць адрас сэрвіснага акаўнта. Галоўная неачавіднасць — трэці пункт. Ролі ў Google Cloud на Search Console не ўплываюць: пакуль адрас не дададзены ў карыстальнікі рэсурсу, любы выклік вяртае 403 пры ідэальна правільным ключы. API для гэтага кроку няма — толькі форма ў інтэрфейсе, рукамі ўладальніка сайта. Узровень доступу я даў «Поўны»: яго хапае на чытанне справаздач і праверку URL. «Уладальнік» патрэбны толькі для Indexing API, і выдаваць яго без патрэбы не варта. Час зэканоміла тое, што сэрвісны акаўнт у мяне ўжо быў — ствараў яго раней для Google Analytics. Адзін акаўнт можна выкарыстоўваць у некалькіх прадуктах Google, доступ у кожным выдаецца асобна. Ключ я трымаю па-за воблачнымі папкамі, якія сінхранізуюцца: па сутнасці гэта пароль да даных. ## Крок 2. Устаноўка — і першая яма: скончылася месца Стаўлю праз pipx, каб пакет жыў у ізаляваным асяроддзі: ``` python -m pipx install gsc-mcp-tools ``` Устаноўка ўпала з памылкай `No space left on device`. Сістэмны дыск C: аказаўся забіты амаль цалкам — вольна каля 200 МБ, а pipx па змаўчанні стварае асяроддзе менавіта там. Лечыцца пераносам каталогаў pipx на іншы дыск перад устаноўкай: ``` $env:PIPX_HOME = "D:\pipx" $env:PIPX_BIN_DIR = "D:\pipx\bin" python -m pipx install gsc-mcp-tools ``` Асяроддзе заняло каля 270 МБ. У каталогу `bin` з'явіліся тры праграмы: `gsc-mcp` — сам сервер, `gsc-mcp-tools` — ён жа пад імем пакета і `gsc-cli` — кансольны кліент. ## Крок 3. Рэгістрацыя ў Claude Code Ключ перадаецца праз пераменныя асяроддзя. У PowerShell: ``` $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 ``` Сцяг `-s user` кладзе запіс у карыстальніцкую канфігурацыю, а не ў файл праекта. Для мяне гэта важна: папка праекта сінхранізуецца з воблакам, і шлях да ключа там свяціць няма чаго. Для інструментаў GA4 у тую ж каманду дадаецца `-e GA4_PROPERTY_ID=…`. ``` claude mcp list ``` Насупраць `gsc` з'явілася «Connected». І другая неачавіднасць: у ўжо адкрытай сесіі новых інструментаў няма. Спіс падхопліваецца пры запуску сесіі, таму пасля дадання сервера яе трэба адкрыць нанова. Да таго ж «Connected» азначае толькі тое, што працэс стартуе і адказвае на поціск рукі, — а не тое, што правы ў Search Console выдадзены. ## Крок 4. Праверка без Claude — і памылка ў кліенце Каб не чакаць новай сесіі, я вырашыў праверыць доступ кансольным кліентам з таго ж пакета: ``` gsc-cli list ``` Ён упаў яшчэ да звароту да Google: `ValueError: badly formed help string`. Трасіроўка паказала, што кліент бярэ першы радок апісання кожнага інструмента і перадае яго ў `argparse` як тэкст даведкі. У адным з апісанняў ёсць знак `%`, а свежы `argparse` (у мяне Python 3.14) правярае такія радкі адразу пры стварэнні каманд і прымае працэнт за пачатак шаблону фарматавання. Дапамагла адна праўка ў `gsc_mcp/cli.py` — экранаваць працэнт перад перадачай: ``` help=help_text.replace("%", "%%") ``` На сам MCP-сервер гэта не ўплывае, ламаўся толькі кліент. Але праўка жыве ва ўсталяваным пакеце і знікне пры абнаўленні — такое лепш адпраўляць аўтару. Яшчэ дэталь: параметры-спісы перадаюцца паўторам сцяга, а не праз коску. Радок праз коску памылкі не выклікае — ён моўчкі ператвараецца ў адзін «адрас»: ``` gsc-cli batch-url-inspection ` --site https://example.com/ ` --urls https://example.com/a ` --urls https://example.com/b ``` Пасля праўкі каманда `gsc-cli list-properties` вярнула мой сайт з узроўнем `siteFullUser` — доступ працуе. ## Што знайшлося на жывым сайце **Смеццевыя адрасы.** Google усё яшчэ трымаў восем лішніх URL: `/ru?Itemid=232` і суседнія — рэшткі даўно выдаленых пунктаў меню, і два старыя адрасы выгляду `/ru/component/content/article/2-…?catid=14` у двух даўно знятых з публікацыі артыкулаў 2019 і 2021 гадоў. Усе восем цяпер аддаюць 410 Gone. Са старымі адрасамі выйшла павучальная гісторыя. Правіла перанакіравання на зыходны адрас не спрацоўвала ўвогуле. Аказалася, Joomla сама перахоплівае стары фармат `/component/content/article/…` і аддае 301 на прамежкавы `?view=article&id=…` — і толькі гэты другі адрас насамрэч адказвае 404. Правіла давялося вешаць на яго. Заадно знайшлася памылка ў MCP-канектары для Joomla: інструмент стварэння перанакіраванняў запісваў код адказу не ў тое поле. **Праверка URL.** Для такіх адрасоў з параметрамі інструмент праверкі вярнуў `NEUTRAL` і пустыя палі. Гэта не памылка выкліку: у Google проста няма асобных даных праверкі па гэтых URL. Пакет жа ставіць ім катэгорыю `fetch_error` — цэтлік уводзіць у зман, глядзець варта на самі палі. Для звычайнай старонкі той жа інструмент аддаў «PASS», дату апошняга абыходу і кананічны адрас. **Хуткія перамогі.** Інструмент `quick_wins` паказаў, што галоўная старонка ў сярэднім на 8-й пазіцыі, але за чатыры тыдні пры 295 паказах атрымала адзін клік. Чаканая клікабельнасць для такой пазіцыі — каля 3 %, фактычная — 0,3 %. Бліжэйшая задача відавочная: загаловак і апісанне ў выніках пошуку. ## Што аказалася карысным, а што не - **Працуе адразу:** параўнанне перыядаў, пошук запытаў, што праселі, хуткія перамогі, пакетная праверка URL, аўдыт карты сайта, тэхнічны аўдыт старонкі. Адказ прыходзіць за секунды, і Claude сам выбірае, які інструмент выклікаць пад пытанне. - **Патрабуе падрыхтоўкі:** інструментам GA4 патрэбны доступ сэрвіснага акаўнта ў Google Analytics, даным CrUX — асобны API-ключ і дастатковы трафік. - **З агаворкамі:** Indexing API афіцыйна прызначаны толькі для старонак з вакансіямі і трансляцыямі, а квота — 200 запытаў за суткі. Для звычайных старонак разлічваць на яго не варта. - **Памятаць заўсёды:** даныя Search Console адстаюць на 2–3 дні, а ў невялікага сайта іх проста мала. ## Кароткі чэк-ліст 1. Уключыць Google Search Console API у праекце Google Cloud. 2. Стварыць сэрвісны акаўнт, спампаваць JSON-ключ і захоўваць яго па-за воблачнымі папкамі. 3. Дадаць адрас акаўнта ў Search Console з узроўнем «Поўны». 4. Паставіць `gsc-mcp-tools` праз pipx; калі не хапае месца, перанесці `PIPX_HOME`. 5. Зарэгістраваць сервер праз `claude mcp add` у карыстальніцкай вобласці. 6. Праверыць доступ камандай `gsc-cli list-properties` і адкрыць новую сесію Claude. Калі праходзіць гэты шлях самому не хочацца, мы можам [падключыць Google Search Console да ШІ-памочніка за вас](https://it-deweloper.pl/be/web/ai/google-search-console-ai) — на вашым камп'ютары ці ў вашым воблаку. *Victor Parhimchik, заснавальнік вэб-студыі IT Deweloper* 14 верасня 2026 | [Victor Parhimchik](https://it-deweloper.pl/index.php?option=com_contact&view=contact&id=1&catid=4) | [Блог вэб-студыі IT Deweloper](https://it-deweloper.pl/index.php?option=com_content&view=category&id=20) ![](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) ## Стварыце свой сайт Даведайцеся, колькі будзе каштаваць распрацоўка вашага сайта [ Прайс ](https://it-deweloper.pl/index.php?Itemid=269&lang=be-BY) ![](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) ### [ Кантакт ](https://it-deweloper.pl/index.php?Itemid=283&lang=be-BY) Вэб-студыя IT Deweloper распрацоўка сайтаў, Польшча. 5423493188 SEOШІРэкламаВэбSMM ### Адрас Nowogródzka 4A Беласток, 15-490, PL [ ### Тэлефон +48 731 190 041 ](tel:+48731190041) [ ### Электронная пошта Гэты адрас электроннай пошты абаронены ад спам-ботаў. Для яго прагляду ў вас павінен быць уключаны JavaScript у браўзэры. ](mailto:office@it-deweloper.pl) [ ### WhatsApp ](https://wa.me/48731190041) [ ### Telegram ](https://t.me/+48731190041) Час працы: - Панядзелак 0900–1800 - Аўторак 0900–1800 - Серада 0900–1800 - Чацвер 0900–1800 - Пятніца 0900–1800 - Субота 0900–1600 - Нядзеля выхадны ![IT Deweloper](https://it-deweloper.pl/images/Logo.webp) Вэб-распрацоўка можа быць цікавай! Нашы сацыяльныя сеткі з кантэнтам пра стварэнне сайтаў. - [](https://www.facebook.com/ITdeweloper) - [](https://www.linkedin.com/company/it-deweloper) - [Партфоліа](https://it-deweloper.pl/index.php?Itemid=307&lang=be-BY) - [Кантакты](https://it-deweloper.pl/index.php?Itemid=283&lang=be-BY) - [Пра нас](https://it-deweloper.pl/index.php?Itemid=260&lang=be-BY) **it-deweloper** — студыя вэб-распрацоўкі. Мы праектуем і ствараем сучасныя сайты і інтэрнэт-крамы. © [it-deweloper](https://it-deweloper.pl/). Усе правы абаронены. [Палітыка прыватнасці](https://it-deweloper.pl/index.php?Itemid=312&lang=be)