Google Ads MCP Server

Что умеет сервер

Сервер опирается на Google Ads API и даёт три инструмента: поиск и получение данных аккаунта (search), метаданные ресурса API, например кампании (get_resource_metadata), и список доступных клиентов (list_accessible_customers). Помимо инструментов он отдаёт ресурсы: документ-описание API, список метрик, список сегментов и заметки о выпусках.

Набором инструментов можно управлять через файл tools_config.yaml: включать и отключать инструменты или категории и менять их префиксы. По умолчанию в пакет встроена конфигурация с включёнными инструментами.

Когда использовать

Подходит маркетологам и аналитикам, которым нужно задавать вопросы к рекламным аккаунтам обычными фразами: структура кампаний, доступные поля, метрики и сегменты для отчёта. Перед сложным запросом ассистент может сначала изучить метаданные нужного ресурса.

Ограничения и безопасность

В README сказано прямо: сервер раскрывает данные вашего аккаунта подключённому агенту или модели. К вызовам API добавляется дополнительный заголовок для сбора данных об использовании.

Для боевых аккаунтов нужен токен разработчика минимум с уровнем доступа Explorer. Если токен одобрен только для тестовых аккаунтов, вы получите ошибку об этом. Вариант с общим веб-сервером поддерживает OAuth-прокси FastMCP и автоматически переключается на транспорт streamable-http. Секреты держите в файле окружения на стороне сервера, а не в конфигурации клиента.

Подготовка

1. Установите pipx.
2. При необходимости получите токен разработчика Google Ads (минимум доступ Explorer).
3. Включите Google Ads API в проекте Google Cloud.
4. Настройте учётные данные. Вариант с Application Default Credentials:

gcloud auth application-default login   --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform   --client-id-file=YOUR_CLIENT_JSON_FILE

Запуск конкретной опубликованной версии:

pipx run --spec "google-ads-mcp==X.Y.Z" google-ads-mcp

Конфигурация клиента (Antigravity и другие)

Блок mcpServers одинаков для всех клиентов:

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

README указывает файлы для других клиентов: ~/.claude/settings.json для Claude Code, .cursor/mcp.json для Cursor, .vscode/mcp.json для VS Code с Copilot. Если доступ идёт через менеджерский аккаунт, добавьте в env переменную GOOGLE_ADS_LOGIN_CUSTOMER_ID с идентификатором менеджерского аккаунта.

Общий сервер (Codex, Antigravity)

Если сервер запущен отдельным процессом по адресу http://localhost:8080/mcp, подключите его к Codex:

codex mcp add google_ads --url http://localhost:8080/mcp
codex mcp login google_ads

В Antigravity тот же адрес указывают в поле serverUrl.