Expón herramientas MCP con un túnel de Gateway MCP
Escritorio v7.8+ Móvil v10.1+
En esta página 8 secciones
- Qué es
- Antes de empezar
- Crear el gateway
- Abrir la página de Gateway MCP
- Rellena el formulario
- Inicia el túnel
- Tipos de URL
- Token del gateway
- Conectar un cliente MCP
- Abrir el panel del gateway
- Registrar tus servidores MCP
- Crear un token de cliente
- Apuntar el cliente MCP al gateway
- Configuración
- Solución de problemas
- Páginas relacionadas
Un túnel de Gateway MCP conecta clientes MCP y asistentes de IA con herramientas que se ejecutan en tu dispositivo a través de un gateway público. El cliente de Localtonet ejecuta el gateway por ti y el túnel le da una dirección HTTPS pública.
Qué es #
El Model Context Protocol (MCP) permite que un asistente de IA llame a herramientas. Un gateway MCP se sitúa delante de los servidores MCP que ejecutas y ofrece todas sus herramientas a través de un único endpoint.
Cuando inicias un túnel de Gateway MCP, el cliente de Localtonet arranca un gateway en tu dispositivo y Localtonet lo publica en la dirección del túnel. No introduces ninguna IP ni puerto locales. El gateway tiene:
- un panel web en
https://<ADDRESS>/dashboard, donde registras servidores MCP y creas tokens de cliente; - el endpoint MCP en
https://<ADDRESS>/mcp, al que se conectan tus clientes MCP.
No es lo mismo que el servidor MCP de Localtonet. Esta página trata de publicar tus propias herramientas. Para que un asistente de IA gestione tu cuenta de Localtonet (túneles, tokens, etc.), consulta Servidor MCP.
Antes de empezar #
- El cliente de Localtonet se está ejecutando en el dispositivo y está conectado con un AuthToken. Consulta Inicio rápido.
- El cliente es lo bastante reciente. Versiones mínimas de la app de Localtonet necesarias para usar esta función:
Desktop v7.8,Mobile v10.1.
Crear el gateway #
-
Abrir la página de Gateway MCP #
Abre Mis túneles › Gateway MCP y despliega Crear túnel de Gateway MCP.
-
Rellena el formulario #
Campo Qué introducir Tipo de URL Subdominio aleatorio, Subdominio personalizado o Dominio personalizado. Consulta la tabla siguiente. Token del dispositivo El token del dispositivo que ejecuta tus herramientas. Región del servidor El servidor al que se conectan tus clientes MCP. Subdominio Se muestra con Subdominio personalizado: el nombre que quieres. Dominio El dominio de la dirección. Selecciona Crear túnel.
-
Inicia el túnel #
El gateway aparece en Tus túneles. Selecciona Iniciar. La columna URL muestra la dirección pública.
Tipos de URL #
| Tipo de URL | Dirección que obtienes | Notas |
|---|---|---|
| Subdominio aleatorio | Un nombre generado bajo el dominio que selecciones. | Bueno para una primera prueba. |
| Subdominio personalizado | El Subdominio que introduces bajo el Dominio que seleccionas. | Requiere saldo. |
| Dominio personalizado | Uno de tus propios dominios. | Requiere saldo. La lista Dominio muestra tus dominios; si está vacía, crea antes un dominio desde el Gestor de DNS. Consulta Dominios personalizados. |
Token del gateway #
Cada túnel de Gateway MCP recibe su propio token del gateway cuando se crea. Es el token de administrador del gateway: el panel del gateway y su API de gestión solo aceptan cambios con él.
- Selecciona el icono de Configuración del túnel.
- Junto a Token del gateway, selecciona Gestionar. La ventana Token del gateway muestra el token con la parte central oculta.
- Selecciona el botón de copiar junto al token. Siempre copia el token completo. El botón de mostrar que hay a su lado revela el token en pantalla.
Mantén privado el token del gateway. Da control total del gateway: sus servidores, herramientas y tokens de cliente. No lo pongas en un cliente MCP; los clientes usan su propio token.
Conectar un cliente MCP #
-
Abrir el panel del gateway #
Con el túnel iniciado, abre
https://<ADDRESS>/dashboarden un navegador. Pega el token del gateway en el campo Admin token de la parte inferior del menú lateral. -
Registrar tus servidores MCP #
Abre Servers y selecciona Add Server. Un servidor puede ser un servidor MCP al que se llega por URL (Streamable HTTP o SSE), un comando local (stdio) o un servicio OpenAPI. Catalog enumera servidores MCP ya preparados que puedes instalar, y Tools muestra las herramientas que el gateway recopiló de todos los servidores.
-
Crear un token de cliente #
Abre Clients y selecciona New Client. Introduce un Name y selecciona Create Client. El gateway muestra el Client Token una sola vez: cópialo ahora, no volverá a mostrarse. En la lista de clientes, Allowed Servers y Allowed Groups muestran qué servidores y grupos de herramientas puede usar un cliente.
-
Apuntar el cliente MCP al gateway #
En tu cliente MCP o asistente de IA, añade un servidor MCP remoto con estos dos valores:
Configuración del cliente MCPURL: https://<ADDRESS>/mcp Header: Authorization: Bearer <CLIENT_TOKEN>Dónde los introduces depende del cliente; sigue su propia documentación para servidores MCP remotos (HTTP).
El Audit Log del panel muestra las solicitudes recientes al gateway, y Settings contiene la configuración del gateway con copia de seguridad y restauración.
El gateway guarda sus servidores, grupos, clientes y registro de auditoría en tu dispositivo, en una carpeta llamada mcp-data-<TUNNEL_ID> dentro del directorio de trabajo del cliente de Localtonet (en Android, dentro del almacenamiento propio de la app). <TUNNEL_ID> es el número de la columna ID, así que cada túnel de Gateway MCP tiene su propia carpeta.
Configuración #
Selecciona el icono de Configuración del túnel para abrir Configuración del túnel.
| Opción | Qué hace | Más información |
|---|---|---|
| Balanceo de carga | Reparte el tráfico entre dispositivos o usa un respaldo cuando un destino no está disponible. | Balanceo de carga |
| ¿Solo HTTPS? | Usa solo HTTPS en el endpoint público del túnel. | Referencia de configuración |
| ¿Autenticación básica? | Exige un nombre de usuario y una contraseña para acceder a este túnel. | Control de acceso |
| ¿HTTP/3 activo? | Permite que los clientes se conecten al endpoint público mediante HTTP/3. | Referencia de configuración |
| ¿Conexión heredada? | Prueba esto si el túnel no puede conectarse con el método de conexión normal. | Referencia de configuración |
| Token del gateway | Gestiona el token de acceso de este Gateway MCP. | Ver más arriba |
| Tiempo de espera HTTP | Cuánto espera el servidor una respuesta de tu aplicación local antes de cancelar la solicitud, de 1 a 600 segundos. Déjalo vacío para usar el valor predeterminado del servidor. | Referencia de configuración |
| Nota del túnel | Guarda una nota privada que te ayude a identificar o documentar este túnel. | Referencia de configuración |
| Restricción de IP | Controla qué direcciones IP de cliente pueden acceder a este túnel. | Control de acceso |
| Fecha de caducidad, Límites de velocidad, Límite de ancho de banda, Uso de ancho de banda | Fecha de caducidad, límites de velocidad de subida y bajada, un límite de transferencia de datos y Borrar para restablecer el uso registrado. | Límites y caducidad |
| Puerto de salida | Elige un puerto de salida fijo para la conexión de la app de Localtonet con el servidor. | Puertos |
| Tráfico de ancho de banda, Registro de solicitudes, Registro de actividad, Salud del túnel | El tráfico a lo largo del tiempo, las solicitudes registradas, los inicios, las detenciones y los cambios de configuración, y los resultados recientes de las comprobaciones de salud. | Registros e inspección |
En la lista de túneles, la columna Webhooks tiene un botón Ver registros de solicitudes y respuestas que abre el inspector de solicitudes de un túnel iniciado. Consulta Registros e inspección.
Solución de problemas #
El gateway no arranca o la dirección no responde
Comprueba la versión de la app de Localtonet en el dispositivo: Gateway MCP necesita como mínimo Desktop v7.8 o Mobile v10.1. Después comprueba que el túnel esté iniciado y que la columna Conexión muestre el dispositivo como conectado.
El panel del gateway no carga sus datos
Las solicitudes de gestión del panel necesitan el token de administrador. El campo Admin token está vacío o es incorrecto. Vuelve a copiar el token del gateway desde la Configuración del túnel y pégalo en el campo.
El cliente MCP es rechazado
El endpoint MCP necesita un token de cliente en la cabecera Authorization: Bearer. Crea uno en Clients en el panel del gateway y úsalo aquí, no el token del gateway.
"Primero inicia tu túnel."
El inspector de solicitudes solo está disponible mientras el túnel está iniciado.
"¡Debes crear un dominio desde el Gestor de DNS!" o "¡ATENCIÓN! No tienes ningún dominio."
Dominio personalizado necesita uno de tus propios dominios. Añádelo en Gestor de DNS, o elige otro tipo de URL.
"Necesitas comprar saldo para usar esta función."
Subdominio personalizado y Dominio personalizado requieren saldo. Usa Subdominio aleatorio o añade saldo. Consulta Planes y saldo.