Menghubungkan GWC Bridge secara manual ke Claude
Hubungkan GWC Bridge ke Claude sebagai konektor kustom agar Claude dapat bekerja dengan file dan perintah yang Anda izinkan di PC Anda sendiri.
Catatan label antarmuka: Label dalam tanda kutip mengikuti dokumentasi antarmuka berbahasa Inggris dari penyedia. Label terjemahan belum diverifikasi dan antarmuka Anda mungkin berbeda. GWC Bridge memungkinkan Claude bekerja dengan file dan perintah yang diizinkan di komputer Anda sendiri, tempat GWC for VS Code atau GWC Studio berjalan. Panduan ini menggunakan pengaturan konektor kustom Claude; menambahkan server secara manual tidak berarti Anthropic telah meninjau atau mendukung server tersebut.
1. Siapa yang dapat menggunakan cara ini
Claude mendukung konektor jarak jauh kustom pada paket Free, Pro, Max, Team, dan Enterprise. Akun Free dapat memiliki satu konektor kustom. Pada paket Team, "Owner" (Pemilik) atau "Primary Owner" (Pemilik utama) harus menambahkan GWC Bridge ke organisasi terlebih dahulu; pada paket Enterprise, "Owner", "Primary Owner", atau anggota dengan peran kustom yang mencakup "Manage access to Libraries" (Kelola akses ke Pustaka) harus menambahkannya terlebih dahulu.[1]
Akses ke Claude Code memiliki persyaratan kelayakan tersendiri melalui langganan yang didukung atau pengaturan akses organisasi. Akun Claude Free saja tidak mencakup akses ke Claude Code.[3]
2. Sebelum memulai
- Siapkan akun GWC Anda, Connect Pass yang aktif, serta GWC for VS Code atau GWC Studio yang berjalan dan terhubung di komputer yang ingin Anda gunakan bersama Claude.
- Masuk ke akun GWC yang sama di aplikasi komputer dan saat mengotorisasi konektor Claude; menambahkan URL GWC Bridge di Claude tidak menginstal komponen komputer.
- Tinjau file, folder, dan izin perintah yang ingin Anda sediakan di komputer tersebut, dan mulailah dengan akses minimum yang diperlukan.
- GWC Bridge menolak pemanggil yang belum terautentikasi atau tidak memiliki hak penggunaan; menambahkan URL-nya atau melihat daftar alat tidak melewati pemeriksaan tersebut.
3. Alamat server dan OAuth
Gunakan alamat server ini:
https://mcp.gwc-corp.com/mcpGWC Bridge melakukan autentikasi secara otomatis menggunakan Dokumen Metadata ID Klien (CIMD) yang dipublikasikan Claude dan PKCE. Anda tidak memerlukan—dan tidak boleh memasukkan—ID Klien OAuth atau Rahasia Klien OAuth. Jangan pernah menempelkan kata sandi, token akses, atau rahasia klien ke dalam percakapan Claude atau header permintaan.[4]
Opsi pemasangan lewat ZIP plugin: Jika halaman penyiapan GWC Bridge menyediakan ZIP untuk Claude, unduh terlebih dahulu dari sana. Di Claude pilih Customize > Plugins > Add > Upload plugin dan unggah ZIP; buka GWC Bridge > Connectors > Connect lalu masuk dengan akun GWC pada komputer. Pilih cara ini atau Add custom connector di bawah, jangan keduanya.
4. Penyiapan pribadi (Free, Pro, atau Max)
- Masuk ke akun Claude yang ingin Anda gunakan di claude.ai (atau di Claude Desktop), lalu buka "Customize" → "Connectors" (Sesuaikan → Konektor).
- Klik "+ Add" (+ Tambahkan) (atau "+") → "Add custom connector" (Tambahkan konektor kustom). Pada tata letak menu terpadu, klik "Add" → "Custom" → "Web".
- Beri nama konektor GWC Bridge dan masukkan
https://mcp.gwc-corp.com/mcp; jika dialog menampilkan bagian "Advanced settings" (Pengaturan lanjutan) untuk ID Klien OAuth dan Rahasia Klien OAuth yang bersifat opsional, biarkan kedua kolom kosong. - Klik "Continue" (Lanjutkan) (atau "Add" jika menggunakan dialog satu langkah) untuk meninjau pengaturan autentikasi yang terdeteksi: di bagian "Authentication", tetap pilih "Sign in now" (jangan pilih "No sign in"); di bagian "OAuth client", tetap pilih "Use Claude's published identity (Recommended)" (jangan pilih "Register automatically", karena GWC Bridge tidak menggunakan Pendaftaran Klien Dinamis, atau "Use your own OAuth client"); dan biarkan "Request headers" kosong.
- Klik "Add" untuk menyelesaikan pembuatan konektor, lalu klik "Connect" (Hubungkan) jika proses masuk belum dimulai, dan selesaikan alur masuk serta persetujuan GWC di browser.
- Pastikan GWC Bridge ditampilkan sebagai terhubung di "Customize" → "Connectors", buka "+" → "Connectors" (atau menu "Search and tools") dalam percakapan untuk mengaktifkan GWC Bridge, tetap atur perubahan file serta perintah agar memerlukan persetujuan sampai Anda merasa nyaman dengan akses tersebut, dan lakukan 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.), dengan meninjau hasil alat yang sebenarnya dan bukan hanya pernyataan Claude bahwa koneksi berhasil.[1]
5. Penyiapan organisasi (Team atau Enterprise)
- "Owner" atau "Primary Owner" organisasi (atau pada Enterprise seseorang dengan peran kustom yang mencakup "Manage access to Libraries") membuka "Organization settings" → "Connectors" → "Add" → "Custom" → "Web" (atau memilih "Add custom connector").
- Masukkan nama GWC Bridge dan URL server
https://mcp.gwc-corp.com/mcp, lalu klik "Continue". - Pertahankan pengaturan autentikasi yang terdeteksi ("Sign in now" dan "Use Claude's published identity (Recommended)"), biarkan "Request headers" dan semua kolom kredensial klien OAuth kustom kosong, lalu klik "Add".
- Setelah konektor ditambahkan ke organisasi, setiap anggota membuka "Customize" → "Connectors", menemukan GWC Bridge yang ditandai dengan label "Custom", mengeklik "Connect" untuk masuk menggunakan akun GWC masing-masing, lalu mengaktifkannya di "+" → "Connectors" (atau "Search and tools").
Menyediakan konektor bagi organisasi tidak otomatis membuat anggotanya masuk.[1]
6. Perangkat seluler dan Claude Code
Siapkan dan autentikasi GWC Bridge di Claude web atau Claude Desktop terlebih dahulu, kemudian masuk ke akun Claude yang sama—dan organisasi yang sama, jika berlaku—di aplikasi Claude untuk iOS atau Android. Konektor web berfungsi di Claude Mobile setelah dikonfigurasi pada akun Anda; pemasangan konektor langsung di perangkat seluler saat ini masih dalam versi beta, sehingga Claude Desktop dan web tetap menjadi jalur utama untuk menyiapkan konektor kustom.[2]
Di dalam Claude Code, periksa /mcp terlebih dahulu: jika Anda masuk menggunakan akun Claude, konektor yang ditambahkan di claude.ai mungkin sudah dimuat secara otomatis, sehingga hindari menambahkan entri CLI duplikat jika konektor akun sudah tersedia. Untuk menambahkan (atau menghapus nantinya) GWC Bridge langsung melalui CLI di terminal:[3]
claude mcp add --transport http --scope user gwc-bridge https://mcp.gwc-corp.com/mcp
claude mcp remove gwc-bridge --scope userSetelah menambahkan server, mulai Claude Code, jalankan /mcp, pilih gwc-bridge, pilih "Authenticate" (Autentikasi), lalu selesaikan alur masuk GWC di browser. Cakupan user membuat server ini tersedia di semua proyek Anda pada komputer tersebut. Periksa status server dan lakukan pemeriksaan awal hanya-baca di atas. Organisasi Anda mungkin membatasi server MCP yang dapat dimuat Claude Code; jangan mencoba melewati kebijakan organisasi dengan mengubah autentikasi atau beralih akun.[3][4]
7. Apa yang dapat dilihat Claude dan cara memutuskan koneksi
GWC Bridge bukan sekadar daftar nama alat. Saat alat yang diizinkan membaca file atau mengembalikan keluaran perintah, konten tersebut dikirim ke Claude, dan konektor juga dapat menyediakan sumber daya MCP serta prompt alur kerja. Tindakan yang tersedia melalui GWC Bridge bergantung pada izin GWC Anda dan kebijakan folder komputer; kontrol izin alat Claude dapat membatasi alat yang dipanggil Claude, tetapi tidak dapat memberikan akses yang ditolak GWC Bridge. Tinjau permintaan persetujuan dengan cermat, terutama sebelum mengedit file, menghapus file, atau menjalankan perintah. Jangan menganggap lalu lintas konektor jarak jauh tetap sepenuhnya lokal: pada claude.ai, Claude Desktop, Cowork, dan Claude Mobile, Claude terhubung ke server MCP jarak jauh dari infrastruktur cloud Anthropic. Menambahkan URL tidak pernah otomatis memberikan kendali layar, akses file tanpa batas, atau eksekusi perintah tanpa persetujuan—hanya folder bersama dan kemampuan yang telah Anda izinkan di GWC yang tersedia.
Untuk memutuskan koneksi atau menghapus GWC Bridge, buka "Customize" → "Connectors" dan pilih GWC Bridge:
- "Disconnect" (Putuskan koneksi) mengeluarkan Claude dari GWC Bridge, tetapi tetap menyimpan konektor di daftar Anda.
- "Remove" / "Delete" (Hapus), dari menu konektor, menghapus konektor kustom pribadi dari akun Anda.
- "Organization-wide removal" (Penghapusan untuk seluruh organisasi) pada paket Team dan Enterprise harus dilakukan oleh pemilik yang berwenang di "Organization settings" → "Connectors".
- Menonaktifkan konektor di menu "+" → "Connectors" atau "Search and tools" dalam percakapan hanya menonaktifkannya untuk percakapan tersebut; jika konektor disinkronkan dari akun claude.ai Anda atau disediakan oleh organisasi, kelola atau hapus konektor tersebut di pengaturan konektor Claude (atau nonaktifkan untuk diri Anda sendiri di
/mcp).
8. Pemecahan masalah
| Gejala | Yang perlu diperiksa |
|---|---|
| Tidak ada opsi untuk menambahkan konektor kustom | Pada paket Free, periksa apakah satu-satunya slot konektor kustom Anda sudah digunakan. Pada Team atau Enterprise, minta pemilik organisasi (atau admin Enterprise dengan "Manage access to Libraries") untuk menambahkannya di "Organization settings" → "Connectors". |
| GWC Bridge tidak ada di Direktori Konektor | Gunakan alur URL konektor kustom (https://mcp.gwc-corp.com/mcp). Penyiapan manual tidak mengharuskan konektor terdaftar di direktori. |
| Penyiapan meminta ID Klien OAuth atau Rahasia Klien OAuth | Biarkan kolom ID Klien dan Rahasia Klien yang opsional di "Advanced settings" kosong. Jangan pernah menebak atau memasukkan kredensial klien statis. |
| Pendaftaran klien OAuth gagal | Pada dialog penyiapan dua langkah, pastikan "OAuth client" diatur ke "Use Claude's published identity (Recommended)", bukan "Register automatically" (GWC Bridge tidak menggunakan Pendaftaran Klien Dinamis) atau "Use your own OAuth client". |
| Proses masuk selesai, tetapi GWC menolak akses | Pastikan Anda masuk menggunakan akun GWC yang dimaksud dan Connect Pass akun tersebut aktif. Jangan pilih "No sign in" untuk melewati penolakan. |
| “Couldn’t reach the MCP server” (Tidak dapat menjangkau server MCP) | Periksa kembali bahwa URL-nya adalah https://mcp.gwc-corp.com/mcp. Gangguan layanan sementara, batas waktu penemuan OAuth yang terlampaui, atau pemblokiran firewall jaringan/WAF antara rentang IP Anthropic dan server dapat menyebabkan kesalahan ini. Laporkan pesan kesalahan persisnya dan ID referensi kepada dukungan GWC. |
| Terhubung, tetapi Claude tidak menggunakan alat | Periksa bahwa GWC Bridge diaktifkan di menu "+" → "Connectors" / "Search and tools" dalam percakapan dan bahwa masing-masing alat tidak dinonaktifkan. Minta tindakan GWC Bridge secara eksplisit. |
| Komputer atau folder tidak tersedia | Pastikan komputer yang dimaksud sedang online, GWC Studio atau GWC for VS Code berjalan dan terhubung, serta folder dibagikan untuk koneksi ini. Jangan beralih ke komputer lain tanpa memastikan bahwa komputer tersebut memang tujuan yang dimaksud. |
| Pembacaan berhasil, tetapi pengeditan atau perintah gagal | Periksa pengaturan persetujuan alat Claude dan izin "Change files" (Ubah file) / "Commands" (Perintah) pada folder di GWC. Perlakukan penolakan izin sebagai pembatasan kebijakan yang perlu diselesaikan, bukan gangguan sementara yang dicoba ulang tanpa pemeriksaan. |
| Perangkat seluler tidak menampilkan konektor | Pastikan Anda masuk ke akun Claude dan organisasi yang sama di perangkat seluler, lalu selesaikan penyiapan awal konektor kustom di Claude web atau Desktop terlebih dahulu. |
| Claude Code tidak menampilkan konektor yang ditambahkan melalui web | Jalankan /status untuk memeriksa metode masuk Anda. Masuk menggunakan kunci API atau profil penyedia yang berbeda akan mencegah konektor akun claude.ai dimuat. Periksa juga kebijakan MCP organisasi di /mcp. |
| Claude Code memerlukan autentikasi atau browser tidak terbuka | Jalankan /mcp, pilih gwc-bridge, lalu pilih "Authenticate". Salin dan buka URL otorisasi yang ditampilkan di terminal jika browser tidak terbuka secara otomatis. |
| Perubahan file atau perintah melewati batas waktu | Jangan menganggap tindakan tersebut gagal sepenuhnya. Periksa keadaan file saat ini atau aktivitas terbaru sebelum mengulangi operasi yang mengubah keadaan. |
Saat menghubungi dukungan GWC, sertakan aplikasi atau antarmuka Claude yang Anda gunakan, jenis paket Claude, langkah saat masalah terjadi, serta pesan kesalahan atau ID referensi apa pun. Jangan pernah mengirim kata sandi, token bearer, rahasia klien, atau isi file pribadi.
9. Referensi resmi
Langkah penyedia diperiksa pada 2026-10-21 (Asia/Singapore) berdasarkan dokumentasi resmi berbahasa Inggris dari Anthropic: