Java-клиент Google для MCP Toolbox for Databases достиг версии 1.0.0 9 сентября. В объявленииот 6 октября компания подробно описала изменения транспорта, аутентификации и параметров инструментов для команд, которые подключают Java-приложения к отдельно запущенному серверу Toolbox. Запись о выпуске датирует публикацию кода почти на месяц раньше этого объявления.

Это различие важно для Java-команды, решающей, стоит ли уже внедрять клиент. Google называет версию 1.0 стабильной основой с обратной совместимостью, но в той же записи о выпуске указано несовместимое изменение: связанные параметры удаляются из определения инструмента, показываемого агенту. Перед обновлением существующим интеграциям следует проверить, как они используют эти определения. В репозитории Google также говорится, что поддержка функций Java ещё развивается и не соответствует уровню SDK для Python, JavaScript/TypeScript и Go.

Главное изменение

Клиент 1.0 предоставляет Java-приложению определённый способ находить и вызывать инструменты, доступные через MCP Toolbox. Новый HttpMcpTransport работает за интерфейсом транспорта, а CredentialsProvider и AuthMethods отделяют разрешение учётных данных от клиента. По словам Google, учётные данные асинхронно разрешаются для каждого запроса. В выпуск также вошли значения параметров по умолчанию, предупреждения HTTP о раскрытии учётных данных, выбор версии, отслеживание сеансов и карта пользовательских заголовков запросов. Это документированные функции SDK, а не тесты производительности или безопасности BIG CHANGE.

Сам Toolbox — отдельный сервер. Оператор настраивает в нём источники данных и инструменты; Java-клиент подключается к его URL, загружает определения инструментов и отправляет вызовы. Одна лишь Java-зависимость не настраивает базу данных, не выдаёт разрешения и не развёртывает сервер. В официальной документации Java описаны роли клиента и сервера, а репозиторий SDK требует, чтобы сервер работал до настройки клиента.

Что может проверить Java-команда

Следующий порядок действий основан на документации и репозитории Google. BIG CHANGE не запускала код и не подключалась к базе данных.

  1. Подготовьте отдельный сервер Toolbox и источник данных. В руководстве Google для начала работы рассматриваются сервер, определения инструментов и поддерживаемые интеграции. Для первой оценки выберите узкий инструмент базы данных только для чтения и проверьте средства контроля доступа к серверу. В репозитории SDK в качестве базовой среды выполнения указана Java 17 или новее.
  2. Зафиксируйте версию Java-зависимости. И объявление о выпуске 1.0 , и репозиторий показывают координаты Maven com.google.cloud.mcp:mcp-toolbox-sdk-java:1.0.0; в репозитории также приведён вариант для Gradle. В общей документации Java по-прежнему используется VERSION заполнитель, поэтому для этой оценки точным источником служит артефакт выпуска.
  3. Подключитесь к серверу и проверьте инструмент. Укажите McpToolboxClient URL работающего сервера /mcp , затем используйте loadToolset, listTools или loadTool , чтобы проверить опубликованные определения перед вызовом инструмента. В репозитории показан вызов с помощью Java Map и возвращённый текстовый результат. Успешная проверка — это ответ от названного и настроенного инструмента, а не просто создание объекта клиента без ошибки.
  4. Обдуманно выберите способ аутентификации. В объявлении версии 1.0 описаны CredentialsProvider и AuthMethods для учётных данных клиента, включая путь Google Application Default Credentials для OIDC. Там также описаны предупреждения HTTP на случай передачи учётных данных в открытом виде. Предупреждение не заменяет HTTPS-адрес и авторизацию на стороне сервера. Связанные значения чувствительных параметров следует проверять на границе сервера и клиента, особенно при обновлении с предварительной сборки.

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

Ограничения и стоимость

В демонстрационном транспортном приложении Google показано, как Spring Boot и LangChain4j вызывают инструменты Toolbox на базе AlloyDB. В октябрьской статье Cymbal Transit назван вымышленным. Это пример архитектуры интеграции, а не измеренного использования клиентами или результата надёжности.

В репозитории Java SDK действует лицензия Apache 2.0. Она не устанавливает цену базы данных, облачного развёртывания, вызовов моделей или сетевого трафика; командам нужно оценить стоимость выбранных ими услуг. В репозитории использование GraalVM native-image отмечено как экспериментальное, а поддержка функций Java SDK названа неполной по сравнению с другими клиентами Toolbox. Сопоставьте эти ограничения с конкретной платформой и источником данных, прежде чем считать утверждение Google о пригодности для предприятий проверенным для промышленной системы.

Источники и дополнительная литература

  • Объявление Google Cloud, 6 октября 2026 года: описание Google функций v1.0 и вымышленного примера транспортной системы. Утверждение о пригодности для промышленной эксплуатации принадлежит поставщику.
  • Выпуск Java SDK v1.0.0, 9 сентября 2026 года: дата выпуска, функции и указанное несовместимое изменение.
  • Репозиторий Java SDK: координаты зависимостей, требование к Java, вызовы клиента, лицензия и актуальное предупреждение о равенстве функций. Просмотрено 12 октября 2026 года.
  • Официальная документация Java SDK: требование к серверу и справочник по установке. Страница в последний раз обновлялась 25 сентября 2026 года; её заполнитель версии менее точен, чем запись о выпуске 1.0.