Menghubungkan GWC Bridge secara manual ke Gemini

Hubungkan GWC Bridge ke Gemini agar Gemini dapat bekerja dengan file dan perintah yang Anda izinkan di PC Anda sendiri.

Catatan label antarmuka: Label dalam tanda kutip mengikuti dokumentasi berbahasa Inggris Google saat ini. Antarmuka Anda dapat berbeda seiring Google meluncurkan fitur. GWC Bridge memungkinkan Gemini bekerja dengan file dan perintah yang diizinkan di PC Anda sendiri, tempat GWC for VS Code atau GWC Studio berjalan. Menambahkan server MCP kustom tidak berarti Google telah meninjau atau mendukung GWC Bridge.

1. Siapa yang dapat menggunakan jalur ini

Gemini: Administrator dapat menambahkan penyimpanan data Custom MCP Server setelah kebijakan organisasi terkelola pada proyek mengizinkan konektor MCP kustom. Google mewajibkan peran Discovery Engine Editor bagi administrator yang membuat penyimpanan data tersebut, dan perubahan kebijakan trafik keluar (egress) atau sumber data tambahan dapat berlaku saat VPC Service Controls atau penegakan kebijakan terkelola diaktifkan.^[1]^[2]

Gemini CLI: GWC Bridge belum mendukung jalur ini. Jangan konfigurasikan klien OAuth Gemini CLI statis.

Aplikasi kustom Gemini konsumen: Saat ini Google membatasi aplikasi kustom hanya untuk pengguna yang memenuhi syarat: berusia 18 tahun ke atas, berada di AS, masuk dengan Akun Google pribadi, Keep Activity (Simpan Aktivitas) aktif, dan menggunakan bahasa Inggris untuk fitur ini. Penyiapan dimulai di aplikasi web Gemini.^[4] GWC Bridge belum diaktifkan untuk alur konsumen ini. Google mendokumentasikan pengisian kredensial di bawah “Advanced features” (Fitur lanjutan) saat server tidak mendukung Pendaftaran Klien Dinamis (Dynamic Client Registration), tetapi halaman bantuan saat ini tidak memublikasikan URI callback yang harus dimasukkan GWC ke daftar izin. GWC tidak akan menebaknya atau menerima pengalihan wildcard.

2. Sebelum memulai

Siapkan akun GWC Anda, Connect Pass yang aktif, serta GWC for VS Code atau GWC Studio yang berjalan dan terhubung di PC yang ingin Anda gunakan bersama Gemini.
Masuk ke akun GWC yang sama saat jendela OAuth terbuka. Menambahkan URL MCP tidak menginstal atau menjalankan komponen PC.
Tinjau izin file, folder, dan perintah yang dibuka oleh PC tersebut. Mulailah dengan akses terkecil yang Anda perlukan.
GWC Bridge tetap menegakkan kebijakan akun, pemberian akses (grant), folder, sumber daya, persetujuan, dan perintahnya sendiri. Gemini tidak dapat memberikan dirinya akses yang ditolak oleh GWC.

3. Alamat server dan OAuth

Gunakan alamat server MCP ini:

https://mcp.gwc-corp.com/mcp

Endpoint OAuth GWC adalah:

Authorization URL: https://api.gwc-corp.com/oauth/authorize
Token URL:         https://api.gwc-corp.com/oauth/token
Issuer:            https://api.gwc-corp.com

Jalur Gemini yang didukung menggunakan Authorization Code dengan PKCE S256. ID klien statisnya adalah pengenal publik yang terikat ke callback terhosting Google yang persis. GWC Bridge saat ini tidak mendaftarkan klien OAuth Gemini CLI.

4. Penyiapan admin Gemini

Google memperlakukan konfigurasi Custom MCP Server sebagai operasi administrator di tingkat organisasi.^[1]

Di Google Cloud, pilih proyek yang memiliki aplikasi Gemini.
Buka Organization Policies (Kebijakan Organisasi) dan temukan Disable custom MCP server connector for Gemini Enterprise (constraints/discoveryengine.managed.disableCustomMcpServerConnector). Timpa kebijakan induk untuk proyek ini dan atur penegakannya ke Off (Nonaktif). Jangan menonaktifkan kebijakan ini untuk cakupan organisasi yang lebih luas kecuali hal tersebut merupakan keputusan tata kelola yang disengaja oleh organisasi Anda.^[2]
Jika proyek Anda dilindungi oleh VPC Service Controls, atau kebijakan konektor terkelola terkait diterapkan pada proyek ini, izinkan custom_mcp sebagai sumber data dan izinkan trafik keluar (egress) ke mcp.gwc-corp.com serta api.gwc-corp.com.^[1]^[5]
Berikan peran Discovery Engine Editor (roles/discoveryengine.editor) yang diperlukan kepada administrator yang membuat penyimpanan data.^[1]
Buka Gemini Enterprise → Data stores (Penyimpanan data) → Create data store (Buat penyimpanan data) → Custom MCP Server → Add MCP server (Tambahkan server MCP).
Pilih OAuth 2.0 lalu masukkan:

