Google Ads — MCP-сервер для Claude Code: разбор кампаний и правки
Подключает аккаунт Google Ads к ИИ-ассистенту: 35 инструментов чтения и 13 инструментов записи, которые по умолчанию выключены.
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Что делает 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.
Какие задачи решает
- посмотреть расходы и конверсии кампании без выгрузки отчёта
- подобрать ключевые слова и посчитать прогноз по ним
- собрать запрос GAQL и тут же прогнать его по аккаунту
- проверить превью правки названия группы объявлений перед применением
- ограничить ассистента одним рекламным аккаунтом из нескольких
Примеры запросов агенту
- Покажи расход и конверсии по кампаниям за последнюю неделю
- Собери прогноз по этим ключевым словам для России
- Переименуй группу объявлений
Brand RU— сначала покажи превью
Как установить Google Ads
Командой платформы
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 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 сервера
Файл настроек
{
"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 сервера
Файл настроек
{
"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 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 сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Google Ads
Как установить Google Ads MCP в Claude Code?
Одной командой: `claude mcp add google-ads -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> -- npx -y @getmcpads/google-ads-mcp-server`. Подставьте свои значения вместо плейсхолдеров.
Что делает Google Ads MCP-сервер?
Открывает ассистенту инструменты Google Ads API: чтение статистики, подбор ключевых слов, сырые запросы GAQL и правки кампаний с предварительным просмотром.
Почему правки не применяются?
Записывающие инструменты выключены по умолчанию. Их включает GOOGLE_ADS_ENABLE_WRITES=true, а каждая правка всё равно сначала возвращает превью и ждёт подтверждения.
