Model Context Protocol (MCP) – это открытый стандарт, который позволяет большим языковым моделям (LLM) безопасно взаимодействовать с внешними данными и приложениями. MCP-сервер Google Рекламы – это стандартизированный мост к Google Ads API. С его помощью ИИ-агенты могут извлекать и анализировать данные в аккаунте, создавать объекты, загружать видео и управлять ярлыками, используя естественный язык.
Ресурсы и поддержка сообщества
Репозиторий GitHub. В репозитории google-ads-mcp вы найдете демоверсии и примеры, а также сможете сообщить об ошибках или предложить новые функции.
На вкладке Issues (Проблемы) можно сообщить об ошибке или запросить добавление новой функции.
Сообщество. Присоединяйтесь к каналу
#ads-api-ai-toolsв сообществе Google Рекламы в Discord.
Технический обзор
Интеграция сервера MCP Google Рекламы устраняет необходимость писать собственный код для аутентификации Google Ads API, получения ресурсов, синтаксического анализа данных и поддерживаемых изменений объектов или ярлыков. Сервер предоставляет вызываемые инструменты и справочные ресурсы (см. раздел Основные возможности), которые LLM может проверять и вызывать.
Основные характеристики
- Протокол: MCP (Model Context Protocol).
- Режим: чтение и частичное изменение (создание объектов, загрузка видео и управление ярлыками с проверкой по принципу "предложение и подтверждение" или настраиваемый режим "только чтение").
- Язык: Python 3.10 или более поздней версии.
- Транспорт. Стандартный ввод/вывод (
stdio) или потоковый HTTP (streamable-httpв Cloud Run). - Аутентификация. Application Default Credentials (учетные данные пользователя OAuth 2.0 или сервисного аккаунта) для локального
stdioили учетные данные веб-приложения OAuth 2.0 для удаленного HTTP. - Телеметрия. Добавляет
google-ads-mcp/VERSIONв заголовок запроса gRPCx-goog-api-clientдля статистики использования.
Как работает цикл взаимодействия
- Запрос. Вы отправляете запрос, например "Какова эффективность моей кампании на этой неделе?" или "Создай объект уточнения для летней распродажи".
- Обнаружение. LLM проверяет доступные инструменты и ресурсы и выбирает подходящий инструмент
google-ads-mcp. - Выполнение или пробная проверка. Инструменты чтения отправляют запросы напрямую в Google Ads API.
Инструменты изменения сначала запускаются в режиме предложения (
validate_only=True), чтобы проверить входные данные без внесения изменений (см. раздел Безопасный рабочий процесс с предложением и подтверждением). - Внедрение контекста. Сервер MCP возвращает структурированные результаты запроса или предложенные записи
change_itemsи дайджест проверкиchecksumв окно контекста LLM. - Ответ и подтверждение. LLM предоставляет ответ или просит вас подтвердить предложенные изменения. После того как вы одобрите изменение, LLM снова вызовет инструмент mutate с
validate_only=Falseи соответствующим значениемchecksum, чтобы применить изменение.
Начать
Чтобы настроить и запустить сервер MCP Google Рекламы локально, выполните следующие действия. Чтобы развернуть общий удаленный сервис, ознакомьтесь с руководством по развертыванию в Google Cloud.
Требования
Прежде чем настраивать сервер, выполните следующие действия в локальной среде и консоли Google Cloud:
- Проект Google Cloud. Создайте или выберите проект Google Cloud с включенным Google Ads API. Включив API, вы получите тестовый доступ, который позволит вам тестировать рабочие процессы чтения и изменения в тестовых аккаунтах. Чтобы получить доступ к рабочим аккаунтам, проверьте, есть ли у вас доступ уровня Explorer, Basic или стандартный доступ, на обзорной странице Google Ads API или подайте заявку на один из этих уровней доступа. В противном случае вызовы в рабочей версии завершатся ошибкой
AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION. 9 сентября 2026 г. Google прекратит поддержку токенов разработчика (GOOGLE_ADS_DEVELOPER_TOKEN). Уровень доступа к API определяется проектом Google Cloud, которому принадлежит ваш клиент OAuth или сервисный аккаунт. - Учетные данные. В локальном режиме
stdioаутентификация выполняется с помощью Application Default Credentials (ADC) из JSON-файла с секретным кодом клиента OAuth 2.0 или сервисного аккаунта в вашем облачном проекте. При необходимости задайте переменную средыGOOGLE_CLOUD_PROJECT, чтобы указать квоту по умолчанию или проект ADC. Для удаленного развертыванияstreamable-httpтребуется идентификатор клиента и секретный код клиента веб-приложения OAuth 2.0 (см. раздел Развертывание в Google Cloud Run). - Локальное ПО (для режима
stdio). Установите Python 3.10 или более поздней версии,pipxи инструмент командной строкиgcloud(используется для создания файлов ADC пользователя).
Конфигурация
Создайте учетные данные по умолчанию для приложения (ADC), используя клиент OAuth из проекта Google Cloud с включенным API, и добавьте область действия Google Ads API:
gcloud auth application-default login \ --scopes=https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \ --client-id-file=PATH_TO_CLIENT_SECRET_JSONЗамените следующее:
PATH_TO_CLIENT_SECRET_JSON– путь к JSON-файлу с секретным кодом клиента OAuth 2.0.
Эта команда выводит
Credentials saved to file: [PATH_TO_CREDENTIALS_JSON](например,~/.config/gcloud/application_default_credentials.jsonв Linux и macOS). Чтобы выполнить аутентификацию с помощью сервисного аккаунта, пропустите этот шаг и укажите вGOOGLE_APPLICATION_CREDENTIALSпуть к JSON-файлу ключа сервисного аккаунта или передайте--impersonate-service-accountвgcloud auth application-default login.Добавьте сервер в файл конфигурации MCP хоста (например,
~/.gemini/config/mcp_config.json,~/.gemini/settings.jsonили~/.claude/settings.json):{ "mcpServers": { "google-ads-mcp": { "command": "pipx", "args": [ "run", "--spec", "google-ads-mcp==0.0.6", "google-ads-mcp" ], "env": { "GOOGLE_CLOUD_PROJECT": "PROJECT_ID", "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON" } } } }Замените следующее:
PROJECT_ID– идентификатор проекта Google Cloud.PATH_TO_CREDENTIALS_JSON– путь к JSON-файлу ADC, указанному на шаге 1, или к JSON-файлу ключа сервисного аккаунта. Если вы используете расположение файла ADC по умолчанию (gcloud), то можете не указыватьGOOGLE_APPLICATION_CREDENTIALS.
Чтобы получить доступ к клиентским аккаунтам через управляющий аккаунт, задайте
GOOGLE_ADS_LOGIN_CUSTOMER_ID(10 цифр без дефисов) вenvили передайте параметрlogin_customer_idпри вызове отдельных инструментов.
Дополнительно: добавьте навыки и помощника разработчика
MCP-сервер Google Рекламы предоставляет вашему ИИ-клиенту доступ к данным отчетов аккаунта, а также к инструментам для создания объектов, загрузки видео и управления ярлыками. Чтобы агент мог создавать корректные запросы на языке запросов Google Рекламы (GAQL) и диагностировать изменения эффективности аккаунта, используйте сервер MCP вместе со следующими инструментами: Эти инструменты также генерируют код клиентской библиотеки, например скрипты для связывания созданных объектов с кампаниями или выполнения других неподдерживаемых изменений:
Навыки ИИ-агента Google Ads API. Портативные модули рабочих процессов (включая
google-ads-api-mcp-setup,google-ads-api-account-diagnosticsиgoogle-ads-api-quickstart), которые помогают агенту использовать сервер MCP Google Рекламы с меньшими затратами токенов. Чтобы установить их, выполните следующую команду (требуется Node.js). Вы также можете ознакомиться с руководством по навыкам ИИ-агента Google Ads API для Antigravity, Claude Code, Codex и Cursor.npx skills add google/skills/skills/adsGoogle Ads API Developer Assistant. Плагин с открытым исходным кодом (не является официально поддерживаемым продуктом Google) для Google Antigravity и Claude Code, который обеспечивает локальную проверку схемы Protobuf, валидацию GAQL, генерацию кода клиентской библиотеки и устранение неполадок с офлайн-конверсиями. Ознакомьтесь со статьей Как выбрать подходящий ИИ-инструмент Google Рекламы или следуйте руководству по установке.
Основные возможности
В следующих разделах описываются инструменты сервера для чтения, инструменты для частичного изменения и справочные ресурсы. Начиная с версии v0.0.6 инструменты по умолчанию регистрируются с префиксом пространства имен категории (например, search_search). При обновлении подсказок или белых списков из выпусков без префиксов обновите названия инструментов или задайте пустой префикс ("") в tools_config.yaml (см. раздел Как настроить пространства имен инструментов и режим "только чтение").
Инструменты чтения
customers_list_accessible_customers(инструментlist_accessible_customers) возвращает идентификаторы клиентов Google Рекламы, напрямую доступные аутентифицированному пользователю.search_search(инструментsearch) – создает и выполняет запросы GAQLSearchStreamна основе структурированных параметров (customer_id,resourceиfields, а также необязательныхconditions,orderings,limitиlogin_customer_id), а не необработанной строки GAQL. Каждый запрос добавляетPARAMETERS omit_unselected_resource_names=true, чтобы получить атрибуты ресурсов, показатели, сегменты, бюджеты и статус.metadata_get_resource_metadata(инструментget_resource_metadata). Извлекает атрибуты, показатели и сегменты, которые можно выбирать, фильтровать и сортировать, для типа ресурса Google Ads API (например,"campaign"). Используйте эти метаданные, чтобы найти допустимые поля запроса, включая показатели и сегменты, добавленные в минорных выпусках, таких как v26.2, перед вызовом инструментаsearch_search.
Инструменты изменения (частичная поддержка)
assets_create_asset(инструментcreate_asset) создает отдельные объекты Google Рекламы со специальными параметрами для объектов следующих типов:TEXT,IMAGE,YOUTUBE_VIDEO,SITELINK,CALLOUTиSTRUCTURED_SNIPPET. Передайте словарьextra_paramsдля других изменяемых типовAssetService(например,PRICE,PROMOTION,CALLилиBUSINESS_MESSAGE) и включитеfinal_urlsкорневого уровня вместе сsitelink_link_textдля объектовSITELINK. Пути к локальным файлам (image_asset_path) работают только в локальном режиме (stdio). Для удаленного развертывания HTTP передайте параметрimage_asset_dataв кодировке base64, задав дляimage_asset_mime_typeзначениеIMAGE_PNG,IMAGE_JPEGилиIMAGE_GIF(до 20 МБ).assets_upload_video_asset(инструментupload_video_asset): загружает локальный видеофайл (.3gp,.avi,.flv,.mkv,.mov,.mp4,.mpeg,.mpg,.ogg,.webmили.wmv) на YouTube через Google Ads API в качестве фоновой задачи FastMCP только в локальном режимеstdio. Параметрыvideo_titleиvideo_descriptionявляются обязательными. Параметрvideo_privacyпринимает значенияUNLISTED(по умолчанию) илиPUBLIC(допускается только на каналах брендов, принадлежащих рекламодателю, с OAuth пользователя). Этот инструмент возвращает значениеvideo_upload_idGoogle Рекламы (и название ресурса), а не 11-значныйvideo_idYouTube. Запроситеyou_tube_video_uploadс помощью инструментаsearch_search(фильтрация поyou_tube_video_upload.video_upload_id) доyou_tube_video_upload.state = 'PROCESSED'. Затем передайтеyou_tube_video_upload.video_idв качестве параметраyoutube_video_idвassets_create_asset(asset_type="YOUTUBE_VIDEO").labels_manage_labels(инструментmanage_labels) – создает, обновляет и удаляет ярлыки аккаунтов, включая название, описание и шестнадцатеричный код цвета фона.labels_manage_label_associations(инструментmanage_label_associations): поддерживает операции связывания ярлыковCREATEиREMOVE(UPDATEне поддерживается) для ресурсовCAMPAIGN,CUSTOMER,AD_GROUPиAD_GROUP_CRITERION. Для ресурсовCUSTOMERпараметрresource_idявляется необязательным и по умолчанию имеет значениеcustomer_id. Передайте составной идентификатор{ad_group_id}~{criterion_id}для ресурсовAD_GROUP_CRITERIONи удалите связи, передавresource_idиlabel_idилиassociation_resource_name. Ярлыки на уровне объявленийAD_GROUP_ADне поддерживаются.
Справочные ресурсы
Сервер предоставляет четыре ресурса MCP, доступных только для чтения. Они остаются подключенными независимо от настроек tools_config.yaml:
resource://discovery-document. Обзор ресурсов, методов сервиса и схем Google Ads API в JSON REST. Он дополняет инструментmetadata_get_resource_metadata, который возвращает поля запросов GAQL, доступные для выбора, фильтрации и сортировки.resource://metrics: справочная документация по показателям Google Ads API в формате HTML.resource://segments– справочная документация по сегментам Google Ads API в формате HTML.resource://release-notes: HTML-примечания к выпуску Google Ads API, в которых рассказывается об изменениях в версиях и новых функциях.
Процесс обеспечения безопасности "Предложение и подтверждение"
Каждый инструмент изменения (assets_create_asset, assets_upload_video_asset, labels_manage_labels и labels_manage_label_associations) использует двухэтапный рабочий процесс предложения и подтверждения, чтобы предотвратить непреднамеренные изменения аккаунта:
- Propose (
validate_only=True, по умолчанию). Проверяет входные данные без внесения изменений. Инструменты для работы с объектами и ярлыками выполняют пробный прогон Google Ads API.validate_onlyПоскольку вYouTubeVideoUploadServiceнет режима пробного выполнения,assets_upload_video_assetпроверяет локальный файл и привязывает его размер и временную метку изменения. Каждый инструмент возвращает человекочитаемые записиchange_itemsи дайджест SHA-256checksumбез сохранения состояния, привязанный к параметруcustomer_idи полезной нагрузке запроса. - Подтверждение (
validate_only=False). После того как агент покажет списокchange_itemsи получит ваше одобрение, он снова вызовет инструмент с параметромvalidate_only=False, тем же параметромcustomer_idи аргументами, а также значениемchecksumиз шага 1. Сервер отклоняет любые отсутствующие или несовпадающие контрольные суммы перед изменением аккаунта.
Настройте пространства имен инструментов и режим "только чтение"
Сервер поставляется с файлом tools_config.yaml по умолчанию, в котором включены все пять категорий инструментов (customers, search, metadata, labels и assets).
Настройте tools_config.yaml, чтобы выборочно включать или отключать отдельные инструменты или пространства имен, изменять или удалять префиксы пространств имен или принудительно развертывать строго только для чтения.
При запуске сервер разрешает tools_config.yaml в следующем порядке:
- Явный путь в переменной среды
GOOGLE_ADS_MCP_TOOLS_CONFIG(рекомендуется для локальных хостовstdio, рабочие каталоги которых могут отличаться от папки проекта). - Файл
tools_config.yamlв текущем рабочем каталоге сервера. - Файл
tools_config.yamlпо умолчанию, который входит в пакет.
Если GOOGLE_ADS_MCP_TOOLS_CONFIG указывает на отсутствующий файл или если какой-либо разрешенный файл конфигурации недействителен, сервер выдает ошибку при запуске вместо возврата к значениям по умолчанию.
Ниже приведен пример минимального файла tools_config.yaml, который обеспечивает развертывание только для чтения.
namespaces:
customers: true
search: true
metadata: true
labels: false
assets: false
В следующем файле tools_config.yaml настраиваются префиксы и фильтруются отдельные инструменты (например, инструмент create_asset base64 становится доступен в Cloud Run, а локальный инструмент upload_video_asset отключается):
namespaces:
# Default prefix ("customers_list_accessible_customers")
customers: true
# Empty prefix mounts unprefixed tool names ("search")
search: ""
# Custom prefix ("schema_get_resource_metadata")
metadata: "schema"
# Enable only specific tools in a multi-tool category
assets:
enabled_tools:
- create_asset
Примеры запросов
После подключения сервера попробуйте ввести в MCP-клиенте следующие запросы.
Спросите, что может сделать сервер
What can the google-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?
Give me a report of the top spending campaigns split by device category over the last 7 days for account 1234567890
Как создавать объекты, загружать видео и управлять ярлыками
Create a callout asset with the text "Free Shipping" for account 1234567890
Upload /path/to/promo.mp4 with title "Summer Sale" and description "Summer promo video" for account 1234567890
Create a label named "Q4 Promo" with background color #34A853 and apply it to campaign 9876543210 in account 1234567890
Развертывание в Google Cloud
Чтобы использовать MCP-сервер с несколькими агентами или запустить его как веб-сервис, разместите его в Google Cloud Run или у другого поставщика облачной инфраструктуры, а не запускайте локально.
Требования
- Проект Google Cloud с включенным Google Ads API (требования для доступа к рабочей версии см. в разделе Предварительные требования).
Установлен инструмент командной строки
gcloud, выполнена аутентификация и настроен активный проект.gcloud config set project PROJECT_IDЗамените следующее:
PROJECT_ID– идентификатор проекта Google Cloud.
Как создать и отправить образ Docker
Используйте Cloud Build, чтобы создать образ контейнера и отправить его в Artifact Registry, не устанавливая Docker локально:
Создайте хранилище в Artifact Registry:
gcloud artifacts repositories create mcp-servers \ --repository-format=docker --location=us-central1Создайте и отправьте образ из тега выпуска в хранилище GitHub (или из
.в локальной копии, если вы настроилиDockerfileилиtools_config.yaml):gcloud builds submit https://github.com/googleads/google-ads-mcp \ --git-source-revision=v0.0.6 \ --tag=us-central1-docker.pkg.dev/PROJECT_ID/mcp-servers/google-ads-mcp:v0.0.6Замените следующее:
PROJECT_ID– идентификатор проекта Google Cloud.
Пересобирайте и повторно развертывайте образ при каждом обновлении
google-ads-mcpили обновлении встроенной клиентской библиотеки Pythongoogle-adsдля новых выпусков Google Ads API (например, версии 26.2).
Развернуть в Google Cloud Run
Настройте следующие переменные среды и секреты для сервиса Cloud Run:
GOOGLE_ADS_MCP_OAUTH_CLIENT_ID: идентификатор клиента OAuth 2.0 веб-приложения из облачного проекта Google Cloud с включенным API для аутентификации OAuth на уровне приложения. Выполните следующие действия по настройке OAuth:- Добавьте авторизованные URI перенаправления для всех ИИ-клиентов, которые вы планируете подключить (например,
https://claude.ai/api/mcp/auth_callback,https://chatgpt.com/connector_platform_oauth_redirectилиhttps://antigravity.google/oauth-callback). - Добавьте область действия
https://www.googleapis.com/auth/adwordsв окно запроса доступа OAuth в разделе APIs & Services (API и сервисы) > OAuth consent screen (Окно запроса доступа OAuth) > Data Access (Доступ к данным) (Add or remove scopes (Добавить или удалить области действия)). - Если для статуса публикации окна запроса доступа OAuth установлено значение Тестирование (по умолчанию), добавьте аккаунты Google, подключающиеся к серверу MCP, в качестве тестовых пользователей в разделе APIs & Services (API и сервисы) > OAuth consent screen (Окно запроса доступа OAuth) > Audience (Аудитория) (Test users (Тестовые пользователи) > + Add users (+ Добавить пользователей)).
- Добавьте авторизованные URI перенаправления для всех ИИ-клиентов, которые вы планируете подключить (например,
GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET– секретный код клиента OAuth, соответствующий вашему идентификатору клиента OAuth.GOOGLE_ADS_MCP_BASE_URL– общедоступный базовый URL вашего MCP-сервера (например,https://google-ads-mcp-xyz-uc.a.run.app). Cloud Run назначает этот URL во время первоначального развертывания, поэтому сначала выполните развертывание без этой переменной, а затем обновите сервис.GOOGLE_ADS_MCP_JWT_SIGNING_KEY(рекомендуется для Cloud Run с несколькими экземплярами) – постоянный секрет, который подписывает JWT FastMCP при перезапуске контейнеров и горизонтальном масштабировании.GOOGLE_ADS_MCP_STORAGE_TYPE(рекомендуется для Cloud Run с несколькими экземплярами) – серверная часть для регистраций и токенов клиентов OAuth. Допустимые значения:redis,firestore,filetree(сGOOGLE_ADS_MCP_STORAGE_PATHдля развертываний, не связанных с Cloud Run VM или подключенными томами) иmemory. Если задать переменную, относящуюся к определенному серверу, будет выбран именно он, даже если переменнаяGOOGLE_ADS_MCP_STORAGE_TYPEне задана. Если все переменные серверной частиGOOGLE_ADS_MCP_STORAGE_*не заданы, FastMCP использует локальное хранилище контейнера по умолчанию. Для тестирования одного экземпляра с локальным хранилищем или хранилищемmemoryпередайте--max-instances=1:redis: задатьGOOGLE_ADS_MCP_STORAGE_REDIS_URL(по умолчаниюredis://localhost:6379/0) и установитьpy-key-value-aio[redis]в пользовательскийDockerfile. Redis автоматически удаляет записи с истекшим сроком действия.firestore: при необходимости задайтеGOOGLE_ADS_MCP_STORAGE_FIRESTORE_PROJECT(по умолчанию используется проект ADC) иGOOGLE_ADS_MCP_STORAGE_FIRESTORE_DATABASE(по умолчанию используется(default)). Установите.[firestore]в пользовательскомDockerfile, подготовьте базу данных Firestore и предоставьте рольroles/datastore.userIdentity and Access Management (IAM) сервисному аккаунту Cloud Run. Хранилище Firestore фильтрует записи с истекшим сроком действия при чтении, не удаляя их. Посколькуexpires_atхранится в виде строки, правила TTL (времени жизни) Firestore не могут удалять записи с истекшим сроком действия. Для долгосрочных развертываний запланируйте периодическую очистку или используйте Redis.memory: временное хранилище в памяти (полезно только с--max-instances=1).
GOOGLE_ADS_MCP_STORAGE_ENCRYPTION_KEY(необязательно) – специальный ключ шифрования Fernet (или секретный код с высокой энтропией) для сохраненного состояния OAuth. Эта настройка иGOOGLE_ADS_MCP_STORAGE_DISABLE_ENCRYPTION=trueприменяются, только если настроен явный бэкендGOOGLE_ADS_MCP_STORAGE_*. Если этот параметр не указан, сервер получает ключ шифрования изGOOGLE_ADS_MCP_JWT_SIGNING_KEYили используетGOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET, если ключ подписи JWT не задан. Если задать специальный ключ шифрования, то при ротации резервного секрета сохраненные токены OAuth не будут аннулированы.PORT(необязательно) – порт прослушивания в режимеstreamable-http(по умолчанию8080; Cloud Run устанавливает его автоматически).GOOGLE_ADS_LOGIN_CUSTOMER_ID(необязательно) – идентификатор клиента управляющего аккаунта по умолчанию (10 цифр без дефисов), который используется, если в вызовах инструмента не указан параметрlogin_customer_id.GOOGLE_ADS_MCP_TOOLS_CONFIG(необязательно) – путь к контейнеру для пользовательского файлаtools_config.yaml(например, смонтированного из Secret Manager в/etc/mcp/tools_config.yaml, чтобы принудительно включить режим только для чтения без пересборки образа). Подробнее о настройке пространств имен инструментов и режима "Только чтение"…
Сохраните GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET и GOOGLE_ADS_MCP_JWT_SIGNING_KEY в Secret Manager и разверните сервис в Google Cloud Run:
gcloud run deploy google-ads-mcp \
--image=us-central1-docker.pkg.dev/PROJECT_ID/mcp-servers/google-ads-mcp:v0.0.6 \
--platform=managed \
--region=us-central1 \
--allow-unauthenticated \
--set-env-vars="GOOGLE_ADS_MCP_OAUTH_CLIENT_ID=CLIENT_ID" \
--set-secrets="GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET=MCP_OAUTH_CLIENT_SECRET:latest,GOOGLE_ADS_MCP_JWT_SIGNING_KEY=MCP_JWT_SIGNING_KEY:latest"
После того как Cloud Run завершит развертывание, получите назначенный URL сервиса и обновите сервис с помощью переменной среды GOOGLE_ADS_MCP_BASE_URL:
gcloud run services update google-ads-mcp \
--region=us-central1 \
--update-env-vars="GOOGLE_ADS_MCP_BASE_URL=https://CLOUD_RUN_SERVICE_URL"
Замените следующее:
PROJECT_ID– идентификатор проекта Google Cloud.CLIENT_ID– идентификатор клиента веб-приложения OAuth 2.0.MCP_OAUTH_CLIENT_SECRET– название секрета Secret Manager, в котором хранится секретный код клиента OAuth 2.0.MCP_JWT_SIGNING_KEY– название секрета Secret Manager, в котором хранится ключ подписи JWT.CLOUD_RUN_SERVICE_URL– имя хоста, назначенное вашему сервису Cloud Run (например,google-ads-mcp-xyz-uc.a.run.app).
Модель аутентификации и безопасности
Развертывание с помощью --allow-unauthenticated отключает проверку IAM инфраструктуры Cloud Run (roles/run.invoker), чтобы внешние ИИ-клиенты могли подключаться без токенов сервисных аккаунтов Google Cloud. Аутентификация делегируется прикладному уровню:
- Если заданы параметры
GOOGLE_ADS_MCP_OAUTH_CLIENT_IDиGOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET, сервер принудительно применяет Google OAuth 2.0 для каждого запроса и возвращает код статуса HTTP401 Unauthorizedдля неаутентифицированных вызывающих объектов. Каждый вызов инструмента выполняется с использованием идентификационных данных OAuth аутентифицированного вызывающего абонента. - Если не указать
--allow-unauthenticated, вызывающие абоненты должны будут передавать токены идентификации OIDC Google Cloud с каждым запросом. Стандартные ИИ-клиенты (например, Claude и ChatGPT) используют OAuth конечного пользователя, а не токены Google Cloud IAM, поэтому для прямых подключений требуется--allow-unauthenticatedв сочетании с OAuth на уровне приложения.
Настройте MCP-клиент
После развертывания настройте клиент MCP, указав URL сервиса Cloud Run. Поскольку сервер использует OAuth 2.0, ваш клиент должен поддерживать процесс OAuth для MCP или предоставлять авторизованный токен на предъявителя:
- Клиенты с поддержкой OAuth. В клиентах, поддерживающих обнаружение MCP OAuth (например, Antigravity), при подключении появляется запрос на вход в аккаунт Google для предоставления области действия
https://www.googleapis.com/auth/adwords(в консоли Google Cloud она отображается как.../auth/adwords). - Сторонние ИИ-платформы (Claude, ChatGPT). В настройках коннектора клиента добавьте собственный коннектор, указывающий на URL вашего сервиса с путем
/mcp(например,https://google-ads-mcp-xyz-uc.a.run.app/mcp). Выберите аутентификацию OAuth 2.0 с идентификатором клиента OAuth и секретным кодом клиента и убедитесь, что URI обратного вызова клиента указан в списке разрешенных URI перенаправления клиента OAuth. - Клиенты без поддержки OAuth. Клиенты, которые не поддерживают потоки HTTP OAuth, получают код статуса HTTP
401 Unauthorized. Для таких клиентов используйте локальную конфигурацию stdio.
В примере ниже показано, как настроить инструмент командной строки gemini в ~/.gemini/settings.json. Если вы используете Google Antigravity в ~/.gemini/config/mcp_config.json, замените "httpUrl" на "serverUrl" или "url".
{
"mcpServers": {
"google-ads-mcp": {
"httpUrl": "https://CLOUD_RUN_SERVICE_URL/mcp"
}
}
}
Замените следующее:
CLOUD_RUN_SERVICE_URL– имя хоста, назначенное вашему сервису Cloud Run (например,google-ads-mcp-xyz-uc.a.run.app).
Дальнейшие действия
- Как установить навыки ИИ-агента Google Ads API
- Сравнение ИИ-инструментов Google Рекламы и Помощника разработчика Google Ads API
- Как установить и использовать Google Ads API Developer Assistant