> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Acceso remoto a Linkly AI

> Accede de forma segura a tu base de conocimiento local desde aplicaciones de IA en línea como ChatGPT y Claude.ai mediante un túnel público con autenticación

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

<Note>
  `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.
</Note>

## Pasos de configuración

<Steps>
  <Step title="Registrar una cuenta de Linkly AI">
    Ve a [linkly.ai](https://linkly.ai) para registrarte e iniciar sesión.
  </Step>

  <Step title="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_`.

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="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 <Badge stroke color="green">● Conectado</Badge>
  </Step>

  <Step title="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](/docs/es/integration/use-in-claude).
  </Step>
</Steps>

## 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

<Tip>
  Si ya has iniciado sesión en linkly.ai en el navegador, el proceso de
  autorización será más rápido.
</Tip>

## 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

<AccordionGroup>
  <Accordion title="Error «API Key no válida»">
    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
  </Accordion>

  <Accordion title="La aplicación de escritorio está desconectada y las llamadas remotas devuelven error">
    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 <Badge stroke color="green">● Conectado</Badge>
  </Accordion>

  <Accordion title="El túnel se desconecta">
    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.
  </Accordion>

  <Accordion title="Fallo en la autorización OAuth">
    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.
  </Accordion>
</AccordionGroup>