Ir para o conteúdo
Localtonet Localtonet Painel

Servidor MCP do Localtonet

Ajuda com esta página
Nesta página 9 seções
  1. O que ele é e o que ele não é
  2. Detalhes da conexão
  3. Antes de começar
  4. Conecte o seu cliente MCP
  5. Adicione o servidor ao cliente
  6. Verifique a conexão
  7. Crie um túnel
  8. Ferramentas
  9. Túneis
  10. Configuração do túnel
  11. AuthTokens e grupos de tokens
  12. Servidores e provedores de SSO
  13. Acesso VPN em túneis de proxy
  14. Dispositivos
  15. Limites
  16. Segurança
  17. Solução de problemas
  18. 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çãoValor
Endpointhttps://localtonet.com/mcp
TransporteHTTP com streaming (Streamable HTTP)
AutenticaçãoSua chave de API como um token Bearer: Authorization: Bearer <YOUR_API_KEY>
Informações do servidorlocaltonet.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 Authorization personalizado.
  • 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 #

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

  2. Verifique a conexão #

    Recarregue o cliente. As ferramentas do Localtonet devem aparecer na lista de ferramentas dele. Comece perguntando algo inofensivo, por exemplo:

    Prompt
    List my Localtonet tunnels and tell me which ones are running.
  3. Crie um túnel #

    Descreva o que você quer. Por exemplo:

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

FinalidadeFerramentas
ConsultarGetTunnels, GetTunnel, GetTunnelRequestLogs
CriarCreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel
ExecutarStartTunnel, StopTunnel, DeleteTunnel
AlterarUpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType
Em loteBulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType

Configuração do túnel #

ConfiguraçãoFerramentas
Restrições de IPGetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions
Controles de acessoGetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls
Cabeçalhos e autenticaçãoGetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication
Expiração e limitesGetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage
Servidor e portaGetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer
Argumentos e notaGetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote
Clientes de proxy rotativo e grupos de tokensGetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups
Configurações avançadasGetAdvancedTunnelSettings, 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 #

FinalidadeFerramentas
AuthTokensGetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken
Modo avião e troca de IPGetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink
Grupos de tokensGetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup

Servidores e provedores de SSO #

FinalidadeFerramentas
ServidoresGetAvailableServers
Provedores de SSOGetSsoProviders, 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 #

FerramentaO que faz
ListDevicesLista 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.
GetDeviceMetricsRetorna os valores mais recentes de CPU, memória, disco e tempo de atividade de um dispositivo.
RunDeviceCommandExecuta 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 429 significa: 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, Stop e Set.
  • Dê a chave de acesso do dispositivo para RunDeviceCommand somente 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.

Suporte