Naar de inhoud
Localtonet Localtonet Dashboard

MCP-tools beschikbaar stellen met een MCP-gateway-tunnel

Desktop v7.8+ Mobile v10.1+

Hulp bij deze pagina
Op deze pagina 8 secties
  1. Wat het is
  2. Voordat je begint
  3. De gateway aanmaken
  4. De pagina MCP-gateway openen
  5. Vul het formulier in
  6. Start de tunnel
  7. URL-typen
  8. Gatewaytoken
  9. Een MCP-client verbinden
  10. Het gatewaydashboard openen
  11. Je MCP-servers registreren
  12. Een clienttoken aanmaken
  13. De MCP-client naar de gateway laten wijzen
  14. Instellingen
  15. Probleemoplossing
  16. Gerelateerde pagina's

Een MCP-gateway-tunnel verbindt MCP-clients en AI-assistenten via een openbare gateway met tools die op je apparaat draaien. De Localtonet-client draait de gateway voor je en de tunnel geeft hem een openbaar HTTPS-adres.

Wat het is #

Met het Model Context Protocol (MCP) kan een AI-assistent tools aanroepen. Een MCP-gateway staat voor de MCP-servers die je draait en biedt al hun tools aan via één endpoint.

Wanneer je een MCP-gateway-tunnel start, start de Localtonet-client een gateway op je apparaat en publiceert Localtonet die op het adres van de tunnel. Je voert geen lokaal IP of poort in. De gateway heeft:

  • een webdashboard op https://<ADDRESS>/dashboard, waar je MCP-servers registreert en clienttokens aanmaakt;
  • het MCP-endpoint op https://<ADDRESS>/mcp, waarmee je MCP-clients verbinden.

Niet hetzelfde als de Localtonet MCP-server. Deze pagina gaat over het publiceren van je eigen tools. Om een AI-assistent je Localtonet-account (tunnels, tokens enzovoort) te laten beheren, zie MCP-server.

Voordat je begint #

  • De Localtonet-client draait op het apparaat en is verbonden met een AuthToken. Zie Snelstart.
  • De client is nieuw genoeg. Minimale versies van de Localtonet-app voor deze functie: Desktop v7.8, Mobile v10.1.

De gateway aanmaken #

  1. De pagina MCP-gateway openen #

    Open Mijn tunnels › MCP-gateway en klap MCP-gateway-tunnel aanmaken open.

  2. Vul het formulier in #

    VeldWat je invult
    URL-typeWillekeurig subdomein, Eigen subdomein of Eigen domein. Zie de tabel hieronder.
    ApparaattokenHet token van het apparaat dat je tools draait.
    ServerregioDe server waarmee je MCP-clients verbinden.
    SubdomeinWordt getoond bij Eigen subdomein: de naam die je wilt.
    DomeinHet domein van het adres.

    Kies Tunnel aanmaken.

  3. Start de tunnel #

    De gateway verschijnt onder Je tunnels. Kies Starten. De kolom URL toont het openbare adres.

URL-typen #

URL-typeAdres dat je krijgtOpmerkingen
Willekeurig subdomeinEen gegenereerde naam onder het domein dat je selecteert.Goed voor een eerste test.
Eigen subdomeinHet Subdomein dat je invoert onder het Domein dat je selecteert.Saldo vereist.
Eigen domeinEen van je eigen domeinen.Saldo vereist. De lijst Domein toont je domeinen; als die leeg is, maak dan eerst een domein aan in DNS-beheer. Zie Eigen domeinen.

Gatewaytoken #

Elke MCP-gateway-tunnel krijgt bij het aanmaken een eigen Gatewaytoken. Het is het admintoken van de gateway: het gatewaydashboard en de beheer-API accepteren alleen wijzigingen met dit token.

  1. Kies het pictogram Instellingen van de tunnel.
  2. Kies naast Gatewaytoken de knop Beheren. Het venster Gatewaytoken toont het token met het midden verborgen.
  3. Kies de kopieerknop naast het token. Die kopieert altijd het volledige token. De toon-knop ernaast toont het token op het scherm.

Houd het Gatewaytoken privé. Het geeft volledige controle over de gateway: zijn servers, tools en clienttokens. Zet het niet in een MCP-client; clients gebruiken hun eigen token.

