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

Протокол контекста модели (MCP) — это открытый стандарт, позволяющий большим языковым моделям (LLM) безопасно взаимодействовать с внешними данными и приложениями. Сервер Google Ads MCP предоставляет стандартизированный мост к API Google Ads, позволяя агентам ИИ анализировать и получать данные о кампаниях, используя естественный язык.

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

Внедрение этого MCP-сервера избавляет от необходимости писать собственный «связующий код» для аутентификации в Google Ads API, получения ресурсов и анализа данных. Сервер предоставляет доступ к определенным инструментам , которые LLM может обнаружить и вызвать автономно.

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

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

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

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

Начать

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

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

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

  • Токен разработчика: Ваша уникальная строка доступа из 22 символов.
  • Идентификатор проекта: ваш идентификатор проекта в Google Cloud.
  • Файл учетных данных: авторизованный файл credentials.json (для OAuth 2.0 или служебной учетной записи).

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

Для интеграции сервера в хост, совместимый с MCP, добавьте следующую запись в конфигурационный файл MCP вашего хоста (например, settings.json ). Точное местоположение и имя файла конфигурации указаны в документации вашего хоста.

JSON

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/credentials.json",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

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

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

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

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

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

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?

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