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

# Usar bibliotecas en la nube

> Sube una biblioteca local a la nube: en línea las 24 horas, consultable por cualquier asistente de IA sin depender de tu ordenador y compartible con otras personas.

## Qué es una biblioteca en la nube

Las [bibliotecas](/docs/es/use-libraries) viven por defecto solo en tu propio ordenador: si la aplicación no está abierta o el equipo no tiene conexión, no se puede buscar en ellas. Una **biblioteca en la nube** es una copia del contenido de una biblioteca local subida a los servidores de Linkly AI: está en línea las 24 horas, no depende de tu ordenador, cualquier herramienta de IA compatible con MCP puede consultarla directamente y además la puedes compartir.

<CardGroup cols={2}>
  <Card title="En línea sin tu ordenador" icon="cloud" iconType="duotone">
    Aunque el equipo esté apagado o la aplicación cerrada, tu asistente de IA
    sigue encontrando el contenido
  </Card>

  <Card title="Se puede compartir" icon="users" iconType="duotone">
    Publícala abiertamente o invita por correo a personas concretas
  </Card>
</CardGroup>

### En qué se diferencia del «acceso remoto»

Los dos nombres se parecen, pero resuelven problemas en direcciones opuestas y es fácil confundirlos:

| Función                                        | Qué resuelve                                                                                      | Depende de tu ordenador   | Compartible | Plan                           |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------------------------- | ----------- | ------------------------------ |
| [Acceso remoto](/docs/es/use-in-remote) (túnel MCP) | Deja que una aplicación de IA en la nube **entre hasta tu ordenador** para leer los documentos    | Sí: encendido y conectado | No          | Pro                            |
| **Biblioteca en la nube**                      | Pone el contenido que elijas en línea **sin depender de tu ordenador**, al alcance de más agentes | No                        | Sí          | Disponible en el plan gratuito |

Regla rápida: si quieres que ChatGPT lea **todos** los documentos de tu ordenador, usa el acceso remoto; si quieres que un conjunto concreto de material esté **siempre en línea** y además pueda servir a otras personas, usa una biblioteca en la nube. Se pueden usar a la vez.

### Cuándo conviene

* **Necesitas disponibilidad 24 horas**: poder preguntar sobre tu material desde el móvil, de viaje o con el ordenador apagado
* **Dar material a tu equipo o a tus clientes**: reunir documentación de producto, especificaciones o casos en una biblioteca y compartirla
* **Publicar una biblioteca abierta**: una colección temática bien organizada que cualquiera pueda consultar con su propio asistente de IA
* **Usar varios dispositivos**: subes una vez y consultas desde donde quieras, sin repetir la indexación en cada ordenador

***

## Crear y subir (desde el punto de vista del propietario)

Una biblioteca en la nube se crea primero como «carcasa» en la web y luego se rellena subiendo el contenido local desde la aplicación de escritorio.

