Как использовать MCP-сервер Google Менеджера рекламы

Google Менеджер рекламы предлагает удаленный сервер Model Context Protocol (MCP), который позволяет ИИ-агентам безопасно взаимодействовать с сетями, инвентарем, заказами и данными пользователей Google Менеджера рекламы. Настроив сервер MCP Менеджера рекламы, вы разрешите приложениям на основе ИИ, таким как Google Antigravity, Claude и ChatGPT, выполнять действия от имени пользователя Менеджера рекламы.

MCP-сервер доступен по адресу https://admanager.googleapis.com/mcp.

Требования

  • Доступ к созданию проектов Google Cloud или к просмотру существующего проекта Google Cloud.
  • Доступ к редактированию подключений или приложений в ИИ-клиентах (например, ChatGPT или Claude).

Как настроить MCP-сервер Менеджера рекламы

Чтобы использовать сервер MCP Менеджера рекламы, выполните следующие действия:

  • Включите Ad Manager API в проекте Google Cloud.
  • Настройте аутентификацию конечных пользователей по протоколу OAuth 2.0.
  • Добавьте MCP-сервер в клиент ИИ.

Как включить Ad Manager API

Чтобы использовать сервер MCP Менеджера рекламы, необходимо включить Ad Manager API в облачном проекте Google Cloud. Если вам нужно создать проект Google Cloud, ознакомьтесь с разделом Новый проект.

Включите API

MCP-сервер Менеджера рекламы использует OAuth 2.0 для аутентификации и авторизации конечных пользователей. Когда ИИ-клиент подключается к MCP-серверу, он проходит аутентификацию как пользователь, запустивший ИИ-клиент. ИИ-агент наследует те же роли пользователей, сети и разрешения Google Менеджера рекламы, что и пользователь.

  1. В консоли Google Cloud перейдите в раздел Google Auth Platform > Branding (Платформа аутентификации Google > Брендинг).

    Перейти к брендингу

  2. Если вы уже настроили Google Auth Platform, то можете задать следующие настройки окна запроса доступа OAuth: Брендинг, Аудитория и Доступ к данным. Если вы видите сообщение Google Auth Platform not configured yet (Платформа аутентификации Google ещё не настроена), нажмите Get Started (Начать).

    1. В разделе Информация о приложении в поле Название приложения введите "Ad Manager MCP Server" или другое название.
    2. В поле Адрес электронной почты для поддержки пользователей выберите свой адрес электронной почты или подходящую группу.
    3. Нажмите Далее.
    4. В разделе Аудитория выберите Внутренняя.
    5. Нажмите Далее.
    6. В разделе Контактная информация укажите адрес электронной почты, на который вы хотите получать уведомления об изменениях в проекте.
    7. Нажмите Далее.
    8. В разделе Завершение ознакомьтесь с Правилами в отношении пользовательских данных сервисов API Google и, если вы согласны с ними, выберите Я принимаю Правила в отношении пользовательских данных сервисов API Google.
    9. Нажмите Продолжить.
    10. Нажмите Создать.

  3. Нажмите Доступ к данным > Добавить или удалить области действия. Появится панель со списком областей для каждого API, включенного в проекте Google Cloud.

    1. В разделе Добавить области действия вручную укажите области действия OAuth, необходимые для MCP-сервера Менеджера рекламы:
      • https://www.googleapis.com/auth/admanager (полный доступ к просмотру и управлению кампаниями)
    2. Нажмите Добавить в таблицу.
    3. Нажмите Обновить.
    4. Выбрав нужные области действия, на странице Доступ к данным нажмите Сохранить.

Добавьте MCP-сервер в ИИ-клиент

Чтобы добавить MCP-сервер Менеджера рекламы в клиент ИИ, следуйте инструкциям для вашего клиента:

Antigravity

Чтобы добавить сервер MCP Менеджера рекламы в Antigravity, выполните следующие действия:

  1. Создайте идентификатор клиента и секретный код OAuth 2.0:

    1. В Google API Console выберите Google Auth Platform > Clients > Create client (Платформа аутентификации Google > Клиенты > Создать клиента).

      Перейти к созданию клиента

      Если у вас не выбран проект, вам будет предложено создать его.

    2. В списке Тип приложения выберите Веб-приложение.

    3. В поле Название введите название приложения.

    4. В разделе Разрешенные URI перенаправления нажмите + Добавить URI и введите https://antigravity.google/oauth-callback в поле URI.

    5. Нажмите Создать. Клиент создан.

      Откроется диалоговое окно OAuth 2.0 client created (Клиент OAuth 2.0 создан).

    6. В разделе Client secrets (Секретные коды клиента) скопируйте Client secret (Секретный код клиента) и сохраните его в надежном месте. Скопировать его можно только один раз. Если вы потеряете секретный код, удалите его и создайте новый.

  2. Чтобы добавить MCP-сервер Менеджера рекламы в Antigravity, обновите файл ~/.gemini/config/mcp_config.json:

    {
  "mcpServers": {
    "AdManager-MCP": {
      // Use your chosen MCP server URL.
      "serverUrl": "https://admanager.googleapis.com/mcp",
      "oauth": {
        "clientId": "CLIENT_ID",
        "clientSecret": "CLIENT_SECRET"
      }
    }
  }
}

    Замените CLIENT_ID и CLIENT_SECRET на учетные данные клиента OAuth 2.0.

  3. Чтобы выполнить аутентификацию MCP-сервера Менеджера рекламы, ознакомьтесь с разделом Antigravity: аутентификация с помощью OAuth.

