Google Ads MCP Server

Полноценный MCP-сервер для управления Google Ads с полным CRUD, панелью визуализации, отчетами и управлением всеми функциями, доступными в панели Google Ads.

Возможности (85+ инструментов)

Аккаунты и клиенты

• list_accessible_customers — Список доступных аккаунтов

• get_customer_details — Детали аккаунта

• list_customer_clients — Клиенты под MCC

• update_customer — Обновить настройки

• get_account_hierarchy — Иерархия аккаунтов

• get_change_history — История изменений

Кампании (полный CRUD)

• list_campaigns — Список кампаний с фильтрами

• get_campaign — Полные детали кампании

• create_campaign — Создать кампанию (Search, Display, Shopping, Video, Performance Max и т.д.)

• update_campaign — Обновить название, статус, ставки, даты

• remove_campaign — Удалить кампанию

• get_campaign_performance — Метрики эффективности

• copy_campaign — Копировать настройки кампании

Группы объявлений (полный CRUD)

• list_ad_groups — Список групп объявлений

• get_ad_group — Детали группы

• create_ad_group — Создать группу объявлений

• update_ad_group — Обновить настройки

• remove_ad_group — Удалить группу

• get_ad_group_performance — Метрики эффективности

Объявления (полный CRUD)

• list_ads — Список объявлений

• get_ad — Детали объявления

• create_responsive_search_ad — Создать RSA с заголовками и описаниями

• update_ad_status — Активировать/приостановить объявление

• remove_ad — Удалить объявление

• get_ad_performance — Метрики эффективности

Ключевые слова (полный CRUD)

• list_keywords — Список ключевых слов с показателем качества

• add_keywords — Добавить ключевые слова (Exact, Phrase, Broad)

• update_keyword — Обновить ставку, статус, URL

• remove_keyword — Удалить ключевое слово

• get_keyword_performance — Эффективность с долей показов

• get_search_terms — Отчет по поисковым запросам

• add_negative_keywords — Добавить негативные слова (кампания или группа)

Бюджеты и стратегии ставок

• list_budgets — Список бюджетов

• create_budget — Создать бюджет

• update_budget — Обновить сумму/метод доставки

• remove_budget — Удалить бюджет

• list_bidding_strategies — Список стратегий

• create_bidding_strategy — Создать стратегию (Target CPA, Target ROAS и т.д.)

• update_bidding_strategy — Обновить стратегию

• remove_bidding_strategy — Удалить стратегию

Аудитории и таргетинг

• list_audiences — Список аудиторий/списков пользователей

• get_audience_performance — Эффективность аудиторий

• list_campaign_targeting — Критерии таргетинга

• add_campaign_location_targeting — Географический таргетинг

• add_campaign_language_targeting — Таргетинг по языку

• add_ad_schedule — Расписание объявлений (dayparting)

• remove_campaign_criterion — Удалить критерий

• get_geo_target_constants — Поиск географических констант

• get_demographics_performance — Демографическая эффективность

Активы и расширения

• list_assets — Список всех активов

• create_sitelink_asset — Создать сайтлинк

• create_callout_asset — Создать коллаут

• create_structured_snippet_asset — Создать структурированные сниппеты

• create_call_asset — Создать расширение для звонков

• create_price_asset — Создать расширение цены

• create_promotion_asset — Создать расширение акции

• create_lead_form_asset — Создать лид-форму

• link_asset_to_campaign — Привязать актив к кампании

• link_asset_to_ad_group — Привязать актив к группе

• remove_asset — Удалить актив

• get_asset_performance — Эффективность активов

• list_campaign_assets — Активы кампании

• remove_campaign_asset — Отвязать актив

Конверсии

• list_conversion_actions — Список действий конверсии

• get_conversion_action — Детали конверсии

• create_conversion_action — Создать действие конверсии

• update_conversion_action — Обновить конверсию

• remove_conversion_action — Удалить конверсию

• get_conversion_performance — Эффективность конверсий

Отчеты и панель управления

• execute_gaql_query — Выполнить пользовательский запрос GAQL

• get_account_dashboard — Полная панель аккаунта