Een MCP-client verbinden #

  1. Het gatewaydashboard openen #

    Open met de gestarte tunnel https://<ADDRESS>/dashboard in een browser. Plak het Gatewaytoken in het veld Admin token onderaan het zijmenu.

  2. Je MCP-servers registreren #

    Open Servers en kies Add Server. Een server kan een MCP-server zijn die via een URL wordt bereikt (Streamable HTTP of SSE), een lokale opdracht (stdio) of een OpenAPI-service. Catalog toont kant-en-klare MCP-servers die je kunt installeren, en Tools toont de tools die de gateway uit alle servers heeft verzameld.

  3. Een clienttoken aanmaken #

    Open Clients en kies New Client. Vul een Name in en kies Create Client. De gateway toont het Client Token één keer: kopieer het nu, het wordt niet opnieuw getoond. In de clientlijst tonen Allowed Servers en Allowed Groups welke servers en toolgroepen een client mag gebruiken.

  4. De MCP-client naar de gateway laten wijzen #

    Voeg in je MCP-client of AI-assistent een externe MCP-server toe met deze twee waarden:

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

    Waar je ze invoert, hangt af van de client; volg de eigen documentatie ervan voor externe (HTTP) MCP-servers.

De Audit Log van het dashboard toont recente gatewayverzoeken, en Settings bevat de gatewayconfiguratie met back-up en herstel.

De gateway slaat zijn servers, groepen, clients en auditlogboek op je apparaat op, in een map met de naam mcp-data-<TUNNEL_ID> in de werkmap van de Localtonet-client (op Android in de eigen opslag van de app). <TUNNEL_ID> is het nummer in de kolom ID, dus elke MCP-gateway-tunnel heeft zijn eigen map.

Instellingen #

Kies het pictogram Instellingen van de tunnel om Tunnelinstellingen te openen.

InstellingWat het doetMeer
Load balancingVerdeel het verkeer over apparaten of gebruik een back-up wanneer een doel niet beschikbaar is.Load balancing
Alleen HTTPS?Gebruik alleen HTTPS voor het openbare tunnel-endpoint.Instellingenreferentie
Basisauthenticatie?Vereis een gebruikersnaam en wachtwoord voor toegang tot deze tunnel.Toegangsbeheer
HTTP/3 actief?Laat clients met het openbare endpoint verbinden via HTTP/3.Instellingenreferentie
Verouderde verbinding?Probeer dit als de tunnel niet kan verbinden met de normale verbindingsmethode.Instellingenreferentie
GatewaytokenBeheer het toegangstoken voor deze MCP-gateway.Zie hierboven
HTTP-time-outHoe lang de server wacht op een antwoord van je lokale toepassing voordat hij het verzoek afbreekt, van 1 tot 600 seconden. Laat het leeg om de standaardwaarde van de server te gebruiken.Instellingenreferentie
TunnelnotitieSla een privénotitie op om deze tunnel te herkennen of te documenteren.Instellingenreferentie
IP-beperkingBepaal welke client-IP-adressen toegang hebben tot deze tunnel.Toegangsbeheer
Vervaldatum, Snelheidslimieten, Bandbreedtelimiet, BandbreedteverbruikVervaldatum, upload- en downloadsnelheidslimieten, een limiet voor dataoverdracht, en Wissen om het vastgelegde verbruik te resetten.Limieten en vervaldatum
Uitgaande poortKies een vaste uitgaande poort voor de serververbinding van de Localtonet-app.Poorten
Bandbreedteverkeer, Verzoeklogboek, Activiteitenlogboek, TunnelgezondheidVerkeer in de tijd, vastgelegde verzoeken, starts, stops en instellingswijzigingen, en recente resultaten van gezondheidscontroles.Logboeken en inspectie

In de tunnellijst heeft de kolom Webhooks een knop Verzoek- & responslogboeken bekijken die de request-inspector opent voor een gestarte tunnel. Zie Logboeken en inspectie.

Probleemoplossing #

De gateway start niet of het adres antwoordt niet

Controleer de versie van de Localtonet-app op het apparaat: MCP-gateway vereist minstens Desktop v7.8 of Mobile v10.1. Controleer daarna of de tunnel is gestart en of de kolom Verbinding het apparaat als verbonden toont.

Het gatewaydashboard laadt zijn gegevens niet

De beheerverzoeken van het dashboard hebben het admintoken nodig. Het veld Admin token is leeg of onjuist. Kopieer het Gatewaytoken opnieuw uit de Instellingen van de tunnel en plak het in het veld.

De MCP-client wordt geweigerd

Het MCP-endpoint vereist een clienttoken in de header Authorization: Bearer. Maak er een aan onder Clients in het gatewaydashboard en gebruik dat hier, niet het Gatewaytoken.

"Start eerst je tunnel."

De request-inspector is alleen beschikbaar terwijl de tunnel is gestart.

"Je moet een domein aanmaken in DNS-beheer!" of "WAARSCHUWING! Je hebt geen domein!"

Eigen domein vereist een van je eigen domeinen. Voeg er een toe in DNS-beheer, of kies een ander URL-type.

"Je moet saldo kopen om deze functie te gebruiken."

Eigen subdomein en Eigen domein vereisen saldo. Gebruik Willekeurig subdomein of voeg saldo toe. Zie Abonnementen en saldo.

Support