Mengekspos alat MCP dengan tunnel MCP Gateway
Desktop v7.8+ Mobile v10.1+
Di halaman ini 8 bagian
Tunnel MCP Gateway menghubungkan klien MCP dan asisten AI ke alat yang berjalan di perangkat Anda melalui gateway publik. Klien Localtonet menjalankan gateway untuk Anda, dan tunnel memberinya alamat HTTPS publik.
Apa itu #
Model Context Protocol (MCP) memungkinkan asisten AI memanggil alat. MCP gateway berada di depan server MCP yang Anda jalankan dan menawarkan semua alatnya melalui satu endpoint.
Saat Anda memulai tunnel MCP Gateway, klien Localtonet menjalankan gateway di perangkat Anda dan Localtonet menerbitkannya di alamat tunnel. Anda tidak perlu memasukkan IP atau port lokal. Gateway memiliki:
- dasbor web di
https://<ADDRESS>/dashboard, tempat Anda mendaftarkan server MCP dan membuat token klien; - endpoint MCP di
https://<ADDRESS>/mcp, yang dituju klien MCP Anda.
Tidak sama dengan server MCP Localtonet. Halaman ini membahas penerbitan alat Anda sendiri. Untuk membiarkan asisten AI mengelola akun Localtonet Anda (tunnel, token, dan seterusnya), lihat Server MCP.
Sebelum memulai #
- Klien Localtonet berjalan di perangkat dan terhubung dengan AuthToken. Lihat Mulai cepat.
- Klien cukup baru. Versi minimum Localtonet App yang diperlukan untuk menggunakan fitur ini:
Desktop v7.8,Mobile v10.1.
Membuat gateway #
-
Membuka halaman MCP Gateway #
Buka Tunnel Saya › MCP Gateway dan perluas Buat Tunnel MCP Gateway.
-
Isi formulir #
Kolom Yang dimasukkan Jenis URL Subdomain acak, Subdomain kustom, atau Domain kustom. Lihat tabel di bawah. Token perangkat Token perangkat yang menjalankan alat Anda. Wilayah server Server tempat klien MCP Anda terhubung. Subdomain Ditampilkan untuk Subdomain kustom: nama yang Anda inginkan. Domain Domain alamat tersebut. Pilih Buat tunnel.
-
Mulai tunnel #
Gateway muncul di bawah Tunnel Anda. Pilih Mulai. Kolom URL menampilkan alamat publik.
Jenis URL #
| Jenis URL | Alamat yang Anda dapat | Catatan |
|---|---|---|
| Subdomain acak | Nama yang dibuat otomatis di bawah domain yang Anda pilih. | Cocok untuk uji coba pertama. |
| Subdomain kustom | Subdomain yang Anda masukkan di bawah Domain yang Anda pilih. | Memerlukan Saldo. |
| Domain kustom | Salah satu domain Anda sendiri. | Memerlukan Saldo. Daftar Domain menampilkan domain Anda; jika kosong, buat dulu domain dari Manajer DNS. Lihat Domain kustom. |
Token Gateway #
Setiap tunnel MCP Gateway mendapat Token Gateway sendiri saat dibuat. Ini adalah token admin gateway: dasbor gateway dan API pengelolaannya hanya menerima perubahan dengan token ini.
- Pilih ikon Pengaturan pada tunnel.
- Di samping Token Gateway, pilih Kelola. Jendela Token gateway menampilkan token dengan bagian tengah disembunyikan.
- Pilih tombol salin di samping token. Tombol ini selalu menyalin token lengkap. Tombol tampilkan di sebelahnya memperlihatkan token di layar.
Jaga kerahasiaan Token Gateway. Token ini memberi kendali penuh atas gateway: server, alat, dan token kliennya. Jangan masukkan ke klien MCP; klien memakai token mereka sendiri.
Menghubungkan klien MCP #
-
Membuka dasbor gateway #
Dengan tunnel yang sudah dimulai, buka
https://<ADDRESS>/dashboarddi browser. Tempel Token Gateway ke kolom Admin token di bagian bawah menu samping. -
Mendaftarkan server MCP Anda #
Buka Servers dan pilih Add Server. Server dapat berupa server MCP yang dijangkau lewat URL (Streamable HTTP atau SSE), perintah lokal (stdio), atau layanan OpenAPI. Catalog mencantumkan server MCP siap pakai yang dapat Anda instal, dan Tools menampilkan alat yang dikumpulkan gateway dari semua server.
-
Membuat token klien #
Buka Clients dan pilih New Client. Masukkan Name dan pilih Create Client. Gateway menampilkan Client Token satu kali: salin sekarang, token tidak akan ditampilkan lagi. Di daftar klien, Allowed Servers dan Allowed Groups menunjukkan server dan grup alat mana yang boleh dipakai klien.
-
Mengarahkan klien MCP ke gateway #
Di klien MCP atau asisten AI Anda, tambahkan server MCP remote dengan dua nilai ini:
Pengaturan klien MCPURL: https://<ADDRESS>/mcp Header: Authorization: Bearer <CLIENT_TOKEN>Tempat memasukkannya bergantung pada klien; ikuti dokumentasinya sendiri untuk server MCP remote (HTTP).
Audit Log di dasbor menampilkan permintaan gateway terbaru, dan Settings berisi konfigurasi gateway beserta pencadangan dan pemulihan.
Gateway menyimpan server, grup, klien, dan log audit di perangkat Anda, dalam folder bernama mcp-data-<TUNNEL_ID> di direktori kerja klien Localtonet (di Android, di dalam penyimpanan aplikasi itu sendiri). <TUNNEL_ID> adalah angka di kolom ID, sehingga setiap tunnel MCP Gateway memiliki folder sendiri.
Pengaturan #
Pilih ikon Pengaturan pada tunnel untuk membuka Pengaturan tunnel.
| Pengaturan | Fungsinya | Selengkapnya |
|---|---|---|
| Load Balance | Membagi trafik ke beberapa perangkat atau memakai cadangan saat target tidak tersedia. | Load balancing |
| Hanya HTTPS? | Gunakan hanya HTTPS untuk endpoint tunnel publik. | Referensi pengaturan |
| Basic Auth? | Mewajibkan nama pengguna dan kata sandi untuk mengakses tunnel ini. | Kontrol akses |
| HTTP/3 Aktif? | Mengizinkan klien terhubung ke endpoint publik menggunakan HTTP/3. | Referensi pengaturan |
| Koneksi Legacy? | Coba ini jika tunnel tidak dapat terhubung dengan metode koneksi normal. | Referensi pengaturan |
| Token Gateway | Kelola token akses untuk MCP Gateway ini. | Lihat di atas |
| Timeout HTTP | Berapa lama server menunggu respons dari aplikasi lokal Anda sebelum membatalkan permintaan, dari 1 hingga 600 detik. Biarkan kosong untuk memakai bawaan server. | Referensi pengaturan |
| Catatan Tunnel | Simpan catatan pribadi untuk membantu Anda mengenali atau mendokumentasikan tunnel ini. | Referensi pengaturan |
| Pembatasan IP | Kendalikan alamat IP klien mana yang dapat mengakses tunnel ini. | Kontrol akses |
| Tanggal Kedaluwarsa, Batas Kecepatan, Batas Bandwidth, Pemakaian Bandwidth | Tanggal kedaluwarsa, batas kecepatan unggah dan unduh, batas transfer data, dan Bersihkan untuk mereset pemakaian yang tercatat. | Batas dan kedaluwarsa |
| Port Keluar | Pilih port keluar tetap untuk koneksi server aplikasi Localtonet. | Port |
| Trafik Bandwidth, Log Permintaan, Log Aktivitas, Kesehatan Tunnel | Trafik dari waktu ke waktu, permintaan yang tercatat, awal, henti, dan perubahan pengaturan, serta hasil pemeriksaan kesehatan terbaru. | Log dan inspeksi |
Di daftar tunnel, kolom Webhook memiliki tombol Lihat log permintaan & respons yang membuka inspektur permintaan untuk tunnel yang sudah dimulai. Lihat Log dan inspeksi.
Pemecahan masalah #
Gateway tidak mulai atau alamat tidak menjawab
Periksa versi aplikasi Localtonet di perangkat: MCP Gateway membutuhkan minimal Desktop v7.8 atau Mobile v10.1. Lalu periksa bahwa tunnel sudah dimulai dan kolom Koneksi menunjukkan perangkat terhubung.
Dasbor gateway tidak memuat datanya
Permintaan pengelolaan dasbor membutuhkan token admin. Kolom Admin token kosong atau salah. Salin lagi Token Gateway dari Pengaturan tunnel dan tempel ke kolom tersebut.
Klien MCP ditolak
Endpoint MCP membutuhkan token klien di header Authorization: Bearer. Buat satu di Clients pada dasbor gateway dan gunakan di sini, bukan Token Gateway.
"Mulai tunnel Anda terlebih dahulu."
Inspektur permintaan hanya tersedia saat tunnel sudah dimulai.
"Anda harus membuat Domain dari Manajer DNS!" atau "PERINGATAN! Anda tidak memiliki Domain apa pun!"
Domain kustom membutuhkan salah satu domain Anda sendiri. Tambahkan di Manajer DNS, atau pilih jenis URL lain.
"Anda perlu membeli saldo untuk menggunakan fitur ini."
Subdomain kustom dan Domain kustom memerlukan Saldo. Gunakan Subdomain acak atau tambah Saldo. Lihat Paket dan Saldo.