• get_campaign_dashboard — Детальная панель кампании

• get_performance_by_device — Эффективность по устройствам

• get_performance_by_network — Эффективность по сетям

• get_performance_by_hour — Эффективность по часам

• get_performance_by_day_of_week — Эффективность по дням недели

• get_geographic_performance — Географическая эффективность

• get_landing_page_performance — Эффективность целевых страниц

• compare_date_ranges — Сравнить периоды

Метки и общие наборы

• list_labels — Список меток

• create_label — Создать метку

• remove_label — Удалить метку

• apply_label_to_campaign — Применить метку к кампании

• apply_label_to_ad_group — Применить метку к группе

• list_shared_sets — Список общих списков

• create_shared_set — Создать общий список негативных слов

• add_shared_set_criteria — Добавить термины в список

• link_shared_set_to_campaign — Привязать список к кампании

Рекомендации и оптимизация

• list_recommendations — Список рекомендаций Google

• apply_recommendation — Применить рекомендацию

• dismiss_recommendation — Отклонить рекомендацию

• get_optimization_score — Оценка оптимизации

Эксперименты и изменения

• list_experiments — Список A/B-тестов

• list_experiment_arms — Список вариантов

• get_change_status — Последние изменения

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

1. Проект Google Cloud с включенным Google Ads API

2. OAuth2 Client ID типа Desktop

3. Developer Token Google Ads (получен в ads.google.com > API Center)

4. Node.js >= 18

Установка

npm install
npm run build

Настройка

Вариант 1: Переменные окружения

export GOOGLE_ADS_CLIENT_ID="seu-client-id"
export GOOGLE_ADS_CLIENT_SECRET="seu-client-secret"
export GOOGLE_ADS_DEVELOPER_TOKEN="seu-developer-token"
export GOOGLE_ADS_REFRESH_TOKEN="seu-refresh-token"
export GOOGLE_ADS_LOGIN_CUSTOMER_ID="123-456-7890"  # opcional, para contas MCC

Вариант 2: Интерактивная настройка

npm run auth

Это создаст файл учетных данных в ~/.google-ads-mcp/credentials.json.

Настройка в Claude Code

Добавьте в ваш ~/.claude/settings.json:

{
  "mcpServers": {
    "google-ads": {
      "command": "node",
      "args": ["/caminho/para/google-ads-manager-hub/dist/index.js"],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "seu-client-id",
        "GOOGLE_ADS_CLIENT_SECRET": "seu-client-secret",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "seu-developer-token",
        "GOOGLE_ADS_REFRESH_TOKEN": "seu-refresh-token",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

Использование

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

• "Перечислите все мои активные кампании"

• "Создайте поисковую кампанию с бюджетом R$50/день"

• "Покажите панель эффективности за последние 30 дней"

• "Добавьте эти ключевые слова в группу объявлений X: ..."

• "Приостановите кампанию Y"

• "Покажите отчет по поисковым запросам"

• "Какие рекомендации Google для моего аккаунта?"

Версия API

Этот сервер использует Google Ads API v23 (последняя, выпущена в январе 2026 года).

Структура проекта

src/
├── index.ts                    # Entry point - MCP server
├── auth/
│   ├── oauth2.ts               # OAuth2 client + token management
│   └── setup.ts                # Interactive auth setup CLI
├── client/
│   └── google-ads-client.ts    # Google Ads REST API client
└── tools/
    ├── accounts/               # Account & customer management
    ├── campaigns/              # Campaign CRUD
    ├── adgroups/               # Ad group CRUD
    ├── ads/                    # Ad CRUD (RSA, etc.)
    ├── keywords/               # Keywords + search terms + negatives
    ├── budgets/                # Budgets + bidding strategies
    ├── audiences/              # Audiences + targeting + demographics
    ├── assets/                 # Assets (sitelinks, callouts, etc.)
    ├── conversions/            # Conversion actions + tracking
    ├── reporting/              # Dashboard + GAQL + analytics
    ├── labels/                 # Labels + shared sets
    ├── recommendations/        # Optimization recommendations
    ├── experiments/            # A/B tests + change tracking
    └── extensions/             # Price, promotion, lead form extensions