GoogleのMCP Toolbox for Databases向けJavaクライアントは、9月9日にバージョン1.0.0に達しました。10月6日の 発表では、別途稼働するToolboxサーバーにJavaアプリケーションを接続するチーム向けに、トランスポート、認証、ツールパラメーターの変更を詳しく説明しています。コードの リリース記録は、 その発表より約1カ月前にコードが公開されたとしています。
今すぐクライアントを採用するか判断するJavaチームにとって、この違いは重要です。Googleは1.0を安定した後方互換性のある基盤と説明していますが、同じリリース記録には互換性を損なう変更も記載されています。エージェントに公開するツール定義からバインド済みパラメーターが削除されます。既存の連携機能は、アップグレード前にそれらの定義の使い方を確認する必要があります。Googleの リポジトリも、 Javaの機能サポートは引き続き開発中で、Python、JavaScript/TypeScript、GoのSDKと同等ではないと述べています。
主な変更点
1.0クライアントにより、JavaアプリケーションはMCP Toolboxが公開するツールを定められた方法で検出して呼び出せます。新しい HttpMcpTransport はトランスポートインターフェースの背後にあり、 CredentialsProvider と AuthMethods は資格情報の解決をクライアントから分離します。Googleによると、資格情報はリクエストごとに非同期で解決されます。また、デフォルトのパラメーター値、資格情報の露出に関するHTTP警告、バージョン選択、セッション追跡、カスタムリクエストヘッダー用のマップも追加されました。これらはSDKで文書化された機能であり、BIG CHANGEの性能試験やセキュリティ試験ではありません。
Toolbox自体は独立したサーバーです。運用担当者がデータソースとツールを設定し、JavaクライアントはそのURLに接続してツール定義を読み込み、呼び出しを送信します。Javaの依存関係を追加しただけでは、データベースの設定、権限の付与、サーバーのデプロイは行われません。公式の Javaドキュメントは、 クライアントとサーバーの役割を説明し、 SDKリポジトリは、 クライアントを設定する前にサーバーが稼働していることを求めています。
Javaチームが評価できること
以下の手順はGoogleのドキュメントとリポジトリに基づいています。BIG CHANGEはコードを実行せず、データベースにも接続していません。
- Toolboxサーバーとデータソースを別々に用意します。 Googleの スタートガイド では、サーバー、ツール定義、サポート対象の連携機能を扱っています。最初の評価では、範囲を絞った読み取り専用のデータベースツールを選び、サーバーのアクセス制御を確認してください。SDKリポジトリはJava 17以降を基本ランタイムとして挙げています。
- Java依存関係のバージョンを固定します。 この 1.0リリースの発表 と リポジトリ には、どちらもMaven座標が記載されています。
com.google.cloud.mcp:mcp-toolbox-sdk-java:1.0.0リポジトリにはGradle形式もあります。一般的なJavaドキュメントでは今もVERSIONというプレースホルダーが使われているため、この評価ではリリース成果物が正確な参照先です。 - サーバーに接続してツールを確認します。 を
McpToolboxClient稼働中のサーバーURLに向け、次に/mcpを使ってloadToolset、listToolsまたはloadToolで公開済みの定義を確認してからツールを呼び出します。リポジトリにはJavaMapを使った呼び出しと、返されるテキスト結果の例があります。成功の確認とは、名前が付いて設定済みのツールから応答を受けることであり、エラーなくクライアントオブジェクトを作るだけではありません。 - 認証方式は慎重に選びます。 1.0の発表では、クライアント資格情報向けに
CredentialsProviderとAuthMethodsが説明されています。これにはOIDC向けのGoogle Application Default Credentialsの経路も含まれます。資格情報が平文で送られる場合のHTTP警告も説明されています。警告はHTTPSエンドポイントやサーバー側の認可の代わりにはなりません。特にプレリリース版からアップグレードする際は、機密パラメーターのバインド値をサーバーとクライアントの境界で確認してください。
確認すべき結果は、エージェントに意図したデータベース権限に合うツール定義と応答です。検出に失敗した場合は、まずサーバーURL、利用可能なツール名、認証設定を確認します。呼び出しに失敗した場合は、ツールが必要とするパラメーターと送信した値を比べ、サーバーログを調べます。これはコンポーネントの分離に関する文書に基づく診断確認であり、特定の導入環境が自動的に復旧するという主張ではありません。
制限とコスト
Googleの サンプル交通アプリケーションは、 AlloyDBを基盤とするToolboxツールをSpring BootとLangChain4jが呼び出す例を示します。10月の記事ではCymbal Transitは架空とされています。これは連携設計の例であり、測定された顧客利用や信頼性の結果ではありません。
Java SDKのリポジトリには Apache 2.0ライセンスが適用されます。これによってデータベース、クラウドへのデプロイ、モデル呼び出し、ネットワーク通信の料金が決まるわけではありません。チームは実際に選ぶサービスの費用を見積もる必要があります。リポジトリはGraalVM native-imageの利用を実験的とし、Java SDKの機能サポートは他のToolboxクライアントに比べて不完全だと警告しています。Googleのエンタープライズ適性に関する主張を本番システムで確認済みと扱う前に、具体的なフレームワークとデータソースに照らして制限を確認してください。
出典と参考資料
- Google Cloudの発表、2026年10月6日：v1.0の機能と架空の交通事例についてのGoogleの説明。本番環境への適性を示す表現はベンダーの主張です。
- Java SDK v1.0.0のリリース、2026年9月9日：リリース日、機能、記載された互換性を損なう変更。
- Java SDKリポジトリ：依存関係の座標、Java要件、クライアント呼び出し、ライセンス、現在の機能同等性に関する警告。2026年10月12日閲覧。
- Java SDK公式ドキュメント：サーバーの前提条件とインストール資料。ページの最終更新は2026年9月25日で、バージョンのプレースホルダーは1.0リリース記録ほど正確ではありません。
