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

# Google menjelaskan MCP Toolbox Java SDK 1.0 untuk agen basis data

> Google merinci MCP Toolbox Java SDK 1.0 pada Oktober setelah kode dirilis pada September. Klien ini menambahkan antarmuka transportasi dan autentikasi, sementara catatan rilis mencantumkan perubahan yang merusak kompatibilitas dan repositori memperingatkan bahwa kesetaraan fitur belum lengkap.

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.

Klien Java Google untuk MCP Toolbox for Databases mencapai versi 1.0.0 pada 9 September. Dalam [pengumuman](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/)tanggal 6 Oktober, perusahaan merinci perubahan transportasi, autentikasi, dan parameter alat bagi tim yang menghubungkan aplikasi Java ke server Toolbox yang berjalan terpisah. Catatan [rilis](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0) menyebut tanggal rilis kode hampir sebulan sebelum pengumuman itu.

Perbedaan ini penting bagi tim Java yang sedang memutuskan apakah akan mengadopsi klien sekarang. Google menyebut 1.0 sebagai fondasi stabil yang kompatibel dengan versi sebelumnya, tetapi catatan rilis yang sama mencantumkan perubahan yang merusak kompatibilitas: parameter terikat dihapus dari definisi alat yang ditampilkan kepada agen. Integrasi yang sudah ada sebaiknya memeriksa penggunaan definisi tersebut sebelum meningkatkan versi. Google [repo](https://github.com/googleapis/mcp-toolbox-sdk-java) juga menyebut dukungan fitur Java masih berjalan dan belum menyamai SDK Python, JavaScript/TypeScript, serta Go.

## Perubahan utama

Yang baru, `HttpMcpTransport` berada di balik antarmuka transportasi, sedangkan `CredentialsProvider` dan `AuthMethods` memisahkan resolusi kredensial dari klien. Google mengatakan kredensial diresolusikan secara asinkron untuk setiap permintaan. Rilis ini juga menambahkan nilai parameter bawaan, peringatan HTTP tentang paparan kredensial, pemilihan versi, pelacakan sesi, dan peta untuk header permintaan khusus. Semuanya merupakan fitur SDK yang didokumentasikan, bukan pengujian kinerja atau keamanan oleh BIG CHANGE.

Toolbox sendiri adalah server terpisah. Operator mengonfigurasinya dengan sumber data dan alat; klien Java terhubung ke URL-nya, memuat definisi alat, lalu mengirim pemanggilan. Dependensi Java saja tidak mengonfigurasi basis data, memberi izin, atau menerapkan server tersebut. [Dokumentasi Java resmi](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/) menjelaskan peran klien dan server itu, sedangkan [repositori SDK](https://github.com/googleapis/mcp-toolbox-sdk-java) mensyaratkan server sudah berjalan sebelum penyiapan klien.

## Hal yang dapat dievaluasi tim Java

Langkah berikut disusun dari dokumentasi dan repositori Google. BIG CHANGE tidak menjalankan kode atau menghubungkan basis data.

1. **Siapkan server Toolbox dan sumber data terpisah.** Dokumentasi [panduan memulai Google](https://mcp-toolbox.dev/documentation/introduction/) mencakup server, definisi alat, dan integrasi yang didukung. Untuk evaluasi pertama, pilih alat basis data yang sempit dan hanya-baca, lalu tinjau kontrol akses server. Repositori SDK mencantumkan Java 17 atau yang lebih baru sebagai runtime dasarnya.
2. **Tetapkan versi dependensi Java.** Pada [pengumuman rilis 1.0](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/) dan [repositori](https://github.com/googleapis/mcp-toolbox-sdk-java) keduanya menampilkan koordinat Maven `com.google.cloud.mcp:mcp-toolbox-sdk-java:1.0.0`; repositori juga memberikan format Gradle. Dokumentasi Java umum masih menggunakan penanda `VERSION` , sehingga artefak rilis menjadi rujukan yang tepat untuk evaluasi ini.
3. **Hubungkan ke server dan periksa alat.** Arahkan `McpToolboxClient` ke URL server yang sedang berjalan `/mcp` , lalu gunakan `loadToolset`, `listTools` atau `loadTool` untuk memeriksa definisi yang dipublikasikan sebelum memanggil alat. Repositori menunjukkan pemanggilan menggunakan Java `Map` dan hasil teks yang dikembalikan. Pemeriksaan berhasil jika ada respons dari alat bernama yang telah dikonfigurasi, bukan sekadar objek klien berhasil dibuat tanpa kesalahan.
4. **Pilih autentikasi dengan sengaja.** Pengumuman 1.0 menjelaskan `CredentialsProvider` dan `AuthMethods` untuk kredensial klien, termasuk jalur Google Application Default Credentials untuk OIDC. Pengumuman itu juga menguraikan peringatan HTTP ketika kredensial akan dikirim sebagai teks biasa. Peringatan bukan pengganti endpoint HTTPS atau otorisasi sisi server. Nilai terikat untuk parameter sensitif perlu ditinjau pada batas server dan klien, khususnya saat meningkatkan dari versi prarilis.

Hasil yang dicari adalah definisi alat dan respons yang sesuai dengan izin basis data yang dimaksudkan untuk agen. Jika penemuan gagal, pastikan dahulu URL server, nama alat yang tersedia, dan penyiapan autentikasi. Jika pemanggilan gagal, bandingkan parameter yang diwajibkan alat dengan nilai yang dikirim dan periksa log server. Ini adalah pemeriksaan diagnostik berdasarkan pemisahan komponen yang didokumentasikan, bukan klaim bahwa penerapan tertentu akan pulih secara otomatis.

## Batasan dan biaya

Aplikasi [contoh transit](https://github.com/googleapis/mcp-toolbox-sdk-java/tree/main/demo-applications/cymbal-transit) Google menunjukkan Spring Boot dan LangChain4j memanggil alat Toolbox yang didukung AlloyDB. Artikel Oktober menyebut Cymbal Transit sebagai fiksi. Contoh ini menunjukkan desain integrasi, bukan penggunaan pelanggan yang terukur atau hasil keandalan.

Repositori Java SDK menggunakan [lisensi Apache 2.0](https://github.com/googleapis/mcp-toolbox-sdk-java/blob/main/LICENSE). Itu tidak menetapkan harga basis data, penerapan cloud, panggilan model, atau lalu lintas jaringan; tim perlu menghitung layanan yang benar-benar mereka pilih. Repositori menandai penggunaan GraalVM native-image sebagai eksperimental dan memperingatkan bahwa dukungan fitur Java SDK belum lengkap dibandingkan klien Toolbox lainnya. Periksa batasan itu terhadap kerangka kerja dan sumber data yang tepat sebelum menganggap klaim kesesuaian perusahaan dari Google telah terbukti untuk sistem produksi.

## Sumber dan bacaan lanjutan

- [Pengumuman Google Cloud, 6 Oktober 2026](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/): penjelasan Google tentang fitur v1.0 dan contoh transit fiktifnya. Pernyataan kesesuaian produksi adalah klaim vendor.
- [Rilis Java SDK v1.0.0, 9 September 2026](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0): tanggal rilis, fitur, dan perubahan yang merusak kompatibilitas yang dicantumkan.
- [Repositori Java SDK](https://github.com/googleapis/mcp-toolbox-sdk-java): koordinat dependensi, persyaratan Java, pemanggilan klien, lisensi, dan peringatan terkini tentang kesetaraan fitur. Dibaca 12 Oktober 2026.
- [Dokumentasi resmi Java SDK](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/): prasyarat server dan rujukan instalasi. Halaman terakhir diubah 25 September 2026; penanda versinya kurang tepat dibanding catatan rilis 1.0.

## Sources

- [Google Cloud Blog: Pengumuman 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/) — Pengumuman lanjutan dan penjelasan rilis 9 September. Kesesuaian produksi adalah klaim Google, bukan hasil validasi independen.
- [Rilis MCP Toolbox Java SDK v1.0.0](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0) — Tanggal rilis kode dan fitur yang berwenang, termasuk perubahan yang merusak kompatibilitas.
- [Google APIs: repositori sumber MCP Toolbox Java SDK](https://github.com/googleapis/mcp-toolbox-sdk-java) — Sumber implementasi resmi; cocokkan tag rilis dan API terkini dengan v1.0.0 sebelum memakai contoh kode.
- [Dokumentasi resmi MCP Toolbox Java SDK](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/) — Rujukan penyiapan umum resmi masih memiliki penanda VERSION; rilis 1.0 yang dipatok dan repositori lebih tepat.