Claude.ai

Чтобы добавить MCP-сервер Менеджера рекламы в Claude.ai, настройте специальный коннектор с идентификатором клиента OAuth и секретным кодом клиента OAuth.

  1. Создайте идентификатор клиента и секретный код OAuth 2.0:

    1. В Google API Console выберите Google Auth Platform > Clients > Create client (Платформа аутентификации Google > Клиенты > Создать клиента).

      Перейти к созданию клиента

      Если у вас не выбран проект, вам будет предложено создать его.

    2. В списке Тип приложения выберите Веб-приложение.

    3. В поле Название введите название приложения.

    4. В разделе Разрешенные URI перенаправления нажмите + Добавить URI и введите https://claude.ai/api/mcp/auth_callback в поле URI.

    5. Нажмите Создать. Клиент создан.

      Откроется диалоговое окно OAuth 2.0 client created (Клиент OAuth 2.0 создан).

    6. В разделе Client secrets (Секретные коды клиента) скопируйте Client secret (Секретный код клиента) и сохраните его в надежном месте. Скопировать его можно только один раз. Если вы потеряете секретный код, удалите его и создайте новый.

  2. Следуйте инструкциям по созданию специального коннектора. Введите идентификатор и секретный код клиента в меню Расширенные настройки.

Claude Code

Чтобы добавить MCP-сервер Менеджера рекламы в Claude Code, настройте специальный коннектор с идентификатором клиента OAuth и секретным кодом клиента OAuth.

  1. Установите Claude Code.

  2. Создайте идентификатор и секретный код клиента OAuth 2.0:

    1. В Google API Console выберите Google Auth Platform > Clients > Create client (Платформа аутентификации Google > Клиенты > Создать клиента).

      Перейти к созданию клиента

      Если у вас не выбран проект, вам будет предложено создать его.

    2. В списке Тип приложения выберите Веб-приложение.

    3. В поле Название введите название приложения.

    4. В разделе Разрешенные URI перенаправления нажмите + Добавить URI и введите https://claude.ai/api/mcp/auth_callback в поле URI.

    5. Нажмите Создать. Клиент создан.

      Откроется диалоговое окно OAuth 2.0 client created (Клиент OAuth 2.0 создан).

    6. В разделе Client secrets (Секретные коды клиента) скопируйте Client secret (Секретный код клиента) и сохраните его в надежном месте. Скопировать его можно только один раз. Если вы потеряете секретный код, удалите его и создайте новый.

  3. Следуйте инструкциям по созданию специального коннектора. Введите идентификатор и секретный код клиента в меню Расширенные настройки.

Claude Desktop

Чтобы добавить MCP-сервер Менеджера рекламы в Claude Desktop, настройте собственный коннектор с идентификатором клиента OAuth и секретным кодом клиента OAuth.

  1. Установите Claude Desktop.

  2. Создайте идентификатор и секретный код клиента OAuth 2.0:

    1. В Google API Console выберите Google Auth Platform > Clients > Create client (Платформа аутентификации Google > Клиенты > Создать клиента).

      Перейти к созданию клиента

      Если у вас не выбран проект, вам будет предложено создать его.

    2. В списке Тип приложения выберите Веб-приложение.

    3. В поле Название введите название приложения.

    4. В разделе Разрешенные URI перенаправления нажмите + Добавить URI и введите https://claude.ai/api/mcp/auth_callback в поле URI.

    5. Нажмите Создать. Клиент создан.

      Откроется диалоговое окно OAuth 2.0 client created (Клиент OAuth 2.0 создан).

    6. В разделе Client secrets (Секретные коды клиента) скопируйте Client secret (Секретный код клиента) и сохраните его в надежном месте. Скопировать его можно только один раз. Если вы потеряете секретный код, удалите его и создайте новый.

  3. Следуйте инструкциям по созданию специального коннектора. Введите идентификатор и секретный код клиента в меню Расширенные настройки.

ChatGPT

Чтобы использовать сервер MCP Менеджера рекламы с ChatGPT, вам понадобится подписка ChatGPT Business.

