Saltar al contenido
Localtonet Localtonet Panel

Servidor MCP de Localtonet

Ayuda con esta página
En esta página 9 secciones
  1. Qué es y qué no es
  2. Datos de conexión
  3. Antes de empezar
  4. Conecta tu cliente MCP
  5. Añade el servidor al cliente
  6. Comprueba la conexión
  7. Crea un túnel
  8. Herramientas
  9. Túneles
  10. Configuración del túnel
  11. AuthTokens y grupos de tokens
  12. Servidores y proveedores de SSO
  13. Acceso VPN en túneles proxy
  14. Dispositivos
  15. Límites
  16. Seguridad
  17. Solución de problemas
  18. Páginas relacionadas

El servidor MCP de Localtonet permite que un asistente de IA compatible con el Model Context Protocol, como Claude o Cursor, gestione tu cuenta en lenguaje natural: listar, crear, iniciar, detener y configurar túneles, y gestionar AuthTokens, grupos de tokens, servidores y proveedores de SSO.

Qué es y qué no es #

  • El servidor MCP de esta página lo ejecuta Localtonet en https://localtonet.com/mcp. Sus herramientas actúan sobre tu cuenta de Localtonet, igual que la REST API.
  • El Gateway MCP es un tipo de túnel. Da una dirección pública a un servidor MCP que se ejecuta en tu propio dispositivo. Úsalo para publicar tus propias herramientas, no para gestionar Localtonet.

Datos de conexión #

AjusteValor
Endpointhttps://localtonet.com/mcp
TransporteStreamable HTTP
AutenticaciónTu clave de API como token Bearer: Authorization: Bearer <YOUR_API_KEY>
Información del servidorlocaltonet.com/mcp-info (JSON) y la tarjeta del servidor en https://localtonet.com/.well-known/mcp-server-card

Antes de empezar #

  • Un cliente MCP que pueda conectarse a un servidor remoto mediante Streamable HTTP y enviar una cabecera Authorization personalizada.
  • Tu clave de API. Abre el Panel y usa Copiar en la tarjeta Clave de API. Consulta Cuenta y seguridad.
  • Para trabajar con túneles: un dispositivo con el cliente de Localtonet conectado, de modo que el asistente tenga un AuthToken en el que crear túneles.

Conecta tu cliente MCP #

  1. Añade el servidor al cliente #

    La mayoría de los clientes MCP aceptan un servidor remoto como una URL más cabeceras. La forma habitual es:

    Configuración del cliente MCP
    {
      "mcpServers": {
        "localtonet": {
          "type": "http",
          "url": "https://localtonet.com/mcp",
          "headers": {
            "Authorization": "Bearer <YOUR_API_KEY>"
          }
        }
      }
    }

    El nombre del archivo y los nombres exactos de las claves varían según el cliente. Consulta la documentación de tu cliente para saber dónde se configuran los servidores MCP remotos, y usa la URL y la cabecera indicadas arriba.

  2. Comprueba la conexión #

    Recarga el cliente. Las herramientas de Localtonet deberían aparecer en su lista de herramientas. Pregunta primero algo inofensivo, por ejemplo:

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

    Describe lo que quieres. Por ejemplo:

    Prompt
    Create an HTTP tunnel with a random subdomain for port 3000 on my device "laptop", then start it and give me the URL.

    El asistente sigue el flujo de trabajo que prescribe el servidor: busca el AuthToken del dispositivo, elige un servidor, llama a la herramienta de creación correspondiente e inicia el túnel, porque un túnel recién creado no está en ejecución.

Herramientas #

Los nombres de herramienta de abajo son los que muestra tu cliente. Una herramienta que falla devuelve un mensaje que empieza por Error:.

Túneles #

FinalidadHerramientas
ConsultarGetTunnels, GetTunnel, GetTunnelRequestLogs
CrearCreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel
EjecutarStartTunnel, StopTunnel, DeleteTunnel
CambiarUpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType
Operaciones en loteBulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType

Configuración del túnel #

AjusteHerramientas
Restricciones de IPGetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions
Controles de accesoGetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls
Cabeceras y autenticaciónGetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication
Caducidad y límitesGetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage
Servidor y puertoGetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer
Argumentos y notaGetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote
Clientes de proxy rotativo y grupos de tokensGetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups
Ajustes avanzadosGetAdvancedTunnelSettings, GetTunnelIpv4Only, SetTunnelIpv4Only, GetTunnelWifiSplit, SetTunnelWifiSplit, SetTunnelSslStream, GetTunnelProxyProtocol, SetTunnelProxyProtocol, GetTunnelPassThrough, SetTunnelPassThrough, GetTunnelHttpsOnly, SetTunnelHttpsOnly, GetTunnelHttp3, SetTunnelHttp3, GetTunnelFilePath, SetTunnelFilePath, GetTunnelHostHeader, SetTunnelHostHeader, GetTunnelPathRewrite, SetTunnelPathRewrite, GetTunnelUpstreamProxy, SetTunnelUpstreamProxy, GetTunnelVless, SetTunnelVless

