Zum Inhalt springen
Localtonet Localtonet Dashboard

MCP-Tools mit einem MCP-Gateway-Tunnel bereitstellen

Desktop v7.8+ Mobile v10.1+

Hilfe zu dieser Seite
Auf dieser Seite 8 Abschnitte
  1. Was es ist
  2. Bevor Sie beginnen
  3. Das Gateway erstellen
  4. Die Seite MCP-Gateway öffnen
  5. Das Formular ausfüllen
  6. Den Tunnel starten
  7. URL-Typen
  8. Gateway-Token
  9. Einen MCP-Client verbinden
  10. Das Gateway-Dashboard öffnen
  11. Ihre MCP-Server registrieren
  12. Ein Client-Token erstellen
  13. Den MCP-Client auf das Gateway richten
  14. Einstellungen
  15. Fehlerbehebung
  16. Verwandte Seiten

Ein MCP-Gateway-Tunnel verbindet MCP-Clients und KI-Assistenten über ein öffentliches Gateway mit Tools, die auf Ihrem Gerät laufen. Der Localtonet-Client betreibt das Gateway für Sie, und der Tunnel gibt ihm eine öffentliche HTTPS-Adresse.

Was es ist #

Das Model Context Protocol (MCP) ermöglicht es einem KI-Assistenten, Tools aufzurufen. Ein MCP-Gateway steht vor den MCP-Servern, die Sie betreiben, und bietet alle ihre Tools über einen einzigen Endpunkt an.

Wenn Sie einen MCP-Gateway-Tunnel starten, startet der Localtonet-Client ein Gateway auf Ihrem Gerät, und Localtonet veröffentlicht es unter der Adresse des Tunnels. Sie geben weder eine lokale IP noch einen Port ein. Das Gateway bietet:

  • ein Web-Dashboard unter https://<ADDRESS>/dashboard, in dem Sie MCP-Server registrieren und Client-Tokens erstellen;
  • den MCP-Endpunkt unter https://<ADDRESS>/mcp, mit dem sich Ihre MCP-Clients verbinden.

Nicht dasselbe wie der Localtonet-MCP-Server. Diese Seite behandelt die Veröffentlichung Ihrer eigenen Tools. Wenn ein KI-Assistent Ihr Localtonet-Konto verwalten soll (Tunnel, Tokens und so weiter), lesen Sie MCP-Server.

Bevor Sie beginnen #

  • Der Localtonet-Client läuft auf dem Gerät und ist mit einem AuthToken verbunden. Siehe Schnellstart.
  • Der Client ist aktuell genug. Mindestens erforderliche Versionen der Localtonet-App für diese Funktion: Desktop v7.8, Mobile v10.1.

Das Gateway erstellen #

  1. Die Seite MCP-Gateway öffnen #

    Öffnen Sie Meine Tunnel › MCP-Gateway und klappen Sie MCP-Gateway-Tunnel erstellen auf.

  2. Das Formular ausfüllen #

    FeldWas Sie eingeben
    URL-TypZufällige Subdomain, Eigene Subdomain oder Eigene Domain. Siehe die Tabelle unten.
    Geräte-TokenDas Token des Geräts, auf dem Ihre Tools laufen.
    ServerregionDer Server, mit dem sich Ihre MCP-Clients verbinden.
    SubdomainWird bei Eigene Subdomain angezeigt: der gewünschte Name.
    DomainDie Domain der Adresse.

    Wählen Sie Tunnel erstellen.

  3. Den Tunnel starten #

    Das Gateway erscheint unter Ihre Tunnel. Wählen Sie Starten. Die Spalte URL zeigt die öffentliche Adresse.

URL-Typen #

