Google Ads MCP

MCP сервер для Google Ads: разбор кампаний, метрик и ключевых слов через запросы GAQL прямо в диалоге с агентом

cohnen/mcp-google-adsАвтор:Ernesto Cohnen

Установка

Ручная установка

git clone https://github.com/cohnen/mcp-google-ads.git
cd mcp-google-ads
uv venv .venv
uv pip install -r requirements.txt

Пакета в PyPI нет, сервер запускается из склонированного репозитория через python из .venv.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер подключает рекламные данные Google Ads к агенту. Он показывает список аккаунтов, отдает метрики по кампаниям и объявлениям за выбранный период и выполняет произвольные запросы на языке GAQL. Результат можно вернуть таблицей, в JSON или CSV, а агент разбирает динамику, находит слабые места и предлагает, что улучшить. Данные только читаются, менять ставки и бюджеты сервер не умеет.

Для кого. Для специалистов по контекстной рекламе, маркетологов и владельцев, кто ведет кампании в Google Ads.

Подходит, если

Нужен разбор эффективности кампаний и объявлений на естественном языке
Нужно быстро выполнить запрос GAQL без интерфейса Google Ads
Нужно найти слабые ключевые слова и точки роста

Не подходит, если

Нужно менять ставки, бюджеты или запускать кампании: сервер только читает
Нет токена разработчика Google Ads API и доступа к аккаунту

Пример запроса к агенту

Покажи топ-10 кампаний за 30 дней и выдели те, где ROAS ниже 2, предложи, что улучшить

Ограничения

Нужны проект в Google Cloud с включенным Google Ads API, токен разработчика и учетные данные OAuth или сервисного аккаунта, а для менеджерского аккаунта еще и login customer id. Токен разработчика выдают после заявки, сначала в тестовом режиме с ограничениями. Устанавливается из клонированного репозитория через виртуальное окружение Python, пакета в PyPI нет. Сервер только читает данные и не меняет настройки рекламы.

Как отключить. Удалите блок googleAdsServer из конфигурации MCP-клиента и перезапустите его, затем при желании удалите папку репозитория с виртуальным окружением.

MCP

Транспорт: stdio
Авторизация: OAuth

Переменные окружения
Переменные окружения
GOOGLE_ADS_CREDENTIALS_PATH обязательная, секрет	Путь к файлу учетных данных OAuth или сервисного аккаунта
GOOGLE_ADS_DEVELOPER_TOKEN обязательная, секрет	Токен разработчика Google Ads API
GOOGLE_ADS_AUTH_TYPE	Тип аутентификации: oauth или service_account
GOOGLE_ADS_LOGIN_CUSTOMER_ID	Id менеджерского аккаунта для доступа к нескольким клиентам

Проверка безопасности

Читает рекламные и финансовые данные аккаунта Google Ads
Работает с токеном разработчика и учетными данными OAuth
Выполняет произвольные запросы GAQL по вашим аккаунтам

Коротко о README

README ведет пошагово даже без опыта в коде: настройка доступа к Google Ads API, выбор между OAuth и сервисным аккаунтом, получение токена разработчика. Описаны установка Python и зависимостей, работа через файл .env и конфигурации для Claude Desktop и Cursor. Перечислены инструменты list_accounts, execute_gaql_query, get_campaign_performance, get_ad_performance и run_gaql с примерами запросов GAQL. Есть раздел диагностики и тестовые скрипты для проверки подключения. Лицензия MIT, репозиторий развивает команда ixigo.

Частые вопросы

Где взять токен разработчика?

В аккаунте Google Ads в разделе API Center по заявке. Сначала выдают тестовый токен с ограничениями, после проверки можно получить рабочий.

Можно ли менять кампании?

Нет. Набор инструментов охватывает чтение аккаунтов, метрик и запросы GAQL, изменение ставок и бюджетов не предусмотрено.

Скиллы DataLens

DataLens Skills

Официальный

Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS

СкиллСредний рискРоссийский стекБез VPN12

MCP Яндекс Метрики со всеми 108 методами API

Yandex Metrika MCP Server

Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2

OpenSEO