Зарегистрируйте, протестируйте и опубликуйте подключенное приложение

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

Шаг 1. Создайте подключенное приложение

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

  1. Войдите в Google Connected Console.
  2. На главной странице нажмите Создать приложение.
  3. В диалоговом окне Выберите, что вы хотите создать:
    • Если вам будет предложено принять Условия использования подключенных приложений, нажмите Посмотреть условия, ознакомьтесь с соглашением и примите его, а затем выберите Создать. Принять соглашение может только администратор аккаунта.
    • В противном случае нажмите Создать на карточке Подключенное приложение.

  4. В диалоговом окне Укажите название подключенного приложения введите название приложения. Оно будет показываться пользователям продуктов Google. Оно также применяется для упоминаний через @. Нажмите Далее.

  5. В диалоговом окне Выберите категорию подключенного приложения выберите домен, категорию или отрасль приложения в меню Выберите категорию.

  6. В диалоговом окне Выберите тип подключения выберите один из следующих вариантов:

    • MCP-сервер. Подключите MCP-сервер, чтобы предоставлять свои сервисы пользователям Gemini и Поиска на Android, iOS и в веб-версии.
    • Android MCP. Предоставьте Gemini на Android доступ к локальным функциям, чтобы он мог выполнять действия и задачи для пользователей в вашем приложении.

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

  7. Выберите Create Connected app (Создать подключенное приложение).

Откроется обзорная страница управления подключенным приложением (Настройка и тестирование подключенного приложения), где можно настроить сведения о приложении, подключение к серверу MCP и список тестировщиков.

Шаг 2. Введите сведения о подключенном приложении

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

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

  4. Заполните следующие поля:

    • Описание. Введите краткое описание (не более 30 слов) основных функций подключенного приложения и его возможностей. Этот текст будет показываться пользователям, но не будет использоваться в качестве инструкций для модели.
    • Возможности. Укажите не менее трех важных задач, которые может выполнять подключенное приложение. Чтобы добавить другие записи, нажмите Добавить возможность. Не начинайте названия возможностей с цифр. В каждой записи указывайте только одну функцию. Если в категории есть стандартные возможности, они будут показаны вверху списка. Изменить их нельзя.
    • Примеры запросов. Укажите хотя бы три примера запросов, чтобы пользователи понимали, что можно спрашивать. Нажмите Добавить пример запроса.
      • Начните хотя бы два запроса с @<YourAppName> (например, @Order Tracker where is my last order?).
      • Упомяните <YourAppName> хотя бы в одном запросе, не начиная его с названия приложения (например, Track my recent order on Order Tracker).
      • Не используйте нумерацию (1., 2., 3.) и не заключайте запросы в кавычки ("...").

    • Многоязычная локализация. Чтобы добавить перевод для полей Description (Описание), Capabilities (Возможности) и Example prompts (Примеры запросов), заключите текст для каждого региона в языковые теги в поле ввода. Пример:

      <en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>

      Connected Console автоматически проверяет теги и показывает обнаруженные региональные настройки под каждым полем (например, Found translations for 2 languages: en-US, es-ES).

    • URL условий использования. Укажите действительную ссылку https:// или http:// на условия использования.

    • URL политики конфиденциальности. Укажите действительную ссылку на политику конфиденциальности, которая начинается с https:// или http://.

    • URL сайта (необязательно). Укажите ссылку на свой сайт для атрибуции.

  5. Нажмите Сохранить внизу страницы, чтобы вернуться на обзорную страницу.

Шаг 3. Укажите конечную точку MCP и подтвердите право собственности на домен

