Zum Inhalt springen
Localtonet Localtonet Dashboard

Localtonet-MCP-Server

Hilfe zu dieser Seite
Auf dieser Seite 9 Abschnitte
  1. Was er ist und was nicht
  2. Verbindungsdetails
  3. Bevor Sie beginnen
  4. Ihren MCP-Client verbinden
  5. Den Server zum Client hinzufügen
  6. Die Verbindung prüfen
  7. Einen Tunnel erstellen
  8. Tools
  9. Tunnel
  10. Tunnelkonfiguration
  11. AuthTokens und Token-Gruppen
  12. Server und SSO-Anbieter
  13. VPN-Zugang bei Proxy-Tunneln
  14. Geräte
  15. Limits
  16. Sicherheit
  17. Fehlerbehebung
  18. Verwandte Seiten

Mit dem Localtonet-MCP-Server kann ein KI-Assistent, der das Model Context Protocol unterstützt, etwa Claude oder Cursor, Ihr Konto in natürlicher Sprache verwalten: Tunnel auflisten, erstellen, starten, stoppen und konfigurieren sowie AuthTokens, Token-Gruppen, Server und SSO-Anbieter verwalten.

Was er ist und was nicht #

  • Der MCP-Server auf dieser Seite wird von Localtonet unter https://localtonet.com/mcp betrieben. Seine Tools wirken auf Ihr Localtonet-Konto, genauso wie die REST-API.
  • Das MCP-Gateway ist ein Tunneltyp. Es gibt einem MCP-Server, der auf Ihrem eigenen Gerät läuft, eine öffentliche Adresse. Verwenden Sie es, um Ihre eigenen Tools zu veröffentlichen, nicht um Localtonet zu verwalten.

Verbindungsdetails #

EinstellungWert
Endpunkthttps://localtonet.com/mcp
TransportStreamable HTTP
AuthentifizierungIhr API-Schlüssel als Bearer-Token: Authorization: Bearer <YOUR_API_KEY>
Serverinformationenlocaltonet.com/mcp-info (JSON) und die Server-Card unter https://localtonet.com/.well-known/mcp-server-card

Bevor Sie beginnen #

  • Ein MCP-Client, der sich über Streamable HTTP mit einem entfernten Server verbinden und einen benutzerdefinierten Authorization-Header senden kann.
  • Ihr API-Schlüssel. Öffnen Sie das Dashboard und verwenden Sie Kopieren in der Karte API-Schlüssel. Siehe Konto und Sicherheit.
  • Für Tunnelarbeiten: ein Gerät mit verbundenem Localtonet-Client, damit der Assistent ein AuthToken hat, auf dem er Tunnel erstellen kann.

Ihren MCP-Client verbinden #

  1. Den Server zum Client hinzufügen #

    Die meisten MCP-Clients nehmen einen entfernten Server als URL plus Header entgegen. Die übliche Form ist:

    MCP-Client-Konfiguration
    {
      "mcpServers": {
        "localtonet": {
          "type": "http",
          "url": "https://localtonet.com/mcp",
          "headers": {
            "Authorization": "Bearer <YOUR_API_KEY>"
          }
        }
      }
    }

    Dateiname und genaue Schlüsselnamen unterscheiden sich je nach Client. Schlagen Sie in der Dokumentation Ihres Clients nach, wo entfernte MCP-Server konfiguriert werden, und verwenden Sie die URL und den Header von oben.

  2. Die Verbindung prüfen #

    Laden Sie den Client neu. Die Localtonet-Tools sollten in seiner Tool-Liste erscheinen. Fragen Sie zuerst etwas Harmloses, zum Beispiel:

    Prompt
    List my Localtonet tunnels and tell me which ones are running.
  3. Einen Tunnel erstellen #

    Beschreiben Sie, was Sie möchten. Zum Beispiel:

    Prompt
    Create an HTTP tunnel with a random subdomain for port 3000 on my device "laptop", then start it and give me the URL.

    Der Assistent folgt dem Ablauf, den der Server vorgibt: Er sucht das AuthToken des Geräts heraus, wählt einen Server, ruft das passende Erstellen-Tool auf und startet den Tunnel, denn ein neu erstellter Tunnel läuft nicht.

Tools #

Die Tool-Namen unten sind die Namen, die Ihr Client anzeigt. Ein Tool, das fehlschlägt, gibt eine Meldung zurück, die mit Error: beginnt.

Tunnel #

ZweckTools
AnsehenGetTunnels, GetTunnel, GetTunnelRequestLogs
ErstellenCreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel
AusführenStartTunnel, StopTunnel, DeleteTunnel
ÄndernUpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType
MassenaktionenBulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType

Tunnelkonfiguration #

EinstellungTools
IP-BeschränkungenGetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions
ZugriffskontrollenGetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls
Header und AuthentifizierungGetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication
Ablauf und LimitsGetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage
Server und PortGetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer
Argumente und NotizGetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote
Clients rotierender Proxys und Token-GruppenGetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups
Erweiterte EinstellungenGetAdvancedTunnelSettings, GetTunnelIpv4Only, SetTunnelIpv4Only, GetTunnelWifiSplit, SetTunnelWifiSplit, SetTunnelSslStream, GetTunnelProxyProtocol, SetTunnelProxyProtocol, GetTunnelPassThrough, SetTunnelPassThrough, GetTunnelHttpsOnly, SetTunnelHttpsOnly, GetTunnelHttp3, SetTunnelHttp3, GetTunnelFilePath, SetTunnelFilePath, GetTunnelHostHeader, SetTunnelHostHeader, GetTunnelPathRewrite, SetTunnelPathRewrite, GetTunnelUpstreamProxy, SetTunnelUpstreamProxy, GetTunnelVless, SetTunnelVless