Kolom	Nilai
MCP Server URL	`https://mcp.gwc-corp.com/mcp`
Authorization URL	`https://api.gwc-corp.com/oauth/authorize`
Authorization URL Parameters	Biarkan kosong (Leave blank)
Token URL	`https://api.gwc-corp.com/oauth/token`
Client ID	`gwc-google-gemini-v1`
Client Secret	`none`
Scopes	`files:read files:write commands:run`
Enable PKCE Support	On
Use HTTP Basic	Off

Contoh Cloud Google saat ini untuk aplikasi MCP Gemini juga menampilkan PKCE diaktifkan dan HTTP Basic tidak dicentang.^[7]

Pengalihan yang didokumentasikan Google untuk konektor ini adalah persis https://vertexaisearch.cloud.google.com/oauth-redirect; profil klien GWC hanya menerima URI tersebut dan tidak menerima jalur sejajar, host alternatif, atau wildcard.^[1] Nilai none bukanlah rahasia bersama. Petunjuk Looker MCP milik Google sendiri menggunakan nilai literal tersebut ketika formulir mewajibkan kolom Client Secret diisi untuk klien publik PKCE.^[6]

Klik Verify Auth (Verifikasi Autentikasi), masuk ke GWC, tinjau izin GWC yang diminta, dan setujui hanya jika akun serta tujuannya benar.
Selesaikan pembuatan penyimpanan data. Tunggu hingga statusnya menjadi Active (Aktif).
Buka tampilan Actions (Tindakan) pada penyimpanan data, muat ulang tindakan kustom jika diperlukan, dan aktifkan hanya alat GWC Bridge yang ingin Anda gunakan bersama Gemini. Google menonaktifkan tindakan MCP kustom secara bawaan.^[1]
Hubungkan penyimpanan data ke aplikasi Gemini yang dimaksud, lalu jalankan pemeriksaan awal hanya-baca: Use GWC Bridge to show which of my computers and shared folders are available. Do not change files or run commands.

5. Gemini CLI

Gemini CLI dapat terhubung ke server MCP jarak jauh, tetapi GWC Bridge saat ini tidak mengaktifkan klien OAuth Gemini CLI. Jangan tambahkan profil OAuth GWC Bridge ke Gemini CLI. Jalur ini tetap tidak didukung sampai GWC menerbitkan mekanisme identitas klien yang ditinjau secara terpisah.

6. Aplikasi kustom Gemini konsumen

Bantuan Gemini Apps konsumen dari Google menyebutkan bahwa pengguna yang memenuhi syarat dapat membuka Settings → Connected Apps (Setelan → Aplikasi Terhubung), menambahkan aplikasi kustom menggunakan URL server MCP, dan—ketika server tidak mendukung Pendaftaran Klien Dinamis—membuka Advanced features (Fitur lanjutan) lalu memasukkan kredensial.^[4]

Jangan memasukkan salah satu ID klien statis GWC di sana saat ini. Halaman bantuan Google saat ini tidak mendokumentasikan URI callback OAuth untuk aplikasi kustom konsumen, dan GWC tidak memiliki endpoint Pendaftaran Klien Dinamis. Menggunakan kembali callback Enterprise atau callback loopback CLI adalah tidak tepat; menerima wildcard akan memperlemah pengikatan pengalihan OAuth.

Jalur ini baru dapat didukung setelah setidaknya salah satu hal berikut terpenuhi:

Google memublikasikan URI callback konsumen yang stabil dan pasti sehingga dapat diikat GWC ke ID klien publik khusus; atau
GWC mengimplementasikan serta meninjau keamanan Pendaftaran Klien Dinamis yang memenuhi alur pendaftaran klien Gemini.

Sampai saat itu, satu-satunya jalur pelanggan yang didukung dalam panduan ini adalah Gemini.

7. Apa yang dapat dilihat Gemini dan cara memutuskan koneksi

Saat Gemini memanggil alat GWC Bridge, hasil alat tersebut dapat mencakup nama file, isi file, keluaran perintah, label perangkat, atau data lain yang dikembalikan oleh alat yang diizinkan. Konten tersebut keluar dari PC Anda dan diproses oleh antarmuka Gemini yang Anda pilih. Google menyatakan bahwa server MCP pihak ketiga kustom berada di luar kendali Google dan menyarankan untuk hanya menghubungkan server yang Anda percayai.^[4]

