Эта страница переведена с помощью Cloud Translation API.

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

The Model Context Protocol (MCP) is an open standard that enables Large Language Models (LLMs) to securely interact with external data and applications. The Google Ads MCP server provides a standardized bridge to the Google Ads API, which lets AI agents analyze and retrieve campaign data using natural language.

Общественные ресурсы и поддержка

Репозиторий GitHub: Найдите демонстрации, примеры и сообщите об ошибках или предложите новые функции в репозитории google-ads-mcp .
Для сообщений об ошибках и предложений по улучшению используйте вкладку «Проблемы» .
Сообщество: Присоединяйтесь к каналу #ads-api-ai-tools в Discord-сообществе Google Advertising .

Технический обзор

By implementing this MCP server, you eliminate the need to write custom "glue code" for Google Ads API authentication, resource fetching, and data parsing. The server exposes specific tools that an LLM can discover and invoke autonomously.

Основные характеристики

Протокол: MCP (Model Context Protocol)
Режим: Только для чтения (текущая версия)
Язык программирования: Python
Транспорт: Стандартный ввод/вывод ( stdio )
Аутентификация: OAuth 2.0 или служебная учетная запись.

Как работает цикл взаимодействия

Запрос: Пользователь отправляет запрос, например: «Как обстоят дела с эффективностью моей кампании на этой неделе?» .
Исследование: Магистр права изучает доступные инструменты и определяет возможности поиска по запросу google-ads-mcp .
Выполнение: Сервер MCP выполняет базовую логику на языке Python для запроса к API Google Ads.
Внедрение контекста: Структурированные результаты возвращаются в контекстное окно LLM.
Ответ: LLM синтезирует данные в удобочитаемый ответ.

Начните

Выполните следующие шаги, чтобы настроить и использовать сервер Google Ads MCP.

Предварительные требования

Перед началом настройки убедитесь, что у вас есть следующие учетные данные из консоли Google Cloud :

Project ID: Your Google Cloud project number. Check the Google Ads API overview page to ensure that your project has Explorer Access, Basic Access, or Standard Access levels. If not, apply for one of these access levels
Учетные данные OAuth: либо пара идентификатор клиента OAuth 2.0/секрет клиента, либо набор учетных данных приложения по умолчанию .

Конфигурация

To integrate the server into an MCP-compatible host, add the following entry to your host's MCP configuration file, such as settings.json . Consult your host's documentation for the exact location and filename of this configuration.

JSON

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Развертывание в облаке Google

Instead of hosting this MCP server locally, you can host it on Google Cloud Run or on any other cloud-based infrastructure. This is useful if you want to share the server across different agents or run it as a web service.

Предварительные требования

Проект Google Cloud.
Инструмент командной строки gcloud установлен, авторизован и имеет активный настроенный проект:
```
gcloud config set project YOUR_PROJECT_ID
```

Создайте и загрузите образ Docker.

С помощью Cloud Build можно собрать и отправить образ в реестр артефактов без необходимости локальной установки Docker.

Создайте репозиторий в реестре артефактов:

gcloud artifacts repositories create mcp-servers --repository-format=docker --location=us-central1

Перейдите в каталог проекта:
```
cd <full path>/google-ads-mcp
```
Создайте и отправьте образ:
```
gcloud builds submit --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/mcp-servers/google-ads-mcp:latest .
```
Обратите внимание, что этот шаг необходимо выполнять всякий раз, когда вы хотите обновить развернутый сервер до последней версии.

Развертывание в Google Cloud Run

Обязательно установите необходимые переменные среды:

GOOGLE_PROJECT_ID : Идентификатор вашего проекта Google Cloud, для которого установлены соответствующие уровни доступа к API.
GOOGLE_ADS_MCP_OAUTH_CLIENT_ID : Идентификатор клиента OAuth, который должен использовать сервер MCP.
GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET : Секретный ключ клиента OAuth, который должен использовать сервер MCP.
GOOGLE_ADS_MCP_BASE_URL : The base URL where your MCP server is accessible: this will be automatically assigned by Google Cloud Run after your first deployment. You can update the environment variables after deployment.
FASTMCP_HOST : Установите это значение равным 0.0.0.0, чтобы FastMCP мог принимать соединения со всех IP-адресов.

gcloud run deploy google-ads-mcp \
  --image us-central1-docker.pkg.dev/YOUR_PROJECT_ID/mcp-servers/google-ads-mcp:latest \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated \
  --set-env-vars="GOOGLE_PROJECT_ID=YOUR_PROJECT_ID,GOOGLE_ADS_MCP_OAUTH_CLIENT_ID=YOUR_CLIENT_ID,GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET=YOUR_CLIENT_SECRET,GOOGLE_ADS_MCP_BASE_URL=YOUR_BASE_URL,FASTMCP_HOST=0.0.0.0"

Настройте клиент MCP.

После развертывания обновите конфигурацию клиента MCP (например, ~/.gemini/settings.json ), чтобы использовать URL-адрес Cloud Run.

{
  "mcpServers": {
    "google-ads-mcp": {
      "httpUrl": "https://your-cloud-run-url.a.run.app/mcp"
    }
  }
}

Основные возможности (инструменты)

Сервер предоставляет инструменты, предназначенные для поиска учетных записей и составления отчетов о производительности:

list_accessible_customers : Возвращает список идентификаторов клиентов и имен учетных записей Google Ads, доступных авторизованному пользователю.
search : Выполняет запросы Google Ads Query Language (GAQL) для получения метрик ресурсов, бюджетов и статуса.
get_resource_metadata : Извлекает метаданные о типе ресурса Google Ads API, например, "кампания".
Это полезно для понимания структуры данных и того, какие поля доступны для запросов.

Примеры подсказок для начала

Спросите, что может делать сервер :

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