Langsung ke konten
Localtonet Localtonet Dasbor

Mengekspos alat MCP dengan tunnel MCP Gateway

Desktop v7.8+ Mobile v10.1+

Bantuan untuk halaman ini
Di halaman ini 8 bagian
  1. Apa itu
  2. Sebelum memulai
  3. Membuat gateway
  4. Membuka halaman MCP Gateway
  5. Isi formulir
  6. Mulai tunnel
  7. Jenis URL
  8. Token Gateway
  9. Menghubungkan klien MCP
  10. Membuka dasbor gateway
  11. Mendaftarkan server MCP Anda
  12. Membuat token klien
  13. Mengarahkan klien MCP ke gateway
  14. Pengaturan
  15. Pemecahan masalah
  16. Halaman terkait

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 #

  1. Membuka halaman MCP Gateway #

    Buka Tunnel Saya › MCP Gateway dan perluas Buat Tunnel MCP Gateway.

  2. Isi formulir #

    KolomYang dimasukkan
    Jenis URLSubdomain acak, Subdomain kustom, atau Domain kustom. Lihat tabel di bawah.
    Token perangkatToken perangkat yang menjalankan alat Anda.
    Wilayah serverServer tempat klien MCP Anda terhubung.
    SubdomainDitampilkan untuk Subdomain kustom: nama yang Anda inginkan.
    DomainDomain alamat tersebut.

    Pilih Buat tunnel.

  3. Mulai tunnel #

    Gateway muncul di bawah Tunnel Anda. Pilih Mulai. Kolom URL menampilkan alamat publik.

Jenis URL #

Jenis URLAlamat yang Anda dapatCatatan
Subdomain acakNama yang dibuat otomatis di bawah domain yang Anda pilih.Cocok untuk uji coba pertama.
Subdomain kustomSubdomain yang Anda masukkan di bawah Domain yang Anda pilih.Memerlukan Saldo.
Domain kustomSalah 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.

  1. Pilih ikon Pengaturan pada tunnel.
  2. Di samping Token Gateway, pilih Kelola. Jendela Token gateway menampilkan token dengan bagian tengah disembunyikan.
  3. 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 #

  1. Membuka dasbor gateway #

    Dengan tunnel yang sudah dimulai, buka https://<ADDRESS>/dashboard di browser. Tempel Token Gateway ke kolom Admin token di bagian bawah menu samping.

  2. 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.

  3. 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.

  4. Mengarahkan klien MCP ke gateway #

    Di klien MCP atau asisten AI Anda, tambahkan server MCP remote dengan dua nilai ini:

    Pengaturan klien MCP
    URL:     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.

PengaturanFungsinyaSelengkapnya
Load BalanceMembagi 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 GatewayKelola token akses untuk MCP Gateway ini.Lihat di atas
Timeout HTTPBerapa 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 TunnelSimpan catatan pribadi untuk membantu Anda mengenali atau mendokumentasikan tunnel ini.Referensi pengaturan
Pembatasan IPKendalikan alamat IP klien mana yang dapat mengakses tunnel ini.Kontrol akses
Tanggal Kedaluwarsa, Batas Kecepatan, Batas Bandwidth, Pemakaian BandwidthTanggal kedaluwarsa, batas kecepatan unggah dan unduh, batas transfer data, dan Bersihkan untuk mereset pemakaian yang tercatat.Batas dan kedaluwarsa
Port KeluarPilih port keluar tetap untuk koneksi server aplikasi Localtonet.Port
Trafik Bandwidth, Log Permintaan, Log Aktivitas, Kesehatan TunnelTrafik 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.

Dukungan