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 también pueden activar el interruptor «Permitir acceso remoto (internet)», pero el servidor rechaza la conexión: el interruptor vuelve solo a la posición de apagado y el estado muestra Requiere 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

Activa el acceso remoto en la aplicación de escritorio

  1. Haz clic en el icono de agente en la parte inferior de la barra lateral izquierda de la ventana principal para abrir la página «Uso por agentes»
  2. En la sección «Gestión», activa «Permitir acceso remoto (internet)». «Permitir acceso local» también debe estar activado; de lo contrario, este interruptor no se puede activar
  3. Espera a que el estado muestre ● Conectado. Si muestra «Sin iniciar sesión» y el interruptor se apaga solo, es que aún no has iniciado sesión: completa antes el paso anterior
  4. La dirección pública está en «Ver la configuración de conexión MCP», en la sección «Integración»: el apartado «Remoto (internet)» de esa ventana muestra la dirección y una configuración lista para copiar
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.
¿Usas la CLI de Linkly AI en su lugar, por ejemplo en un servidor o en un contenedor? Ejecuta allí linkly auth login: muestra un enlace que puedes abrir en cualquier dispositivo y guarda una API Key nueva en cuanto autorizas. Después, añade --remote a cualquier comando. Si prefieres pegar una clave que ya tienes, ejecuta tú mismo linkly auth set-key lkai_… en tu propia terminal, sin encargárselo a un asistente de IA. Consulta Uso de CLI → Modo remoto.

​
Estados de la conexión

La fila «Permitir acceso remoto (internet)» muestra el estado de conexión del túnel, y el apartado «Remoto (internet)» de la ventana de configuración de conexión muestra el mismo estado. Entenderlo 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. Si es una cuenta nueva, la primera vez que inicias sesión pasas antes por la página «Completa tu perfil» para definir el nombre para mostrar y el nombre de usuario
  3. La página de autorización indica a qué dominio «se te redirigirá» después de permitir el acceso; comprueba que es la aplicación de IA que estás usando (por ejemplo, claude.ai o chatgpt.com) y haz clic en «Permitir»
  4. La aplicación de IA obtiene el token de acceso y lo incluye automáticamente en las peticiones posteriores, sin necesidad de volver a autorizar
Las aplicaciones que ya no uses se pueden revocar en «Aplicaciones autorizadas», en la página Integraciones de la consola. Tras revocarla, la aplicación conserva el acceso durante una hora como máximo y después tendrá que volver a pedir autorización.
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 ni la pegues en ninguna conversación con una IA (ChatGPT, Claude, Cursor, Codex, Doubao, Kimi, etc.): el contenido de las conversaciones se envía al proveedor del modelo y queda guardado en el historial. Las aplicaciones de IA en línea se conectan con OAuth y los asistentes de IA que usan la CLI inician sesión con linkly auth login, así que nunca necesitas copiar la clave. Si la clave ha aparecido en una conversación o 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; las aplicaciones de IA conectadas por OAuth se revocan en «Aplicaciones autorizadas», en la página Integraciones
  • Ocultación automática de información sensible: en el contenido devuelto por el MCP remoto, más de 200 tipos de información sensible, como claves API, contraseñas, claves privadas, números de tarjeta bancaria o números de documentos de identidad, se sustituyen primero por marcas [REDACTED:tipo] antes de entregarlo a la aplicación de IA. Las notas por ahora no se ocultan, para que la IA no sobrescriba el texto original al editarlas. Esto reduce el riesgo de filtraciones, pero no es infalible: para el material más importante, es mejor dejarlo fuera del índice con reglas de exclusión. Las conexiones locales y de red local no pasan por la nube y no aplican esta sustitución
  • 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: actualiza en la página de precios y vuelve a activar el interruptor «Permitir acceso remoto (internet)»
  • 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, inicia sesión primero
  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 (en la sección «Gestión» de la página «Uso por agentes», la fila «Permitir acceso local» muestra «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.
Cuando el túnel se corta, reconecta solo, sin límite de intentos: el intervalo entre reintentos empieza en 1 segundo y se duplica cada vez, hasta un máximo de 120 segundos. Mientras tanto, el estado indica «Conectando». 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 desactivar el interruptor «Permitir acceso remoto (internet)» y volver a activarlo.
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