Vai al contenuto
Localtonet Localtonet Dashboard

Esporre gli strumenti MCP con un tunnel Gateway MCP

Desktop v7.8+ Mobile v10.1+

Aiuto su questa pagina
In questa pagina 8 sezioni
  1. Cos'è
  2. Prima di iniziare
  3. Creare il gateway
  4. Aprire la pagina Gateway MCP
  5. Compila il modulo
  6. Avvia il tunnel
  7. Tipi di URL
  8. Token del gateway
  9. Connettere un client MCP
  10. Aprire la dashboard del gateway
  11. Registrare i tuoi server MCP
  12. Creare un token del client
  13. Indirizzare il client MCP al gateway
  14. Impostazioni
  15. Risoluzione dei problemi
  16. Pagine correlate

Un tunnel Gateway MCP collega i client MCP e gli assistenti IA agli strumenti in esecuzione sul tuo dispositivo tramite un gateway pubblico. Il client Localtonet esegue il gateway per te e il tunnel gli dà un indirizzo HTTPS pubblico.

Cos'è #

Il Model Context Protocol (MCP) permette a un assistente IA di richiamare degli strumenti. Un gateway MCP si pone davanti ai server MCP che esegui e offre tutti i loro strumenti attraverso un unico endpoint.

Quando avvii un tunnel Gateway MCP, il client Localtonet avvia un gateway sul tuo dispositivo e Localtonet lo pubblica all'indirizzo del tunnel. Non devi inserire alcun IP o porta locale. Il gateway ha:

  • una dashboard web all'indirizzo https://<ADDRESS>/dashboard, dove registri i server MCP e crei i token dei client;
  • l'endpoint MCP all'indirizzo https://<ADDRESS>/mcp, a cui si connettono i tuoi client MCP.

Non è la stessa cosa del server MCP di Localtonet. Questa pagina riguarda la pubblicazione dei tuoi strumenti. Per consentire a un assistente IA di gestire il tuo account Localtonet (tunnel, token e così via), vedi Server MCP.

Prima di iniziare #

  • Il client Localtonet è in esecuzione sul dispositivo ed è connesso con un AuthToken. Vedi Avvio rapido.
  • Il client è abbastanza recente. Versioni minime dell'app Localtonet necessarie per usare questa funzione: Desktop v7.8, Mobile v10.1.

Creare il gateway #

  1. Aprire la pagina Gateway MCP #

    Apri I miei tunnel › Gateway MCP ed espandi Crea tunnel Gateway MCP.

  2. Compila il modulo #

    CampoCosa inserire
    Tipo di URLSottodominio casuale, Sottodominio personalizzato o Dominio personalizzato. Vedi la tabella qui sotto.
    Token del dispositivoIl token del dispositivo che esegue i tuoi strumenti.
    Regione del serverIl server a cui si connettono i tuoi client MCP.
    SottodominioMostrato per Sottodominio personalizzato: il nome che desideri.
    DominioIl dominio dell'indirizzo.

    Seleziona Crea tunnel.

  3. Avvia il tunnel #

    Il gateway compare in I tuoi tunnel. Seleziona Avvia. La colonna URL mostra l'indirizzo pubblico.

Tipi di URL #

Tipo di URLIndirizzo ottenutoNote
Sottodominio casualeUn nome generato sotto il dominio che selezioni.Adatto a un primo test.
Sottodominio personalizzatoIl Sottodominio che inserisci sotto il Dominio che selezioni.Richiede saldo.
Dominio personalizzatoUno dei tuoi domini.Richiede saldo. L'elenco Dominio mostra i tuoi domini; se è vuoto, crea prima un dominio da Gestore DNS. Vedi Domini personalizzati.

Token del gateway #

Ogni tunnel Gateway MCP riceve alla creazione un proprio token del gateway. È il token di amministrazione del gateway: la dashboard del gateway e la sua API di gestione accettano modifiche solo con questo token.

  1. Seleziona l'icona Impostazioni del tunnel.
  2. Accanto a Token del gateway seleziona Gestisci. La finestra Token del gateway mostra il token con la parte centrale nascosta.
  3. Seleziona il pulsante di copia accanto al token. Copia sempre il token completo. Il pulsante di visualizzazione accanto mostra il token sullo schermo.

Tieni privato il token del gateway. Dà il controllo completo del gateway: dei suoi server, strumenti e token dei client. Non inserirlo in un client MCP; i client usano un proprio token.