Lo que hace cada ajuste se describe en la Referencia de ajustes.

AuthTokens y grupos de tokens #

FinalidadHerramientas
AuthTokensGetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken
Modo avión y cambio de IPGetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink
Grupos de tokensGetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup

Servidores y proveedores de SSO #

FinalidadHerramientas
ServidoresGetAvailableServers
Proveedores de SSOGetSsoProviders, GetSsoProviderDefaultEndpoints, SaveSsoProvider, DeleteSsoProvider, GetSsoProvidersForTunnel, SetSsoProvidersForTunnel

Acceso VPN en túneles proxy #

GetVpnAccessDevices, CreateVpnAccessDevice, GetVpnAccessDeviceConfig, GetVpnAccessDeviceCredentials, RegenerateVpnAccessDevice, DeleteVpnAccessDevice. Estas herramientas gestionan dispositivos WireGuard y OpenVPN en un túnel proxy. Cada dispositivo recibe su propia configuración y todo su tráfico sale a través del proxy.

Dispositivos #

HerramientaQué hace
ListDevicesLista los ordenadores emparejados con tu cuenta en Mis dispositivos, indicando si cada uno está en línea y su uso de CPU, memoria y disco.
GetDeviceMetricsDevuelve las cifras más recientes de CPU, memoria, disco y tiempo de actividad de un dispositivo.
RunDeviceCommandEjecuta un comando de shell en un dispositivo y devuelve su salida y su código de salida. Espera hasta el tiempo límite que indiques, de 1 a 120 segundos, 30 de forma predeterminada.

RunDeviceCommand necesita algo más que la clave de API: requiere una clave de acceso del dispositivo (empieza por ltd_) que creas para ese dispositivo en Mis dispositivos. Consulta Terminal de dispositivos. Una ejecución aparece en el historial de conexiones del dispositivo con su hora y su dirección IP; el comando no se guarda.

Límites #

  • Las solicitudes al servidor MCP tienen un límite de frecuencia, junto con las solicitudes a la API de tu clave de API. Una respuesta 429 significa: espera y vuelve a intentarlo.
  • Las herramientas de lote aceptan una lista de hasta 100 elementos.

Seguridad #

El asistente actúa con tu clave de API. Sus herramientas pueden crear, detener y eliminar túneles, eliminar AuthTokens y grupos de tokens, y cambiar reglas de acceso, sin un paso de confirmación por parte de Localtonet.

  • Activa la confirmación de las llamadas a herramientas en tu cliente MCP, al menos para las herramientas que empiezan por Delete, BulkDelete, Stop y Set.
  • Da la clave de acceso del dispositivo para RunDeviceCommand solo a un asistente al que también darías un terminal en ese ordenador. Un comando lo ejecuta el shell predeterminado del dispositivo.
  • Trata el archivo de configuración del cliente como un secreto: contiene tu clave de API. No lo subas a un repositorio.
  • Si la clave puede haberse filtrado, selecciona Cambiar en la tarjeta Clave de API del panel. Esto crea una clave nueva e invalida la antigua; después actualiza tu cliente MCP.
  • Con una clave de API copiada en el panel de un equipo, el asistente lista solo tus AuthTokens y túneles de ese equipo. Consulta Gestión de equipos.

Solución de problemas #

El cliente informa de 401, o de "API key is required. Provide Authorization: Bearer <apikey>"

La solicitud no tiene una cabecera Authorization válida. Comprueba que el cliente envía cabeceras personalizadas para este servidor, que el valor es Bearer, un espacio y luego la clave, y que la clave no se ha cambiado en el panel desde que la copiaste.

El asistente dice que una herramienta devolvió "Error: …"

Esa es la respuesta de Localtonet, no un problema de conexión. El texto después de Error: indica qué se rechazó, por ejemplo la falta de un AuthToken o un límite del plan. Corrige esa causa en lugar de dejar que el asistente reintente.

El túnel se creó, pero no responde

Pide al asistente que lo inicie. Un túnel nuevo está detenido hasta que se llama a StartTunnel, y el cliente de Localtonet del dispositivo debe estar conectado.

Faltan herramientas en mi cliente

Algunos clientes limitan el número de herramientas o te piden habilitarlas una por una. Habilita en los ajustes del cliente las herramientas de Localtonet que necesites.

Soporte