Google Play Console MCP

MCP-сервер для Google Play Console — 169 инструментов для публикации, Android vitals, дохода, ASO и магазинных материалов, с подтверждающим шлюзом на каждом деструктивном действии.

Подключите Claude, Cursor, VS Code, Codex, Gemini CLI, Windsurf или любой клиент Model Context Protocol к своему аккаунту разработчика Google Play.

Выпускайте релиз. Спрашивайте, не падает ли он. Узнавайте, что он заработал. Смотрите, что пользователи вводили в поиске, чтобы его найти. Отвечайте на отзыв. Всё это — в одной сессии, и ни одна разрушительная операция не выполнится, пока вы явно не скажете «да».

"Is the 4.2.1 rollout healthy?"
  -> vitals freshness checked, crash rate by version code, worst issue's stack
     trace, current rollout fraction — and a recommendation

"How much did we make in July, and where did the installs come from?"
  -> earnings per currency, acquisitions by traffic source, top search terms

"Ship 4.2.2 to production at 10%."
  -> a preview you have to approve before anything moves

Почему именно этот

На рынке есть десяток MCP-серверов для Google Play. Этот — единственный, кто покрывает всю поверхность, и единственный с реальным набором тестов.

Большинство серверов оборачивают Android Publisher API и останавливаются. Этот API не скажет вам, какова частота падений, сколько заработано и что пользователи набирали, чтобы найти приложение — всё это живёт в двух других местах.

Related MCP server: MCP Google Play Store Server

Пять направлений

Каждому из этих направлений нужны свои учётные данные, и сервер точно рассказывает, какие отсутствуют и как это исправить.

Установка

uvx google-play-console-mcp          # no install
pipx install google-play-console-mcp # or install it
pip install google-play-console-mcp

Отчужка

Добавьте в вашего MCP-клиента (.mcp.json, claude_desktop_config.json, …):

{
  "mcpServers": {
    "google-play": {
      "command": "uvx",
      "args": ["google-play-console-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json",
        "GOOGLE_PLAY_MCP_REPORTS_BUCKET": "pubsite_prod_rev_0123456789"
      }
    }
  }
}

Учётные данные

1. Учётная запись сервиса — в Google Cloud Console включите Google Play Android Developer API → создайте учётную запись сервиса → скачайте JSON-ключ.

2. Пригласите её в Play Console → «Пользователи и разрешения».

3. Выдайте ей следующие — уровни независимы и о них легко забыть:

Разрешение на массовые отчёты выдаётся на уровне аккаунта. Выдача уровня приложения не достаёт до bucket-хранилища — и это самая частая причина ошибок 403 у этих инструментов.

Найдите bucket-адрес в Play Console → Download reports → Statistics → Copy Cloud Storage URI. Нет никакого API, который бы определял её самостоятельно.

Затем попросите агента выполнить check_reports_access или прочитайте ресурс gplay://config — по обоим видно, что настроено и что требуется для каждого пробела.

Безопасность

Этот сервер умеет выпускать в прод, удалять все локализованные страницы и возвращать реальные деньги. Поэтому:

18 деструктивных инструментов защищены двухвороточным подтверждением. Первый вызов возвращает предпросмотр — что меняется, на что влияет, как откатить — и ничего не делает. Только второй вызов с этим токеном предпросмотра выполняет действие.

Токен — это HMAC по каноническому отпечатку операции, подписанный секретом конкретной установки, который модель никогда не видит. Он ловит вымышленный токен, токен от другой операции, параметр, изменённый между предпросмотром и подтверждением, повторное использование токена и истёкший токен.

Модель угроз — не враждебный пользователь. Это языковая модель, что галлюцинирует покторискаемые, воспроизводит старые, подменяет параметр между предпросмотром и подтверждением и с удовольствием доложит, что вы одобрили то, чего не видели.

halt_release намеренно не закрыт воротами. Остановка неудачного релиза — единственная операция, которая сокращает радиус поражения, и требование второго прохода во время инцидента само по себе и есть отказ.

Продакш нельзя на 100% одним шагом. Политика поэтапного выката ограничивает первый шаг в 20%; досяжимость всей аудитории требует отдельного инструмента расширения охвата. Потолок можно ужесточить, но не отключить.

Всё аудируется — просмотрено, подтверждено, отклонено, выполнено, упало — в ~/.google-play-mcp/audit.jsonl, при этом секреты вычищаются.

GOOGLE_PLAY_MCP_READ_ONLY=1 полностью запрещает любую запись — для исследовательских сессий.

См. Безопасность записи.

Что сервер знает, а вы иначе узнавали бы долгим опытом

• Скриншоты не должны содержать альфа-канал; у иконки он должен быть. Обычный экспорт «PNG» — это RGBA: подходит для иконки и отклоняется для всего остального. preflight_store_image ловит это до того, как массовая генерация шестидесяти изображений рухнет при загрузке.

• Play требует минимум два скриншота на каждый тип в каждой локали. Акцион из одного файла валиден по отдельности, но всё равно блокирует релиз.

• Покупка подписки, не подтверждённая в течение трёх дней, автоматически возвращается и отзывается Google. Тихая потеря дохода.

• API принимает заголовок из 50 символов; политика Play ограничивает его 30. Он загружается хорошо и отклоняется при проверке.

• Данные vitals задерживаются на часы и дни. Запрос за семь дней, возвращающий пять, читается как улучшение, а не пропуск, поэтому актуальность belongs на переднем плане.

• Доход за месяц не публикуется до примерно 5 числа следующего. Отчёт о «$0» до этого выглядит как обвал, а не отсутствие.

• Доход никогда не суммируется между валютами — 1000 JPY плюс 10 EUR — это неверный ответ, который выглядит верно.

• com.acme.free не должен брать доход com.acme.freemium. Атрибуция останавливается на границе пакетного сегмента.

Инструменты

169 инструментов. Полный справочник — в документации.

Плюс 2 промпта (publish_screenshots, release_health_check) и 4 ресурсах.

Протестировано

1,198 tests · 100% line and branch coverage · 15 modules
ruff clean · mypy clean · every release gated at --cov-fail-under=100

В наборе тестов нет ни одного реального API. Разбор отчётов проверяется через реальные байты UTF-16, предпросмотр изображений — на реальных заголовках PNG и JPEG.

Вне области

Генерация скриншотов — используйте [appscreens](https://github.com/client- lium/app-screenshot-generator) или любой другой инструмент, затем — предпроверка и загрузка здесь.

Лицензия

Apache-2.0.

Контекстные слова: Google Play console mcp, Google Play mcp server, Android Publisher API mcp, Play Developer API, Model Context Protocol Play, android app automation, Android vitals mcp, Play console api Claude, aso mcp, google play earnings api, play store screenshots api, android release agent