Server MCP Localtonet
Di halaman ini 9 bagian
- Apa itu, dan apa yang bukan
- Detail koneksi
- Sebelum memulai
- Menghubungkan klien MCP Anda
- Menambahkan server ke klien
- Memeriksa koneksi
- Membuat tunnel
- Tool
- Tunnel
- Konfigurasi tunnel
- AuthToken dan grup token
- Server dan penyedia SSO
- Akses VPN pada tunnel proxy
- Perangkat
- Batas
- Keamanan
- Pemecahan masalah
- Halaman terkait
Server MCP Localtonet memungkinkan asisten AI yang mendukung Model Context Protocol, seperti Claude atau Cursor, mengelola akun Anda dengan bahasa alami: mencantumkan, membuat, memulai, menghentikan, dan mengonfigurasi tunnel, serta mengelola AuthToken, grup token, server, dan penyedia SSO.
Apa itu, dan apa yang bukan #
- Server MCP di halaman ini dijalankan oleh Localtonet di
https://localtonet.com/mcp. Tool-nya bekerja pada akun Localtonet Anda, sama seperti REST API. - MCP Gateway adalah jenis tunnel. MCP Gateway memberi alamat publik pada server MCP yang berjalan di perangkat Anda sendiri. Gunakan untuk memublikasikan tool Anda sendiri, bukan untuk mengelola Localtonet.
Detail koneksi #
| Pengaturan | Nilai |
|---|---|
| Endpoint | https://localtonet.com/mcp |
| Transport | Streamable HTTP |
| Autentikasi | Kunci API Anda sebagai token Bearer: Authorization: Bearer <YOUR_API_KEY> |
| Informasi server | localtonet.com/mcp-info (JSON) dan kartu server di https://localtonet.com/.well-known/mcp-server-card |
Sebelum memulai #
- Klien MCP yang dapat terhubung ke server jarak jauh lewat Streamable HTTP dan mengirim header
Authorizationkustom. - Kunci API Anda. Buka Dasbor dan gunakan Salin pada kartu Kunci API. Lihat Akun dan keamanan.
- Untuk pekerjaan tunnel: perangkat dengan klien Localtonet yang terhubung, agar asisten memiliki AuthToken untuk membuat tunnel.
Menghubungkan klien MCP Anda #
-
Menambahkan server ke klien #
Sebagian besar klien MCP menerima server jarak jauh berupa URL ditambah header. Bentuk yang umum adalah:
Konfigurasi klien MCP{ "mcpServers": { "localtonet": { "type": "http", "url": "https://localtonet.com/mcp", "headers": { "Authorization": "Bearer <YOUR_API_KEY>" } } } }Nama file dan nama kunci yang persis berbeda-beda di tiap klien. Periksa dokumentasi klien Anda untuk mengetahui tempat server MCP jarak jauh dikonfigurasi, lalu gunakan URL dan header di atas.
-
Memeriksa koneksi #
Muat ulang klien. Tool Localtonet seharusnya muncul di daftar tool-nya. Tanyakan hal yang tidak berbahaya terlebih dahulu, misalnya:
PromptList my Localtonet tunnels and tell me which ones are running. -
Membuat tunnel #
Jelaskan apa yang Anda inginkan. Misalnya:
PromptCreate an HTTP tunnel with a random subdomain for port 3000 on my device "laptop", then start it and give me the URL.Asisten mengikuti alur kerja yang ditetapkan server: mencari AuthToken perangkat, memilih server, memanggil tool pembuatan yang sesuai, lalu memulai tunnel, karena tunnel yang baru dibuat belum berjalan.
Tool #
Nama tool di bawah adalah nama yang ditampilkan klien Anda. Tool yang gagal mengembalikan pesan yang diawali Error:.
Tunnel #
| Tujuan | Tool |
|---|---|
| Memeriksa | GetTunnels, GetTunnel, GetTunnelRequestLogs |
| Buat | CreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel |
| Menjalankan | StartTunnel, StopTunnel, DeleteTunnel |
| Mengubah | UpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType |
| Massal | BulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType |
Konfigurasi tunnel #
| Pengaturan | Tool |
|---|---|
| Pembatasan IP | GetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions |
| Kontrol akses | GetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls |
| Header dan autentikasi | GetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication |
| Masa berlaku dan batas | GetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage |
| Server dan port | GetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer |
| Argumen dan catatan | GetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote |
| Klien proxy rotasi dan grup token | GetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups |
| Pengaturan lanjutan | GetAdvancedTunnelSettings, GetTunnelIpv4Only, SetTunnelIpv4Only, GetTunnelWifiSplit, SetTunnelWifiSplit, SetTunnelSslStream, GetTunnelProxyProtocol, SetTunnelProxyProtocol, GetTunnelPassThrough, SetTunnelPassThrough, GetTunnelHttpsOnly, SetTunnelHttpsOnly, GetTunnelHttp3, SetTunnelHttp3, GetTunnelFilePath, SetTunnelFilePath, GetTunnelHostHeader, SetTunnelHostHeader, GetTunnelPathRewrite, SetTunnelPathRewrite, GetTunnelUpstreamProxy, SetTunnelUpstreamProxy, GetTunnelVless, SetTunnelVless |
Fungsi pengaturan dijelaskan di Referensi pengaturan.
AuthToken dan grup token #
| Tujuan | Tool |
|---|---|
| AuthToken | GetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken |
| Mode pesawat dan penggantian IP | GetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink |
| Grup token | GetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup |
Server dan penyedia SSO #
| Tujuan | Tool |
|---|---|
| Server | GetAvailableServers |
| Penyedia SSO | GetSsoProviders, GetSsoProviderDefaultEndpoints, SaveSsoProvider, DeleteSsoProvider, GetSsoProvidersForTunnel, SetSsoProvidersForTunnel |
Akses VPN pada tunnel proxy #
GetVpnAccessDevices, CreateVpnAccessDevice, GetVpnAccessDeviceConfig, GetVpnAccessDeviceCredentials, RegenerateVpnAccessDevice, DeleteVpnAccessDevice. Tool ini mengelola perangkat WireGuard dan OpenVPN pada tunnel proxy. Setiap perangkat mendapat konfigurasinya sendiri, dan seluruh lalu lintasnya keluar melalui proxy.
Perangkat #
| Alat | Fungsinya |
|---|---|
ListDevices | Mencantumkan komputer yang dipasangkan dengan akun Anda di Perangkat Saya, beserta status online masing-masing dan pemakaian CPU, memori, dan disknya. |
GetDeviceMetrics | Mengembalikan angka terbaru CPU, memori, disk, dan uptime dari satu perangkat. |
RunDeviceCommand | Menjalankan satu perintah shell di perangkat dan mengembalikan keluaran serta kode keluarnya. Tool ini menunggu hingga batas waktu yang Anda tentukan, 1 sampai 120 detik, default 30. |
RunDeviceCommand memerlukan lebih dari kunci API: tool ini membutuhkan kunci akses perangkat (diawali ltd_) yang Anda buat untuk perangkat tersebut di Perangkat Saya. Lihat Terminal Perangkat. Setiap proses muncul di riwayat koneksi perangkat dengan waktu dan alamat IP-nya; perintahnya tidak disimpan.
Batas #
- Permintaan ke server MCP dibatasi lajunya, bersama dengan permintaan API dari kunci API Anda. Jawaban
429berarti: tunggu, lalu coba lagi. - Tool massal menerima daftar hingga 100 item.
Keamanan #
Asisten bertindak dengan kunci API Anda. Tool-nya dapat membuat, menghentikan, dan menghapus tunnel, menghapus AuthToken dan grup token, serta mengubah aturan akses, tanpa langkah konfirmasi di sisi Localtonet.
- Aktifkan konfirmasi untuk pemanggilan tool di klien MCP Anda, setidaknya untuk tool yang diawali
Delete,BulkDelete,Stop, danSet. - Berikan kunci akses perangkat untuk
RunDeviceCommandhanya kepada asisten yang juga akan Anda beri terminal di komputer itu. Perintah dijalankan oleh shell default perangkat. - Perlakukan file konfigurasi klien sebagai rahasia: file itu berisi kunci API Anda. Jangan meng-commit-nya ke repositori.
- Jika kunci mungkin bocor, pilih Ubah pada kartu Kunci API di dasbor. Ini membuat kunci baru dan membatalkan yang lama; lalu perbarui klien MCP Anda.
- Dengan kunci API yang disalin di dasbor tim, asisten hanya mencantumkan AuthToken dan tunnel Anda di tim tersebut. Lihat Manajemen Tim.
Pemecahan masalah #
Klien melaporkan 401, atau "API key is required. Provide Authorization: Bearer <apikey>"
Permintaan tidak memiliki header Authorization yang valid. Periksa bahwa klien mengirim header kustom untuk server ini, bahwa nilainya adalah Bearer, sebuah spasi, lalu kunci, dan bahwa kunci tidak diubah di dasbor sejak Anda menyalinnya.
Asisten mengatakan sebuah tool mengembalikan "Error: …"
Itu adalah jawaban dari Localtonet, bukan masalah koneksi. Teks setelah Error: menjelaskan apa yang ditolak, misalnya AuthToken yang hilang atau batas paket. Atasi penyebabnya, jangan biarkan asisten mencoba ulang.
Tunnel sudah dibuat tetapi tidak menjawab
Minta asisten untuk memulainya. Tunnel baru berhenti sampai StartTunnel dipanggil, dan klien Localtonet di perangkat harus terhubung.
Tool tidak muncul di klien saya
Sebagian klien membatasi jumlah tool atau meminta Anda mengaktifkannya satu per satu. Aktifkan tool Localtonet yang Anda butuhkan di pengaturan klien.