Server MCP di Localtonet
In questa pagina 9 sezioni
- Cos'è e cosa non è
- Dettagli di connessione
- Prima di iniziare
- Connetti il tuo client MCP
- Aggiungi il server al client
- Verifica la connessione
- Crea un tunnel
- Strumenti
- Tunnel
- Configurazione del tunnel
- AuthToken e gruppi di token
- Server e provider SSO
- Accesso VPN sui tunnel proxy
- Dispositivi
- Limiti
- Sicurezza
- Risoluzione dei problemi
- Pagine correlate
Il server MCP di Localtonet permette a un assistente AI che supporta il Model Context Protocol, come Claude o Cursor, di gestire il tuo account in linguaggio naturale: elencare, creare, avviare, fermare e configurare tunnel, e gestire AuthToken, gruppi di token, server e provider SSO.
Cos'è e cosa non è #
- Il server MCP di questa pagina è gestito da Localtonet all'indirizzo
https://localtonet.com/mcp. I suoi strumenti agiscono sul tuo account Localtonet, come fa la REST API. - Il Gateway MCP è un tipo di tunnel. Dà un indirizzo pubblico a un server MCP che gira sul tuo dispositivo. Usalo per pubblicare i tuoi strumenti, non per gestire Localtonet.
Dettagli di connessione #
| Impostazione | Valore |
|---|---|
| Endpoint | https://localtonet.com/mcp |
| Trasporto | Streamable HTTP |
| Autenticazione | La tua chiave API come token Bearer: Authorization: Bearer <YOUR_API_KEY> |
| Informazioni sul server | localtonet.com/mcp-info (JSON) e la server card all'indirizzo https://localtonet.com/.well-known/mcp-server-card |
Prima di iniziare #
- Un client MCP in grado di connettersi a un server remoto tramite Streamable HTTP e di inviare un'intestazione
Authorizationpersonalizzata. - La tua chiave API. Apri la Dashboard e usa Copia nella scheda Chiave API. Vedi Account e sicurezza.
- Per lavorare con i tunnel: un dispositivo con il client Localtonet connesso, in modo che l'assistente abbia un AuthToken su cui creare i tunnel.
Connetti il tuo client MCP #
-
Aggiungi il server al client #
La maggior parte dei client MCP accetta un server remoto come URL più intestazioni. La forma abituale è:
Configurazione del client MCP{ "mcpServers": { "localtonet": { "type": "http", "url": "https://localtonet.com/mcp", "headers": { "Authorization": "Bearer <YOUR_API_KEY>" } } } }Il nome del file e i nomi esatti delle chiavi cambiano da client a client. Consulta la documentazione del tuo client per sapere dove si configurano i server MCP remoti e usa l'URL e l'intestazione indicati sopra.
-
Verifica la connessione #
Ricarica il client. Gli strumenti di Localtonet dovrebbero comparire nel suo elenco di strumenti. Come prima cosa chiedi qualcosa di innocuo, ad esempio:
PromptList my Localtonet tunnels and tell me which ones are running. -
Crea un tunnel #
Descrivi cosa vuoi. Ad esempio:
PromptCreate an HTTP tunnel with a random subdomain for port 3000 on my device "laptop", then start it and give me the URL.L'assistente segue il flusso di lavoro prescritto dal server: cerca l'AuthToken del dispositivo, sceglie un server, chiama lo strumento di creazione corrispondente e avvia il tunnel, perché un tunnel appena creato non è in esecuzione.
Strumenti #
I nomi degli strumenti qui sotto sono quelli che mostra il tuo client. Uno strumento che fallisce restituisce un messaggio che inizia con Error:.
Tunnel #
| Scopo | Strumenti |
|---|---|
| Ispezione | GetTunnels, GetTunnel, GetTunnelRequestLogs |
| Creazione | CreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel |
| Esecuzione | StartTunnel, StopTunnel, DeleteTunnel |
| Modifica | UpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType |
| Operazioni in blocco | BulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType |
Configurazione del tunnel #
| Impostazione | Strumenti |
|---|---|
| Restrizioni IP | GetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions |
| Controlli di accesso | GetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls |
| Intestazioni e autenticazione | GetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication |
| Scadenza e limiti | GetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage |
| Server e porta | GetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer |
| Argomenti e nota | GetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote |
| Client proxy a rotazione e gruppi di token | GetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups |
| Impostazioni avanzate | GetAdvancedTunnelSettings, GetTunnelIpv4Only, SetTunnelIpv4Only, GetTunnelWifiSplit, SetTunnelWifiSplit, SetTunnelSslStream, GetTunnelProxyProtocol, SetTunnelProxyProtocol, GetTunnelPassThrough, SetTunnelPassThrough, GetTunnelHttpsOnly, SetTunnelHttpsOnly, GetTunnelHttp3, SetTunnelHttp3, GetTunnelFilePath, SetTunnelFilePath, GetTunnelHostHeader, SetTunnelHostHeader, GetTunnelPathRewrite, SetTunnelPathRewrite, GetTunnelUpstreamProxy, SetTunnelUpstreamProxy, GetTunnelVless, SetTunnelVless |
Cosa fanno le impostazioni è descritto nel Riferimento delle impostazioni.
AuthToken e gruppi di token #
| Scopo | Strumenti |
|---|---|
| AuthToken | GetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken |
| Modalità aereo e cambio IP | GetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink |
| Gruppi di token | GetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup |
Server e provider SSO #
| Scopo | Strumenti |
|---|---|
| Server | GetAvailableServers |
| Provider SSO | GetSsoProviders, GetSsoProviderDefaultEndpoints, SaveSsoProvider, DeleteSsoProvider, GetSsoProvidersForTunnel, SetSsoProvidersForTunnel |
Accesso VPN sui tunnel proxy #
GetVpnAccessDevices, CreateVpnAccessDevice, GetVpnAccessDeviceConfig, GetVpnAccessDeviceCredentials, RegenerateVpnAccessDevice, DeleteVpnAccessDevice. Questi strumenti gestiscono i dispositivi WireGuard e OpenVPN su un tunnel proxy. Ogni dispositivo ha una propria configurazione e tutto il suo traffico esce attraverso il proxy.
Dispositivi #
| Strumento | Cosa fa |
|---|---|
ListDevices | Elenca i computer associati al tuo account in I miei dispositivi, indicando se ciascuno è online e il suo utilizzo di CPU, memoria e disco. |
GetDeviceMetrics | Restituisce gli ultimi valori di CPU, memoria, disco e uptime di un dispositivo. |
RunDeviceCommand | Esegue un comando shell su un dispositivo e restituisce il suo output e il codice di uscita. Attende fino al timeout indicato, da 1 a 120 secondi, 30 per impostazione predefinita. |
RunDeviceCommand richiede più della chiave API: serve una chiave di accesso del dispositivo (inizia con ltd_) che crei per quel dispositivo in I miei dispositivi. Vedi Terminale dispositivo. Un'esecuzione compare nella cronologia delle connessioni del dispositivo con l'ora e l'indirizzo IP; il comando non viene memorizzato.
Limiti #
- Le richieste al server MCP hanno un limite di frequenza, calcolato insieme alle richieste API della tua chiave API. Una risposta
429significa: attendi, poi riprova. - Gli strumenti in blocco accettano un elenco di massimo 100 elementi.
Sicurezza #
L'assistente agisce con la tua chiave API. I suoi strumenti possono creare, fermare ed eliminare tunnel, eliminare AuthToken e gruppi di token e modificare le regole di accesso, senza un passaggio di conferma da parte di Localtonet.
- Attiva la conferma per le chiamate agli strumenti nel tuo client MCP, almeno per gli strumenti che iniziano con
Delete,BulkDelete,StopeSet. - Dai la chiave di accesso del dispositivo per
RunDeviceCommandsolo a un assistente a cui daresti anche un terminale su quel computer. Un comando viene eseguito dalla shell predefinita del dispositivo. - Tratta il file di configurazione del client come un segreto: contiene la tua chiave API. Non inserirlo in un repository.
- Se la chiave potrebbe essere trapelata, seleziona Cambia nella scheda Chiave API della dashboard. Questo crea una nuova chiave e invalida la vecchia; poi aggiorna il tuo client MCP.
- Con una chiave API copiata in una dashboard di team, l'assistente elenca solo i tuoi AuthToken e i tuoi tunnel in quel team. Vedi Gestione team.
Risoluzione dei problemi #
Il client riporta 401, oppure "API key is required. Provide Authorization: Bearer <apikey>"
La richiesta non ha un'intestazione Authorization valida. Verifica che il client invii intestazioni personalizzate per questo server, che il valore sia Bearer, uno spazio, poi la chiave, e che la chiave non sia stata cambiata nella dashboard dopo che l'hai copiata.
L'assistente dice che uno strumento ha restituito "Error: …"
Questa è la risposta di Localtonet, non un problema di connessione. Il testo dopo Error: indica cosa è stato rifiutato, ad esempio un AuthToken mancante o un limite del piano. Correggi quella causa invece di lasciare che l'assistente riprovi.
Il tunnel è stato creato ma non risponde
Chiedi all'assistente di avviarlo. Un nuovo tunnel resta fermo finché non viene chiamato StartTunnel, e il client Localtonet del dispositivo deve essere connesso.
Nel mio client mancano degli strumenti
Alcuni client limitano il numero di strumenti o ti chiedono di abilitarli uno per uno. Abilita gli strumenti Localtonet che ti servono nelle impostazioni del client.