Exponha ferramentas MCP com um túnel de Gateway MCP
Desktop v7.8+ Mobile v10.1+
Nesta página 8 seções
- O que é
- Antes de começar
- Crie o gateway
- Abra a página Gateway MCP
- Preencha o formulário
- Inicie o túnel
- Tipos de URL
- Token do gateway
- Conecte um cliente MCP
- Abra o painel do gateway
- Registre os seus servidores MCP
- Crie um token de cliente
- Aponte o cliente MCP para o gateway
- Configurações
- Solução de problemas
- Páginas relacionadas
Um túnel de Gateway MCP conecta clientes MCP e assistentes de IA a ferramentas que rodam no seu dispositivo por meio de um gateway público. O cliente Localtonet executa o gateway para você, e o túnel dá a ele um endereço HTTPS público.
O que é #
O Model Context Protocol (MCP) permite que um assistente de IA chame ferramentas. Um gateway MCP fica na frente dos servidores MCP que você executa e oferece todas as ferramentas deles por um único endpoint.
Quando você inicia um túnel de Gateway MCP, o cliente Localtonet inicia um gateway no seu dispositivo e a Localtonet o publica no endereço do túnel. Você não informa IP local nem porta. O gateway tem:
- um painel web em
https://<ADDRESS>/dashboard, onde você registra servidores MCP e cria tokens de cliente; - o endpoint MCP em
https://<ADDRESS>/mcp, ao qual os seus clientes MCP se conectam.
Não é o mesmo que o servidor MCP da Localtonet. Esta página trata de publicar as suas próprias ferramentas. Para permitir que um assistente de IA gerencie a sua conta Localtonet (túneis, tokens e assim por diante), veja Servidor MCP.
Antes de começar #
- O cliente Localtonet está em execução no dispositivo e conectado com um AuthToken. Veja o Início rápido.
- O cliente é recente o bastante. Versões mínimas do app Localtonet necessárias para usar este recurso:
Desktop v7.8,Mobile v10.1.
Crie o gateway #
-
Abra a página Gateway MCP #
Abra Meus túneis › Gateway MCP e expanda Criar túnel de Gateway MCP.
-
Preencha o formulário #
Campo O que informar Tipo de URL Subdomínio aleatório, Subdomínio personalizado ou Domínio personalizado. Veja a tabela abaixo. Token do dispositivo O token do dispositivo que executa as suas ferramentas. Região do servidor O servidor ao qual os seus clientes MCP se conectam. Subdomínio Aparece para Subdomínio personalizado: o nome que você quer. Domínio O domínio do endereço. Selecione Criar túnel.
-
Inicie o túnel #
O gateway aparece em Seus túneis. Selecione Iniciar. A coluna URL mostra o endereço público.
Tipos de URL #
| Tipo de URL | Endereço que você recebe | Observações |
|---|---|---|
| Subdomínio aleatório | Um nome gerado sob o domínio que você selecionar. | Bom para um primeiro teste. |
| Subdomínio personalizado | O Subdomínio que você informar sob o Domínio que você selecionar. | Exige Saldo. |
| Domínio personalizado | Um dos seus próprios domínios. | Exige Saldo. A lista Domínio mostra os seus domínios; se estiver vazia, crie antes um domínio no Gerenciador de DNS. Veja Domínios personalizados. |
Token do gateway #
Todo túnel de Gateway MCP recebe o próprio Token do gateway quando é criado. Ele é o token de administrador do gateway: o painel do gateway e a API de gerenciamento dele só aceitam alterações com ele.
- Selecione o ícone de Configurações do túnel.
- Ao lado de Token do gateway, selecione Gerenciar. A janela Token do gateway mostra o token com o meio oculto.
- Selecione o botão de copiar ao lado do token. Ele sempre copia o token completo. O botão de mostrar ao lado dele revela o token na tela.
Mantenha o Token do gateway privado. Ele dá controle total do gateway: seus servidores, ferramentas e tokens de cliente. Não o coloque em um cliente MCP; os clientes usam o próprio token.
Conecte um cliente MCP #
-
Abra o painel do gateway #
Com o túnel iniciado, abra
https://<ADDRESS>/dashboardem um navegador. Cole o Token do gateway no campo Admin token, na parte de baixo do menu lateral. -
Registre os seus servidores MCP #
Abra Servers e selecione Add Server. Um servidor pode ser um servidor MCP acessado por URL (Streamable HTTP ou SSE), um comando local (stdio) ou um serviço OpenAPI. Catalog lista servidores MCP prontos que você pode instalar, e Tools mostra as ferramentas que o gateway coletou de todos os servidores.
-
Crie um token de cliente #
Abra Clients e selecione New Client. Informe um Name e selecione Create Client. O gateway mostra o Client Token uma única vez: copie-o agora, ele não será mostrado de novo. Na lista de clientes, Allowed Servers e Allowed Groups mostram quais servidores e grupos de ferramentas um cliente pode usar.
-
Aponte o cliente MCP para o gateway #
No seu cliente MCP ou assistente de IA, adicione um servidor MCP remoto com estes dois valores:
Configurações do cliente MCPURL: https://<ADDRESS>/mcp Header: Authorization: Bearer <CLIENT_TOKEN>Onde você os informa depende do cliente; siga a documentação dele para servidores MCP remotos (HTTP).
O Audit Log do painel mostra as requisições recentes ao gateway, e Settings guarda a configuração do gateway, com backup e restauração.
O gateway guarda seus servidores, grupos, clientes e log de auditoria no seu dispositivo, em uma pasta chamada mcp-data-<TUNNEL_ID> no diretório de trabalho do cliente Localtonet (no Android, dentro do armazenamento do próprio app). <TUNNEL_ID> é o número da coluna ID, então cada túnel de Gateway MCP tem a própria pasta.
Configurações #
Selecione o ícone de Configurações do túnel para abrir Configurações do túnel.
| Configuração | O que faz | Mais |
|---|---|---|
| Balanceamento de carga | Distribui o tráfego entre dispositivos ou usa um backup quando um destino está indisponível. | Balanceamento de carga |
| Somente HTTPS? | Usa somente HTTPS no endpoint público do túnel. | Referência de configurações |
| Basic Auth? | Exige usuário e senha para acessar este túnel. | Controle de acesso |
| HTTP/3 ativo? | Permite que os clientes se conectem ao endpoint público usando HTTP/3. | Referência de configurações |
| Conexão legada? | Tente isto se o túnel não conseguir se conectar pelo método de conexão normal. | Referência de configurações |
| Token do gateway | Gerencia o token de acesso deste Gateway MCP. | Veja acima |
| Tempo limite HTTP | Quanto tempo o servidor espera por uma resposta da sua aplicação local antes de abortar a requisição, de 1 a 600 segundos. Deixe vazio para usar o padrão do servidor. | Referência de configurações |
| Nota do túnel | Salve uma nota privada para ajudar a identificar ou documentar este túnel. | Referência de configurações |
| Restrição de IP | Controle quais endereços IP de clientes podem acessar este túnel. | Controle de acesso |
| Data de expiração, Limites de velocidade, Limite de banda, Uso de banda | Data de expiração, limites de velocidade de upload e download, um limite de transferência de dados e Limpar para zerar o uso registrado. | Limites e expiração |
| Porta de saída | Escolha uma porta de saída fixa para a conexão do app Localtonet com o servidor. | Portas |
| Tráfego de banda, Log de requisições, Log de atividades, Saúde do túnel | O tráfego ao longo do tempo, as requisições registradas, inícios, paradas e alterações de configuração, e os resultados recentes das verificações de saúde. | Logs e inspeção |
Na lista de túneis, a coluna Webhooks tem um botão Ver logs de requisição e resposta que abre o inspetor de requisições de um túnel iniciado. Veja Logs e inspeção.
Solução de problemas #
O gateway não inicia ou o endereço não responde
Verifique a versão do app Localtonet no dispositivo: o Gateway MCP exige pelo menos Desktop v7.8 ou Mobile v10.1. Depois verifique se o túnel está iniciado e se a coluna Conexão mostra o dispositivo como conectado.
O painel do gateway não carrega os dados
As requisições de gerenciamento do painel precisam do token de administrador. O campo Admin token está vazio ou errado. Copie o Token do gateway de novo em Configurações do túnel e cole-o no campo.
O cliente MCP é rejeitado
O endpoint MCP precisa de um token de cliente no cabeçalho Authorization: Bearer. Crie um em Clients no painel do gateway e use-o aqui, não o Token do gateway.
"Inicie seu túnel primeiro."
O inspetor de requisições só está disponível enquanto o túnel está iniciado.
"Você precisa criar um domínio no Gerenciador de DNS!" ou "ATENÇÃO! Você não tem nenhum domínio!"
Domínio personalizado exige um dos seus próprios domínios. Adicione-o no Gerenciador de DNS ou escolha outro tipo de URL.
"Você precisa comprar saldo para usar este recurso."
Subdomínio personalizado e Domínio personalizado exigem Saldo. Use Subdomínio aleatório ou adicione Saldo. Veja Planos e Saldo.