Servidor MCP do Localtonet
Nesta página 9 seções
- O que ele é e o que ele não é
- Detalhes da conexão
- Antes de começar
- Conecte o seu cliente MCP
- Adicione o servidor ao cliente
- Verifique a conexão
- Crie um túnel
- Ferramentas
- Túneis
- Configuração do túnel
- AuthTokens e grupos de tokens
- Servidores e provedores de SSO
- Acesso VPN em túneis de proxy
- Dispositivos
- Limites
- Segurança
- Solução de problemas
- Páginas relacionadas
O servidor MCP do Localtonet permite que um assistente de IA compatível com o Model Context Protocol, como o Claude ou o Cursor, gerencie a sua conta em linguagem natural: listar, criar, iniciar, parar e configurar túneis, e gerenciar AuthTokens, grupos de tokens, servidores e provedores de SSO.
O que ele é e o que ele não é #
- O servidor MCP desta página é operado pelo Localtonet em
https://localtonet.com/mcp. As ferramentas dele atuam na sua conta Localtonet, da mesma forma que a API REST. - O Gateway MCP é um tipo de túnel. Ele dá um endereço público a um servidor MCP que roda no seu próprio dispositivo. Use-o para publicar as suas próprias ferramentas, não para gerenciar o Localtonet.
Detalhes da conexão #
| Configuração | Valor |
|---|---|
| Endpoint | https://localtonet.com/mcp |
| Transporte | HTTP com streaming (Streamable HTTP) |
| Autenticação | Sua chave de API como um token Bearer: Authorization: Bearer <YOUR_API_KEY> |
| Informações do servidor | localtonet.com/mcp-info (JSON) e o cartão do servidor em https://localtonet.com/.well-known/mcp-server-card |
Antes de começar #
- Um cliente MCP que consiga se conectar a um servidor remoto por Streamable HTTP e enviar um cabeçalho
Authorizationpersonalizado. - Sua chave de API. Abra o Painel e use Copiar no cartão Chave de API. Veja Conta e segurança.
- Para trabalhar com túneis: um dispositivo com o cliente Localtonet conectado, para que o assistente tenha um AuthToken no qual criar túneis.
Conecte o seu cliente MCP #
-
Adicione o servidor ao cliente #
A maioria dos clientes MCP aceita um servidor remoto como uma URL mais cabeçalhos. O formato usual é:
Configuração do cliente MCP{ "mcpServers": { "localtonet": { "type": "http", "url": "https://localtonet.com/mcp", "headers": { "Authorization": "Bearer <YOUR_API_KEY>" } } } }O nome do arquivo e os nomes exatos das chaves variam entre os clientes. Consulte a documentação do seu cliente para saber onde os servidores MCP remotos são configurados e use a URL e o cabeçalho indicados acima.
-
Verifique a conexão #
Recarregue o cliente. As ferramentas do Localtonet devem aparecer na lista de ferramentas dele. Comece perguntando algo inofensivo, por exemplo:
PromptList my Localtonet tunnels and tell me which ones are running. -
Crie um túnel #
Descreva o que você quer. Por exemplo:
PromptCreate an HTTP tunnel with a random subdomain for port 3000 on my device "laptop", then start it and give me the URL.O assistente segue o fluxo de trabalho que o servidor prescreve: ele consulta o AuthToken do dispositivo, escolhe um servidor, chama a ferramenta de criação correspondente e inicia o túnel, porque um túnel recém-criado não está em execução.
Ferramentas #
Os nomes de ferramentas abaixo são os nomes que o seu cliente mostra. Uma ferramenta que falha retorna uma mensagem que começa com Error:.
Túneis #
| Finalidade | Ferramentas |
|---|---|
| Consultar | GetTunnels, GetTunnel, GetTunnelRequestLogs |
| Criar | CreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel |
| Executar | StartTunnel, StopTunnel, DeleteTunnel |
| Alterar | UpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType |
| Em lote | BulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType |
Configuração do túnel #
| Configuração | Ferramentas |
|---|---|
| Restrições de IP | GetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions |
| Controles de acesso | GetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls |
| Cabeçalhos e autenticação | GetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication |
| Expiração e limites | GetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage |
| Servidor e porta | GetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer |
| Argumentos e nota | GetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote |
| Clientes de proxy rotativo e grupos de tokens | GetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups |
| Configurações avançadas | GetAdvancedTunnelSettings, GetTunnelIpv4Only, SetTunnelIpv4Only, GetTunnelWifiSplit, SetTunnelWifiSplit, SetTunnelSslStream, GetTunnelProxyProtocol, SetTunnelProxyProtocol, GetTunnelPassThrough, SetTunnelPassThrough, GetTunnelHttpsOnly, SetTunnelHttpsOnly, GetTunnelHttp3, SetTunnelHttp3, GetTunnelFilePath, SetTunnelFilePath, GetTunnelHostHeader, SetTunnelHostHeader, GetTunnelPathRewrite, SetTunnelPathRewrite, GetTunnelUpstreamProxy, SetTunnelUpstreamProxy, GetTunnelVless, SetTunnelVless |
O que cada configuração faz está descrito na Referência de configurações.
AuthTokens e grupos de tokens #
| Finalidade | Ferramentas |
|---|---|
| AuthTokens | GetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken |
| Modo avião e troca de IP | GetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink |
| Grupos de tokens | GetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup |
Servidores e provedores de SSO #
| Finalidade | Ferramentas |
|---|---|
| Servidores | GetAvailableServers |
| Provedores de SSO | GetSsoProviders, GetSsoProviderDefaultEndpoints, SaveSsoProvider, DeleteSsoProvider, GetSsoProvidersForTunnel, SetSsoProvidersForTunnel |
Acesso VPN em túneis de proxy #
GetVpnAccessDevices, CreateVpnAccessDevice, GetVpnAccessDeviceConfig, GetVpnAccessDeviceCredentials, RegenerateVpnAccessDevice, DeleteVpnAccessDevice. Essas ferramentas gerenciam dispositivos WireGuard e OpenVPN em um túnel de proxy. Cada dispositivo recebe a própria configuração, e todo o tráfego dele sai pelo proxy.
Dispositivos #
| Ferramenta | O que faz |
|---|---|
ListDevices | Lista os computadores pareados com a sua conta em Meus dispositivos, indicando se cada um está online e o uso de CPU, memória e disco. |
GetDeviceMetrics | Retorna os valores mais recentes de CPU, memória, disco e tempo de atividade de um dispositivo. |
RunDeviceCommand | Executa um comando de shell em um dispositivo e retorna a saída e o código de saída. Aguarda até o tempo limite que você definir, de 1 a 120 segundos, 30 por padrão. |
RunDeviceCommand precisa de mais do que a chave de API: exige uma chave de acesso do dispositivo (que começa com ltd_) que você cria para esse dispositivo em Meus dispositivos. Veja Terminal de dispositivo. Uma execução aparece no histórico de conexões do dispositivo com a hora e o endereço IP; o comando não é armazenado.
Limites #
- As requisições ao servidor MCP têm limite de taxa, somadas às requisições de API da sua chave de API. Uma resposta
429significa: aguarde e tente de novo. - As ferramentas em lote aceitam uma lista de até 100 itens.
Segurança #
O assistente age com a sua chave de API. As ferramentas dele podem criar, parar e excluir túneis, excluir AuthTokens e grupos de tokens e alterar regras de acesso, sem uma etapa de confirmação do lado do Localtonet.
- Ative a confirmação de chamadas de ferramentas no seu cliente MCP, pelo menos para as ferramentas que começam com
Delete,BulkDelete,StopeSet. - Dê a chave de acesso do dispositivo para
RunDeviceCommandsomente a um assistente a quem você também daria um terminal naquele computador. Um comando é executado pelo shell padrão do dispositivo. - Trate o arquivo de configuração do cliente como um segredo: ele contém a sua chave de API. Não o envie por commit para um repositório.
- Se a chave pode ter vazado, selecione Alterar no cartão Chave de API do painel. Isso cria uma nova chave e invalida a antiga; depois, atualize o seu cliente MCP.
- Com uma chave de API copiada em um painel de equipe, o assistente lista apenas os seus AuthTokens e túneis nessa equipe. Veja Gerenciamento de equipe.
Solução de problemas #
O cliente informa 401 ou "API key is required. Provide Authorization: Bearer <apikey>"
A requisição não tem um cabeçalho Authorization válido. Verifique se o cliente envia cabeçalhos personalizados para este servidor, se o valor é Bearer, um espaço e depois a chave, e se a chave não foi alterada no painel desde que você a copiou.
O assistente diz que uma ferramenta retornou "Error: …"
Essa é a resposta do Localtonet, não um problema de conexão. O texto depois de Error: diz o que foi recusado, por exemplo um AuthToken ausente ou um limite do plano. Corrija essa causa em vez de deixar o assistente tentar de novo.
O túnel foi criado, mas não responde
Peça ao assistente para iniciá-lo. Um novo túnel fica parado até que StartTunnel seja chamada, e o cliente Localtonet do dispositivo precisa estar conectado.
Faltam ferramentas no meu cliente
Alguns clientes limitam o número de ferramentas ou pedem que você as habilite uma a uma. Habilite nas configurações do cliente as ferramentas do Localtonet de que você precisa.