Izin GWC Bridge tetap menjadi penentu utama:

Pembacaan file dibatasi pada folder yang dibagikan dengan koneksi GWC Bridge yang aktif.
Perubahan file mengharuskan koneksi dan folder mengizinkan perubahan, ditambah pemeriksaan tindakan yang dilindungi.
Perintah mengharuskan koneksi mengizinkan Commands dan tetap dapat memerlukan persetujuan.
PC lain, akun lain, atau pemberian akses (grant) yang telah dicabut tidak dapat dipertukarkan dengan yang telah Anda otorisasi.

Untuk memutuskan koneksi:

Gemini: administrator dapat menonaktifkan tindakan, memutuskan penyimpanan data dari aplikasi, atau menghapus penyimpanan data MCP kustom sesuai kebijakan organisasi.
Gemini CLI: tidak ada klien OAuth GWC yang diaktifkan. Hapus profil OAuth GWC Bridge eksperimental alih-alih mencoba mengautentikasinya.
Di GWC, mencabut pemberian akses Bridge yang mendasarinya akan menghentikan akses secara independen dari konfigurasi di sisi Gemini.

8. Pemecahan masalah

Gejala	Yang perlu diperiksa
OAuth Gemini CLI dicoba	Hentikan. GWC Bridge saat ini tidak mendukung OAuth Gemini CLI.
Gemini menyatakan Custom MCP Server diblokir	Pastikan batasan terkelola tingkat proyek Disable custom MCP server connector for Gemini Enterprise telah ditimpa ke Off. Jika VPC Service Controls atau penegakan kebijakan terkelola berlaku, izinkan juga `custom_mcp` dan FQDN trafik keluar yang diperlukan.
Verify Auth melaporkan pengalihan tidak valid	Pastikan Client ID persis `gwc-google-gemini-v1`. GWC hanya menerima `https://vertexaisearch.cloud.google.com/oauth-redirect` yang didokumentasikan Google untuk klien tersebut.
Verify Auth melaporkan rahasia klien tidak valid	Masukkan persis `none`, aktifkan PKCE, dan biarkan Use HTTP Basic nonaktif. GWC memperlakukan nilai ini hanya sebagai placeholder formulir yang diwajibkan Google untuk satu klien publik ini; rahasia lain apa pun akan ditolak.
Otorisasi langsung gagal	Pastikan GWC telah mengaktifkan OAuth manual Gemini. Bendera kompatibilitas sisi server nonaktif secara bawaan.
Gemini tidak dapat menjangkau server atau endpoint OAuth	Jika kontrol trafik keluar berlaku, izinkan `mcp.gwc-corp.com` dan `api.gwc-corp.com`. Periksa kembali URL HTTPS secara persis.
Penyimpanan data berstatus Active tetapi Gemini tidak memanggil alat	Tindakan MCP kustom dinonaktifkan secara bawaan. Aktifkan tindakan yang dimaksud dan hubungkan penyimpanan data ke aplikasi Gemini yang diinginkan.

| Proses masuk berhasil tetapi GWC menolak akses | Periksa akun GWC dan Connect Pass yang aktif, lalu periksa pemberian akses Bridge serta izin PC. Jangan mencoba ulang alat pengubah keadaan secara membabi buta. | | PC atau folder tidak tersedia | Pastikan PC yang dimaksud sedang online, GWC Studio atau GWC for VS Code berjalan dan terhubung, serta folder dibagikan ke koneksi ini. | | Pembacaan berhasil tetapi pengeditan atau perintah gagal | Tinjau izin Change files (Ubah file) / Commands (Perintah) di GWC Bridge dan setiap permintaan persetujuan. Penolakan adalah batas kebijakan, bukan bukti bahwa autentikasi gagal. | | Aplikasi kustom Gemini konsumen meminta kredensial | Jangan gunakan ID klien Enterprise atau CLI. URI callback konsumen saat ini belum didokumentasikan, sehingga GWC sengaja menolak jalur ini. |

Saat menghubungi dukungan GWC, sertakan antarmuka Gemini (Enterprise atau CLI), langkah penyiapan, dan pesan kesalahan persisnya. Jangan pernah mengirimkan kata sandi, token bearer, isi file pribadi, atau rahasia klien yang sebenarnya.

9. Referensi resmi

Langkah penyedia diperiksa pada 2026-10-22 (Asia/Singapore) berdasarkan dokumentasi resmi berbahasa Inggris Google saat ini: