Localtonet MCP-server
Op deze pagina 9 secties
- Wat het is en wat niet
- Verbindingsgegevens
- Voordat je begint
- Je MCP-client verbinden
- De server aan de client toevoegen
- De verbinding controleren
- Een tunnel aanmaken
- Tools
- Tunnels
- Tunnelconfiguratie
- AuthTokens en tokengroepen
- Servers en SSO-providers
- VPN-toegang op proxytunnels
- Apparaten
- Limieten
- Veiligheid
- Probleemoplossing
- Gerelateerde pagina's
Met de Localtonet MCP-server kan een AI-assistent die het Model Context Protocol ondersteunt, zoals Claude of Cursor, je account in gewone taal beheren: tunnels weergeven, aanmaken, starten, stoppen en configureren, en AuthTokens, tokengroepen, servers en SSO-providers beheren.
Wat het is en wat niet #
- De MCP-server op deze pagina wordt door Localtonet beheerd op
https://localtonet.com/mcp. De tools werken op je Localtonet-account, op dezelfde manier als de REST API. - De MCP-gateway is een tunneltype. Het geeft een MCP-server die op je eigen apparaat draait een openbaar adres. Gebruik het om je eigen tools te publiceren, niet om Localtonet te beheren.
Verbindingsgegevens #
| Instelling | Waarde |
|---|---|
| Eindpunt | https://localtonet.com/mcp |
| Transport | Streamable HTTP |
| Authenticatie | Je API-sleutel als Bearer-token: Authorization: Bearer <YOUR_API_KEY> |
| Serverinformatie | localtonet.com/mcp-info (JSON) en de serverkaart op https://localtonet.com/.well-known/mcp-server-card |
Voordat je begint #
- Een MCP-client die via Streamable HTTP verbinding kan maken met een externe server en een eigen
Authorization-header kan meesturen. - Je API-sleutel. Open het Dashboard en gebruik Kopiëren in de kaart API-sleutel. Zie Account en beveiliging.
- Voor werk met tunnels: een apparaat met een verbonden Localtonet-client, zodat de assistent een AuthToken heeft om tunnels op aan te maken.
Je MCP-client verbinden #
-
De server aan de client toevoegen #
De meeste MCP-clients nemen een externe server als een URL plus headers. De gebruikelijke vorm is:
Configuratie van de MCP-client{ "mcpServers": { "localtonet": { "type": "http", "url": "https://localtonet.com/mcp", "headers": { "Authorization": "Bearer <YOUR_API_KEY>" } } } }De bestandsnaam en de exacte sleutelnamen verschillen per client. Kijk in de documentatie van je client waar externe MCP-servers worden geconfigureerd en gebruik de URL en de header van hierboven.
-
De verbinding controleren #
Laad de client opnieuw. De Localtonet-tools zouden in de lijst met tools moeten verschijnen. Vraag eerst iets onschuldigs, bijvoorbeeld:
PromptList my Localtonet tunnels and tell me which ones are running. -
Een tunnel aanmaken #
Beschrijf wat je wilt. Bijvoorbeeld:
PromptCreate an HTTP tunnel with a random subdomain for port 3000 on my device "laptop", then start it and give me the URL.De assistent volgt de workflow die de server voorschrijft: hij zoekt het AuthToken van het apparaat op, kiest een server, roept de bijbehorende aanmaaktool aan en start de tunnel, omdat een nieuw aangemaakte tunnel niet draait.
Tools #
De onderstaande toolnamen zijn de namen die je client toont. Een tool die mislukt, geeft een melding terug die met Error: begint.
Tunnels #
| Doel | Tools |
|---|---|
| Bekijken | GetTunnels, GetTunnel, GetTunnelRequestLogs |
| Aanmaken | CreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel |
| Uitvoeren | StartTunnel, StopTunnel, DeleteTunnel |
| Wijzigen | UpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType |
| Bulk | BulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType |
Tunnelconfiguratie #
| Instelling | Tools |
|---|---|
| IP-beperkingen | GetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions |
| Toegangsregels | GetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls |
| Headers en authenticatie | GetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication |
| Vervaldatum en limieten | GetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage |
| Server en poort | GetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer |
| Argumenten en notitie | GetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote |
| Clients van roterende proxy en tokengroepen | GetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups |
| Geavanceerde instellingen | GetAdvancedTunnelSettings, GetTunnelIpv4Only, SetTunnelIpv4Only, GetTunnelWifiSplit, SetTunnelWifiSplit, SetTunnelSslStream, GetTunnelProxyProtocol, SetTunnelProxyProtocol, GetTunnelPassThrough, SetTunnelPassThrough, GetTunnelHttpsOnly, SetTunnelHttpsOnly, GetTunnelHttp3, SetTunnelHttp3, GetTunnelFilePath, SetTunnelFilePath, GetTunnelHostHeader, SetTunnelHostHeader, GetTunnelPathRewrite, SetTunnelPathRewrite, GetTunnelUpstreamProxy, SetTunnelUpstreamProxy, GetTunnelVless, SetTunnelVless |
Wat de instellingen doen, staat beschreven in de Instellingenreferentie.
AuthTokens en tokengroepen #
| Doel | Tools |
|---|---|
| AuthTokens | GetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken |
| Vliegtuigmodus en IP-wijziging | GetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink |
| Tokengroepen | GetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup |
Servers en SSO-providers #
| Doel | Tools |
|---|---|
| Servers | GetAvailableServers |
| SSO-providers | GetSsoProviders, GetSsoProviderDefaultEndpoints, SaveSsoProvider, DeleteSsoProvider, GetSsoProvidersForTunnel, SetSsoProvidersForTunnel |
VPN-toegang op proxytunnels #
GetVpnAccessDevices, CreateVpnAccessDevice, GetVpnAccessDeviceConfig, GetVpnAccessDeviceCredentials, RegenerateVpnAccessDevice, DeleteVpnAccessDevice. Met deze tools beheer je WireGuard- en OpenVPN-apparaten op een proxytunnel. Elk apparaat krijgt een eigen configuratie en al het verkeer ervan verlaat het netwerk via de proxy.
Apparaten #
| Tool | Wat het doet |
|---|---|
ListDevices | Toont de computers die onder Mijn apparaten aan je account zijn gekoppeld, met of ze online zijn en hun cpu-, geheugen- en schijfgebruik. |
GetDeviceMetrics | Geeft de meest recente cpu-, geheugen-, schijf- en uptimecijfers van één apparaat terug. |
RunDeviceCommand | Voert één shellcommando uit op een apparaat en geeft de uitvoer en de exitcode terug. Het wacht maximaal de time-out die je opgeeft, 1 tot 120 seconden, standaard 30. |
RunDeviceCommand heeft meer nodig dan de API-sleutel: er is een toegangssleutel voor het apparaat nodig (die begint met ltd_) die je voor dat apparaat aanmaakt onder Mijn apparaten. Zie Apparaatterminal. Een uitvoering verschijnt in de verbindingsgeschiedenis van het apparaat met tijd en IP-adres; het commando zelf wordt niet opgeslagen.
Limieten #
- Verzoeken aan de MCP-server zijn aan een limiet gebonden, samen met de API-verzoeken van je API-sleutel. Een antwoord
429betekent: wacht en probeer het daarna opnieuw. - Bulktools accepteren een lijst van maximaal 100 items.
Veiligheid #
De assistent handelt met je API-sleutel. Met zijn tools kan hij tunnels aanmaken, stoppen en verwijderen, AuthTokens en tokengroepen verwijderen en toegangsregels wijzigen, zonder bevestigingsstap aan de kant van Localtonet.
- Schakel bevestiging voor toolaanroepen in in je MCP-client, ten minste voor de tools die beginnen met
Delete,BulkDelete,StopenSet. - Geef de toegangssleutel van het apparaat voor
RunDeviceCommandalleen aan een assistent aan wie je ook een terminal op die computer zou geven. Een commando wordt uitgevoerd door de standaardshell van het apparaat. - Behandel het configuratiebestand van de client als geheim: het bevat je API-sleutel. Commit het niet naar een repository.
- Als de sleutel mogelijk is uitgelekt, selecteer dan Wijzigen in de kaart API-sleutel van het dashboard. Dit maakt een nieuwe sleutel aan en maakt de oude ongeldig; werk daarna je MCP-client bij.
- Met een API-sleutel die in een teamdashboard is gekopieerd, toont de assistent alleen jouw AuthTokens en tunnels in dat team. Zie Teambeheer.
Probleemoplossing #
De client meldt 401, of "API key is required. Provide Authorization: Bearer <apikey>"
Het verzoek heeft geen geldige Authorization-header. Controleer of de client voor deze server eigen headers meestuurt, of de waarde Bearer, een spatie en dan de sleutel is, en of de sleutel sinds je hem kopieerde niet in het dashboard is gewijzigd.
De assistent zegt dat een tool "Error: …" teruggaf
Dat is het antwoord van Localtonet, geen verbindingsprobleem. De tekst na Error: zegt wat is geweigerd, bijvoorbeeld een ontbrekend AuthToken of een abonnementslimiet. Los die oorzaak op in plaats van de assistent het opnieuw te laten proberen.
De tunnel is aangemaakt maar antwoordt niet
Vraag de assistent hem te starten. Een nieuwe tunnel is gestopt totdat StartTunnel wordt aangeroepen, en de Localtonet-client van het apparaat moet verbonden zijn.
Tools ontbreken in mijn client
Sommige clients beperken het aantal tools of vragen je ze een voor een in te schakelen. Schakel de Localtonet-tools die je nodig hebt in bij de instellingen van de client.