MCP-Tools mit einem MCP-Gateway-Tunnel bereitstellen
Desktop v7.8+ Mobile v10.1+
Auf dieser Seite 8 Abschnitte
- Was es ist
- Bevor Sie beginnen
- Das Gateway erstellen
- Die Seite MCP-Gateway öffnen
- Das Formular ausfüllen
- Den Tunnel starten
- URL-Typen
- Gateway-Token
- Einen MCP-Client verbinden
- Das Gateway-Dashboard öffnen
- Ihre MCP-Server registrieren
- Ein Client-Token erstellen
- Den MCP-Client auf das Gateway richten
- Einstellungen
- Fehlerbehebung
- 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 #
-
Die Seite MCP-Gateway öffnen #
Öffnen Sie Meine Tunnel › MCP-Gateway und klappen Sie MCP-Gateway-Tunnel erstellen auf.
-
Das Formular ausfüllen #
Feld Was Sie eingeben URL-Typ Zufällige Subdomain, Eigene Subdomain oder Eigene Domain. Siehe die Tabelle unten. Geräte-Token Das Token des Geräts, auf dem Ihre Tools laufen. Serverregion Der Server, mit dem sich Ihre MCP-Clients verbinden. Subdomain Wird bei Eigene Subdomain angezeigt: der gewünschte Name. Domain Die Domain der Adresse. Wählen Sie Tunnel erstellen.
-
Den Tunnel starten #
Das Gateway erscheint unter Ihre Tunnel. Wählen Sie Starten. Die Spalte URL zeigt die öffentliche Adresse.
URL-Typen #
| URL-Typ | Adresse, die Sie erhalten | Hinweise |
|---|---|---|
| Zufällige Subdomain | Ein generierter Name unter der gewählten Domain. | Gut für einen ersten Test. |
| Eigene Subdomain | Die Subdomain, die Sie eingeben, unter der gewählten Domain. | Guthaben erforderlich. |
| Eigene Domain | Eine 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.
- Wählen Sie das Einstellungen-Symbol des Tunnels.
- Wählen Sie neben Gateway-Token die Option Verwalten. Das Fenster Gateway-Token zeigt das Token mit verborgener Mitte.
- 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 #
-
Das Gateway-Dashboard öffnen #
Öffnen Sie bei gestartetem Tunnel
https://<ADDRESS>/dashboardin einem Browser. Fügen Sie das Gateway-Token in das Feld Admin token unten im Seitenmenü ein. -
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.
-
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.
-
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-EinstellungenURL: 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.
| Einstellung | Funktion | Mehr |
|---|---|---|
| Load Balancing | Traffic 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-Token | Das Zugriffstoken für dieses MCP-Gateway verwalten. | Siehe oben |
| HTTP-Timeout | Wie 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 |
| Tunnelnotiz | Speichern Sie eine private Notiz, die Ihnen hilft, diesen Tunnel zu erkennen oder zu dokumentieren. | Einstellungsreferenz |
| IP-Beschränkung | Festlegen, welche Client-IP-Adressen auf diesen Tunnel zugreifen dürfen. | Zugriffskontrolle |
| Ablaufdatum, Geschwindigkeitslimits, Bandbreitenlimit, Bandbreitennutzung | Ablaufdatum, Upload- und Download-Geschwindigkeitslimits, ein Limit für das Datenvolumen und Leeren, um die erfasste Nutzung zurückzusetzen. | Limits und Ablauf |
| Ausgehender Port | Einen festen ausgehenden Port für die Serververbindung der Localtonet-App wählen. | Ports |
| Bandbreitenverkehr, Anfrageprotokoll, Aktivitätsprotokoll, Tunnelzustand | Traffic 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.