google-ads-mcp

Сервер MCP только для чтения для Google Ads API. Он предоставляет инструменты для построения отчётов (кампании, группы объявлений, ключевые слова и произвольные GAQL-запросы), чтобы MCP-клиент (Claude Code, Claude Desktop и т. д.) мог запрашивать данные вашего аккаунта Google Ads. Инструментов для изменения/записи нет — этот сервер не может вносить изменения в кампании, бюджеты или ставки.

Инструменты

Предварительные требования

Вам потребуются учётные данные Google Ads API:

1. Токен разработчика из центра Google Ads API (Tools & Settings → API Center) в менеджер-аккаунте, с использованием которого будет выполняться аутентификация.

2. Идентификатор/секрет клиента OAuth2 из проекта Google Cloud с включённым Google Ads API.

3. Refresh-токен для пользователя с доступом к целевым аккаунтам. См. руководство Google по OAuth desktop flow или запустите вспомогательный скрипт из Python-библиотеки google-ads.

4. Если аутентификация выполняется через менеджер-аккаунт (MCC) от имени клиентского аккаунта — его login_customer_id.

Настройка

# from the repo root
pip install -e .

Настроить учётные данные можно одним из двух способов:

Способ A: файл YAML

cp google-ads.yaml.example google-ads.yaml
# edit google-ads.yaml with your values

Способ B: переменные окружения

cp .env.example .env
# edit .env, then export the variables into your shell environment

Файл google-ads.yaml в текущем каталоге или переменные окружения GOOGLE_ADS_* будут подхвачены автоматически. Если требуется, задайте GOOGLE_ADS_CONFIGURERATION_FILE_PATH, чтобы указать на YAML-файл в другом месте.

Запуск отдельно

python -m google_ads_mcp
# or, after `pip install -e .`:
google-ads-mcp

Сервер общается через stdio, согласно спецификации MCP.

Регистрация в MCP-клиенте

Claude Code (файл .mcp.json на уровне проекта или claude mcp add):

{
  "mcpServers": {
    "google-ads": {
      "command": "google-ads-mcp",
      "env": {
        "GOOGLE_ADS_CONFIGURATION_FILE_PATH": "/absolute/path/to/google-ads.yaml"
      }
    }
  }
}

Claude Хost (claude_desktop_config.json): тот же фрагмент mcpServers, что и выше.

Заметки по безопасности

• Этот сервер использует только GAQL-запросы SELECT через GoogleAdsService.SearchStream. В GAQL нет синтаксиса INSERT/UPDATE/DELETE, поэтому невозможно изменить данные Google Ads с помощью этих инструментов.

• Никогда не коммитьте google-ads.yaml или .env — оба они указаны в .gitignore. Относитесь к вашему токену разработчика, секрету клиента OAuth и refresh-токену как к учётным данным.

• customer_id и идентификаторы сущностей численчески проверенных пften, перед тем, как подставлять их в строки GAQL-запросов.