Google Ads API MCP Server

Disable path length limit

Disable path length limit - это опция в установщике Python для Windows, которая позволяет вашей системе работать с длинными путями файлов/папок, устраняя старое ограничение в 260 символов. Для современных проектов рекомендуется ее включать.

Дело в том, что по умолчанию Windows ограничивает длину полного пути к файлу 260 символами (включая букву диска, все папки и само имя файла). В реальных рабочих папках с длинными именами, глубокими вложенностями или большими проектами вы можете столкнуться с ошибками: файлы или каталоги не будут открываться или записываться, если путь превышает 260 символов.

Если выбрать Disable path length limit, то Python и другие современные программы смогут работать с очень длинными путями, если это поддерживается ими и файловой системой, обходя эти ограничения. Эта настройка меняет системный реестр Windows и для этого требуются права администратора. Нажмите на Disable path length limit. Дождитесь завершения настройки и закройте установщик Pytnon.

Завершение установки Python

Проверка версии

Проверить установленную версию Python можно через командную строку. Для Windows: нажмите Win+R, введите cmd и нажмите Enter.

Открытие командной строки (cmd)

Введите команду:

или:

После нажатия Enter вы увидите вашу версию Python.

Ваша версия Python

Если установлен Python 3, но стандартная команда не работает. Попробуйте вместо python использовать:

Для macOS: откройте Terminal через Программы (Applications) - Утилиты (Utilities) - Terminal или используйте Spotlight (Cmd+Space) и введите Terminal. Проверьте через команду:

Расширение “Python” в VS Code

Откройте Visual Studio Code и перейдите на вкладку Extensions (иконка квадратика слева или сочетание клавиш Ctrl+Shift+X).

Extensions

Добавьте расширение Python для VS Code, введя в поиске Python. Установите официальное расширение от Microsoft (называется просто Python):

Расширение "Python" для VS Code

Расширение Python для Visual Studio Code - это официальное дополнение от Microsoft, предназначенное для улучшения работы с языком Python в этом редакторе кода. Оно добавляет комплекс поддержки, включая автодополнение кода (IntelliSense), подсветку синтаксиса, линтинг (статический анализ кода), отладку, работу с виртуальными средами, тестирование и многое другое. Это расширение превращает VS Code в полноценную среду разработки для Python, подходящую как для новичков, так и для профессионалов.

Установленное расширение

Краткий список возможностей расширения Python (VS Code):

• автодополнение кода для удобного и быстрого написания программ;
• отладка с поддержкой точек останова, анализа переменных и управления выполнением;
• поддержка сниппетов - готовых шаблонов кода;
• управление виртуальными окружениями и версиями Python;
• интеграция с тестовыми фреймворками для написания и запуска тестов;
• поддержка интерактивных вычислений в Jupyter Notebooks;
• работа с менеджером пакетов Conda.

VS Code автоматически предлагает установить это расширение при первом открытии Python-файла, так как оно является ключевым инструментом для продуктивной работы с Python в данном редакторе. Но если этого не произошло, вы теперь знаете как добавить его вручную.

Базовый интерпретатор Python

Чтобы изменить базовый интерпретатор Python в VS Code, откройте палитру команд (Ctrl+Shift+P) и введите Python: Select Interpreter:

Python: Select Interpreter

Выберите нужный интерпретатор из списка:

Выбор интерпретатора Python

Установка pipx

pipx - это инструмент для установки и запуска приложений, написанных на Python, которые предоставляют интерфейс командной строки (CLI). Он создает изолированные среды для каждого установленного приложения, предотвращая конфликты зависимостей. В отличие от pip, который управляет зависимостями проекта, pipx создает отдельные виртуальные окружения для каждого приложения, что позволяет избежать конфликтов между зависимостями разных приложений. pipx не входит в комплект pip, но его установка часто является важной частью начальной загрузки системы.

Официальная документация расположена по адресу pipx.pypa.io. В ней подробно описана установка для различных операционных систем. Я буду демонстрировать установку для Windows.

Откройте командную строку и вставьте в нее нижеприведенную команду:

Нажмите Enter. Возможно (и даже вероятнее всего), что установка будет сопровождаться предупреждением: WARNING: The script pipx.exe is installed in <USER folder>\AppData\Roaming\Python\Python3x\Scripts which is not on PATH

Предупреждение при установке pipx

Если да, перейдите в указанную папку, чтобы запустить исполняемый файл pipx напрямую. Введите следующую строку (даже если предупреждение не появилось), указав полный путь до файла pipx.exe на вашем компьютере:

