Skip to main content

​
Qué es el acceso remoto

Linkly AI se ejecuta en tu máquina local, mientras que aplicaciones de IA en línea como ChatGPT y Claude.ai se ejecutan en la nube, así que no pueden acceder directamente al servicio MCP de tu base de conocimiento local. El acceso remoto establece un túnel seguro entre tu aplicación de escritorio y la nube para hacer de intermediario a través de internet:
  1. La aplicación de escritorio abre una conexión WebSocket en forma de túnel hacia mcp.linkly.ai
  2. Las aplicaciones de IA en línea, tras completar la autorización OAuth, envían sus peticiones MCP a https://mcp.linkly.ai/mcp
  3. El servicio en la nube reenvía la petición por el túnel hasta tu aplicación de escritorio, que la ejecuta y devuelve el resultado
Tus documentos siguen guardados siempre en local: el túnel solo reenvía peticiones y respuestas MCP, y no almacena ningún contenido.
El acceso remoto es una función exclusiva de Pro. Las cuentas gratuitas ven y pueden pulsar Conectar túnel, pero el servidor rechaza la conexión: el estado pasa a Se requiere actualización y aparece el aviso «El acceso remoto requiere una suscripción Pro.».Si lo único que quieres es que una IA en la nube lea un conjunto concreto de material, no hace falta que actualices: las bibliotecas en la nube están disponibles en las cuentas gratuitas y además no necesitan que tu ordenador esté encendido. Las diferencias entre ambas vías están en Acceso remoto o biblioteca en la nube, más abajo.
mcp.linkly.ai es un servicio MCP de intermediación en la nube, mantenido oficialmente por Linkly AI. Los datos se transmiten de forma anónima y Linkly AI solo registra el número de usos para mostrarlo estadísticamente.

​
Acceso remoto o biblioteca en la nube

Las dos opciones permiten que una IA en la nube llegue a tu material, pero resuelven problemas distintos: Se pueden usar las dos a la vez, no se estorban.
Hay un tercer caso que suele pasarse por alto: si tu cliente de IA está instalado en este mismo ordenador (Claude Code, Cursor, Cherry Studio…), el túnel no pinta nada. Conéctalo directamente a http://127.0.0.1:60606/mcp: es gratis y más rápido. Ver Usar MCP.

​
Pasos de configuración

1

Inicia sesión en tu cuenta de Linkly AI y actualiza a Pro

En la aplicación de escritorio, ve a Ajustes → Cuenta y pulsa Iniciar sesión; al terminar la autorización en el navegador, volverás automáticamente a la aplicación. La clave API se obtiene sola al iniciar sesión, no hace falta que la copies a mano desde la consola.El acceso remoto requiere suscripción Pro, que se contrata en la página de precios.
Si tienes alguna necesidad especial (por ejemplo, usar una clave concreta), al final de Ajustes → Cuenta sigue estando el bloque Opcional: conecta tu cuenta configurando una clave API manualmente, donde puedes pegarla; empieza por lkai_ y se genera en la consola.
2

Conecta el túnel en la aplicación de escritorio

Ve a Ajustes → MCP, busca la sección Acceso remoto y despliégala con el interruptor de la derecha:
  1. Si aún no has iniciado sesión, verás el aviso «Inicia sesión primero en tu cuenta para habilitar el acceso remoto.»; pulsa Abrir ajustes de Cuenta para completar antes el paso anterior
  2. Pulsa el botón Conectar túnel
  3. Espera a que el estado muestre ● Conectado; debajo aparecerá el Endpoint MCP público
3

Añade el servicio MCP en la aplicación de IA

En aplicaciones de IA compatibles con MCP como ChatGPT y Claude.ai, añade este endpoint MCP:
La primera vez se activa el flujo de autorización OAuth; sigue las indicaciones para iniciar sesión y autorizar en el navegador.Para la configuración concreta de cada aplicación, consulta la visión general de las integraciones.

​
Estados de la conexión

La etiqueta de estado de la sección Acceso remoto puede tomar estos valores; entenderlos basta para saber dónde está el problema:

​
Sobre la autorización OAuth