URL-TypAdresse, die Sie erhaltenHinweise
Zufällige SubdomainEin generierter Name unter der gewählten Domain.Gut für einen ersten Test.
Eigene SubdomainDie Subdomain, die Sie eingeben, unter der gewählten Domain.Guthaben erforderlich.
Eigene DomainEine Ihrer eigenen Domains.Guthaben erforderlich. Die Liste Domain zeigt Ihre Domains; ist sie leer, erstellen Sie zuerst eine Domain im DNS-Manager. Siehe Eigene Domains.

Gateway-Token #

Jeder MCP-Gateway-Tunnel erhält beim Erstellen sein eigenes Gateway-Token. Es ist das Admin-Token des Gateways: Das Gateway-Dashboard und seine Verwaltungs-API akzeptieren Änderungen nur mit diesem Token.

  1. Wählen Sie das Einstellungen-Symbol des Tunnels.
  2. Wählen Sie neben Gateway-Token die Option Verwalten. Das Fenster Gateway-Token zeigt das Token mit verborgener Mitte.
  3. Wählen Sie die Kopieren-Schaltfläche neben dem Token. Sie kopiert immer das vollständige Token. Die Anzeigen-Schaltfläche daneben zeigt das Token auf dem Bildschirm an.

Halten Sie das Gateway-Token geheim. Es gibt volle Kontrolle über das Gateway: seine Server, Tools und Client-Tokens. Tragen Sie es nicht in einen MCP-Client ein; Clients verwenden ihr eigenes Token.

Einen MCP-Client verbinden #

  1. Das Gateway-Dashboard öffnen #

    Öffnen Sie bei gestartetem Tunnel https://<ADDRESS>/dashboard in einem Browser. Fügen Sie das Gateway-Token in das Feld Admin token unten im Seitenmenü ein.

  2. Ihre MCP-Server registrieren #

    Öffnen Sie Servers und wählen Sie Add Server. Ein Server kann ein per URL erreichbarer MCP-Server (Streamable HTTP oder SSE), ein lokaler Befehl (stdio) oder ein OpenAPI-Dienst sein. Catalog listet fertige MCP-Server auf, die Sie installieren können, und Tools zeigt die Tools, die das Gateway von allen Servern gesammelt hat.

  3. Ein Client-Token erstellen #

    Öffnen Sie Clients und wählen Sie New Client. Geben Sie einen Name ein und wählen Sie Create Client. Das Gateway zeigt das Client Token nur einmal an: Kopieren Sie es jetzt, es wird nicht erneut angezeigt. In der Clientliste zeigen Allowed Servers und Allowed Groups, welche Server und Tool-Gruppen ein Client nutzen darf.

  4. Den MCP-Client auf das Gateway richten #

    Fügen Sie in Ihrem MCP-Client oder KI-Assistenten einen Remote-MCP-Server mit diesen beiden Werten hinzu:

    MCP-Client-Einstellungen
    URL:     https://<ADDRESS>/mcp
    Header:  Authorization: Bearer <CLIENT_TOKEN>

    Wo Sie sie eingeben, hängt vom Client ab; folgen Sie dessen eigener Dokumentation für Remote-MCP-Server (HTTP).

Der Audit Log des Dashboards zeigt aktuelle Gateway-Anfragen, und Settings enthält die Gateway-Konfiguration mit Sicherung und Wiederherstellung.

Das Gateway speichert seine Server, Gruppen, Clients und das Audit-Protokoll auf Ihrem Gerät, in einem Ordner namens mcp-data-<TUNNEL_ID> im Arbeitsverzeichnis des Localtonet-Clients (unter Android im eigenen Speicher der App). <TUNNEL_ID> ist die Zahl in der Spalte ID, sodass jeder MCP-Gateway-Tunnel seinen eigenen Ordner hat.

Einstellungen #

Wählen Sie das Einstellungen-Symbol des Tunnels, um die Tunneleinstellungen zu öffnen.

