Google Ads MCP — MCP-сервер для Claude Code
Подключает Google Ads API к ассистенту в режиме чтения: выполняет GAQL-запросы, собирает рекомендации и подбирает ключевые слова.
claude mcp add google-ads-mcp -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> -- uvx scalably-google-ads-mcpЧто делает Google Ads MCP
Сервер открывает доступ к Google Ads API без права на внесение изменений. Защита от мутаций реализована программно: вызовы ограничены списком разрешённых методов SDK, а запросы проверяются на обязательное наличие команды SELECT. Ассистент может просматривать дочерние клиентские аккаунты через управляющий профиль MCC, изучать каталог доступных ресурсов и схему полей.
Помимо отчётов через GAQL, инструмент помогает планировать рекламу. Он находит варианты поисковых фраз, показывает оценки стоимости клика, конкуренции и частотности, а также выдаёт официальные рекомендации по оптимизации. Для отслеживания правок доступен журнал событий с фиксацией авторов изменений.
Для запуска требуется подготовить токен разработчика, настольное OAuth-приложение в консоли Google Cloud и токен обновления. Без предварительного одобрения токена разработчика со стороны Google сервер работать не будет.
Какие задачи решает
- выполнять GAQL-запросы к аккаунтам через управляющий профиль MCC
- подбирать ключевые фразы с оценками конкуренции и стоимости клика
- проверять журнал изменений в кампаниях и аудировать действия
- читать официальные рекомендации Google по оптимизации рекламы
Примеры запросов агенту
- Покажи список всех дочерних аккаунтов в нашем управляющем профиле MCC
- Выполни GAQL-запрос расходов и показов по активным кампаниям
- Подбери ключевые слова для поисковой рекламы и проверь уровень конкуренции
Как установить Google Ads MCP
Командой платформы
claude mcp add google-ads-mcp -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> -- uvx scalably-google-ads-mcpВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-google-ads-mcp <команда>
Командой платформы
codex mcp add google-ads-mcp --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> -- uvx scalably-google-ads-mcpВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-google-ads-mcp <команда>
Файл настроек
{
"mcpServers": {
"google-ads-mcp": {
"command": "uvx",
"args": [
"scalably-google-ads-mcp"
],
"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>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-google-ads-mcp <команда>
Файл настроек
{
"servers": {
"google-ads-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"scalably-google-ads-mcp"
],
"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>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-google-ads-mcp <команда>
Командой платформы
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-mcp uvx scalably-google-ads-mcpВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-google-ads-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Google Ads MCP
Как установить Google Ads MCP в Claude Code?
Выполните команду `claude mcp add google-ads-mcp -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> -- uvx scalably-google-ads-mcp`.
Что делает Google Ads MCP?
Предоставляет доступ к данным Google Ads API в режиме только для чтения, позволяя составлять GAQL-отчёты, планировать ключевые слова и отслеживать историю изменений.
Можно ли через этот сервер случайно изменить или остановить кампании?
Нет, сервер работает строго в режиме чтения. В нём заблокированы методы мутаций SDK, а все GAQL-запросы фильтруются проверкой на чтение.