Was die Einstellungen bewirken, steht in der Einstellungsreferenz.

AuthTokens und Token-Gruppen #

ZweckTools
AuthTokensGetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken
Flugmodus und IP-WechselGetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink
Token-GruppenGetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup

Server und SSO-Anbieter #

ZweckTools
ServerGetAvailableServers
SSO-AnbieterGetSsoProviders, GetSsoProviderDefaultEndpoints, SaveSsoProvider, DeleteSsoProvider, GetSsoProvidersForTunnel, SetSsoProvidersForTunnel

VPN-Zugang bei Proxy-Tunneln #

GetVpnAccessDevices, CreateVpnAccessDevice, GetVpnAccessDeviceConfig, GetVpnAccessDeviceCredentials, RegenerateVpnAccessDevice, DeleteVpnAccessDevice. Diese Tools verwalten WireGuard- und OpenVPN-Geräte an einem Proxy-Tunnel. Jedes Gerät erhält eine eigene Konfiguration, und sein gesamter Datenverkehr verlässt das Netz über den Proxy.

Geräte #

ToolFunktion
ListDevicesListet die Computer auf, die unter Meine Geräte mit Ihrem Konto gekoppelt sind, mit der Angabe, ob sie online sind, sowie ihrer CPU-, Arbeitsspeicher- und Festplattennutzung.
GetDeviceMetricsGibt die neuesten Werte für CPU, Arbeitsspeicher, Festplatte und Betriebszeit eines Geräts zurück.
RunDeviceCommandFührt einen Shell-Befehl auf einem Gerät aus und gibt dessen Ausgabe und Exit-Code zurück. Es wartet bis zum angegebenen Timeout, 1 bis 120 Sekunden, standardmäßig 30.

RunDeviceCommand benötigt mehr als den API-Schlüssel: Es verlangt einen Geräte-Zugriffsschlüssel (er beginnt mit ltd_), den Sie für dieses Gerät unter Meine Geräte erstellen. Siehe Geräte-Terminal. Ein Aufruf erscheint im Verbindungsverlauf des Geräts mit Zeit und IP-Adresse; der Befehl wird nicht gespeichert.

Limits #

  • Anfragen an den MCP-Server unterliegen einer Ratenbegrenzung, gemeinsam mit den API-Anfragen Ihres API-Schlüssels. Eine Antwort 429 bedeutet: warten und es dann erneut versuchen.
  • Massen-Tools akzeptieren eine Liste mit bis zu 100 Einträgen.

Sicherheit #

Der Assistent handelt mit Ihrem API-Schlüssel. Seine Tools können Tunnel erstellen, stoppen und löschen, AuthTokens und Token-Gruppen löschen und Zugriffsregeln ändern, ohne dass Localtonet eine Bestätigung verlangt.

  • Schalten Sie in Ihrem MCP-Client die Bestätigung für Tool-Aufrufe ein, zumindest für die Tools, die mit Delete, BulkDelete, Stop und Set beginnen.
  • Geben Sie den Geräte-Zugriffsschlüssel für RunDeviceCommand nur an einen Assistenten, dem Sie auch ein Terminal auf diesem Computer geben würden. Ein Befehl wird von der Standard-Shell des Geräts ausgeführt.
  • Behandeln Sie die Konfigurationsdatei des Clients wie ein Geheimnis: Sie enthält Ihren API-Schlüssel. Checken Sie sie nicht in ein Repository ein.
  • Wenn der Schlüssel möglicherweise offengelegt wurde, wählen Sie Ändern in der Karte API-Schlüssel des Dashboards. Das erzeugt einen neuen Schlüssel und macht den alten ungültig; aktualisieren Sie dann Ihren MCP-Client.
  • Mit einem in einem Team-Dashboard kopierten API-Schlüssel listet der Assistent nur Ihre AuthTokens und Tunnel in diesem Team auf. Siehe Teamverwaltung.

Fehlerbehebung #

Der Client meldet 401 oder „API key is required. Provide Authorization: Bearer <apikey>“

Die Anfrage hat keinen gültigen Authorization-Header. Prüfen Sie, ob der Client für diesen Server benutzerdefinierte Header sendet, ob der Wert aus Bearer, einem Leerzeichen und dem Schlüssel besteht und ob der Schlüssel im Dashboard seit dem Kopieren nicht geändert wurde.

Der Assistent meldet, ein Tool habe „Error: …“ zurückgegeben

Das ist die Antwort von Localtonet, kein Verbindungsproblem. Der Text nach Error: sagt, was abgelehnt wurde, zum Beispiel ein fehlendes AuthToken oder ein Plan-Limit. Beheben Sie diese Ursache, statt den Assistenten es erneut versuchen zu lassen.

Der Tunnel wurde erstellt, antwortet aber nicht

Bitten Sie den Assistenten, ihn zu starten. Ein neuer Tunnel bleibt gestoppt, bis StartTunnel aufgerufen wird, und der Localtonet-Client des Geräts muss verbunden sein.

In meinem Client fehlen Tools

Manche Clients begrenzen die Anzahl der Tools oder verlangen, dass Sie sie einzeln aktivieren. Aktivieren Sie die benötigten Localtonet-Tools in den Einstellungen des Clients.

Brauchen Sie Hilfe zu dieser Seite? Fragen Sie die Community oder eröffnen Sie ein Support-Ticket.

Support