Чтобы Google мог подключиться к вашему MCP-серверу или синхронизировать инструменты, вы должны указать URL конечной точки MCP-сервера и подтвердить право собственности на домен, в котором он размещен.

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

  1. На обзорной странице подключенного приложения найдите карточку Настройка MCP и инструментов и нажмите Начать (или Управление, если вы обновляете существующие данные). Откроется шаг 1 (Конечные точки MCP-сервера) процесса настройки MCP.
  2. В разделе Подключите конечную точку MCP-сервера введите полный URL конечной точки MCP-сервера по протоколу HTTPS, например https://api.yourdomain.com/v1/mcp.

  3. В разделе Подтвердите домен подтвердите домен с помощью токена. Если вы уже подтвердили домен или его родительский домен в аккаунте разработчика, он будет автоматически показан как подтвержденный.

    1. На карточке Подтвердите право собственности на домен выберите Скачать токен. Браузер скачает файл с названием google-connected-apps.json, имеющий следующую структуру:

      {
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}

    2. Загрузите этот контент JSON и разместите его на своем сервере по адресу https://<your-domain>/.well-known/google-connected-apps.

      • Убедитесь, что конечная точка доступна по протоколу HTTPS, возвращает HTTP 200 OK напрямую без переадресации HTTP и содержит ваш токен в массиве verification_tokens.

    3. Вернитесь в Google Connected Console и выберите Подтвердить домен.

    4. После успешной проверки в строке Домен подтвержден с помощью токена вызова появится зеленая галочка и станет доступен раздел Учетные данные для доступа.

Шаг 4. Настройте учетные данные для доступа

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

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

  1. В разделе Укажите учетные данные для доступа (на шаге 1 страницы Настройка MCP и инструментов) выберите Начать (или Обновить учетные данные, чтобы изменить существующую конфигурацию).

  2. В разделе Требуется ли авторизация для доступа к вашему серверу? выберите один из следующих вариантов:

    • Нет. Выберите этот вариант, если ваш MCP-сервер общедоступен и не требует аутентификации, а затем нажмите Подтвердить.

    • Да. Выберите этот вариант, если для каких-либо инструментов, предоставляемых вашим MCP-сервером, требуется авторизация. Затем в разделе Выберите модель авторизации, которую использует ваш MCP-сервер выберите способ аутентификации:

      • Межмашинное взаимодействие (с использованием учетных данных клиента OAuth). Выберите этот вариант для аутентификации между сервисами (RFC 6749), когда Google напрямую взаимодействует с вашим MCP-сервером, используя общий идентификатор клиента и секретный код, без переадресации входа конечного пользователя.
        1. Укажите идентификатор клиента (обязательно) и секретный код клиента (необязательно).
        2. При необходимости укажите конечную точку авторизации и конечную точку токена, если ваш сервер не объявляет их с помощью /.well-known/oauth-authorization-server.
        3. Выберите Зарегистрировать клиента (или Обновить клиента).

      • Делегирование пользователем (код авторизации). Выберите этот вариант, если MCP-серверу требуется, чтобы отдельные пользователи входили в систему и разрешали действия в личных аккаунтах через связывание аккаунтов Google.

        1. Добавьте в белый список URI перенаправления OAuth от Google. На баннере Убедитесь, что вы добавили в белый список предоставленные URI перенаправления нажмите Посмотреть (или выберите значок копирования), чтобы проверить URI перенаправления, созданные для вашего подключенного приложения. Добавьте их в белый список сервера OAuth, а затем вернитесь в Google Connected Console.
        2. В разделе Выберите способ аутентификации Google на сервере OAuth укажите, как зарегистрирован ваш клиент OAuth:
          • Предварительно зарегистрированный. Выберите этот вариант, если вы генерируете статический идентификатор клиента и секретный код клиента (необязательно) в поставщике OAuth. Вы также можете указать собственную конечную точку авторизации и собственную конечную точку токена.
          • Метаданные идентификатора клиента или Dynamic Client Registration (рекомендуется). Выберите этот вариант, если ваш сервер поддерживает Client ID Metadata Documents (CIMD) или Dynamic Client Registration (RFC 7591). Google сначала проверяет CIMD, а затем возвращается к DCR, используя конечные точки обнаружения .well-known. Вы также можете указать собственные конечные точки авторизации и токена.

        3. В разделе Аутентификация с помощью учетных данных разработчика выберите модель авторизации "Делегирование пользователем". Чтобы Google мог получить инструменты, вам нужно войти на сервер. Выберите один из двух вариантов:

          • Аутентификация во всплывающем окне (рекомендуется). Аутентификация будет проходить во всплывающем окне. Это вариант по умолчанию.
          • Аутентификация с помощью переадресации (резервный вариант). Аутентификация будет проходить в полноэкранном режиме в той же вкладке или окне. Используйте этот вариант, если диалоговое окно не появляется из-за ограничений отображения или заголовков безопасности (например, X-Frame-Options или Content-Security-Policy).

          Рекомендуем сначала попробовать выполнить аутентификацию с помощью диалогового окна. Если вы не можете выполнить аутентификацию с помощью диалогового окна, используйте метод перенаправления. От выбранного варианта также зависит, как будет выглядеть вход в систему для пользователей, которые впервые запускают подключенное приложение.

        4. Выберите Зарегистрировать клиента (или Обновить клиента).

