Ошибки настройки 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 выключен в этом проекте CloudAPI не включён
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 включён в другом проекте.

  1. Сравните номер проекта в ошибке с проектом из JSON-файла с вашими учётными данными.
  2. В Google Cloud откройте в этом проекте APIs & Services > Library и включите Google Search Console API.
  3. Подождите несколько минут и попробуйте снова. Google предупреждает, что новым настройкам нужно время, чтобы дойти до его систем.

Ошибки прав доступа

Ошибка выглядит как 403 "User does not have sufficient permission for site". Проверка URL вместо этого пишет "The caller does not have permission".

Созданный сервисный аккаунт не получает никакого доступа к Search Console. Его email нужно добавить именно в тот ресурс, который вы запрашиваете.

  1. Откройте JSON-ключ сервисного аккаунта и скопируйте значение client_email.
  2. В Search Console откройте Settings > Users and permissions > Add user, вставьте email и выдайте полный доступ (Full).
  3. Если вы входите через 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. Токены также перестают работать, если вы отозвали доступ или не пользовались ими шесть месяцев.

  1. В Google Cloud переведите статус публикации экрана согласия в In production. Для личного использования приложение может остаться непроверенным.
  2. Удалите файл с токеном, который сохранил сервер.
  3. Войдите снова.

Если пользуетесь 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 и управляют ими. Ни один из них не редактирует ваши страницы.

zaDojo