Что нужно для использования подключенных приложений

Чтобы начать работу, требуется следующее:

  • Развернутый MCP-сервер с защищенной конечной точкой HTTPS.

    Ваш MCP-сервер должен быть общедоступен по протоколу HTTPS с использованием транспорта Streamable HTTP (например, https://api.yourdomain.com/v1/mcp).

    Подробную информацию о реализации можно найти в руководстве для разработчиков по MCP-серверу Connected Apps Platform.

  • Убедитесь, что ваш сервер может получать запросы от Google

    Если ваш сервер ограничивает внешний доступ по IP-адресу источника, добавьте в белый список следующие IP-адреса:

    • 108.177.64.0/20
    • 142.250.88.0/22
    • 172.217.80.0/20
    • 192.178.20.0/22
    • 192.179.0.0/20
    • 74.125.232.0/24
    • 136.121.40.0/21

    Диапазоны исходящих IP-адресов Google могут со временем меняться, поэтому рекомендуем сверяться с опубликованными списками Google и регулярно обновлять белый список.

  • Доступ к зарегистрированному аккаунту разработчика в Google Connected Console.

    После входа убедитесь, что у вас есть одно из следующих разрешений для подключенных приложений в Google Connected Console:

    • Посмотреть подключенные приложения
    • Создание подключенных приложений и управление ими

    Условия использования подключенных приложений также должны быть приняты владельцем или администратором аккаунта. Когда ваша организация впервые получит доступ к связанным приложениям в Google Connected Console, владелец аккаунта или администратор должен войти в систему и принять соглашение программы, прежде чем приглашенные участники команды смогут продолжить.

    Если вы считаете, что у вас есть доступ, но не можете создавать подключенные приложения, попросите владельца аккаунта или администратора предоставить вашему аккаунту пользователя разрешение "Просмотр подключенных приложений" или "Создание подключенных приложений и управление ими" на странице Пользователи и разрешения.

  • Возможность разместить файл подтверждения .well-known в домене MCP-сервера.

    Чтобы подтвердить право собственности на домен, вы должны иметь возможность разместить файл JSON с токеном подтверждения непосредственно по адресу https://<your-domain>/.well-known/google-connected-apps (с кодом ответа HTTP 200 OK и без переадресации).

  • Доступные категории подключенных приложений

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

  • Развернутый MCP-сервер с действительным URL конечной точки.

    Подробную информацию можно найти в руководстве для разработчиков по MCP-серверу подключенных приложений.

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

    • Название подключенного приложения. Отображаемое название подключенного приложения, которое пользователи видят в продуктах Google и используют, когда упоминают ваше приложение с помощью @.
    • Описание. Краткое описание (не более 30 слов) того, что ваше приложение может делать для пользователей, например "Отслеживайте недавние покупки, проверяйте статус доставки и просматривайте историю заказов".
    • Значок. Значок приложения размером 512 x 512 пкс в формате JPEG или PNG. Максимальный размер файла – 1 МБ (1024 КБ).
    • Возможности. Укажите не менее трех важных задач, которые может выполнять ваше подключенное приложение, например "Поиск по истории заказов" или "Проверка статуса доставки". Они должны отличаться от возможностей по умолчанию, определенных категорией приложения. Эта информация поможет пользователям решить, подключать ли его. Не начинайте названия возможностей с цифр.
    • Примеры запросов. Не менее трех примеров запросов, которые помогут пользователям понять, что они могут спросить. Начните хотя бы два примера запросов с названия подключенного приложения. Упомяните название приложения хотя бы в одном запросе (не начинайте его с названия приложения). Не добавляйте цифры в начале примеров запросов.
    • URL условий использования. Общедоступный URL условий использования подключенного приложения.
    • URL политики конфиденциальности. Общедоступный URL политики конфиденциальности подключенного приложения.
    • URL сайта (необязательно). Сайт связанного приложения.