Чтобы добавить MCP-сервер в ChatGPT, создайте идентификатор клиента и секретный код Google OAuth 2.0, а затем добавьте MCP-сервер как приложение в ChatGPT.

Как создать идентификатор и секретный код клиента OAuth 2.0

  1. В Google API Console перейдите в раздел Google Auth Platform (Платформа Google Auth) > Clients (Клиенты) > Create client (Создать клиента).

    Перейти к созданию клиента

    Если у вас не выбран проект, вам будет предложено создать его.

  2. В списке Тип приложения выберите Веб-приложение.

  3. В поле Название введите название приложения.

  4. В разделе Разрешенные URI перенаправления нажмите + Добавить URI и введите https://chatgpt.com/connector_platform_oauth_redirect в поле URI.

  5. Нажмите Создать. Клиент создан.

    Откроется диалоговое окно OAuth 2.0 client created (Клиент OAuth 2.0 создан).

  6. В разделе Client secrets (Секретные коды клиента) скопируйте Client secret (Секретный код клиента) и сохраните его в надежном месте. Скопировать его можно только один раз. Если вы потеряете секретный код, удалите его и создайте новый.

Как добавить MCP-сервер в ChatGPT в качестве приложения

  1. Войдите в ChatGPT.
  2. Включите режим разработчика.
  3. Откройте настройки приложений ChatGPT.
  4. Нажмите Создать приложение и создайте приложение для удаленного MCP-сервера.
  5. В разделе OAuth укажите идентификатор и секретный код клиента.
  6. Подтвердите, что вы понимаете риски, связанные с использованием MCP-сервера, и нажмите Создать.

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

Курсор

Чтобы добавить MCP-сервер Менеджера рекламы в Cursor, создайте идентификатор клиента и секретный код. Настройте MCP-сервер со статическим OAuth. В Cursor используются URI переадресации в зависимости от того, как вы получаете доступ к Cursor, например через веб- или настольное приложение.

  1. Создайте идентификатор и секретный код клиента OAuth 2.0:

    агентов Web или Cursor;

    1. В Google API Console перейдите в раздел Google Auth Platform (Платформа Google Auth) > Clients (Клиенты) > Create client (Создать клиента).

      Перейти к созданию клиента

      Если у вас не выбран проект, вам будет предложено создать его.

    2. В списке Тип приложения выберите Веб-приложение.

    3. В поле Название введите название приложения.

    4. В разделе Разрешенные URI перенаправления нажмите + Добавить URI и введите https://www.cursor.com/agents/mcp/oauth/callback в поле URI.

    5. Нажмите Создать. Клиент создан.

      Откроется диалоговое окно OAuth 2.0 client created (Клиент OAuth 2.0 создан).

    6. В разделе Client secrets (Секретные коды клиента) скопируйте Client secret (Секретный код клиента) и сохраните его в надежном месте. Скопировать его можно только один раз. Если вы потеряете секретный код, удалите его и создайте новый.

    Компьютеры

    1. В Google API Console выберите Google Auth Platform > Clients > Create client (Платформа аутентификации Google > Клиенты > Создать клиента).

      Перейти к созданию клиента

      Если у вас не выбран проект, вам будет предложено создать его.

    2. В списке Тип приложения выберите Веб-приложение.

    3. В поле Название введите название приложения.

    4. В разделе Разрешенные URI перенаправления нажмите + Добавить URI и введите http://localhost:8787/callback в поле URI.

    5. Нажмите Создать. Клиент создан.

      Откроется диалоговое окно OAuth 2.0 client created (Клиент OAuth 2.0 создан).

    6. В разделе Client secrets (Секретные коды клиента) скопируйте Client secret (Секретный код клиента) и сохраните его в надежном месте. Скопировать его можно только один раз. Если вы потеряете секретный код, удалите его и создайте новый.

  2. Следуйте инструкциям по настройке MCP-сервера со статическим OAuth.
  3. Используйте MCP-сервер в Chat.

Как протестировать MCP-сервер Менеджера рекламы

После того как вы настроите и выполните аутентификацию клиента MCP, вы можете проверить подключение, выполнив тестовые запросы в интерфейсе ИИ-чата.

Попробуйте задать ИИ-клиенту следующие вопросы:

  • "Перечисли сети Google Менеджера рекламы, к которым у меня есть доступ".

    Клиент вызывает list_networks, чтобы получить и показать коды сетей Менеджера рекламы и отображаемые названия, связанные с вашим аккаунтом пользователя.

  • "Найди информацию о коде сети NETWORK_CODE".

    Клиент использует get_network, чтобы получить метаданные для указанной сети.

  • Покажи первые пять заказов в сети NETWORK_CODE.

    Клиент вызывает функцию list_orders, чтобы запросить информацию о заказах в вашей сети и получить их сводку.

Если инструменты работают правильно и возвращают данные Google Менеджера рекламы, значит подключение к MCP-серверу настроено верно.