Saltar al contenido principal

​
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; estas no pueden acceder directamente al servicio MCP de tu base de conocimiento local. La función de acceso remoto establece un túnel seguro entre tu aplicación de escritorio y la nube para habilitar el enrutamiento a través de internet:
  1. La aplicación de escritorio se autentica con una API Key y establece 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 solicitudes MCP a https://mcp.linkly.ai/mcp
  3. El servicio en la nube reenvía las solicitudes a través del túnel hacia tu aplicación de escritorio, que las ejecuta y devuelve los resultados
Tus datos de documentos siempre se almacenan localmente; el túnel solo reenvía solicitudes y respuestas MCP, sin almacenar ningún contenido de documentos.
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.

​
Pasos de configuración

1

Registrar una cuenta de Linkly AI

Ve a linkly.ai para registrarte e iniciar sesión.
2

Generar una API Key

En el Dashboard, en la sección “Gestión de API Keys”, haz clic en “Nueva API Key” para generar una clave que comience con lkai_.
Guarda tu API Key de forma segura y no la compartas con otros. Una clave filtrada puede ser usada para acceder a tu base de conocimiento local.
3

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

Abre Linkly AI Desktop, ve a Configuración → MCP y busca la sección “Acceso remoto”:
  1. Pega la clave que acabas de generar en el campo API Key
  2. Haz clic en el botón “Conectar túnel público”
  3. Espera a que el estado muestre ● Conectado
4

Agregar el servicio MCP en la aplicación de IA

En aplicaciones de IA compatibles con MCP como ChatGPT y Claude.ai, agrega el siguiente endpoint MCP:
https://mcp.linkly.ai/mcp
La primera vez que lo agregues se activará el flujo de autorización OAuth. Sigue las instrucciones para iniciar sesión y autorizar en el navegador.Para ver cómo configurar cada aplicación específicamente, consulta la documentación de integración.

​
Descripción de 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 solicitudes 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

  • Proteger la API Key: La API Key equivale a tus credenciales de túnel; no la compartas con nadie. Si sospechas que fue comprometida, puedes revocarla y regenerarla en el Dashboard
  • Transmisión HTTPS: El túnel remoto usa encriptación HTTPS/WSS en todo momento, garantizando la seguridad de los datos
  • Revocable en cualquier momento: Puedes desconectar el túnel desde la aplicación de escritorio en cualquier momento. Revocar la API Key en el Dashboard impedirá nuevas conexiones y reconexiones, pero no desconectará inmediatamente una sesión de túnel ya establecida
  • Los datos no van a la nube: Tus documentos siempre se almacenan en tu ordenador local; el túnel solo reenvía las solicitudes y respuestas de llamadas a herramientas MCP

​
Preguntas frecuentes

Verifica:
  1. Que la API Key esté pegada completa (debe comenzar con lkai_)
  2. Que la API Key no haya sido revocada en el Dashboard
  3. Intenta generar una nueva API Key en el Dashboard
El servicio MCP remoto requiere que la aplicación de escritorio esté en ejecución y conectada al túnel. Si la aplicación de escritorio está cerrada o el túnel está desconectado, las llamadas remotas devolverán inmediatamente un error 503.Asegúrate de que:
  • Linkly AI Desktop esté iniciado
  • El servicio MCP esté en ejecución (aparece como Running en la configuración)
  • El estado del túnel sea ● Conectado
El túnel tiene un mecanismo de reconexión automática (hasta 10 reintentos con estrategia de retroceso exponencial). Si se desconecta con frecuencia, verifica:
  • Si la conexión de red es estable
  • Si la API Key sigue siendo válida
Si la desconexión persiste, intenta desconectar manualmente y volver a conectar.
Si la autorización falla al agregar MCP en ChatGPT o Claude.ai:
  1. Asegúrate de que el túnel de la aplicación de escritorio esté conectado
  2. Intenta iniciar sesión primero en linkly.ai desde el navegador y luego autorizar
  3. Vuelve a agregar el servidor MCP en la aplicación de IA
Si el problema persiste, elimina el servidor MCP ya agregado y vuelve a añadirlo.