Шаг 5. Укажите сведения о тестовом аккаунте (только для авторизации с делегированием доступа)

Если для подключенного приложения требуется аутентификация, вы должны предоставить представителю Google тестовые учетные данные, предварительно заполненные реалистичными примерами данных и с отключенной двухфакторной аутентификацией (2FA), а также инструкции по тестированию. Это позволит команде Google по проверке и контролю качества убедиться в работоспособности инструмента, не сталкиваясь с пустыми тестовыми средами, платным доступом или двухфакторной аутентификацией. Если у нас не получится полностью проверить ваше подключенное приложение, оно может быть отклонено.

Шаг 6. Синхронизируйте инструменты

Чтобы создать каждую версию подключенного приложения, Google синхронизируется с предоставленной вами конечной точкой, чтобы получить доступные инструменты и сделать снимок. Это инструменты, которые будут доступны пользователям в этой версии. Пока предварительная версия подключенного приложения доступна тестировщикам, вы можете вносить изменения на сервере и повторно синхронизировать инструменты для обновления. Это создаст новый снимок ваших инструментов.

При публикации для этой версии подключенного приложения используется самый последний снимок инструментов. Вы больше не сможете вносить изменения в инструменты, описания или сведения о сервере. Чтобы обновить инструменты или синхронизировать изменения с сервера, создайте новую версию подключенного приложения. Рекомендуем создавать новую конечную точку для каждой версии подключенного приложения.

Чтобы синхронизировать инструменты:

  1. В разделе Инструменты синхронизации:

    1. Выберите Инструменты синхронизации.
    2. Если вам будет предложено войти, выполните аутентификацию с помощью аккаунта разработчика, у которого есть разрешения на перечисление всех инструментов, которые вы хотите предоставить пользователям. Инструменты, к которым у вашего аккаунта нет доступа, не синхронизируются.
    3. После подключения в Connected Console появится количество синхронизированных инструментов и кнопка Синхронизировать инструменты заново.

  2. Нажмите Далее внизу страницы, чтобы перейти к шагу 2 настройки MCP и инструментов.

Шаг 7. Определите, как и где пользователи будут взаимодействовать с вашим приложением

В разделе Инструменты на странице Настройка MCP и инструментов задайте основные параметры, например регионы и языки, для которых доступно ваше подключенное приложение, а также продукты Google, в которых оно будет доступно.

  1. В разделе Доступность рядом с пунктом Сделать версию доступной в настройте следующие параметры таргетинга:
    • Страны/регионы. Выберите географические местоположения, в которых должно быть доступно ваше подключенное приложение.
    • Языки. Выберите языки, которые поддерживает ваше подключенное приложение.
    • Продукты. Выберите продукты Google, в которых будет доступно ваше подключенное приложение.

  2. В разделе Инструменты после раздела Доступность проверьте инструменты, синхронизированные с MCP-сервера. Выберите любой инструмент в списке Инструменты, чтобы настроить его параметры на панели Управление инструментом справа.

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

    • Дополнительный контекст. Укажите, нужны ли вашему инструменту контекстные сигналы от Google для работы.

      • Региональные настройки. Региональные настройки, определенные по аккаунту Google пользователя.
      • Приблизительное местоположение. Местоположение пользователя или устройства в пределах области площадью три квадратных километра или более (например, город, в котором находится пользователь).
      • Точное местоположение. Местоположение пользователя или устройства в пределах области радиусом 50 метров или меньше.

    • Подтверждение пользователя. Выберите Требуется подтверждение пользователя, чтобы перед выполнением инструмента требовалось явное подтверждение пользователя (этот вариант выбирается автоматически, если в аннотациях MCP вашего инструмента указано destructiveHint: true).

  3. Если ваш MCP-сервер предоставляет ресурсы пользовательского интерфейса, перейдите на вкладку Ресурсы пользовательского интерфейса рядом с вкладкой Инструменты, чтобы проверить ресурсы пользовательского интерфейса сервера (text/html, text/html;profile=mcp-app, text/javascript, text/css), убедиться, какие инструменты связаны с каждым ресурсом, и проверить Content Security Policy (CSP) connectDomains и resourceDomains.

  4. Нажмите Сохранить внизу страницы.

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

