Ошибки настройки Search Console MCP и решения
Как исправить ошибки серверов Google Search Console MCP: API не включён, 403 по правам, sc-domain, Access blocked, invalid_grant, spawn uvx ENOENT.
Автор: Denis Veisllari
Большинство ошибок Google Search Console MCP возникает в пяти местах: проект Google Cloud, ресурс Search Console, экран согласия OAuth, файл с учётными данными и конфигурация ИИ-клиента. Найдите своё сообщение об ошибке ниже, исправьте этот один шаг и перезапустите клиент. Если хотите обойтись без Google Cloud совсем, в последнем разделе описан путь, которому нужен только вход через Google.
Официального MCP-сервера Search Console Google не публиковал. Его репозиторий MCP охватывает Google Analytics, BigQuery, Maps и другие продукты, но не Search Console, поэтому любой сервер Search Console, который можно установить, это проект сообщества. Два самых используемых: mcp-gsc (устанавливается как mcp-search-console) и mcp-server-gsc. Ошибки ниже относятся к обоим и к большинству остальных.
Быстрый поиск
| Что вы видите | Вероятная причина | Раздел |
|---|---|---|
| "has not been used in project ... before or it is disabled" | Search Console API выключен в этом проекте Cloud | API не включён |
| 403 "User does not have sufficient permission for site" | Сервисный аккаунт не добавлен в ресурс или неверный URL | Ошибки прав доступа |
| "is not a verified Search Console site in this account" | Путаница между доменным ресурсом и ресурсом с префиксом URL | Неверный формат ресурса |
| "Failed to add user: email not found" в Search Console | Ошибка Google с новыми сервисными аккаунтами | Email не найден |
| "Access blocked" или "Error 403: access_denied" на экране Google | Приложение OAuth в режиме Testing, вы не тестовый пользователь | Ошибки экрана OAuth |
invalid_grant примерно через неделю после того, как всё работало | Токены обновления в режиме Testing истекают через 7 дней | Работало, потом перестало |
| "Error 400: redirect_uri_mismatch" | Клиент Web там, где нужен клиент Desktop | Ошибки экрана OAuth |
| "Service account credentials file not found" | Относительный путь или не тот пакет | Файл с учётными данными |
spawn uvx ENOENT или spawn npx ENOENT | Клиент не находит команду | Ошибки клиента |
| Инструменты не появляются, лог не пишется | Python старше 3.11 | Ошибки клиента |
| Цифры не совпадают с панелью Search Console | Задержка данных, лимиты строк, анонимизированные запросы | Цифры не совпадают |
API не включён
Ошибка выглядит как 403 с сообщением, что Google Search Console API "has not been used in project" и номером проекта, часто со ссылкой для включения.
API должен быть включён в том же проекте Cloud, которому принадлежит ваш OAuth-клиент или сервисный аккаунт. Обычная ошибка: API включён в другом проекте.
- Сравните номер проекта в ошибке с проектом из JSON-файла с вашими учётными данными.
- В Google Cloud откройте в этом проекте APIs & Services > Library и включите Google Search Console API.
- Подождите несколько минут и попробуйте снова. Google предупреждает, что новым настройкам нужно время, чтобы дойти до его систем.
Ошибки прав доступа
Ошибка выглядит как 403 "User does not have sufficient permission for site". Проверка URL вместо этого пишет "The caller does not have permission".
Созданный сервисный аккаунт не получает никакого доступа к Search Console. Его email нужно добавить именно в тот ресурс, который вы запрашиваете.
- Откройте JSON-ключ сервисного аккаунта и скопируйте значение
client_email. - В Search Console откройте Settings > Users and permissions > Add user, вставьте email и выдайте полный доступ (Full).
- Если вы входите через OAuth, используйте аккаунт Google, который уже видит этот ресурс в Search Console.
Если у аккаунта есть доступ, а 403 всё равно появляется, скорее всего, неверно указан ресурс. Читайте следующий раздел.
Неверный формат ресурса
Ошибка выглядит как "'sc-domain:example.com' is not a verified Search Console site in this account" или как тот же 403, что выше.
В Search Console есть два вида ресурсов, и API ждёт точную строку для вашего:
- Доменный ресурс:
sc-domain:example.com - Ресурс с префиксом URL: полный URL с протоколом и косой чертой в конце, например
https://www.example.com/
http и https это разные ресурсы, как и www и домен без него. Не угадывайте. Попросите агента запустить инструмент сервера со списком сайтов и скопируйте URL сайта ровно в том виде, в каком он вернулся.
Search Console пишет, что email сервисного аккаунта не найден
Когда вы добавляете сервисный аккаунт как пользователя, Search Console отвечает "Failed to add user: email not found."
Это проблема Google с только что созданными сервисными аккаунтами, а не ваша ошибка. Впервые о ней сообщили примерно в апреле 2026 года, в сентябре 2026 года она вернулась и затрагивает также Google Analytics. Google её признал, но срок исправления не назвал. Пользователи сообщают о трёх обходных путях:
- Подождать от нескольких часов до суток и добавить пользователя снова.
- Добавить пользователя через API, а не через интерфейс Search Console.
- Использовать OAuth вместо сервисного аккаунта, если ваш сервер это поддерживает.
Ошибки экрана OAuth
"Access blocked" с "Error 403: access_denied". Ваш экран согласия в режиме Testing, а аккаунт Google, которым вы вошли, не тестовый пользователь. В Google Cloud откройте Google Auth Platform > Audience > Test users и добавьте свой адрес.
"Google hasn't verified this app". Это предупреждение появляется, когда непроверенное приложение просит доступ к Search Console. Если вы сами создали проект Cloud и пользуетесь им только вы, можно продолжить, минуя предупреждение. Проверка приложения важна, только если вы отдаёте его другим людям.
"Error 400: redirect_uri_mismatch". Вы создали OAuth-клиент типа "Web application", а локальные серверы входят через loopback-адрес вроде http://localhost со случайным портом. Создайте новый OAuth-клиент типа Desktop app, скачайте его JSON и укажите серверу путь к нему. Для mcp-gsc это настройка GSC_OAUTH_CLIENT_SECRETS_FILE.
Работало, а через неделю перестало
Ошибка invalid_grant, обычно "Token has been expired or revoked."
Google отзывает токены обновления через 7 дней, если экран согласия внешнего приложения всё ещё в режиме Testing. Токены также перестают работать, если вы отозвали доступ или не пользовались ими шесть месяцев.
- В Google Cloud переведите статус публикации экрана согласия в In production. Для личного использования приложение может остаться непроверенным.
- Удалите файл с токеном, который сохранил сервер.
- Войдите снова.
Если пользуетесь mcp-gsc, ещё и обновите его. Версии до 0.4.2 могли не обновить токены только для чтения и удалить файл с токеном.
Файл с учётными данными не найден
Ошибка "Service account credentials file not found."
- Относительный путь. Инструменты вроде uvx запускают сервер из папки кеша, поэтому путь вида
./key.jsonникуда не ведёт. Укажите в конфигурации клиента полный путь. В Windows удваивайте обратные косые черты:C:\\Users\\you\\key.json. - Не тот пакет. Для mcp-gsc устанавливайте
mcp-search-console, а не посторонний пакетmcp-gscиз PyPI. Запускайте его какuvx mcp-search-console@latest, чтобы получить текущую версию. - Не тот файл не в той настройке. Ключ сервисного аккаунта содержит
"type": "service_account"иclient_email. Файл OAuth-клиента начинается с ключаinstalledилиweb. Каждый указывается в своей настройке: mcp-gsc используетGSC_CREDENTIALS_PATHдля первого иGSC_OAUTH_CLIENT_SECRETS_FILEдля второго, а mcp-server-gsc используетGOOGLE_APPLICATION_CREDENTIALS.
Клиент не может запустить сервер
spawn uvx ENOENT или spawn npx ENOENT. Десктопные приложения не загружают PATH вашего терминала, поэтому не находят команду. Укажите полный путь в "command". Узнать его можно командой which uvx в macOS или Linux либо where uvx в Windows. Для npx в Windows используйте "command": "cmd" с аргументами ["/c", "npx", "-y", ...].
Нет инструментов, нет лог-файла. mcp-gsc нужен Python 3.11 или новее, на старых версиях он молча падает. Запускайте его через uvx, который сам подберёт подходящий Python, или установите Python 3.12.
Изменения конфигурации ни на что не влияют. Проверьте JSON на висячие запятые и неэкранированные обратные косые черты, затем полностью закройте приложение и откройте снова. На Mac закрыть окно недостаточно, нажмите Cmd+Q.
Где искать логи:
- Claude Desktop в macOS:
~/Library/Logs/Claude. Вmcp.logошибки подключения, а вmcp-server-<name>.logсобственные ошибки этого сервера. - Claude Desktop в Windows:
%APPDATA%\Claude\logs. - Claude Code: выполните
claude mcp get <name>, чтобы увидеть ошибку, или/mcpвнутри сессии. - Cursor: откройте панель Output и выберите MCP Logs.
Ещё одно ограничение: локальные серверы работают только в десктопных и терминальных приложениях. Они не работают на claude.ai в браузере и в ChatGPT, которым нужен удалённый сервер.
Цифры не совпадают с панелью
Это не ошибки, но именно из-за них чаще всего жалуются, что «агент ошибся».
- Задержка. Данные Search Console обычно приходят через два-три дня, а последние дни ещё могут меняться. Некоторые серверы запрашивают только окончательные данные, поэтому последние дни у них выглядят пустыми.
- Лимиты строк. Один запрос к API возвращает не больше 25 000 строк, а Google отдаёт не больше 50 000 строк в день на тип поиска. На большом сайте запросы из длинного хвоста обрезаются.
- Пропавшие запросы. Редкие и персональные запросы не показываются, поэтому строки по запросам никогда не складываются в общее число кликов. Для точных итогов запрашивайте данные без измерения запроса или страницы.
- Разные итоги. График считает итоги по ресурсу, а таблица по странице, поэтому они могут расходиться. Проверьте и диапазон дат; почасовые данные идут по тихоокеанскому времени.
- Квоты. Проверка URL позволяет 2000 проверок в день на сайт, поэтому пакетная проверка на большом сайте останавливается на полпути. Search Analytics позволяет 1200 запросов в минуту на сайт.
Обойтись без Google Cloud совсем
Все ошибки выше, кроме последнего раздела, возникают из-за собственного проекта Google Cloud. Google Search Console MCP от zaDojo размещается за вас: вы подключаете Search Console в проекте zaDojo обычным входом через Google, а агент читает данные по адресу https://app.zadojo.com/mcp. Не нужны ни проект Cloud, ни включение API, ни сервисный аккаунт, ни экран согласия, ни файл с учётными данными, и всё работает в claude.ai и ChatGPT, а также в десктопных клиентах.
Чтение Search Console, проверка URL и покрытие индекса бесплатны на тарифе Free в zaDojo, для которого не нужна карта. Так же бесплатны чтение Google Analytics и аудит сайта до 50 страниц. Данные по ключевым словам, конкурентам и видимости в ИИ тратят кредиты. Сравнение с другими бесплатными вариантами есть в обзоре бесплатных SEO MCP-серверов.
Частые вопросы
Есть ли официальный MCP-сервер Google Search Console? Нет. Google публикует MCP-серверы для Google Analytics и других продуктов, но не для Search Console. Любой сервер Search Console это проект сообщества или облачный сервис.
Что использовать: сервисный аккаунт или OAuth? Сервисный аккаунт подходит серверу, который работает без участия человека, но его email придётся добавить в каждый ресурс. OAuth использует ваш собственный аккаунт Google и видит все ресурсы, к которым у вас уже есть доступ, но в режиме Testing вам придётся входить заново каждые 7 дней, пока вы не переведёте приложение в In production.
Почему агент видит только часть моих сайтов? Аккаунт или сервисный аккаунт, который он использует, видит только ресурсы, в которые его добавили. Попросите агента вывести список сайтов и сравните его с Search Console.
Может ли MCP-сервер Search Console изменить мой сайт? Нет. Эти серверы читают данные Search Console и управляют ими. Ни один из них не редактирует ваши страницы.