Connettere un client MCP #

  1. Aprire la dashboard del gateway #

    Con il tunnel avviato, apri https://<ADDRESS>/dashboard in un browser. Incolla il token del gateway nel campo Admin token in fondo al menu laterale.

  2. Registrare i tuoi server MCP #

    Apri Servers e seleziona Add Server. Un server può essere un server MCP raggiunto tramite URL (Streamable HTTP o SSE), un comando locale (stdio) o un servizio OpenAPI. Catalog elenca server MCP già pronti che puoi installare e Tools mostra gli strumenti che il gateway ha raccolto da tutti i server.

  3. Creare un token del client #

    Apri Clients e seleziona New Client. Inserisci un Name e seleziona Create Client. Il gateway mostra il Client Token una sola volta: copialo subito, non verrà più mostrato. Nell'elenco dei client, Allowed Servers e Allowed Groups indicano quali server e gruppi di strumenti un client può usare.

  4. Indirizzare il client MCP al gateway #

    Nel tuo client MCP o assistente IA, aggiungi un server MCP remoto con questi due valori:

    Impostazioni del client MCP
    URL:     https://<ADDRESS>/mcp
    Header:  Authorization: Bearer <CLIENT_TOKEN>

    Dove inserirli dipende dal client; segui la sua documentazione per i server MCP remoti (HTTP).

Audit Log della dashboard mostra le richieste recenti al gateway, mentre Settings contiene la configurazione del gateway con backup e ripristino.

Il gateway conserva i suoi server, gruppi, client e il registro di audit sul tuo dispositivo, in una cartella chiamata mcp-data-<TUNNEL_ID> nella directory di lavoro del client Localtonet (su Android, nello spazio di archiviazione dell'app). <TUNNEL_ID> è il numero nella colonna ID, quindi ogni tunnel Gateway MCP ha una propria cartella.

Impostazioni #

Seleziona l'icona Impostazioni del tunnel per aprire Impostazioni del tunnel.

ImpostazioneCosa faAltro
Bilanciamento del caricoDistribuisce il traffico tra più dispositivi oppure usa un backup quando un target non è disponibile.Bilanciamento del carico
Solo HTTPS?Usa solo HTTPS per l'endpoint pubblico del tunnel.Riferimento delle impostazioni
Autenticazione Basic?Richiede un nome utente e una password per accedere a questo tunnel.Controllo degli accessi
HTTP/3 attivo?Permette ai client di connettersi all'endpoint pubblico usando HTTP/3.Riferimento delle impostazioni
Connessione legacy?Provala se il tunnel non riesce a connettersi con il metodo di connessione normale.Riferimento delle impostazioni
Token del gatewayGestisci il token di accesso di questo Gateway MCP.Vedi sopra
Timeout HTTPPer quanto tempo il server attende una risposta dalla tua applicazione locale prima di interrompere la richiesta, da 1 a 600 secondi. Lascialo vuoto per usare il valore predefinito del server.Riferimento delle impostazioni
Nota del tunnelSalva una nota privata per identificare o documentare questo tunnel.Riferimento delle impostazioni
Restrizione IPControlla quali indirizzi IP dei client possono accedere a questo tunnel.Controllo degli accessi
Data di scadenza, Limiti di velocità, Limite di banda, Utilizzo di bandaData di scadenza, limiti di velocità di upload e download, un limite di trasferimento dati e Cancella per azzerare l'utilizzo registrato.Limiti e scadenza
Porta in uscitaScegli una porta in uscita fissa per la connessione dell'app Localtonet al server.Porte
Traffico di banda, Registro richieste, Registro attività, Salute del tunnelIl traffico nel tempo, le richieste registrate, gli avvii, gli arresti e le modifiche alle impostazioni, e i risultati recenti dei controlli di integrità.Log e ispezione

Nell'elenco dei tunnel, la colonna Webhook ha un pulsante Visualizza i log di richieste e risposte che apre l'ispettore delle richieste per un tunnel avviato. Vedi Log e ispezione.

Risoluzione dei problemi #

Il gateway non si avvia o l'indirizzo non risponde

Controlla la versione dell'app Localtonet sul dispositivo: il Gateway MCP richiede almeno Desktop v7.8 o Mobile v10.1. Poi controlla che il tunnel sia avviato e che la colonna Connessione mostri il dispositivo come connesso.

La dashboard del gateway non carica i suoi dati

Le richieste di gestione della dashboard richiedono il token di amministrazione. Il campo Admin token è vuoto o errato. Copia di nuovo il token del gateway dalle Impostazioni del tunnel e incollalo nel campo.

Il client MCP viene rifiutato

L'endpoint MCP richiede un token del client nell'header Authorization: Bearer. Creane uno in Clients nella dashboard del gateway e usalo qui, non il token del gateway.

"Prima avvia il tuo tunnel."

L'ispettore delle richieste è disponibile solo mentre il tunnel è avviato.

"Devi creare un dominio dal Gestore DNS!" oppure "ATTENZIONE! Non hai alcun dominio!"

Dominio personalizzato richiede uno dei tuoi domini. Aggiungilo in Gestore DNS, oppure scegli un altro tipo di URL.

"Devi acquistare del saldo per usare questa funzione."

Sottodominio personalizzato e Dominio personalizzato richiedono saldo. Usa Sottodominio casuale oppure aggiungi saldo. Vedi Piani e saldo.

Supporto