> ## 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.
# Utiliser les bibliothèques cloud
> Envoyez une bibliothèque locale vers le cloud : disponible 24h/24, interrogeable par n'importe quel assistant IA sans dépendre de votre ordinateur, et partageable avec d'autres.
## Qu'est-ce qu'une bibliothèque cloud
Par défaut, une [bibliothèque](/docs/fr/use-libraries) n'existe que sur votre propre ordinateur : application fermée ou machine hors ligne, plus rien n'est interrogeable. Une **bibliothèque cloud** est une copie du contenu d'une bibliothèque locale envoyée sur les serveurs de Linkly AI : elle est disponible 24h/24, ne dépend pas de votre ordinateur, peut être interrogée directement par n'importe quel outil IA compatible MCP, et peut être partagée avec d'autres personnes.
Ordinateur éteint, application fermée : votre assistant IA retrouve quand
même le contenu
Publiez publiquement, ou invitez par e-mail les personnes de votre choix
### Quelle différence avec l'« accès distant »
Ces deux fonctionnalités portent des noms proches, mais résolvent des problèmes de sens opposé — d'où une confusion fréquente :
| Fonctionnalité | Problème résolu | Dépend de votre ordinateur | Partageable | Formule |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------- | ----------- | ------- |
| [Accès distant](/docs/fr/use-in-remote) (tunnel MCP) | Permettre à une application IA en ligne de **redescendre jusqu'à votre machine** pour y lire vos documents | Oui : machine allumée et connectée | Non | Pro |
| **Bibliothèque cloud** | Mettre en ligne le contenu choisi **indépendamment de votre machine**, pour davantage d'agents | Non | Oui | Gratuit |
Pour trancher rapidement : vous voulez que ChatGPT lise **tous** les documents de votre ordinateur → accès distant ; vous voulez qu'un ensemble de documents soit **disponible en permanence** et utilisable par d'autres → bibliothèque cloud. Les deux peuvent d'ailleurs être utilisés en même temps.
### Dans quels cas
* **Disponibilité 24h/24** : interroger vos documents depuis votre téléphone, en déplacement, ou quand votre ordinateur est éteint
* **Fournir de la documentation à une équipe ou à des clients** : rassembler docs produit, spécifications et études de cas dans une bibliothèque à partager
* **Publier une base de connaissances** : un corpus thématique soigné, que n'importe qui peut interroger avec son propre assistant IA
* **Plusieurs appareils** : un seul envoi, des recherches partout, sans réindexer sur chaque machine
***
## Créer et envoyer (côté propriétaire)
Une bibliothèque cloud se crée d'abord sous forme de « coquille » sur le site web ; l'application de bureau y envoie ensuite le contenu local.
Connectez-vous sur [linkly.ai](https://linkly.ai), ouvrez **Dashboard → Mes bibliothèques** et cliquez sur **Nouveau** (adresse directe : `https://linkly.ai/libraries/new`).
À la première création, il faut d'abord définir un **nom d'utilisateur** — l'adresse d'une bibliothèque cloud est de la forme `linkly.ai//`, le compte a donc besoin d'un nom unique.
La page **Nouvelle bibliothèque cloud** demande :
* **Titre de la bibliothèque** : le nom affiché, dans la langue de votre choix
* **Slug** : le segment qui apparaît dans l'adresse, 6 à 60 caractères, uniquement minuscules, chiffres et tirets
* **Description (facultative)** : une phrase indiquant à qui s'adresse la bibliothèque et ce qu'elle contient
* **Catégorie** : pour faciliter la découverte, modifiable à tout moment
* **Visibilité** : voir [Partage et visibilité](#partage-et-visibilité) plus bas
Une fois la création terminée, un bouton **Lier dans Linkly Desktop** apparaît : il ouvre l'application de bureau.
Si rien ne se déclenche, utilisez **Copier l'URL de la bibliothèque** sur la page, puis liez manuellement depuis l'application de bureau : ouvrez **Paramètres → Bibliothèques**, sélectionnez la bibliothèque locale à envoyer, cliquez sur **Déjà créée ? Collez l'URL de la bibliothèque** dans le panneau **Bibliothèque cloud**, collez l'adresse puis cliquez sur **Lier**.
La liaison est une relation **une bibliothèque locale ↔ une bibliothèque cloud**. La bibliothèque cloud est une copie de la locale : c'est le contenu local qui fait foi.
Une fois la liaison établie, le panneau **Bibliothèque cloud** indique le nombre de documents en attente. Cliquez sur **Envoyer** pour lancer le téléversement ; vous pouvez le mettre en pause, le reprendre et consulter le détail du traitement en cours de route. Après une interruption, un nouveau clic reprend là où l'envoi s'était arrêté.
Une fois l'envoi terminé, la carte affiche **Synchronisée avec le cloud** ainsi que le nombre de documents. Lorsque des documents locaux sont ajoutés ou modifiés, elle affiche **Modifications locales** : il suffit de relancer un envoi.
Activez **Synchronisation auto** dans le panneau **Bibliothèque cloud** : l'application vérifie les changements toutes les 5 minutes et les envoie automatiquement, sans clic supplémentaire.
### Dissocier
Dans le menu du panneau **Bibliothèque cloud** de la bibliothèque, choisissez **Dissocier cette bibliothèque cloud** : le poste local cesse alors d'envoyer vers le cloud. **Le contenu déjà présent dans le cloud est conservé**, et la liaison peut être rétablie à tout moment.
Pour supprimer définitivement la copie cloud, passez par la page de réglages de la bibliothèque sur le site → **Zone dangereuse** → supprimer la bibliothèque. La suppression efface d'un coup les fichiers, les invitations, les favoris et les liaisons de tous les utilisateurs — c'est irréversible.
***
## Lier une bibliothèque (côté utilisateur)
Pour qu'un assistant IA puisse interroger une bibliothèque cloud, la première chose à faire est de la **lier** à votre compte : ouvrez son adresse web et cliquez sur le bouton **Lier** en haut à droite (en anglais : **Link**) ; c'est réussi lorsque le bouton devient **Liée**.
**Même une bibliothèque que vous avez créée vous-même doit être liée une
fois.** La portée interrogeable via MCP est déterminée par la **liaison**, et
non par la **propriété** : une bibliothèque non liée, même la vôtre, reste
invisible pour l'assistant IA.
La liaison est une relation entre **votre compte** et **cette bibliothèque**, indépendante du propriétaire :
* le propriétaire voit qui a lié sa bibliothèque (réglages de la bibliothèque → **Utilisateurs**)
* vous pouvez la délier à tout moment d'un nouveau clic, sans effet sur la bibliothèque elle-même
* chaque liaison occupe un **emplacement de connexion (slot)** : 1 pour un compte gratuit, 99 pour un compte Pro
***
## Utiliser depuis un assistant IA
Les bibliothèques cloud sont exposées via la passerelle MCP cloud de Linkly AI, dont le point de terminaison est fixe :
```
https://mcp.linkly.ai/mcp
```
Lors de l'ajout dans un client IA, **nommez le serveur `linkly-ai-cloud`**. Ce nom sert à le distinguer du `linkly-ai` de l'application de bureau locale : les deux peuvent être configurés simultanément sans interférer, alors qu'un nom identique les ferait s'écraser mutuellement.
### Trois modes de raccordement
| Votre outil | Comment se raccorder |
| -------------------------------------------------- | ---------------------------------------------------- |
| Claude Code, Codex, Cursor, Gemini CLI, etc. | HTTP MCP + clé API (en-tête `Bearer`) |
| ChatGPT, Claude.ai et autres applications en ligne | Renseigner l'URL puis passer par OAuth, sans clé API |
| Linkly AI CLI | `linkly auth set-key`, puis le paramètre `--remote` |
Exemple avec Claude Code :
```bash theme={null}
claude mcp add --transport http linkly-ai-cloud https://mcp.linkly.ai/mcp \
--header "Authorization: Bearer lkai_votre_cle"
```
Les clés API se créent dans la section **Clés API** du [tableau de bord](https://linkly.ai/dashboard/integrations) et commencent par `lkai_`. Le format de configuration propre à chaque client est détaillé dans le [Guide d'intégration](/docs/fr/integration).
La configuration manuelle vous rebute ? Sur n'importe quelle page de
bibliothèque cloud, cliquez sur **Utiliser dans l'IA**, copiez la phrase
affichée dans la fenêtre et envoyez-la à votre assistant IA : il lira le
[guide de connexion](/docs/fr/library-setup) et vous accompagnera jusqu'au bout.
### Comment désigner une bibliothèque
L'identifiant d'une bibliothèque cloud est de la forme `cloud:///` — exactement les deux segments de l'adresse web :
```
adresse web https://linkly.ai/blueeon/linkly-init-example
identifiant cloud://blueeon/linkly-init-example
```
`list_libraries` liste toutes les bibliothèques que vous avez liées, avec leur identifiant exact.
**Précisez la bibliothèque à chaque recherche.** Lorsque le paramètre de
bibliothèque est omis, la requête est routée par défaut vers votre machine
(via le tunnel distant), et le tunnel est une fonctionnalité Pro — les comptes
gratuits reçoivent directement une erreur. Les bibliothèques cloud ne sont
**jamais** incluses implicitement : il faut nommer celle que l'on veut
interroger, et faire deux appels pour en interroger deux.
Face à un assistant IA, vous n'avez pas à retenir cette syntaxe : nommez simplement la bibliothèque.
« Cherche ce qui concerne le RAG dans la bibliothèque cloud
blueeon/linkly-init-example »
« Liste les bibliothèques que j'ai liées »
***
## Utiliser depuis l'application de bureau
Si l'application de bureau Linkly AI est installée, les bibliothèques cloud sont utilisables sans configurer le moindre MCP :
* ouvrez **Paramètres → Bibliothèques** : la zone **Bibliothèques cloud connectées** liste toutes les bibliothèques liées et permet d'activer ou non chacune d'elles dans le Chat
* dans le Chat de l'application, mentionnez une bibliothèque cloud avec `@` pour l'interroger comme une bibliothèque locale
Cette zone est en lecture seule — lier et délier se font sur le site. Si la liste est vide, commencez par lier la bibliothèque depuis le web.
***
## Partage et visibilité
Une bibliothèque cloud a trois niveaux de visibilité, modifiables à tout moment depuis la page de réglages :
| Visibilité | Qui voit les détails et la liste des fichiers | Qui peut lier et interroger | Référencée dans la page Explore et par les moteurs de recherche |
| ------------ | --------------------------------------------- | ----------------------------------------- | --------------------------------------------------------------- |
| **Public** | Tout le monde | Tous les utilisateurs connectés | Oui |
| **Showcase** | Tout le monde | Uniquement les membres invités | Oui |
| **Private** | Le propriétaire et les personnes invitées | Le propriétaire et les personnes invitées | Non |
**Inviter quelqu'un** : sur la page de réglages de la bibliothèque → **Partage**, saisissez l'adresse e-mail de la personne pour lui envoyer une invitation. Une fois celle-ci acceptée, elle devient lectrice et peut lier la bibliothèque à son propre compte pour l'interroger.
Un changement de visibilité qui **restreint** l'accès (par exemple Public →
Private) supprime immédiatement les liaisons et les favoris des personnes qui
ne sont pas lectrices, sans retour possible ; **les lecteurs ayant accepté une
invitation sont toujours conservés**. Avant validation, la page indique
précisément le nombre d'éléments qui seront supprimés.
***
## Quotas et limites
| | Gratuit | Pro |
| -------------------------------------- | ------------------ | --------------------------- |
| Bibliothèques cloud créables | 1 | 30 |
| Documents par bibliothèque | 500 | 2000 |
| Bibliothèques liables | 1 | 99 |
| Visibilités disponibles | Private uniquement | Public / Showcase / Private |
| Recherche cloud | Disponible | Disponible |
| Tunnel distant (accès à votre machine) | Indisponible | Disponible |
**Les bibliothèques créées avec un compte gratuit sont forcément Private**, c'est-à-dire réservées à vous-même et aux personnes invitées. Pour publier publiquement ou monter une bibliothèque vitrine, il faut passer à [Pro](https://linkly.ai/pricing).
Un dépassement de quota n'affecte pas l'existant : les bibliothèques déjà créées et les documents déjà envoyés ne sont pas touchés, seule la création de nouvelles bibliothèques devient impossible.
***
## Questions fréquentes
Seules les bibliothèques que vous envoyez volontairement sont téléversées. Le texte des documents, les vecteurs et les métadonnées sont transmis et stockés chiffrés côté serveur, et la visibilité reste sous votre contrôle, Private par défaut. Le jour où vous ne souhaitez plus rien laisser en ligne, supprimer la bibliothèque cloud en efface l'intégralité du contenu.
Il n'y a pas de synchronisation en temps réel. Par défaut, il faut cliquer sur
**Envoyer** ; avec **Synchronisation auto** activée, l'application vérifie les
changements toutes les 5 minutes et les envoie automatiquement. Le cloud est
une copie du local, dans un sens unique — le contenu n'est pas modifiable côté
cloud.
La cause la plus fréquente est l'absence de clic sur **Lier**. La portée
interrogeable est déterminée par la liaison, et non par la propriété : vos
propres bibliothèques doivent elles aussi être liées une fois depuis leur
page.
Vous êtes très probablement raccordé au MCP **local** (`127.0.0.1:60606`,
serveur nommé `linkly-ai`). Les bibliothèques cloud sont inaccessibles par
cette voie. Ajoutez une connexion distincte vers la passerelle cloud : URL
`https://mcp.linkly.ai/mcp`, serveur nommé `linkly-ai-cloud`. Les deux peuvent
coexister.
Non. Dissocier arrête simplement les envois ; le contenu cloud est conservé et
la liaison peut être rétablie à tout moment. Pour supprimer la copie cloud, il
faut le faire explicitement depuis la page de réglages de la bibliothèque sur
le site → **Zone dangereuse**.
Non. Création et liaison relèvent de deux quotas distincts : la bibliothèque de quelqu'un d'autre n'occupe qu'un de vos **emplacements de connexion** et ne compte pas dans le nombre de bibliothèques que vous pouvez créer.
***
## Pour aller plus loin
* [Guide de connexion aux bibliothèques cloud pour les Agents](/docs/fr/library-setup) — confier toute la procédure à votre assistant IA
* [Utiliser les bibliothèques](/docs/fr/use-libraries) — création des bibliothèques locales et recherche par bibliothèque
* [Accès distant](/docs/fr/use-in-remote) — laisser une IA en ligne accéder aux documents de votre machine
* [Présentation des outils](/docs/fr/tools-intro) — la description complète des paramètres des outils de recherche