EinstellungFunktionMehr
Load BalancingTraffic auf Geräte verteilen oder ein Backup nutzen, wenn ein Ziel nicht verfügbar ist.Lastverteilung
Nur HTTPS?Nur HTTPS für den öffentlichen Tunnel-Endpunkt verwenden.Einstellungsreferenz
Basic Auth?Für den Zugriff auf diesen Tunnel Benutzername und Passwort verlangen.Zugriffskontrolle
HTTP/3 aktiv?Clients erlauben, sich über HTTP/3 mit dem öffentlichen Endpunkt zu verbinden.Einstellungsreferenz
Legacy-Verbindung?Versuchen Sie dies, wenn sich der Tunnel mit der normalen Verbindungsmethode nicht verbinden kann.Einstellungsreferenz
Gateway-TokenDas Zugriffstoken für dieses MCP-Gateway verwalten.Siehe oben
HTTP-TimeoutWie lange der Server auf eine Antwort Ihrer lokalen Anwendung wartet, bevor er die Anfrage abbricht, von 1 bis 600 Sekunden. Lassen Sie das Feld leer, um den Standardwert des Servers zu verwenden.Einstellungsreferenz
TunnelnotizSpeichern Sie eine private Notiz, die Ihnen hilft, diesen Tunnel zu erkennen oder zu dokumentieren.Einstellungsreferenz
IP-BeschränkungFestlegen, welche Client-IP-Adressen auf diesen Tunnel zugreifen dürfen.Zugriffskontrolle
Ablaufdatum, Geschwindigkeitslimits, Bandbreitenlimit, BandbreitennutzungAblaufdatum, Upload- und Download-Geschwindigkeitslimits, ein Limit für das Datenvolumen und Leeren, um die erfasste Nutzung zurückzusetzen.Limits und Ablauf
Ausgehender PortEinen festen ausgehenden Port für die Serververbindung der Localtonet-App wählen.Ports
Bandbreitenverkehr, Anfrageprotokoll, Aktivitätsprotokoll, TunnelzustandTraffic im Zeitverlauf, aufgezeichnete Anfragen, Starts, Stopps und Einstellungsänderungen sowie aktuelle Ergebnisse der Zustandsprüfung.Protokolle und Inspektion

In der Tunnelliste hat die Spalte Webhooks eine Schaltfläche Request- & Response-Protokolle anzeigen, die den Request-Inspektor für einen gestarteten Tunnel öffnet. Siehe Protokolle und Inspektion.

Fehlerbehebung #

Das Gateway startet nicht oder die Adresse antwortet nicht

Prüfen Sie die Version der Localtonet-App auf dem Gerät: Das MCP-Gateway benötigt mindestens Desktop v7.8 oder Mobile v10.1. Prüfen Sie dann, ob der Tunnel gestartet ist und die Spalte Verbindung das Gerät als verbunden anzeigt.

Das Gateway-Dashboard lädt seine Daten nicht

Die Verwaltungsanfragen des Dashboards benötigen das Admin-Token. Das Feld Admin token ist leer oder falsch. Kopieren Sie das Gateway-Token erneut aus den Einstellungen des Tunnels und fügen Sie es in das Feld ein.

Der MCP-Client wird abgelehnt

Der MCP-Endpunkt benötigt ein Client-Token im Header Authorization: Bearer. Erstellen Sie eines unter Clients im Gateway-Dashboard und verwenden Sie es hier, nicht das Gateway-Token.

„Bitte starten Sie zuerst Ihren Tunnel.“

Der Request-Inspektor ist nur verfügbar, solange der Tunnel gestartet ist.

„Sie müssen eine Domain im DNS-Manager erstellen!“ oder „WARNUNG! Sie haben keine Domain!“

Eigene Domain erfordert eine Ihrer eigenen Domains. Fügen Sie sie im DNS-Manager hinzu oder wählen Sie einen anderen URL-Typ.

„Sie müssen Guthaben kaufen, um diese Funktion zu nutzen.“

Eigene Subdomain und Eigene Domain erfordern Guthaben. Verwenden Sie Zufällige Subdomain oder laden Sie Guthaben auf. Siehe Pläne und Guthaben.

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

Support