Localtonet-MCP-Server
Auf dieser Seite 9 Abschnitte
- Was er ist und was nicht
- Verbindungsdetails
- Bevor Sie beginnen
- Ihren MCP-Client verbinden
- Den Server zum Client hinzufügen
- Die Verbindung prüfen
- Einen Tunnel erstellen
- Tools
- Tunnel
- Tunnelkonfiguration
- AuthTokens und Token-Gruppen
- Server und SSO-Anbieter
- VPN-Zugang bei Proxy-Tunneln
- Geräte
- Limits
- Sicherheit
- Fehlerbehebung
- 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/mcpbetrieben. 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 #
| Einstellung | Wert |
|---|---|
| Endpunkt | https://localtonet.com/mcp |
| Transport | Streamable HTTP |
| Authentifizierung | Ihr API-Schlüssel als Bearer-Token: Authorization: Bearer <YOUR_API_KEY> |
| Serverinformationen | localtonet.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 #
-
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.
-
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:
PromptList my Localtonet tunnels and tell me which ones are running. -
Einen Tunnel erstellen #
Beschreiben Sie, was Sie möchten. Zum Beispiel:
PromptCreate 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 #
| Zweck | Tools |
|---|---|
| Ansehen | GetTunnels, GetTunnel, GetTunnelRequestLogs |
| Erstellen | CreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel |
| Ausführen | StartTunnel, StopTunnel, DeleteTunnel |
| Ändern | UpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType |
| Massenaktionen | BulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType |
Tunnelkonfiguration #
| Einstellung | Tools |
|---|---|
| IP-Beschränkungen | GetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions |
| Zugriffskontrollen | GetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls |
| Header und Authentifizierung | GetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication |
| Ablauf und Limits | GetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage |
| Server und Port | GetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer |
| Argumente und Notiz | GetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote |
| Clients rotierender Proxys und Token-Gruppen | GetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups |
| Erweiterte Einstellungen | GetAdvancedTunnelSettings, 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 #
| Zweck | Tools |
|---|---|
| AuthTokens | GetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken |
| Flugmodus und IP-Wechsel | GetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink |
| Token-Gruppen | GetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup |
Server und SSO-Anbieter #
| Zweck | Tools |
|---|---|
| Server | GetAvailableServers |
| SSO-Anbieter | GetSsoProviders, 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 #
| Tool | Funktion |
|---|---|
ListDevices | Listet 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. |
GetDeviceMetrics | Gibt die neuesten Werte für CPU, Arbeitsspeicher, Festplatte und Betriebszeit eines Geräts zurück. |
RunDeviceCommand | Fü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
429bedeutet: 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,StopundSetbeginnen. - Geben Sie den Geräte-Zugriffsschlüssel für
RunDeviceCommandnur 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.