Saltar al contenido
Localtonet Localtonet Panel

Expón herramientas MCP con un túnel de Gateway MCP

Escritorio v7.8+ Móvil v10.1+

Ayuda con esta página
En esta página 8 secciones
  1. Qué es
  2. Antes de empezar
  3. Crear el gateway
  4. Abrir la página de Gateway MCP
  5. Rellena el formulario
  6. Inicia el túnel
  7. Tipos de URL
  8. Token del gateway
  9. Conectar un cliente MCP
  10. Abrir el panel del gateway
  11. Registrar tus servidores MCP
  12. Crear un token de cliente
  13. Apuntar el cliente MCP al gateway
  14. Configuración
  15. Solución de problemas
  16. 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 #

  1. Abrir la página de Gateway MCP #

    Abre Mis túneles › Gateway MCP y despliega Crear túnel de Gateway MCP.

  2. Rellena el formulario #

    CampoQué introducir
    Tipo de URLSubdominio aleatorio, Subdominio personalizado o Dominio personalizado. Consulta la tabla siguiente.
    Token del dispositivoEl token del dispositivo que ejecuta tus herramientas.
    Región del servidorEl servidor al que se conectan tus clientes MCP.
    SubdominioSe muestra con Subdominio personalizado: el nombre que quieres.
    DominioEl dominio de la dirección.

    Selecciona Crear túnel.

  3. 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 URLDirección que obtienesNotas
Subdominio aleatorioUn nombre generado bajo el dominio que selecciones.Bueno para una primera prueba.
Subdominio personalizadoEl Subdominio que introduces bajo el Dominio que seleccionas.Requiere saldo.
Dominio personalizadoUno 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.

  1. Selecciona el icono de Configuración del túnel.
  2. Junto a Token del gateway, selecciona Gestionar. La ventana Token del gateway muestra el token con la parte central oculta.
  3. 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 #

  1. Abrir el panel del gateway #

    Con el túnel iniciado, abre https://<ADDRESS>/dashboard en un navegador. Pega el token del gateway en el campo Admin token de la parte inferior del menú lateral.

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

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

  4. 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 MCP
    URL:     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ónQué haceMás información
Balanceo de cargaReparte 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 gatewayGestiona el token de acceso de este Gateway MCP.Ver más arriba
Tiempo de espera HTTPCuá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únelGuarda una nota privada que te ayude a identificar o documentar este túnel.Referencia de configuración
Restricción de IPControla 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 bandaFecha 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 salidaElige 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únelEl 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.

Soporte