Langsung ke konten
Localtonet Localtonet Dasbor

Server MCP Localtonet

Bantuan untuk halaman ini
Di halaman ini 9 bagian
  1. Apa itu, dan apa yang bukan
  2. Detail koneksi
  3. Sebelum memulai
  4. Menghubungkan klien MCP Anda
  5. Menambahkan server ke klien
  6. Memeriksa koneksi
  7. Membuat tunnel
  8. Tool
  9. Tunnel
  10. Konfigurasi tunnel
  11. AuthToken dan grup token
  12. Server dan penyedia SSO
  13. Akses VPN pada tunnel proxy
  14. Perangkat
  15. Batas
  16. Keamanan
  17. Pemecahan masalah
  18. 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 #

PengaturanNilai
Endpointhttps://localtonet.com/mcp
TransportStreamable HTTP
AutentikasiKunci API Anda sebagai token Bearer: Authorization: Bearer <YOUR_API_KEY>
Informasi serverlocaltonet.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 Authorization kustom.
  • 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 #

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

  2. Memeriksa koneksi #

    Muat ulang klien. Tool Localtonet seharusnya muncul di daftar tool-nya. Tanyakan hal yang tidak berbahaya terlebih dahulu, misalnya:

    Prompt
    List my Localtonet tunnels and tell me which ones are running.
  3. Membuat tunnel #

    Jelaskan apa yang Anda inginkan. Misalnya:

    Prompt
    Create 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 #

TujuanTool
MemeriksaGetTunnels, GetTunnel, GetTunnelRequestLogs
BuatCreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel
MenjalankanStartTunnel, StopTunnel, DeleteTunnel
MengubahUpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType
MassalBulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType

Konfigurasi tunnel #

PengaturanTool
Pembatasan IPGetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions
Kontrol aksesGetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls
Header dan autentikasiGetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication
Masa berlaku dan batasGetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage
Server dan portGetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer
Argumen dan catatanGetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote
Klien proxy rotasi dan grup tokenGetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups
Pengaturan lanjutanGetAdvancedTunnelSettings, 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 #

TujuanTool
AuthTokenGetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken
Mode pesawat dan penggantian IPGetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink
Grup tokenGetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup

Server dan penyedia SSO #

TujuanTool
ServerGetAvailableServers
Penyedia SSOGetSsoProviders, 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 #

AlatFungsinya
ListDevicesMencantumkan komputer yang dipasangkan dengan akun Anda di Perangkat Saya, beserta status online masing-masing dan pemakaian CPU, memori, dan disknya.
GetDeviceMetricsMengembalikan angka terbaru CPU, memori, disk, dan uptime dari satu perangkat.
RunDeviceCommandMenjalankan 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 429 berarti: 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, dan Set.
  • Berikan kunci akses perangkat untuk RunDeviceCommand hanya 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.

Dukungan