Servidor MCP de Localtonet
En esta página 9 secciones
- Qué es y qué no es
- Datos de conexión
- Antes de empezar
- Conecta tu cliente MCP
- Añade el servidor al cliente
- Comprueba la conexión
- Crea un túnel
- Herramientas
- Túneles
- Configuración del túnel
- AuthTokens y grupos de tokens
- Servidores y proveedores de SSO
- Acceso VPN en túneles proxy
- Dispositivos
- Límites
- Seguridad
- Solución de problemas
- 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 #
| Ajuste | Valor |
|---|---|
| Endpoint | https://localtonet.com/mcp |
| Transporte | Streamable HTTP |
| Autenticación | Tu clave de API como token Bearer: Authorization: Bearer <YOUR_API_KEY> |
| Información del servidor | localtonet.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
Authorizationpersonalizada. - 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 #
-
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.
-
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:
PromptList my Localtonet tunnels and tell me which ones are running. -
Crea un túnel #
Describe lo que quieres. Por ejemplo:
PromptCreate 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 #
| Finalidad | Herramientas |
|---|---|
| Consultar | GetTunnels, GetTunnel, GetTunnelRequestLogs |
| Crear | CreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel |
| Ejecutar | StartTunnel, StopTunnel, DeleteTunnel |
| Cambiar | UpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType |
| Operaciones en lote | BulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType |
Configuración del túnel #
| Ajuste | Herramientas |
|---|---|
| Restricciones de IP | GetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions |
| Controles de acceso | GetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls |
| Cabeceras y autenticación | GetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication |
| Caducidad y límites | GetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage |
| Servidor y puerto | GetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer |
| Argumentos y nota | GetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote |
| Clientes de proxy rotativo y grupos de tokens | GetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups |
| Ajustes avanzados | GetAdvancedTunnelSettings, 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 #
| Finalidad | Herramientas |
|---|---|
| AuthTokens | GetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken |
| Modo avión y cambio de IP | GetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink |
| Grupos de tokens | GetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup |
Servidores y proveedores de SSO #
| Finalidad | Herramientas |
|---|---|
| Servidores | GetAvailableServers |
| Proveedores de SSO | GetSsoProviders, 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 #
| Herramienta | Qué hace |
|---|---|
ListDevices | Lista 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. |
GetDeviceMetrics | Devuelve las cifras más recientes de CPU, memoria, disco y tiempo de actividad de un dispositivo. |
RunDeviceCommand | Ejecuta 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
429significa: 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,StopySet. - Da la clave de acceso del dispositivo para
RunDeviceCommandsolo 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.