Naar de inhoud
Localtonet Localtonet Dashboard

Localtonet MCP-server

Hulp bij deze pagina
Op deze pagina 9 secties
  1. Wat het is en wat niet
  2. Verbindingsgegevens
  3. Voordat je begint
  4. Je MCP-client verbinden
  5. De server aan de client toevoegen
  6. De verbinding controleren
  7. Een tunnel aanmaken
  8. Tools
  9. Tunnels
  10. Tunnelconfiguratie
  11. AuthTokens en tokengroepen
  12. Servers en SSO-providers
  13. VPN-toegang op proxytunnels
  14. Apparaten
  15. Limieten
  16. Veiligheid
  17. Probleemoplossing
  18. 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 #

InstellingWaarde
Eindpunthttps://localtonet.com/mcp
TransportStreamable HTTP
AuthenticatieJe API-sleutel als Bearer-token: Authorization: Bearer <YOUR_API_KEY>
Serverinformatielocaltonet.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 #

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

  2. De verbinding controleren #

    Laad de client opnieuw. De Localtonet-tools zouden in de lijst met tools moeten verschijnen. Vraag eerst iets onschuldigs, bijvoorbeeld:

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

    Beschrijf wat je wilt. Bijvoorbeeld:

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

DoelTools
BekijkenGetTunnels, GetTunnel, GetTunnelRequestLogs
AanmakenCreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel
UitvoerenStartTunnel, StopTunnel, DeleteTunnel
WijzigenUpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType
BulkBulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType

Tunnelconfiguratie #

InstellingTools
IP-beperkingenGetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions
ToegangsregelsGetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls
Headers en authenticatieGetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication
Vervaldatum en limietenGetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage
Server en poortGetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer
Argumenten en notitieGetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote
Clients van roterende proxy en tokengroepenGetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups
Geavanceerde instellingenGetAdvancedTunnelSettings, 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 #

DoelTools
AuthTokensGetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken
Vliegtuigmodus en IP-wijzigingGetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink
TokengroepenGetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup

Servers en SSO-providers #

DoelTools
ServersGetAvailableServers
SSO-providersGetSsoProviders, 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 #

ToolWat het doet
ListDevicesToont de computers die onder Mijn apparaten aan je account zijn gekoppeld, met of ze online zijn en hun cpu-, geheugen- en schijfgebruik.
GetDeviceMetricsGeeft de meest recente cpu-, geheugen-, schijf- en uptimecijfers van één apparaat terug.
RunDeviceCommandVoert éé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 429 betekent: 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, Stop en Set.
  • Geef de toegangssleutel van het apparaat voor RunDeviceCommand alleen 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.

Support