Esporre gli strumenti MCP con un tunnel Gateway MCP
Desktop v7.8+ Mobile v10.1+
In questa pagina 8 sezioni
- Cos'è
- Prima di iniziare
- Creare il gateway
- Aprire la pagina Gateway MCP
- Compila il modulo
- Avvia il tunnel
- Tipi di URL
- Token del gateway
- Connettere un client MCP
- Aprire la dashboard del gateway
- Registrare i tuoi server MCP
- Creare un token del client
- Indirizzare il client MCP al gateway
- Impostazioni
- Risoluzione dei problemi
- 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 #
-
Aprire la pagina Gateway MCP #
Apri I miei tunnel › Gateway MCP ed espandi Crea tunnel Gateway MCP.
-
Compila il modulo #
Campo Cosa inserire Tipo di URL Sottodominio casuale, Sottodominio personalizzato o Dominio personalizzato. Vedi la tabella qui sotto. Token del dispositivo Il token del dispositivo che esegue i tuoi strumenti. Regione del server Il server a cui si connettono i tuoi client MCP. Sottodominio Mostrato per Sottodominio personalizzato: il nome che desideri. Dominio Il dominio dell'indirizzo. Seleziona Crea tunnel.
-
Avvia il tunnel #
Il gateway compare in I tuoi tunnel. Seleziona Avvia. La colonna URL mostra l'indirizzo pubblico.
Tipi di URL #
| Tipo di URL | Indirizzo ottenuto | Note |
|---|---|---|
| Sottodominio casuale | Un nome generato sotto il dominio che selezioni. | Adatto a un primo test. |
| Sottodominio personalizzato | Il Sottodominio che inserisci sotto il Dominio che selezioni. | Richiede saldo. |
| Dominio personalizzato | Uno 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.
- Seleziona l'icona Impostazioni del tunnel.
- Accanto a Token del gateway seleziona Gestisci. La finestra Token del gateway mostra il token con la parte centrale nascosta.
- 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 #
-
Aprire la dashboard del gateway #
Con il tunnel avviato, apri
https://<ADDRESS>/dashboardin un browser. Incolla il token del gateway nel campo Admin token in fondo al menu laterale. -
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.
-
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.
-
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 MCPURL: 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.
| Impostazione | Cosa fa | Altro |
|---|---|---|
| Bilanciamento del carico | Distribuisce 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 gateway | Gestisci il token di accesso di questo Gateway MCP. | Vedi sopra |
| Timeout HTTP | Per 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 tunnel | Salva una nota privata per identificare o documentare questo tunnel. | Riferimento delle impostazioni |
| Restrizione IP | Controlla quali indirizzi IP dei client possono accedere a questo tunnel. | Controllo degli accessi |
| Data di scadenza, Limiti di velocità, Limite di banda, Utilizzo di banda | Data 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 uscita | Scegli una porta in uscita fissa per la connessione dell'app Localtonet al server. | Porte |
| Traffico di banda, Registro richieste, Registro attività, Salute del tunnel | Il 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.