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

# Google explique MCP Toolbox Java SDK 1.0 pour les agents de bases de données

> Google a détaillé en octobre son MCP Toolbox Java SDK 1.0, après la publication du code en septembre. Le client ajoute des interfaces de transport et d’authentification, tandis que la fiche de version signale une modification incompatible et que le dépôt avertit que la parité des fonctionnalités est incomplète.

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.

Le client Java de Google pour MCP Toolbox for Databases a atteint la version 1.0.0 le 9 septembre. Dans une [annonce](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/)du 6 octobre, l’entreprise a détaillé les changements du transport, de l’authentification et des paramètres d’outil pour les équipes qui relient des applications Java à un serveur Toolbox exécuté séparément. La fiche de [version](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0) situe la publication du code près d’un mois avant cette annonce.

Cette distinction compte pour une équipe Java qui décide d’adopter ou non le client dès maintenant. Google présente la version 1.0 comme une base stable et rétrocompatible, mais la même fiche signale une modification incompatible : les paramètres liés sont supprimés de la définition d’outil exposée à un agent. Avant une mise à niveau, les intégrations existantes devraient vérifier leur utilisation de ces définitions. Le [dépôt](https://github.com/googleapis/mcp-toolbox-sdk-java) indique également que la prise en charge des fonctionnalités Java reste en cours et n’égale pas celle des SDK Python, JavaScript/TypeScript et Go.

## Le changement principal

Le client 1.0 fournit à une application Java une méthode définie pour découvrir et appeler les outils exposés par MCP Toolbox. Son nouveau `HttpMcpTransport` se trouve derrière une interface de transport, tandis que `CredentialsProvider` et `AuthMethods` séparent la résolution des identifiants du client. Google indique que les identifiants sont résolus de façon asynchrone pour chaque requête. La version ajoute aussi des valeurs de paramètres par défaut, des avertissements HTTP sur l’exposition d’identifiants, le choix de version, le suivi des sessions et une table pour les en-têtes de requête personnalisés. Ce sont des fonctionnalités documentées du SDK, pas des tests de performance ou de sécurité menés par BIG CHANGE.

Toolbox est un serveur distinct. Un opérateur le configure avec des sources de données et des outils ; le client Java se connecte à son URL, charge les définitions d’outil et envoie des appels. Une dépendance Java ne configure pas à elle seule une base de données, n’accorde pas d’autorisations et ne déploie pas ce serveur. La [documentation Java officielle](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/) décrit les rôles du client et du serveur, et le [dépôt du SDK](https://github.com/googleapis/mcp-toolbox-sdk-java) exige que le serveur soit lancé avant la configuration du client.

## Ce qu’une équipe Java peut évaluer

La procédure suivante s’appuie sur la documentation et le dépôt de Google. BIG CHANGE n’a ni exécuté le code ni connecté une base de données.

1. **Préparez un serveur Toolbox et une source de données distincts.** La [documentation de prise en main de Google](https://mcp-toolbox.dev/documentation/introduction/) couvre le serveur, les définitions d’outil et les intégrations prises en charge. Pour une première évaluation, choisissez un outil de base de données à portée limitée et en lecture seule, puis examinez les contrôles d’accès du serveur. Le dépôt du SDK indique Java 17 ou ultérieur comme environnement d’exécution de base.
2. **Figez la dépendance Java.** L’ [annonce de la version 1.0](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/) et le [dépôt](https://github.com/googleapis/mcp-toolbox-sdk-java) indiquent tous deux les coordonnées Maven `com.google.cloud.mcp:mcp-toolbox-sdk-java:1.0.0` ; le dépôt fournit également la forme Gradle. La documentation Java générale utilise encore un `VERSION` espace réservé ; l’artefact de la version publiée est donc la référence précise pour cette évaluation.
3. **Connectez-vous au serveur et inspectez un outil.** Pointez `McpToolboxClient` vers l’URL du serveur en cours d’exécution `/mcp` , puis utilisez `loadToolset`, `listTools` ou `loadTool` pour examiner les définitions publiées avant d’appeler un outil. Le dépôt montre un appel avec Java `Map` et un résultat textuel renvoyé. Une vérification réussie consiste à recevoir une réponse d’un outil nommé et configuré, pas seulement à créer un objet client sans erreur.
4. **Choisissez l’authentification avec soin.** L’annonce de la version 1.0 décrit `CredentialsProvider` et `AuthMethods` pour les identifiants du client, notamment un parcours Google Application Default Credentials pour OIDC. Elle décrit aussi les avertissements HTTP lorsque les identifiants risquent de transiter en clair. Un avertissement ne remplace ni un point de terminaison HTTPS ni une autorisation côté serveur. Les valeurs liées de paramètres sensibles doivent être examinées aux frontières du serveur et du client, en particulier lors d’une mise à niveau depuis une version préliminaire.

Le résultat recherché est une définition d’outil et une réponse conformes aux autorisations de base de données prévues pour l’agent. Si la découverte échoue, vérifiez d’abord l’URL du serveur, le nom de l’outil disponible et la configuration de l’authentification. Si l’appel échoue, comparez les paramètres requis par l’outil aux valeurs envoyées et consultez les journaux du serveur. Il s’agit de vérifications diagnostiques fondées sur la séparation documentée des composants, et non de l’affirmation qu’un déploiement particulier se rétablira automatiquement.

## Limites et coûts

L’ [application de transport de démonstration](https://github.com/googleapis/mcp-toolbox-sdk-java/tree/main/demo-applications/cymbal-transit) de Google montre Spring Boot et LangChain4j appelant des outils Toolbox reposant sur AlloyDB. L’article d’octobre précise que Cymbal Transit est fictif. Il illustre une conception d’intégration, pas une utilisation client mesurée ni un résultat de fiabilité.

Le dépôt du SDK Java est assorti d’une [licence Apache 2.0](https://github.com/googleapis/mcp-toolbox-sdk-java/blob/main/LICENSE). Celle-ci ne fixe pas le prix d’une base de données, d’un déploiement cloud, des appels de modèle ou du trafic réseau ; les équipes doivent chiffrer les services qu’elles choisissent réellement. Le dépôt qualifie d’expérimentale l’utilisation de GraalVM native-image et avertit que la prise en charge des fonctionnalités du SDK Java est incomplète par rapport aux autres clients Toolbox. Évaluez ces limites avec le framework et la source de données précis avant de considérer comme vérifiée pour un système de production l’affirmation de Google sur l’adéquation aux entreprises.

## Sources et lectures complémentaires

- [Annonce de Google Cloud, 6 octobre 2026](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/) : présentation par Google des fonctionnalités de v1.0 et de son exemple fictif de transport. L’adéquation à la production est une affirmation du fournisseur.
- [Sortie de Java SDK v1.0.0, 9 septembre 2026](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0) : date de sortie, fonctionnalités et modification incompatible signalée.
- [Dépôt du Java SDK](https://github.com/googleapis/mcp-toolbox-sdk-java) : coordonnées des dépendances, exigence Java, appels du client, licence et avertissement actuel sur la parité des fonctionnalités. Consulté le 12 octobre 2026.
- [Documentation officielle du Java SDK](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/) : prérequis du serveur et référence d’installation. La page a été modifiée pour la dernière fois le 25 septembre 2026 ; son espace réservé de version est moins précis que la fiche de la version 1.0.

## Sources

- [Google Cloud Blog : annonce de 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/) — Annonce ultérieure et explication de la sortie du 9 septembre. L’adéquation à la production est une affirmation de Google, non validée indépendamment.
- [Sortie de MCP Toolbox Java SDK v1.0.0](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0) — Date de publication du code et fonctionnalités faisant autorité, y compris la modification incompatible signalée.
- [Google APIs : dépôt source de MCP Toolbox Java SDK](https://github.com/googleapis/mcp-toolbox-sdk-java) — Source officielle de l’implémentation ; vérifiez les tags de version et les API actuels par rapport à v1.0.0 avant d’utiliser des exemples de code.
- [Documentation officielle de MCP Toolbox Java SDK](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/) — La référence générale officielle de configuration contient toujours l’espace réservé VERSION ; la version 1.0 épinglée et le dépôt sont plus précis.