.\pipx.exe ensurepath

Это добавит указанный выше путь и папку %USERPROFILE%\.local\bin в ваш путь поиска.

%USERPROFILE%\.local\bin

Таким образом, каждая виртуальная среда будет создаваться в этом конкретном каталоге.

Перезапустите сеанс терминала и убедитесь, что pipx запускается.

Обновите pipx с помощью:

В командной строке это будет выглядеть так:

Обновление pipx

Проверить установку pipx можно с помощью команды:

В конце нажмите Enter. Если в списке вы видите pipx, значит он успешно установлен.

Команда pip list

После этого командную строку можно закрыть.

Получение токена разработчика

Читайте еще:

• Официальная справка Google
• Уровни доступа токена

Токен разработчика (Developer Token) - это 22-символьная буквенно-цифровая строка, позволяющая вашему приложению подключаться к API Google Ads. Вы можете получить токен разработчика, зарегистрировавшись на странице API Center вашего аккаунта Google Ads Manager. При каждом вызове API вы отправляете токен разработчика в составе запроса, устанавливая заголовок http или gRPC developer-token.

Каждому токену разработчика назначается уровень доступа, который контролирует количество вызовов API и которые вы можете совершать в день с помощью токена, а также среду, к которой вы можете совершать вызовы (тестовая или рабочая).

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

Для получения токена разработчика вам необходим аккаунт-менеджер Google Ads (MCC - менеджерский/управляющий аккаунт). Если такого нет, его нужно создать. Подробную инструкцию по его созданию читайте по ссылке.

Как только вы это сделаете, откройте Google Ads и войдите в свой MCC-аккаунт:

Вход в MCC-аккаунт

В открывшемся окне в левом меню перейдите в раздел Администратор - Центр API:

Администратор - Центр API

Примечание: если вы зайдете под личным аккаунтом, то раздела Центр API (API Center) в интерфейсе Google Рекламы вы не увидите.

Заполните форму заявки на доступ к API, указав достоверные сведения о себе или своей компании, а также статус и тип приложения. Используйте только реальные данные, так как Google может вручную проверить заявку и связаться с вами по электронной почте или через сайт, чтобы подтвердить, что запрос на получение токена разработчика отправили именно вы, а не третье лицо.

Контактный адрес, название компании, URL и тип компании

В блоке Планируемое использование вы можете задать: планирую использовать официальный Google Ads MCP Server https://github.com/googleads/google-ads-mcp

Планируемое использование

Укажите основную страну предпринимательской деятельности, выбрав ее из списка, примите Условия пользовательского соглашения и нажмите кнопку Создать идентификатор:

Завершение создания токена разработчика

После подачи заявки вас перенаправит на страницу созданного токена разработчика:

Токен разработчика

Как правило, он создается с уровнем доступа Тестовый аккаунт (Test Account Access). Для работы с реальными аккаунтами необходимо подать заявку на Basic Access или Standard Access, которая проходит проверку и утверждение Google. Подробнее об уровнях доступа читайте в официальной документации.

Именно базовый уровень доступа позволяет токену разработчика делать запросы к API Google Ads как для тестовых аккаунтов с балансом 0, так и для рекламных кабинетов, которые активны и показывают реальную, живую рекламу (работают с бюджетами). Поэтому раскройте блок с уровнем доступа и подайте заявку на базовый доступ (Basic Access) через Google Форму.

Подать заявку на базовый доступ

Базовый уровень доступа позволяет токену разработчика выполнять до 15 000 операций в день. Этого достаточно для большинства разработчиков. Для использования Google Ads API MCP Server этого хватит с избытком.

Я рекомендую заполнять заявку на английском языке. Первый шаг - это указание идентификатора MCC-аккаунта, а также подача заявки на новый токен Apply for a new token:

Шаг №1

Нажмите Далее. Шаг второй - это вопросы:

• имеет ли ваша компания в настоящее время какие-либо ОДОБРЕННЫЕ токены API Google Ads?

Ответ: Нет

• укажите идентификатор(ы) учетной записи менеджера Google Ads (MCC), связанный с вашим ДРУГИМ токеном(ами)

Можно не указывать

• моя контактная информация по электронной почте в API-центре Google Ads...

Ответ: Точный и регулярно проверяемый адрес электронной почты или список рассылки

• кратко опишите бизнес-модель вашей компании и то, как вы используете Google Ads

