AI-translated from English; not yet reviewed by a fluent editor.

# Google рассказывает о MCP Toolbox Java SDK 1.0 для агентов баз данных

> В октябре Google подробно рассказала о своём MCP Toolbox Java SDK 1.0 после публикации кода в сентябре. Клиент получил интерфейсы транспорта и аутентификации; в записи о выпуске указано несовместимое изменение, а репозиторий предупреждает о неполном равенстве функций.

By BIG CHANGE Editorial

Published: 2026-10-12T18:00:12.162Z
Updated: 2026-10-12T18:00:12.162Z
Canonical: https://bigchange.ai/blog/google-mcp-toolbox-java-sdk-v1-stable-interfaces

![Conceptual charcoal illustration of an orange network cable plugged into a generic server-rack patch panel.](https://bigchange.ai/api/media/file/mcp-toolbox-java-patch-bay-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE. No MCP Toolbox product interface, database transaction or tested integration is depicted.

Java-клиент Google для MCP Toolbox for Databases достиг версии 1.0.0 9 сентября. В [объявлении](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/)от 6 октября компания подробно описала изменения транспорта, аутентификации и параметров инструментов для команд, которые подключают Java-приложения к отдельно запущенному серверу Toolbox. Запись о [выпуске](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0) датирует публикацию кода почти на месяц раньше этого объявления.

Это различие важно для Java-команды, решающей, стоит ли уже внедрять клиент. Google называет версию 1.0 стабильной основой с обратной совместимостью, но в той же записи о выпуске указано несовместимое изменение: связанные параметры удаляются из определения инструмента, показываемого агенту. Перед обновлением существующим интеграциям следует проверить, как они используют эти определения. В [репозитории Google](https://github.com/googleapis/mcp-toolbox-sdk-java) также говорится, что поддержка функций Java ещё развивается и не соответствует уровню SDK для Python, JavaScript/TypeScript и Go.

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

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

Сам Toolbox — отдельный сервер. Оператор настраивает в нём источники данных и инструменты; Java-клиент подключается к его URL, загружает определения инструментов и отправляет вызовы. Одна лишь Java-зависимость не настраивает базу данных, не выдаёт разрешения и не развёртывает сервер. В [официальной документации Java](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/) описаны роли клиента и сервера, а [репозиторий SDK](https://github.com/googleapis/mcp-toolbox-sdk-java) требует, чтобы сервер работал до настройки клиента.

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

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

1. **Подготовьте отдельный сервер Toolbox и источник данных.** В [руководстве Google для начала работы](https://mcp-toolbox.dev/documentation/introduction/) рассматриваются сервер, определения инструментов и поддерживаемые интеграции. Для первой оценки выберите узкий инструмент базы данных только для чтения и проверьте средства контроля доступа к серверу. В репозитории SDK в качестве базовой среды выполнения указана Java 17 или новее.
2. **Зафиксируйте версию Java-зависимости.** И [объявление о выпуске 1.0](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/) , и [репозиторий](https://github.com/googleapis/mcp-toolbox-sdk-java) показывают координаты 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 сервера, имя доступного инструмента и настройку аутентификации. Если не работает вызов, сравните обязательные параметры инструмента с отправленными значениями и изучите журналы сервера. Это диагностические проверки, основанные на документированном разделении компонентов, а не утверждение, что конкретное развёртывание восстановится автоматически.

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

В [демонстрационном транспортном приложении](https://github.com/googleapis/mcp-toolbox-sdk-java/tree/main/demo-applications/cymbal-transit) Google показано, как Spring Boot и LangChain4j вызывают инструменты Toolbox на базе AlloyDB. В октябрьской статье Cymbal Transit назван вымышленным. Это пример архитектуры интеграции, а не измеренного использования клиентами или результата надёжности.

В репозитории Java SDK действует [лицензия Apache 2.0](https://github.com/googleapis/mcp-toolbox-sdk-java/blob/main/LICENSE). Она не устанавливает цену базы данных, облачного развёртывания, вызовов моделей или сетевого трафика; командам нужно оценить стоимость выбранных ими услуг. В репозитории использование GraalVM native-image отмечено как экспериментальное, а поддержка функций Java SDK названа неполной по сравнению с другими клиентами Toolbox. Сопоставьте эти ограничения с конкретной платформой и источником данных, прежде чем считать утверждение Google о пригодности для предприятий проверенным для промышленной системы.

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

- [Объявление Google Cloud, 6 октября 2026 года](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/): описание Google функций v1.0 и вымышленного примера транспортной системы. Утверждение о пригодности для промышленной эксплуатации принадлежит поставщику.
- [Выпуск Java SDK v1.0.0, 9 сентября 2026 года](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0): дата выпуска, функции и указанное несовместимое изменение.
- [Репозиторий Java SDK](https://github.com/googleapis/mcp-toolbox-sdk-java): координаты зависимостей, требование к Java, вызовы клиента, лицензия и актуальное предупреждение о равенстве функций. Просмотрено 12 октября 2026 года.
- [Официальная документация Java SDK](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/): требование к серверу и справочник по установке. Страница в последний раз обновлялась 25 сентября 2026 года; её заполнитель версии менее точен, чем запись о выпуске 1.0.

## Sources

- [Google Cloud Blog: объявление MCP Toolbox Java SDK v1.0](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/) — Более позднее объявление и пояснение выпуска от 9 сентября. Пригодность для промышленной эксплуатации — заявление Google, не проверенное независимо.
- [Выпуск MCP Toolbox Java SDK v1.0.0](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0) — Авторитетные дата публикации кода и сведения о функциях, включая указанное несовместимое изменение.
- [Google APIs: репозиторий исходного кода MCP Toolbox Java SDK](https://github.com/googleapis/mcp-toolbox-sdk-java) — Официальный источник реализации; перед использованием примеров кода сверьте текущие теги выпусков и API с v1.0.0.
- [Официальная документация MCP Toolbox Java SDK](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/) — В общей официальной инструкции по настройке по-прежнему есть заполнитель VERSION; закреплённый выпуск 1.0 и репозиторий точнее.