Vai al contenuto
Localtonet Localtonet Dashboard

Server MCP di Localtonet

Aiuto su questa pagina
In questa pagina 9 sezioni
  1. Cos'è e cosa non è
  2. Dettagli di connessione
  3. Prima di iniziare
  4. Connetti il tuo client MCP
  5. Aggiungi il server al client
  6. Verifica la connessione
  7. Crea un tunnel
  8. Strumenti
  9. Tunnel
  10. Configurazione del tunnel
  11. AuthToken e gruppi di token
  12. Server e provider SSO
  13. Accesso VPN sui tunnel proxy
  14. Dispositivi
  15. Limiti
  16. Sicurezza
  17. Risoluzione dei problemi
  18. 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 #

ImpostazioneValore
Endpointhttps://localtonet.com/mcp
TrasportoStreamable HTTP
AutenticazioneLa tua chiave API come token Bearer: Authorization: Bearer <YOUR_API_KEY>
Informazioni sul serverlocaltonet.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 Authorization personalizzata.
  • 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 #

  1. 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.

  2. 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:

    Prompt
    List my Localtonet tunnels and tell me which ones are running.
  3. Crea un tunnel #

    Descrivi cosa vuoi. Ad esempio:

    Prompt
    Create 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 #

ScopoStrumenti
IspezioneGetTunnels, GetTunnel, GetTunnelRequestLogs
CreazioneCreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel
EsecuzioneStartTunnel, StopTunnel, DeleteTunnel
ModificaUpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType
Operazioni in bloccoBulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType

Configurazione del tunnel #

ImpostazioneStrumenti
Restrizioni IPGetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions
Controlli di accessoGetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls
Intestazioni e autenticazioneGetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication
Scadenza e limitiGetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage
Server e portaGetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer
Argomenti e notaGetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote
Client proxy a rotazione e gruppi di tokenGetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups
Impostazioni avanzateGetAdvancedTunnelSettings, 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 #

ScopoStrumenti
AuthTokenGetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken
Modalità aereo e cambio IPGetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink
Gruppi di tokenGetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup

Server e provider SSO #

ScopoStrumenti
ServerGetAvailableServers
Provider SSOGetSsoProviders, 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 #

StrumentoCosa fa
ListDevicesElenca i computer associati al tuo account in I miei dispositivi, indicando se ciascuno è online e il suo utilizzo di CPU, memoria e disco.
GetDeviceMetricsRestituisce gli ultimi valori di CPU, memoria, disco e uptime di un dispositivo.
RunDeviceCommandEsegue 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 429 significa: 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, Stop e Set.
  • Dai la chiave di accesso del dispositivo per RunDeviceCommand solo 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.

Supporto