<Steps>
  <Step title="Crear la biblioteca en la nube en la web">
    Inicia sesión en [linkly.ai](https://linkly.ai) y entra en **Dashboard → Mis bibliotecas**; pulsa **Nuevo** (dirección directa: `https://linkly.ai/libraries/new`) para abrir la página **Nueva biblioteca en la nube**.

    La primera vez tendrás que definir un **nombre de usuario**: la dirección de una biblioteca en la nube tiene la forma `linkly.ai/<username>/<slug>`, así que la cuenta necesita un nombre único.

    Qué hay que rellenar:

    * **Título de la biblioteca**: el nombre visible; puede estar en cualquier idioma
    * **Slug**: el segmento que aparece en la dirección; de 6 a 60 caracteres, solo minúsculas, números y guiones
    * **Descripción (opcional)**: una frase que explique para quién es la biblioteca y qué contiene
    * **Categoría**: ayuda a que la descubran y se puede cambiar cuando quieras
    * **Visibilidad**: consulta [Compartir con otras personas](#compartir-con-otras-personas) más abajo
  </Step>

  <Step title="Vincular desde la aplicación de escritorio">
    Al terminar de crearla verás un botón **Vincular en Linkly Desktop** que abre la aplicación de escritorio.

    Si no se abre, usa **Copiar URL de la biblioteca** en la página y vincula a mano desde la aplicación: entra en **Ajustes → Bibliotecas**, selecciona la biblioteca local que quieras subir y, en el panel **Biblioteca en la nube**, pulsa **¿Ya la creaste? Pega la URL de la biblioteca**; pega la dirección y pulsa **Vincular**.

    <Note>
      La vinculación es una relación uno a uno entre **biblioteca local ↔ biblioteca en la nube**. La biblioteca en la nube es una copia de la local, y el contenido local siempre manda.
    </Note>
  </Step>

  <Step title="Subir el contenido">
    Una vez vinculada, el panel **Biblioteca en la nube** muestra cuántos documentos quedan por enviar. Pulsa **Subir** para empezar; durante el proceso puedes pausar, reanudar y ver los detalles. Si se interrumpe, al volver a pulsar continúa desde donde se quedó.

    Al terminar, la tarjeta muestra **Sincronizada con la nube** junto al número de documentos. Cuando haya archivos nuevos o modificados en local, la tarjeta pasará a **Hay cambios locales**: basta con volver a subir.
  </Step>

  <Step title="Activar la sincronización automática (recomendado)">
    Activa **Sincronización automática** en el panel **Biblioteca en la nube** y la aplicación comprobará los cambios cada 5 minutos y los subirá sola, sin que tengas que pulsar nada.
  </Step>
</Steps>

### Desvincular

En el menú del panel **Biblioteca en la nube** de la biblioteca, elige **Desvincular esta biblioteca en la nube** y el equipo dejará de subir contenido. **Lo que ya está en la nube se conserva** y puedes volver a vincularla cuando quieras.

Para borrar del todo la copia en la nube, ve a la página de ajustes de la biblioteca en la web → **Zona peligrosa** → eliminar la biblioteca. Al eliminarla se borran también los archivos, las invitaciones, los favoritos y las relaciones de conexión de todo el mundo, y no hay vuelta atrás.

***

## Vincular una biblioteca (desde el punto de vista de quien la usa)

Para que un asistente de IA pueda buscar en una biblioteca en la nube, lo primero es **vincularla** a tu cuenta: abre la dirección web de la biblioteca y pulsa el botón **Vincular** de la esquina superior derecha (en inglés: **Link**); cuando el botón pase a **Vinculada**, ya está.

<Warning>
  **Incluso las bibliotecas que has creado tú hay que vincularlas una vez.** El
  alcance de búsqueda de MCP se basa en la relación de vinculación, no en la
  propiedad: una biblioteca sin vincular no la ve tu asistente de IA, ni siendo
  tuya.
</Warning>

La vinculación es una relación entre **tu cuenta** y **esa biblioteca**, y no depende del propietario:

* El propietario ve quién ha vinculado su biblioteca (ajustes de la biblioteca → **Usuarios**)
* Puedes desvincularla en cualquier momento volviendo a pulsar el botón, sin que la biblioteca en sí se vea afectada
* Cada vinculación ocupa un **espacio de conexión (Slot)**: las cuentas gratuitas tienen 1 y Pro tiene 99

***

## Usar la biblioteca en un asistente de IA

Las bibliotecas en la nube se consultan a través de la pasarela MCP en la nube de Linkly AI, cuyo endpoint es fijo:

```
https://mcp.linkly.ai/mcp
```

Al añadirla en un cliente de IA, **usa `linkly-ai-cloud` como nombre del servidor**. Ese nombre sirve para distinguirla del `linkly-ai` de la aplicación de escritorio local: se pueden configurar las dos a la vez sin que interfieran entre sí, pero si les pones el mismo nombre se sobrescriben mutuamente.

### Tres formas de conectarse

| La herramienta que usas                        | Cómo se conecta                                         |
| ---------------------------------------------- | ------------------------------------------------------- |
| Claude Code, Codex, Cursor, Gemini CLI, etc.   | HTTP MCP + clave API (con `Bearer` en la cabecera)      |
| Aplicaciones en línea como ChatGPT o Claude.ai | Rellenas la URL y autorizas por OAuth; sin clave API    |
| Linkly AI CLI                                  | `linkly auth set-key` y después el parámetro `--remote` |

Con Claude Code, por ejemplo:

```bash theme={null}
claude mcp add --transport http linkly-ai-cloud https://mcp.linkly.ai/mcp \
  --header "Authorization: Bearer lkai_tu_clave"
```

Las claves API se crean en la sección **Claves API** del [panel](https://linkly.ai/dashboard/integrations) y empiezan por `lkai_`. El formato de configuración concreto de cada cliente está en la [Guía de integración](/docs/es/integration).

<Tip>
  ¿Se te hace pesado configurarlo a mano? En la página de cualquier biblioteca
  en la nube, pulsa **Usar en IA**, copia la frase del diálogo y envíasela a tu
  asistente de IA: leerá la [guía de conexión](/docs/es/library-setup) y te llevará
  de la mano hasta el final.
</Tip>

### Cómo indicar la biblioteca

El identificador de una biblioteca en la nube tiene la forma `cloud://<owner>/<slug>`, que son justo los dos segmentos de la dirección web:

```
Dirección web   https://linkly.ai/blueeon/linkly-init-example
Identificador   cloud://blueeon/linkly-init-example
```

Con `list_libraries` puedes listar todas las bibliotecas que tienes vinculadas junto a su identificador exacto.

<Warning>
  **Indica la biblioteca explícitamente en cada búsqueda.** Si omites el
  parámetro de biblioteca, la petición se enruta por defecto a tu propio
  ordenador (a través del túnel remoto), y el túnel es una función Pro: las
  cuentas gratuitas reciben un error directamente. Las bibliotecas en la nube
  **nunca** se incluyen de forma implícita: hay que nombrar la que quieras
  consultar, y para consultar dos hacen falta dos llamadas.
</Warning>

Con un asistente de IA no necesitas recordar esta sintaxis: basta con decir claramente el nombre de la biblioteca.

<CardGroup cols={1}>
  <Card title="Buscar en una biblioteca en la nube" icon="magnifying-glass" iconType="duotone" horizontal>
    «Busca material sobre RAG en la biblioteca en la nube
    blueeon/linkly-init-example»
  </Card>

  <Card title="Ver qué bibliotecas tengo" icon="list" iconType="duotone" horizontal>
    «Lista las bibliotecas que tengo vinculadas»
  </Card>
</CardGroup>

***

## Usar la biblioteca en la aplicación de escritorio

Si tienes instalada la aplicación de escritorio de Linkly AI, puedes usar las bibliotecas en la nube sin configurar ningún MCP:

* Entra en **Ajustes → Bibliotecas**: en la sección **Bibliotecas en la nube conectadas** verás todas las que tienes vinculadas y podrás decidir, biblioteca a biblioteca, si están disponibles en el Chat
* Dentro del Chat de la aplicación, menciona una biblioteca en la nube con `@` y podrás buscar en ella igual que en una local

Esta sección es de solo lectura: vincular y desvincular se hace siempre en la web. Si la lista está vacía, vincula primero la biblioteca desde el sitio web.

***

## Compartir con otras personas

Las bibliotecas en la nube tienen tres visibilidades, que puedes cambiar cuando quieras en la página de ajustes de la biblioteca:

| Visibilidad  | Quién ve los detalles y la lista de archivos | Quién puede vincularla y buscar en ella      | ¿La indexan la página Explorar y los buscadores? |
| ------------ | -------------------------------------------- | -------------------------------------------- | ------------------------------------------------ |
| **Public**   | Todo el mundo                                | Cualquier usuario con la sesión iniciada     | Sí                                               |
| **Showcase** | Todo el mundo                                | Solo los miembros invitados                  | Sí                                               |
| **Private**  | Solo el propietario y las personas invitadas | Solo el propietario y las personas invitadas | No                                               |

**Invitar a otras personas**: en la página de ajustes de la biblioteca → **Compartir**, escribe el correo de la persona y envía la invitación. Cuando la acepte pasará a ser lectora y podrá vincular la biblioteca desde su propia cuenta y buscar en ella.

<Note>
  Cuando el cambio de visibilidad **restringe** el acceso (por ejemplo, de
  Public a Private), se eliminan al instante las vinculaciones y los favoritos
  de quienes no son lectores, y no se puede deshacer; **los lectores que
  aceptaron una invitación se conservan siempre**. Antes de confirmar, la página
  detalla exactamente cuántos elementos se van a eliminar.
</Note>

***

## Cuotas y límites

|                                         | Free          | Pro                         |
| --------------------------------------- | ------------- | --------------------------- |
| Bibliotecas en la nube que puedes crear | 1             | 30                          |
| Límite de documentos por biblioteca     | 500           | 2000                        |
| Bibliotecas que puedes vincular         | 1             | 99                          |
| Visibilidades disponibles               | Solo Private  | Public / Showcase / Private |
| Búsqueda en la nube                     | Disponible    | Disponible                  |
| Túnel remoto (acceso a tu ordenador)    | No disponible | Disponible                  |

**Las bibliotecas creadas con una cuenta gratuita solo pueden ser Private**, es decir, para ti y para quien invites. Para publicarlas abiertamente o convertirlas en una biblioteca de exhibición hace falta pasar a [Pro](https://linkly.ai/pricing).

Superar la cuota no afecta a lo que ya tienes: las bibliotecas creadas y los documentos ya subidos siguen igual; simplemente no puedes crear más.

***

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Es seguro el contenido que subo a la nube?">
    Solo se sube la biblioteca que envías tú de forma deliberada. El texto de los documentos, los vectores y los metadatos se transmiten cifrados y se almacenan en el servidor, y la visibilidad la controlas tú (por defecto, Private). Cuando ya no quieras tenerlo en la nube, al eliminar la biblioteca en la nube se borra todo su contenido.
  </Accordion>

  <Accordion title="¿El contenido local y el de la nube se mantienen sincronizados automáticamente?">
    No hay sincronización en tiempo real. Por defecto hay que pulsar **Subir** a
    mano; con **Sincronización automática** activada, la aplicación comprueba los
    cambios cada 5 minutos y los sube sola. La nube es una copia de lo local y la
    dirección es única: en la nube no se puede editar el contenido.
  </Accordion>

  <Accordion title="¿Por qué mi asistente de IA no encuentra ni mis propias bibliotecas?">
    Lo más habitual es no haber pulsado **Vincular**. El alcance de búsqueda se
    basa en la relación de vinculación, no en la propiedad: tus propias
    bibliotecas también hay que vincularlas una vez desde su página.
  </Accordion>

  <Accordion title="¿Qué hago si mi asistente de IA dice que no encuentra las bibliotecas cloud://?">
    Lo más probable es que estés conectado al MCP **local** (`127.0.0.1:60606`,
    servidor `linkly-ai`). Por esa ruta las bibliotecas en la nube son
    inalcanzables. Hay que añadir además la conexión a la pasarela en la nube: URL
    `https://mcp.linkly.ai/mcp`, nombre de servidor `linkly-ai-cloud`. Las dos
    pueden coexistir.
  </Accordion>

  <Accordion title="Si desvinculo o elimino la biblioteca local, ¿desaparece la de la nube?">
    No. Desvincular solo detiene las subidas: el contenido en la nube se conserva
    y puedes volver a vincularla cuando quieras. Para borrar la copia en la nube
    hay que eliminarla explícitamente en la página de ajustes de la biblioteca en
    la web → **Zona peligrosa**.
  </Accordion>

  <Accordion title="Las bibliotecas que otros comparten conmigo, ¿consumen mi cuota de bibliotecas?">
    No. La cuota de creación y la de vinculación son dos cosas distintas: las bibliotecas ajenas solo ocupan un **espacio de conexión** y no cuentan para el número de bibliotecas que puedes crear.
  </Accordion>
</AccordionGroup>

***

## Lecturas adicionales

* [Guía de conexión a bibliotecas en la nube para Agentes](/docs/es/library-setup) — deja que tu asistente de IA se encargue de todo el proceso de conexión
* [Usar bibliotecas](/docs/es/use-libraries) — crear bibliotecas locales y buscar filtrando por biblioteca
* [Acceso remoto](/docs/es/use-in-remote) — deja que una IA en la nube llegue hasta los documentos de tu ordenador
* [Introducción a las herramientas](/docs/es/tools-intro) — todos los parámetros de las herramientas de recuperación
