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

Как тестировать, отлаживать и оценивать приложения в режиме разработчика приложений Gemini

Режим разработчика в приложениях Gemini позволяет тестировать сервер Model Context Protocol (MCP), диагностировать ошибки схемы и выполнения, а также оценивать качество инструментов перед отправкой подключенного приложения на проверку в Google Connected Console.

В этом руководстве рассматриваются следующие задачи:

Включите режим разработчика приложений Gemini в Gemini, создайте пользовательское приложение MCP и проверьте, как работает обнаружение инструментов.
Отлаживайте неудачные вызовы инструментов, синхронизируйте обновленные схемы и тестируйте аутентификацию.
Имитируйте контекст среды пользователя и настраивайте аутентификацию клиента.

Чтобы узнать больше о макете рабочей области и вкладках инспектора, ознакомьтесь с обзором режима разработчика приложений Gemini.

Включить режим разработчика приложений Gemini

Если вы добавляете MCP-сервер в Google Connected Console, зарегистрированное приложение уже будет доступно, когда вы включите режим разработчика приложений Gemini. В этом случае шаг 2 можно пропустить. Если вы хотите протестировать развернутую конечную точку HTTPS MCP-сервера непосредственно в Gemini, прежде чем регистрировать ее в консоли, выполните оба шага, чтобы включить режим разработчика приложений Gemini и подключить сервер как пользовательское MCP-приложение.

Шаг 1. Включите режим разработчика в приложениях Gemini

Откройте Gemini в браузере.
Нажмите Настройки > Режим разработчика приложений Gemini или перейдите на страницу gemini.google.com/devmode.

Шаг 2 (необязательно). Создайте и протестируйте собственное MCP-приложение

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

В диалоговом окне Выберите приложение нажмите + Создать.
В диалоговом окне Подключиться к MCP-серверу в поле URL MCP-сервера введите общедоступную конечную точку HTTPS сервера. Убедитесь, что URL начинается с https://, например https://your-app-link.com/mcp.
Если серверу требуются предварительно зарегистрированные учетные данные OAuth, нажмите Дополнительные настройки > Показать больше, введите идентификатор клиента и секретный код клиента OAuth, а затем нажмите Далее.
В диалоговом окне подтверждения безопасности и конфиденциальности проверьте, как Gemini взаимодействует с вашим MCP-сервером:
- Выполнение инструментов. Gemini использует инструменты MCP-сервера, чтобы запускать и выполнять доступные функции для обработки ваших запросов.
- Получение и передача данных. Gemini получает ресурсы, схемы и контекст, предоставляемые конечными точками MCP-сервера, и управляет ими. Он также может делиться информацией, к которой у него есть доступ, в соответствии с настройками вашего аккаунта Google или при взаимодействии с другими подключенными приложениями.
- Доверие и отключение. Убедитесь, что вы доверяете MCP-серверу, и ознакомьтесь с его политикой конфиденциальности, прежде чем продолжить. Вы можете в любой момент отключить сервер на странице "Подключенные приложения" или удалить его связь с аккаунтом Google.
Установите флажок Я понимаю и принимаю риски для безопасности и конфиденциальности, связанные с подключением этого пользовательского приложения и нажмите Подключить.
В диалоговом окне Сохранение пользовательского приложения введите отображаемое название приложения, убедитесь, что инструменты сервера указаны в списке Доступные действия, и нажмите Подключить.
На боковой панели режима разработчика приложений Gemini выберите вкладку Схемы инструментов, чтобы посмотреть информацию о каждом инструменте в подключенном приложении, включая определения параметров, значки безопасности (Только чтение, Деструктивное действие, Требуется аутентификация), Необработанная схема и Структура ответа.
На панели чата слева введите запрос на естественном языке или @mention (например, @MyApp show my profile) и следите за вкладкой Журнал событий, чтобы увидеть, как работает инструмент.

Отладка вызовов инструментов

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

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

На панели справа выберите вкладку Журнал событий.
Нажмите на событие с ошибкой в списке Телеметрия, чтобы развернуть его и посмотреть полезную нагрузку запроса Tool call и ответ Tool result.
- Ошибки подключения и сети. Проверьте сообщения об ошибках и задержку, чтобы убедиться, что конечная точка доступна.
- Ошибки аутентификации. Если событие возвращает 401 или 403, проверьте состояние токена OAuth или учетные данные клиента на вкладке Аутентификация.
- Несоответствия при проверке схемы. Если сервер возвращает ошибку недопустимых параметров MCP (-32602), сравните сгенерированные моделью аргументы JSON в Tool call с типами параметров, обязательными свойствами и инструкциями по форматированию на вкладке Схемы инструментов.
- Исключения времени выполнения сервера. Чтобы диагностировать исключения серверной части, проверьте код ошибки JSON-RPC и сообщение в Tool result.
Чтобы устранить проблему, обновите реализацию MCP-сервера или уточните описания инструментов и параметров. Рекомендации по созданию понятных схем инструментов и ответов об ошибках можно найти в стандартах интеграции подключенных приложений MCP.
На вкладке Схемы инструментов нажмите Синхронизировать схему. Gemini повторно получает tools/list от вашего MCP-сервера и обновляет определения активных инструментов, сохраняя текущую цепочку чата.
Повторите запрос. На вкладке Журнал событий убедитесь, что повторный вызов инструмента возвращает 200 OK и в окне предварительного просмотра чата отображается ожидаемый ответ.

Как смоделировать контекст среды и аутентификацию

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

Переопределить контекст среды

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

На панели справа выберите вкладку Environment (Среда).
В разделе Дата и время выберите Имитируемая дата и Имитируемое время, чтобы протестировать относительные временные выражения (например, "завтра утром" или "в эту субботу днем").
В разделе Настройки выберите Язык, чтобы имитировать региональные настройки пользователя (например, en-US).
Выполните тестовый запрос на панели чата, чтобы оценить работу инструмента в смоделированном контексте.
Чтобы восстановить настройки среды по умолчанию, нажмите Сбросить.

Настройте аутентификацию клиента

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

На панели справа выберите вкладку Authentication (Аутентификация).
В разделе Client Authentication Configuration (Конфигурация аутентификации клиента) выберите один из следующих режимов аутентификации:
- Dynamic Client Registration. Использует поток OAuth для автоматического согласования учетных данных с вашим сервером авторизации. Дополнительную информацию можно найти в руководстве по внедрению OAuth 2.1. При необходимости введите конечную точку в поле Добавьте ссылку на пользовательское приложение.
- Регистрация клиента вручную. Позволяет вручную указать предварительно зарегистрированный идентификатор и секретный код клиента. Разверните раздел Расширенные настройки, чтобы задать дополнительные переопределения.
Нажмите Сохранить и дождитесь появления сообщения Сохранено. Затем выполните тестовый запрос, чтобы убедиться, что аутентифицированные инструменты работают.