Шаг 8. Протестируйте подключенное приложение

Чтобы подключенное приложение стало доступно тестировщикам, добавьте их на экране "Управление тестировщиками". Только пользователи из списка тестировщиков могут видеть ваше неопубликованное подключенное приложение и взаимодействовать с ним. В список можно добавлять только пользователей с аккаунтом @gmail.com.

  1. На обзорной странице подключенного приложения найдите карточку Протестируйте приложение и нажмите Добавить тестировщиков (или Управление тестировщиками, если вы уже добавили пользователей).

  2. На экране Управление тестировщиками выберите существующие списки рассылки или нажмите Создать список рассылки, чтобы добавить аккаунты Google, авторизованные для тестирования интеграции. Если вы планируете сами участвовать в тестировании, укажите свой адрес электронной почты.

  3. Нажмите Сохранить.

  4. Тестировщики в приложении Gemini могут вызвать ваше подключенное приложение, введя @ и название приложения, а затем выбрав его в меню. Вы также можете посмотреть и подключить приложение в Gemini, выбрав Настройки и справка → Подключенные приложения на панели навигации слева.

  5. Рекомендуем тщательно протестировать интеграцию:

    • Попробуйте все примеры запросов.
    • Протестируйте явные вызовы @<AppName> и запросы на естественном языке.
    • Проверьте сквозной процесс аутентификации, выполнение инструмента, запросы на подтверждение пользователя и все ресурсы пользовательского интерфейса.

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

Шаг 9. Отправьте подключенное приложение на проверку и опубликуйте его после одобрения

Прежде чем ваше подключенное приложение станет доступно всем пользователям, Google проверит и протестирует интеграцию.

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

  1. На обзорной странице подключенного приложения найдите карточку Выпуски справа и нажмите Отправить на проверку. Эта кнопка станет активна, когда вы завершите настройку приложения и в предварительной версии не будет проблем, блокирующих публикацию.

  2. Пока ваша версия находится на рассмотрении:

    • Connected Console автоматически создаст новую редактируемую черновую версию, чтобы тестировщики могли продолжить проверку приложения, а вы – подготовить будущие изменения, не прерывая ее.
    • Блокирует любые изменения в проверяемой версии.
    • Чтобы посмотреть сведения о версии, которая находится на проверке, или отменить проверку, нажмите кнопку дополнительных параметров (⋮) на карточке На проверке и выберите Посмотреть сведения о приложении или Отменить проверку.

  3. Когда проверка будет завершена, вы получите уведомление, а карточка Выпуски обновится.

    • Если проблемы обнаружены, на карточке Выпуски появится сообщение Обнаружены проблемы. Нажмите Посмотреть проблемы, чтобы узнать, что именно было обнаружено. Обновите конфигурацию или MCP-сервер в редактируемой предварительной версии, проверьте исправления с помощью тестировщиков и снова нажмите Отправить на проверку.
    • Если заявка одобрена, на карточке Выпуски появится статус Готово к публикации. Когда вы будете готовы выпустить подключенное приложение, нажмите Опубликовать.

Поздравляем! Подключенное приложение опубликовано и становится доступно пользователям в выбранных продуктах Google.

Управление версиями после публикации

После публикации в нижней карточке в разделе Выпуски появится статус Опубликовано, а также номер активной версии подключенного приложения, дата публикации и количество целевых стран/регионов, языков и продуктов. Чтобы посмотреть конфигурацию опубликованного выпуска, нажмите на значок меню (⋮) на карточке Опубликовано и выберите Посмотреть сведения о приложении.

Пока рабочая версия приложения опубликована, вы можете использовать панель Изменение и тестирование подключенного приложения слева (или нажать Создать новую версию, если черновика нет), чтобы настроить, протестировать и посмотреть новую версию (Version <N+1>) перед отправкой на проверку и публикацией.