Cuando aplicaciones de IA en línea como ChatGPT y Claude.ai se conectan por primera vez a un servicio MCP remoto, activan automáticamente el flujo de autorización OAuth 2.1:
  1. La aplicación de IA detecta que el endpoint MCP requiere autorización
  2. Redirige automáticamente a la página de inicio de sesión de linkly.ai
  3. Tras iniciar sesión y confirmar la autorización, la aplicación de IA obtiene el token de acceso
  4. Las peticiones posteriores llevan el token automáticamente, sin necesidad de volver a autorizar
Si ya has iniciado sesión en linkly.ai en el navegador, el proceso de autorización será más rápido.

​
Consideraciones de seguridad

  • Cuida las credenciales: la credencial del túnel es la llave que da acceso a tu base de conocimiento local; no la compartas con nadie. Si sospechas que se ha filtrado, revoca y regenera la clave API en la consola
  • Transmisión HTTPS: el túnel remoto va cifrado de extremo a extremo con HTTPS/WSS
  • Revocable en cualquier momento: puedes desconectar el túnel desde la aplicación de escritorio cuando quieras. Revocar la clave API en la consola impide nuevas conexiones y reconexiones, pero no corta de inmediato una sesión de túnel ya establecida
  • Los datos no van a la nube: tus documentos siguen guardados en tu ordenador; el túnel solo reenvía las peticiones y respuestas de las llamadas a herramientas MCP

​
Preguntas frecuentes

Significa que la cuenta no es Pro: el servidor rechaza directamente el establecimiento del túnel (HTTP 402).Hay dos caminos:
  • Actualizar a Pro: pulsa Actualizar a Pro → bajo el estado, o ve directamente a la página de precios
  • Pasarte a una biblioteca en la nube: envía a la nube el material al que necesitas llegar en remoto. Está disponible en las cuentas gratuitas y se consulta aunque el ordenador esté apagado
Ojo con una trampa muy fácil de pisar: aunque uses una biblioteca en la nube, la búsqueda tiene que indicar la biblioteca explícitamente (library="cloud://owner/slug"). Si omites ese parámetro, la petición vuelve por defecto a tu propio equipo, es decir, pasa por el túnel — y por esa vía una cuenta gratuita recibirá el aviso de Pro.
Revisa en este orden:
  1. Comprueba que Ajustes → Cuenta muestra Conectado a Linkly AI Cloud. Si no has iniciado sesión, la sección de acceso remoto avisará directamente con «Inicia sesión primero en tu cuenta para habilitar el acceso remoto.»
  2. Si pusiste la clave API a mano, comprueba que está pegada entera (empieza por lkai_) y que no ha sido revocada en la consola
  3. Genera una clave API nueva en la consola, o simplemente cierra sesión y vuelve a iniciarla para que la obtenga sola
El servicio MCP remoto requiere que la aplicación de escritorio esté en ejecución y conectada al túnel. Si está cerrada o el túnel está caído, las llamadas remotas devuelven de inmediato un error 503.Asegúrate de que:
  • Linkly AI Desktop está iniciado
  • El servicio MCP está funcionando (arriba en Ajustes → MCP debe poner En ejecución)
  • El estado del túnel es ● Conectado
Si lo que quieres es «poder consultar con el ordenador apagado», entonces lo que necesitas es una biblioteca en la nube, no el túnel.
El túnel reconecta solo (hasta 10 reintentos con retroceso exponencial) y mientras tanto el estado indica Reconectando (intento N). Si se cae con frecuencia, comprueba:
  • Si la conexión de red es estable
  • Si las credenciales siguen siendo válidas
Si la desconexión persiste, prueba a pulsar Desconectar túnel a mano y volver a conectar.
Si la autorización falla tras añadir el MCP en ChatGPT o Claude.ai:
  1. Asegúrate de que el túnel de la aplicación de escritorio está conectado
  2. Prueba a iniciar sesión primero en linkly.ai desde el navegador
  3. Vuelve a añadir el servidor MCP en la aplicación de IA
Si el problema persiste, elimina el servidor MCP ya añadido y vuelve a añadirlo.

​
Lecturas adicionales