Ответ: I want to start using the official Google Ads MCP Server for my clients https://github.com/googleads/google-ads-mcp

• управляет ли ваша компания рекламными кампаниями для клиентов (или пользователей за пределами вашей компании)?

Ответ: Yes

• URL-адрес основного сайта вашей компании

Ответ: Укажите здесь URL вашей компании (у меня - это https://osipenkov.ru/)

• укажите веб-сайт (сайты), рекламу которого вы размещаете, и владельца каждого сайта

Ответ: Укажите здесь URL-адреса веб-сайтов ваших клиентов, которым мы ведете рекламу в Google Ads

• будете ли вы использовать API совместно с рекламой Google Ads

Ответ: Yes

• кто будет иметь доступ к создаваемому вами инструменту API Google Ads

Ответ: Only me

• если у вас есть клиенты, будет ли у них доступ к вашему инструменту для просмотра отчетов

Ответ: My clients will receive email reports that I will send after working with Google Ads API MCP Server

• планируете ли вы совершать какие-либо мутационные вызовы API или создавать/управлять кампаниями через API

Ответ: No

• будет ли ваш инструмент использоваться для составления отчетов или извлечения данных об эффективности Google Ads

Ответ: Yes

• планируете ли вы проводить какие-либо исследования ключевых слов через API? В частности, планируете ли вы использовать KeywordPlanIdeaService или KeywordPlanService?

Ответ: Yes

Можно не указывать

Шаг №2

Нажмите Далее. На заключительном шаге подачи заявки в поле Пожалуйста, опишите свой вопрос ниже, можете добавить такой текст: I like your new Google Ads MCP Server solution and want to try it out for my clients. Отправьте свою заявку, нажав на кнопку Отправить:

Отправка заявки на базовый доступ

Имейте в виду, что одобрение заявки может занять несколько дней. Как только вы получите базовый доступ, ссылка будет обновлена для подачи заявки на стандартный доступ (Standard Access).

Одобренная заявка на базовый доступ

Сохраните ваш новый токен разработчика. Он вам понадобится в дальнейшем для работы с Google Ads API.

Создание проекта Google Cloud

Для того чтобы начать работу в Google Cloud, вам необходим аккаунт Google. Если у вас нет аккаунта на Gmail.com, создайте его. После создания аккаунта (или использования текущего) перейдите по адресу console.cloud.google.com и создайте свой первый проект в Google Cloud.

Регистрация в облаке Google

В связи с текущими событиями в мире Google приостановил работу для пользователей из России. На данный момент вы не сможете выбрать из списка стран Россию и привязать банковскую карту, выпущенную на территории РФ. Наиболее простое и эффективное решение – выпустить карту другой страны (Казахстан, Киргизия, Армения и т.д.), чтобы иметь возможность пользоваться Google Cloud Platform и оплачивать счета.

Если вы впервые используете облачные службы Google, тогда вас попросят добавить страну (Country) и дать согласие с условиями предоставления услуг Google Cloud Platform. Подтвердите свои действия с помощью Agree and Continue.

В левом верхнем углу нажмите на Select A project:

Выберите проект

И создайте новый проект – New Project:

Новый проект

Появится окно создания проекта. Задайте название вашему проекту в поле Project name (например gaads-mcp, или оставьте по умолчанию) и нажмите кнопку Create:

Создание проекта

Через несколько секунд в Google Cloud будет создан ваш новый проект, а на панели управления в правом верхнем углу отобразится соответствующее уведомление.

Уведомление об успешно созданном проекте

В завершение нажмите на SELECT PROJECT, чтобы выбрать только что созданный проект Google Cloud.

Активация API Google Ads

Теперь в созданном проекте необходимо включить API. В Google Ads MCP Server используются Google Ads API. Для этого в строке поиска сначала введите Google Analytics Admin API и выберите первый результат из списка:

Google Ads API

Активируйте API, нажав на кнопку Enabled:

Активация Google Ads API

После активации Data API вы должны увидеть такое уведомление: To use this API, you may need credentials.

To use this API, you may need credential

Это означает, что для использования Google Ads API вам требуются учетные данные.

Регистрация сервисного аккаунта

В официальном репозитории на GitHub Google предлагает несколько вариантов получения учетных данных:

1. с использованием учетных данных приложения по умолчанию;
2. с помощью клиентской библиотеки Google Ads API Python.

В рамках этого руководства мы с вами создадим сервисный аккаунт и добавим его в наш MCC-аккаунт Google Рекламы.

Сервисные аккаунты (service accounts) - это специальные аккаунты Google для доступа приложений к Менеджеру рекламы через API. Они не требуют персональной авторизации. Вместо этого используется файл ключа, доступ к которому есть только у вашего приложения. Подробнее об этом читайте в официальной документации Google.

Чтобы создать сервисный аккаунт, в Google Cloud после создания проекта перейдите в раздел IAM & Admin - Service Accounts:

IAM & Admin - Service Accounts

Нажмите + Create service account:

Создание сервисного аккаунта

Введите имя сервисного аккаунта (например: mcp-ads):

Имя сервисного аккаунта (Service account name)

Далее вы можете установить для сервисного аккаунта отдельные права доступа и роли. Я рекомендую добавить Owner:

Назначение роли "Owner"

На следующем можно добавить e-mailы пользователей, которым будет разрешен доступ к этому сервисному аккаунту. И этот шаг является необязательным, поэтому его можно пропустить.

Настройка доступов пользователям (необязательно)

В завершение нажмите Done. Будет создан сервисный аккаунт. Вы увидите его в списке всех аккаунтов.

Список сервисных аккаунтов

Напротив него нажмите на иконку с тремя точками и выберите Manage keys:

Manage keys

Затем создайте новый ключ: Add key – Create new key:

Создание нового ключа

Укажите тип ключа JSON и нажмите Create:

Key type – JSON

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

Уведомлении Google Cloud о сохраненном ключе на вашем компьютере

Файл на компьютере:

Сохраненный ключ JSON

И его содержимое (можно открыть обычным блокнотом или программой типа Notepad++):

Содержимое ключа

Этот ключ в дальнейшем будет использоваться в сервере Google Ads API MCP Server.

Добавление сервисного аккаунта в Google Ads

Скопируйте адрес электронной почты сервисного аккаунта (или из сохраненного файла из поля client_email, или из интерфейса Google Cloud из поля Email) и откройте свой MCC-аккаунт Google Ads. Перейдите в раздел Администратор – Доступ и безопасность. Добавьте нового пользователя:

Добавление нового пользователя

Введите адрес электронной почты учетной записи службы в поле Электронная почта:

Электронная почта сервисного аккаунта

Окончание срока действия доступа оставьте Никогда. Выберите Стандартный уровень доступа и нажмите Добавить аккаунт.

Уровень доступа к аккаунту - Стандартный

Примечание: уровни доступа Электронная почта и Администратор не поддерживаются для учетных записей служб.

После этого ваш сервисный аккаунт будет добавлен и отображаться в списке пользователей MCC-аккаунта:

Ваш сервисный аккаунт в списке пользователей

Установка Gemini Code Assist

Следующий этап - установка Gemini Code Assist. Это инструмент для помощи разработчикам от Google, основанный на модели Gemini, который интегрируется в среду разработки (IDE) и помогает писать, редактировать и понимать код.

Gemini Code Assist

Gemini Code Assist бесплатно добавляет мощь Gemini 2.5 в вашу IDE, предлагая чат-интерфейс, который учитывает ваш код, автоматическое автодополнение кода по мере написания, а также генерацию и преобразование полных функций или файлов по запросу. Лимит в 6000 запросов, связанных с кодом, и 240 запросов в чате в день поможет вам в решении ваших задач.

Вернитесь в VS Code, откройте раздел Extentions и введите в строке поиска Gemini Code Assist. На открывшейся странице нажмите Install:

Установка Gemini Code Assist в Visual Studio Code

В открывшемся окне нажмите Trust Publisher & Install:

Trust Publisher & Install

И затем Trust Workspace & Install:

Trust Workspace & Install

Дождитесь окончания установки расширения. Как только это произойдет, в VS Code откроется новая страница с описанием функционала Gemini Code Assist.

Get started with Gemini Code Assist

Создание папки с проектом и открытие в VS Code

Теперь вам необходимо создать на своем компьютере отдельную папку для MCP и добавить в нее ключ JSON, который вы создали и сохранили на предыдущем шаге. В качестве примера я создам папку MCP на диске D своего компьютера и помещу в нее файл JSON. Это будет выглядеть примерно так:

Папка проекта с ключом JSON на компьютере

Перейдите в VS Code и откройте раздел Explorer, а затем нажмите на кнопку Open Folder:

Explorer - Open Folder

Укажите путь до папки, которую вы создали. В моем примере это MCP. Когда вы выбираете Open Folder, VS Code загружает содержимое этой папки и воспринимает ее как рабочее пространство (workspace), предоставляя вам удобный интерфейс для работы с файлами и папками внутри нее. Фактически, папка, которую вы открываете, становится корнем вашего рабочего пространства - все файлы и подпапки внутри нее становятся доступны для просмотра и редактирования в VS Code.

Обычно VS Code в явном виде просит дать разрешение авторам файлов, находящимся в открытой папке. Поэтому когда вы увидите похожее окно, просто нажмите Yes, I trust the authors:

Yes, I trust the authors

Создание файла конфигурации Gemini

Теперь вам необходимо создать файл конфигурации Gemini. Для этого перейдите на компьютере в соответствующую директорию:

• Linux/macOS: ~/.gemini/settings.json
• Windows: C:\Users\<ваш_пользователь>\.gemini\settings.json

Путь ~/.gemini/settings.json не всегда создается автоматически - его нужно создать вручную, создав скрытую папку .gemini в домашней директории и внутри нее файл settings.json с нужными настройками. Это стандартный подход для хранения пользовательских конфигураций.

Файл settings.json в папке .gemini

Откройте его любым текстовым редактором (например, блокнотом или Notepad++) и вставьте в него нижеприведенный фрагмент:

, где в переменные GOOGLE_APPLICATION_CREDENTIALS, GOOGLE_PROJECT_ID и GOOGLE_ADS_DEVELOPER_TOKEN вам нужно задать свои собственные значения.

Примечание: примеры файлов settings приведены в официальном репозитории GitHub.

В переменную окружения GOOGLE_APPLICATION_CREDENTIALS добавьте абсолютный путь к вашему JSON-файлу с учетными данными.

Например, если файл с учетными данными находится по пути:

то в JSON-конфигурации для settings.json в разделе "env" нужно записать путь так:

Важно: в пути для Windows в JSON нужно либо экранировать обратные слеши двойным обратным слешем (\\), либо использовать прямые слеши (/). Оба варианта работают.

Пример с прямыми слешами:

Убедитесь, что указанный файл существует и доступен приложению (у вас есть права на чтение).

На macOS в переменной окружения GOOGLE_APPLICATION_CREDENTIALS указывается абсолютный путь к JSON-файлу с учетными данными, например:

"env": { "GOOGLE_APPLICATION_CREDENTIALS": "/Users/ваш_пользователь/путь_к_файлу/abc.json" }

1 2 3

"env": {   "GOOGLE_APPLICATION_CREDENTIALS": "/Users/ваш_пользователь/путь_к_файлу/abc.json" }

Поскольку я создал папку на диске D, то путь к JSON-файлу у меня выглядит так:

"env": { "GOOGLE_APPLICATION_CREDENTIALS": "D:\\MCP\\gaads-mcp-969a6b2aeff2.json" }

1 2 3

"env": { "GOOGLE_APPLICATION_CREDENTIALS": "D:\\MCP\\gaads-mcp-969a6b2aeff2.json" }

В переменной окружения GOOGLE_PROJECT_ID задайте идентификатор вашего проекта в Google Cloud. Для этого вернитесь на страницу console.cloud.google.com и скопируйте значение из Project ID:

Project ID в Google Cloud

В переменную окружения GOOGLE_ADS_DEVELOPER_TOKEN вставьте скопированный из интерфейса MCC-аккаунта Google Рекламы токен разработчика, который вы получили на предыдущем шаге после подачи заявки на базовый доступ.

Вот так может выглядеть ваш заполненный файл settings.json со всеми данными:

Конфигурация файла settings.json

Сохраните файл. После создания папки и файла с конфигурацией VS Code и расширение Gemini Assist смогут прочитать настройки MCP серверов, которые вы в него внесете.

Запуск Gemini Code Assist

Вернитесь в VS Code и откройте файл - Open file.

Open file

В открывшемся окне выберите файл settings.json, который вы создали на предыдущем шаге. Возможно, VS Code выдаст вам предупреждение, поскольку вы уже открыли и работаете в доверенном рабочем пространстве, а теперь пытаетесь открыть другой файл, который считается недоверенным (они могут находиться вне доверенной папки). VS Code спрашивает, хотите ли вы разрешить недоверенным файлам выполнять возможные скрипты, расширения и запускать задачи в рамках этого доверенного пространства. Нажмите Open:

Open

После этого вам откроется файл settings.json внутри VS Code:

Окно VS с открытым файлом

Перезагрузите VS Code, просто закройте программу и откройте снова (на всякий случай). После этого в правом нижнем углу нажмите на иконку с искрой:

Иконка Gemini Code Assist

Так вы запустите Gemini Code Assist. Нажмите Sign In:

Sign In

Это стандартный шаг для входа в ваш Google аккаунт, чтобы разрешить расширению доступ к вашим сервисам Google и активировать возможности Gemini Code Assist. В открывшемся окне нажмите Open:

Open

Выберите аккаунт для перехода в приложение Gemini Code Assist and Gemini CLI:

Выбор учетной записи

Затем нажмите Вход:

Вход

После этого вам должно отобразиться уведомление об успешной аутентификации с помощью Gemini Code Assist.

Gemini Code Assist теперь имеют доступ к вашей учетной записи

Однако когда вы вернетесь назад, может быть такое, что ваш текущий аккаунт не имеет права на Gemini Code Assist для частных лиц и бесплатную версию.

Аккаунт не подходит для Gemini Code Assist

Нажав на ссылку Learn more, вам откроется официальная документация Gemini Code Assist, в которой приведены ответы на часто задаваемые вопросы. Как я узнал из FAQ, моя учетная запись не может быть допущена к участию, поскольку я нахожусь в неподдерживаемом географическом регионе - в России. Это было известно и так, поскольку Gemini в РФ не поддерживается. Скорее всего, если вы выполняли все предыдущие шаги за мной и тоже находитесь в России, то у вас будет та же самая проблема.

Примечание: доступные места для Gemini Code Assist для частных лиц представлены на этой странице.

Я не стану подробно рассматривать способы обхода этих ограничений, поскольку это выходит за рамки данного руководства. К тому же, Google Ads в настоящее время недоступен в России, поэтому рекламные кампании там не проводятся. Те же, кто работает с международными проектами, как правило, находятся за пределами РФ или имеют доступ к Gemini. Эта инструкция как раз для них.

Я использовал аккаунт Google со страной США + VPN из США, так как использование только одного VPN не помогло. По всей видимости, первоначальная проверка Google идет именно по стране, которая привязана к аккаунту Gmail. Прокси-сервер необязателен, связки VPN + Gmail США вполне хватило для авторизации и запуска Gemini Code Assist в VS Code. VPN использовал бесплатный, а вот за аккаунт Gmail со страной США пришлось заплатить 90 руб. (купил на одной из бирж).

После того, как я использовал аккаунт Gmail со страной США и VPN, я смог авторизоваться:

Авторизация в Gemini Code Assist

Подключение агента

В режиме агента вы можете выполнять любые из следующих действий:

• задавать вопросы о своем коде;
• использовать контекст и встроенные инструменты для улучшения создаваемого контента;
• настроить MCP-серверы для расширения возможностей агента;
• получать решения сложных задач, состоящие из нескольких шагов;
• создавать код на основе проектной документации, проблем и комментариев TODO;
• управлять поведением агента, комментируя, редактируя и утверждая планы и использование инструментов во время выполнения.

Чтобы переключиться в режим агента, откройте чат и нажмите на переключатель Agent, чтобы активировать его.

Переход в режим агента

Переключатель подсвечивается при переключении в режим агента и становится серым при обычном чате.

Переключившись в режим Agent, вы увидите экспериментальные подсказки, в числе которых нужная нам команда для запуска /mcp:

Подсказка /mcp в режиме Agent

Введите команду /mcp и нажмите Enter (от агента вам будет всплывать подсказка команды):

Команда /mcp

Вы должны увидеть google-ads-mcp результат в списке:

google-ads-mcp

Раскройте его, чтобы посмотреть содержимое:

Содержимое google-ads-mcp

В официальном репозитории на GitHub подробно описаны все возможные функции Google Ads MCP Server:

• search - получает информацию об аккаунтах Google Ads (GAQL);
• list_accessible_customers - возвращает список рекламных кабинетов, к которым пользователь имеет прямой доступ.

Если вы видите красный значок рядом с google-ads-mcp (0 tools), значит программе не удалось установить соединение с MCP сервером:

Проблема с подключением

Попробуйте перепроверить все настройки из этого руководства и повторно подключиться, вызвав команду /mcp.

Подсказки и запросы

Теперь мы наконец можем перейти к самому главному - задавать вопросы Gemini и узнавать у него все, что нас интересует о наших рекламных кабинетах Google Ads. В официальном репозитории на GitHub есть несколько примеров подсказок, которые вы можете использовать на старте. Например:

• Спросите, что может сделать сервер? - what can the ads-mcp server do?
• К каким клиентам у меня есть доступ? - what customers do I have access to?
• Сколько у меня активных кампаний? - How many active campaigns do I have?
• Какие результаты моей кампании на этой неделе - How is my campaign performance this week?

Для большинства запросов вашему агенту потребуется идентификатор рекламного кабинета. Если вы перемещаетесь между несколькими клиентами, включение ID аккаунта в запрос может быть проще.

• Сколько у меня активных кампаний для идентификатора клиента 1234567890? - How many active campaigns do I have for customer id 1234567890

Все эти запросы интересны, но они на английском языке и мало что имеют общего с моими данными. Поэтому я буду использовать русский язык и другие примеры. Допустим, я хочу узнать, какое количество рекламных кабинетов находятся в моем MCC-аккаунте и какие из них активны. Именно так я и напишу агенту, а затем нажму Enter.

Так как агент Gemini будет обучаться на протяжении всего нашего диалога, вначале его ответы могут быть не самыми быстрыми или не совсем такими, как мы ожидаем. Однако по мере обучения и корректировки он станет отвечать все точнее и быстрее, предоставляя именно те результаты, которые вам нужны. Плюс периодически ему нужно давать разрешения на выполнение тех или иных действий с помощью кнопки Accept:

Подтверждение действий (Accept)

Получение API ключа Gemini

Когда вы общаетесь с моделями вроде GPT, Claude, Gemini или DeepSeek через их официальные сайты или приложения - это бесплатно, потому что компания оплачивает вычисления за вас (в рекламных, демонстрационных или ограниченных целях). Но когда вы используете те же модели через API, ситуация меняется:

• теперь вы обращаетесь к модели программно, напрямую к серверам компании;
• за каждый запрос и ответ модель тратит вычислительные ресурсы.

API требует личный ключ (API key) и платежную (привязанную) карту, чтобы оплачивать эти ресурсы. Именно поэтому работа с чат-ботами ИИ:

• в интерфейсе - бесплатно;
• через API - платно.

API - это инструмент для разработчиков и интеграций, а не для бесплатного массового доступа, поэтому компании взимают оплату за его использование.

Gemini Code Assist предоставляет различные ежедневные квоты на агентские функции в зависимости от вашего уровня. Если вы исчерпали ежедневные квоты для агента Gemini Code Assist, вы можете продолжить пользоваться сервисом, предоставив ключ API. Можно использовать ключ API Gemini или ключ API Vertex AI.

Пример ошибки с исчерпанием квот для режима Agent:

Agent Error, unknown agent message: You have exhausted your capacity on this model. Your quota will reset after 14h37m9s.

Это означает, что вам нужно использовать API ключ и платную версию.

Для создания ключа API перейдите по ссылке и откройте вкладку API keys:

Google AI Studio - API keys

Поскольку мы уже с вами создали отдельный проект в Google Cloud, вы можете импортировать его в Google AI Studio, подключить биллинг, а затем скопировать ключ API. Для этого нажмите на кнопку Import projects:

Import projects

В открывшемся окне выберите свой проект и нажмите Import:

Импорт проекта в Google AI Studio

Ваш проект теперь будет отображаться в общем списке:

Импортированный проект

Теперь вам нужно сделать две вещи:

1. привязать платежный аккаунт (настроить биллинг);
2. создать новый ключ для проекта.

Если ранее вы не привязали платежный аккаунт к проекту Google Cloud, вам необходимо это будет сделать сейчас. Нажмите на Set up billing напротив вашего проекта:

Set up billing

Вас перенаправит на страницу биллинга в Google Cloud. Нажмите на Manage billing accounts:

Manage billing accounts

Если у вас еще нет активных платежных аккаунтов - создайте его:

Create account

Google приостановил работу для пользователей из России. На момент публикации этого материала вы не сможете привязать свою банковскую карту, выпущенную на территории РФ. Наиболее простое и эффективное решение - выпустить карту другой страны (Казахстан, Киргизия, Армения и т.д.), чтобы иметь возможность пользоваться Google Cloud и оплачивать счета.

Задайте название платежному аккаунту и укажите страну:

Название аккаунта и страна

На следующем шаге вас попросят указать ваши персональные данные, включая тип аккаунта (можете выбрать Individual), имя, адрес и реквизиты банковской карты.

Тип аккаунта и платежные данные

Сохраните карту. Нажмите кнопку Submit and enable billing, чтобы создать платежный аккаунт. Затем привяжите платежный аккаунт к своему проекту в Google Cloud, нажав на Link a billing account:

Link a billing account

В открывшемся окне назначьте вашему проекту платежный аккаунт, который вы создали. Нажмите Set account:

Привязка платежного аккаунта к проекту Google Cloud

После этого вернитесь на платформу Google AI Studio и напротив своего проекта нажмите на keys:

Ключи проекта

Создайте новый ключ API:

Create API key

В открывшемся окне задайте название новому ключу (например - Google Ads API MCP Server), а также выберите свой импортированный проект из Google Cloud:

Название ключа и импортированный проект

Нажмите кнопку Create key. Вас перенаправит на страницу со всеми ключами проекта. Нажмите на только что созданный API key:

API Keys

В открывшемся окне скопируйте ключ API:

Копирование API ключа

Вернитесь в Visual Studio Code и откройте палитру команд (Cmd + Shift + P), а затем выберите Open User Settings JSON;

Open User Settings JSON

Добавьте нижеприведенную строку, заменив YOUR_KEY на значение своего ключа API:

"geminicodeassist.geminiApiKey": "YOUR_KEY"

1	"geminicodeassist.geminiApiKey": "YOUR_KEY"

Результат выполнения команды:

Параметр geminicodeassist.geminiApiKey с вашим ключом API

Сохраните файл settings.json. После этого я рекомендую перезапустить программу.

Тестирование Google Ads API MCP Server

Я записал короткое видео, где на протяжении некоторого времени общаюсь с Gemini Code Assist Chat и задаю ему вопросы по разным рекламным кабинетам, которые подключены к моему MCC-аккаунту. Уверен, такой формат лучше демонстрирует его работу, чем длинные тексты и скриншоты.

Gemini API Usage:

Мои API запросы с использованием Gemini

И итоговый расход во время тестирования Google Ads API MCP Server:

Расходы на Gemini API

Google выпустил свое решение примерно месяц назад. Во время тестирования у меня возникали трудности как с подключением к MCP, так и при обращении к API. Иногда Gemini не справлялся с задачей, иногда зависал, а порой выдавал странные результаты. Так или иначе, со временем Google, безусловно, исправит все ошибки и недочеты. Вскоре нас ждет обновленная и стабильная версия с еще более широким набором функций! А пока вы можете потестировать официальный MCP Server, либо же воспользоваться решениями сторонних разработчиков.

Итоги

Google в октябре представил официальный открытый MCP-сервер для Google Ads - программное решение, реализующее стандарт Model Context Protocol (MCP) и обеспечивающее доступ LLM-приложениям к данным рекламных аккаунтов.

Теперь разработчики и маркетологи смогут подключать ИИ-агентов для анализа, мониторинга и аудита кампаний без необходимости использовать проприетарные SDK или создавать индивидуальные интеграции.

MCP выступает универсальным протоколом обмена данными между системами искусственного интеллекта и внешними сервисами - такими как базы данных, API или SaaS-платформы. В текущей версии сервер работает в режиме «только чтение»: он позволяет получать данные и формировать отчеты, но не изменять настройки или содержимое кампаний.

Технически сервер разработан на Python и распространяется под лицензией Apache 2.0. Он совместим с любыми клиентами, поддерживающими MCP, включая Gemini CLI и Code Assist. Среди его основных возможностей - выполнение GAQL-запросов к рекламным аккаунтам и получение списка доступных клиентов.

Установка выполняется через менеджер пакетов pipx. Для доступа к данным требуется токен разработчика Google Ads и корректно настроенные OAuth2-разрешения. Внедрение MCP значительно упрощает интеграцию сторонних ИИ-инструментов, снижая технический порог для аналитических и маркетинговых команд, работающих с бюджетами и KPI.

MCP стремительно набирает популярность как стандарт соединения ИИ с корпоративными инструментами и потоками данных в реальном времени. Эксперты прогнозируют, что дальнейшее развитие протокола сделает возможной автоматизацию управления рекламными кампаниями при появлении поддержки операций записи, то есть вы сможете не только читать/запрашивать данные, но и давать ИИ инструкции по корректировке ваших рекламных кампаний (изменение ставок, оптимизации и т.д.).

Понравилось? Уверен, что да! Изучайте лучшие мировые практики вместе со мной и другими слушателями онлайн-курсов!