# Google Ads

Подключает аккаунт Google Ads к ИИ-ассистенту: 35 инструментов чтения и 13 инструментов записи, которые по умолчанию выключены.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: get-mcp-ads
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/get-mcp-ads/google-ads-mcp-server
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/google-ads

## Что делает

Сервер даёт агенту прямой доступ к Google Ads API: посмотреть статистику кампаний и групп объявлений, заняться подбором ключевых слов, собрать сырой запрос GAQL. Читающих инструментов 35. Пишущих — 13, и они не работают, пока вы явно не включите их флагом `GOOGLE_ADS_ENABLE_WRITES`. Каждая запись сначала показывает превью, а выполняется только после подтверждения.

Запускается локально на Node.js: нужна версия `^22.23.4 || ^24.22.1 || >=26.12.1`, на старых сборках сервер ругается в stderr. Без четырёх учётных данных Google — developer token, client ID, client secret и refresh token — подключение не поднимется, их передают в переменных окружения при настройке клиента. Белый список `GOOGLE_ADS_ACCOUNT_IDS` проверяется перед каждым запросом и сужает работу до перечисленных клиентов.

Запросы уходят напрямую в Google Ads API v26, мимо посредников. Если refresh token отозвали, сервер один раз попросит авторизоваться заново и перестанет дёргать токен. Проект под Apache-2.0, стоит смотреть на него, когда нужно тянуть рекламные данные в разговор с ассистентом без выгрузок в CSV.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `GOOGLE_ADS_DEVELOPER_TOKEN`, `GOOGLE_ADS_CLIENT_ID`, `GOOGLE_ADS_CLIENT_SECRET`, `GOOGLE_ADS_REFRESH_TOKEN`, `GOOGLE_ADS_LOGIN_CUSTOMER_ID`, `GOOGLE_ADS_ACCOUNT_IDS`, `GOOGLE_ADS_ENABLE_WRITES` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env GOOGLE_ADS_DEVELOPER_TOKEN=<GOOGLE_ADS_DEVELOPER_TOKEN> --env GOOGLE_ADS_CLIENT_ID=<GOOGLE_ADS_CLIENT_ID> --env GOOGLE_ADS_CLIENT_SECRET=<GOOGLE_ADS_CLIENT_SECRET> --env GOOGLE_ADS_REFRESH_TOKEN=<GOOGLE_ADS_REFRESH_TOKEN> --env GOOGLE_ADS_LOGIN_CUSTOMER_ID=<GOOGLE_ADS_LOGIN_CUSTOMER_ID> --transport stdio google-ads -- npx -y @getmcpads/google-ads-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add google-ads --env GOOGLE_ADS_DEVELOPER_TOKEN=<GOOGLE_ADS_DEVELOPER_TOKEN> --env GOOGLE_ADS_CLIENT_ID=<GOOGLE_ADS_CLIENT_ID> --env GOOGLE_ADS_CLIENT_SECRET=<GOOGLE_ADS_CLIENT_SECRET> --env GOOGLE_ADS_REFRESH_TOKEN=<GOOGLE_ADS_REFRESH_TOKEN> --env GOOGLE_ADS_LOGIN_CUSTOMER_ID=<GOOGLE_ADS_LOGIN_CUSTOMER_ID> -- npx -y @getmcpads/google-ads-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "google-ads": {
            "command": "npx",
            "args": [
                "-y",
                "@getmcpads/google-ads-mcp-server"
            ],
            "env": {
                "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
                "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
                "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
                "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
                "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<GOOGLE_ADS_LOGIN_CUSTOMER_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "google-ads": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@getmcpads/google-ads-mcp-server"
            ],
            "env": {
                "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
                "GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
                "GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
                "GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
                "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "<GOOGLE_ADS_LOGIN_CUSTOMER_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e GOOGLE_ADS_DEVELOPER_TOKEN=<GOOGLE_ADS_DEVELOPER_TOKEN> -e GOOGLE_ADS_CLIENT_ID=<GOOGLE_ADS_CLIENT_ID> -e GOOGLE_ADS_CLIENT_SECRET=<GOOGLE_ADS_CLIENT_SECRET> -e GOOGLE_ADS_REFRESH_TOKEN=<GOOGLE_ADS_REFRESH_TOKEN> -e GOOGLE_ADS_LOGIN_CUSTOMER_ID=<GOOGLE_ADS_LOGIN_CUSTOMER_ID> google-ads npx -y @getmcpads/google-ads-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера

## Когда брать
- посмотреть расходы и конверсии кампании без выгрузки отчёта
- подобрать ключевые слова и посчитать прогноз по ним
- собрать запрос GAQL и тут же прогнать его по аккаунту
- проверить превью правки названия группы объявлений перед применением
- ограничить ассистента одним рекламным аккаунтом из нескольких

## Примеры запросов агенту
- Покажи расход и конверсии по кампаниям за последнюю неделю
- Собери прогноз по этим ключевым словам для России
- Переименуй группу объявлений `Brand RU` — сначала покажи превью

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md