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

# Intégrer aux assistants IA via MCP

> Découvrez comment utiliser Linkly AI MCP pour bénéficier d'une plus grande flexibilité et d'une expérience plus avancée.

## Présentation de MCP

MCP (Model Context Protocol) est un protocole ouvert qui permet aux assistants IA d'appeler des outils externes pour obtenir des informations contextuelles. Linkly AI Desktop intègre un service MCP qui démarre automatiquement après l'installation, sans configuration supplémentaire.

Il vous suffit d'ajouter le point de terminaison MCP de Linkly AI à votre assistant IA pour que celui-ci puisse directement rechercher, parcourir et lire vos documents locaux.

## Trois modes d'accès

Linkly AI propose trois modes d'accès MCP, adaptés à différents scénarios :

> [card] Accès local
>
> Utilisez directement sur votre machine avec des outils IA locaux, sans configuration supplémentaire. Adapté à Claude Code, Cursor et autres applications locales.
>
> Point de terminaison : `http://127.0.0.1:60606/mcp`

> [card] Accès réseau local
>
> D'autres appareils sur le même réseau peuvent également se connecter. Nécessite d'activer l'accès réseau local et d'utiliser un jeton d'accès.
>
> Point de terminaison : `http://{IP locale}:60606/mcp`

> [card] [Accès distant (public)](https://linkly.ai/docs/fr/use-in-remote.md)
>
> Accès à distance via un tunnel public. Adapté à ChatGPT, Claude.ai et autres applications IA en ligne. **Réservé à Pro**.
>
> Point de terminaison : `https://mcp.linkly.ai/mcp`

Cette page présente la configuration pour l'accès local et l'accès réseau local, tous deux gratuits. Pour l'accès distant (public), consultez le [guide d'accès distant](https://linkly.ai/docs/fr/use-in-remote.md) — c'est une fonctionnalité réservée à Pro ; et si votre objectif se limite à faire lire un ensemble de documents précis par une IA en ligne, les [bibliothèques cloud](https://linkly.ai/docs/fr/use-cloud-library.md), gratuites, conviennent en général mieux. Les avantages et inconvénients de chaque chemin sont comparés dans la [vue d'ensemble des intégrations](https://linkly.ai/docs/fr/integration.md).

> [card] HTTP MCP (recommandé)
>
> La plupart des assistants IA prennent en charge le protocole de transport HTTP. Connexion directe au point de terminaison MCP de Linkly AI, sans installation du CLI

> [card] Stdio MCP
>
> Certains assistants IA ne prennent en charge que le protocole de transport stdio et nécessitent le Linkly AI CLI comme passerelle

> [!TIP]
>
> Si vous hésitez sur le choix, optez pour HTTP MCP. Utilisez la méthode Stdio uniquement si votre assistant IA ne prend explicitement pas en charge le transport HTTP.

## Prérequis

**1. Installer et lancer Linkly AI Desktop**

Rendez-vous sur [linkly.ai](https://linkly.ai/#download) pour télécharger et installer l'application de bureau. Après le premier lancement, complétez l'assistant d'initialisation ; l'application commencera automatiquement à indexer vos documents.

**2. Confirmer que le service MCP est actif**

Le service MCP démarre automatiquement au lancement de Linkly AI Desktop. Cliquez sur l'icône Agent en bas de la barre latérale gauche de la fenêtre principale pour ouvrir la page « Utilisation par les agents » :

* dans la zone « Gestion », la ligne « Autoriser l'accès local » indique si le service tourne ;
* dans la zone « Intégration », « Voir la configuration de connexion MCP » affiche l'adresse et le numéro de port réels.

Point de terminaison MCP par défaut : `http://127.0.0.1:60606/mcp`

> [!NOTE]
>
> Si vous optez pour la méthode Stdio MCP, vous devez également [installer le Linkly AI CLI](https://linkly.ai/docs/fr/use-cli.md).

## Méthodes d'utilisation

### HTTP MCP (recommandé)

Compatible avec les assistants IA prenant en charge le protocole de transport HTTP/StreamableHTTP. Pas besoin d'installer le CLI, connexion directe.

> [tab] Claude Code
>
> Exécutez dans le terminal :
>
> ```bash theme={null}
> claude mcp add --transport http linkly-ai "http://127.0.0.1:60606/mcp?client=claude-code"
> ```

> [tab] Cursor
>
> 1. Ouvrez Settings → MCP Servers → Add Server
> 2. Name: `linkly-ai`
> 3. Type: `StreamableHTTP`
> 4. URL: `http://127.0.0.1:60606/mcp?client=cursor`

> [tab] Codex
>
> Exécutez dans le terminal :
>
> ```bash theme={null}
> codex mcp add linkly-ai --url "http://127.0.0.1:60606/mcp?client=codex"
> ```

> [tab] Cherry Studio
>
> 1. Ouvrez Settings → MCP Servers → Add
> 2. Name: `linkly-ai`
> 3. Type: `StreamableHTTP`
> 4. URL: `http://127.0.0.1:60606/mcp?client=cherry-studio`

Le `?client=` en fin d'URL est facultatif ; avec lui, le journal des accès de la page « Utilisation par les agents » sait quel client appelle.

> [!TIP]
>
> `60606` est le port par défaut du service MCP. Si la connexion échoue, ouvrez la page « Utilisation par les agents » et cliquez sur « Voir la configuration de connexion MCP » pour connaître l'adresse et le numéro de port réels.

### Stdio MCP

Compatible avec les assistants IA prenant en charge le protocole de transport stdio. Vous devez d'abord [installer le Linkly AI CLI](https://linkly.ai/docs/fr/use-cli.md#installation), puis configurer `linkly mcp` comme commande de passerelle stdio dans votre assistant IA.

`linkly mcp` lit automatiquement le nom que le client déclare à la connexion et l'inscrit dans le journal d'accès de l'application de bureau ; dans les exemples ci-dessous, `--client` permet d'imposer un nom fixe qui remplace celui détecté automatiquement.

> [tab] Claude Code
>
> Exécutez dans le terminal :
>
> ```bash theme={null}
> claude mcp add linkly-ai -- linkly mcp --client claude-code
> ```

> [tab] Codex
>
> Exécutez dans le terminal :
>
> ```bash theme={null}
> codex mcp add linkly-ai -- linkly mcp --client codex
> ```

> [tab] Cherry Studio
>
> 1. Ouvrez Settings → MCP Servers → Add
> 2. Name: `linkly-ai`
> 3. Type: `stdio`
> 4. Command: `linkly`
> 5. Args: `mcp`, `--client`, `cherry-studio` (un par ligne)

> [tab] Autres assistants IA
>
> Pour les autres assistants IA compatibles stdio MCP, configurez simplement la commande suivante comme serveur MCP :
>
> * Commande : `linkly`
> * Arguments : `mcp`
>
> Le CLI découvrira automatiquement l'instance locale de Linkly AI Desktop et établira la connexion.

### Accès réseau local

Si vous devez accéder à Linkly AI depuis un autre appareil sur le même réseau (comme un autre ordinateur, n8n sur un NAS, etc.), vous pouvez activer le mode d'accès réseau local.

**1. Activer l'accès réseau local**

Cliquez sur l'icône Agent en bas de la barre latérale gauche de la fenêtre principale de Linkly AI Desktop pour ouvrir la page « Utilisation par les agents », puis activez « Autoriser l'accès LAN » dans la zone « Gestion ». « Autoriser l'accès local » doit rester activé lui aussi, sinon cet interrupteur ne peut pas être activé.

À la première activation, l'application génère automatiquement un jeton d'accès.

**2. Obtenir l'adresse locale et le jeton d'accès**

Dans la zone « Intégration », cliquez sur « Voir la configuration de connexion MCP » ; la section « LAN » de la fenêtre affiche :

* **l'adresse** : similaire à `http://192.168.x.x:60606/mcp`, copiable directement
* **le jeton** : masqué par défaut ; cliquez sur l'icône en forme d'œil pour l'afficher, ou directement sur le bouton de copie

Cette section contient aussi une configuration JSON : remplacez-y `<jeton>` et « nom-de-votre-app » par les valeurs réelles pour l'utiliser sur l'appareil qui doit se connecter.

Après régénération du jeton, tous les clients LAN déjà configurés doivent passer au nouveau jeton.

**3. Configurer sur l'autre appareil**

Lors de l'ajout du serveur MCP dans les outils IA de l'autre appareil, utilisez l'adresse locale comme point de terminaison et incluez le jeton d'accès dans l'en-tête de la requête :

```
Authorization: Bearer <votre jeton d'accès>
```

L'accès réseau local nécessite un outil IA prenant en charge le transport HTTP. La passerelle stdio (`linkly mcp`) se connecte uniquement à l'application de bureau de cette machine et ne prend pas en charge le réseau local.

Renseignez vous-même cette configuration. **Ne collez le jeton d'accès dans aucune conversation avec une IA**, et ne laissez pas un assistant IA le configurer à votre place : le contenu des conversations est envoyé au fournisseur du modèle et conservé dans l'historique. Si le jeton est déjà apparu dans une conversation, régénérez-le dans « Voir la configuration de connexion MCP ».

Si vous utilisez Linkly AI CLI, enregistrez une fois l'adresse réseau local et le jeton d'accès dans votre propre terminal, puis ajoutez simplement `--lan` :

```bash theme={null}
linkly auth set-key <votre jeton d'accès> --lan --endpoint http://192.168.x.x:60606
linkly search "mot-clé" --lan
```

> [!WARNING]
>
> L'accès réseau local utilise une transmission HTTP en clair. Il est recommandé de l'utiliser uniquement sur des réseaux de confiance, comme un réseau domestique. N'activez pas cette fonctionnalité sur un WiFi public ou dans un environnement réseau non fiable.

### Recharger après la configuration

Une fois la configuration MCP enregistrée, **les nouveaux outils n'apparaîtront pas dans la conversation que vous avez déjà ouverte** : la grande majorité des clients IA ne lisent la liste des outils qu'une seule fois, au moment où la session démarre. C'est le mécanisme de chargement du client, pas une erreur de configuration.

Deux possibilités ; essayez la première d'abord :

1. **Démarrer une nouvelle conversation** (pour les outils en ligne de commande, quittez et ouvrez une nouvelle session). Une conversation déjà en cours conserve la liste d'outils qu'elle avait au démarrage ; une nouvelle récupère la liste à jour.
2. **Quitter complètement le client, puis le rouvrir.** À utiliser quand la première option ne suffit pas — et attention, fermer la fenêtre n'est pas quitter : sous macOS, appuyez sur `Cmd + Q` ou choisissez Quitter dans la barre de menus ; sous Windows, vérifiez qu'il a aussi quitté la zone de notification.

Une fois le rechargement fait, revenez à l'étape de vérification ci-dessous. S'il ne manque aucun outil et qu'un seul refuse de fonctionner, voyez plus bas *Lorsqu'un outil récemment ajouté n'apparaît pas*.

### Vérifier l'intégration

Une fois la configuration terminée, vous pouvez envoyer le prompt suivant dans votre assistant IA pour vérifier :

Recherche dans mes documents le contenu relatif à XX

Recherche dans mes documents le contenu relatif à la gestion de projet

Si l'intégration est réussie, l'assistant IA appellera l'outil `search` de Linkly AI et retournera les résultats pertinents de vos documents locaux.

### Lorsqu'un outil récemment ajouté n'apparaît pas

Nous ajoutons régulièrement de nouveaux outils MCP. La plupart des clients IA récupèrent la liste des outils une seule fois, au moment où la session démarre, et ne la rafraîchissent jamais d'eux-mêmes : un outil récemment publié n'apparaîtra donc pas tant que le client n'aura pas récupéré la liste à nouveau.

Si un outil décrit dans cette documentation est absent de votre client :

1. Rafraîchissez la connexion dans votre client — dans ChatGPT : **Paramètres → Connecteurs → votre connecteur → Actualiser**.
2. Si l'outil n'apparaît toujours pas, supprimez la connexion puis ajoutez-la de nouveau.
3. Démarrez une nouvelle conversation. Une conversation déjà en cours conserve la liste d'outils avec laquelle elle a démarré.

### Utiliser avec les Skills

Nous vous recommandons vivement d'[installer les Linkly AI Skills](https://linkly.ai/docs/fr/use-skills.md) en même temps que la configuration MCP. Les Skills enseignent à l'assistant IA comment utiliser efficacement les outils de Linkly AI, notamment quand rechercher, quand consulter le plan, quand lire le texte intégral, et comment gérer la lecture paginée des documents longs.

Veuillez installer l'Agent Skill linkly-ai-skills et compléter l'intégration des outils LinklyAI...

Veuillez installer l'Agent Skill linkly-ai-skills et compléter l'intégration des outils LinklyAI, en référence : [https://linkly.ai/docs/fr/use-skills](https://linkly.ai/docs/fr/use-skills.md)

## Masquage des informations sensibles

Quand ce que lit un agent contient des clés, des mots de passe, des codes de récupération ou d'autres informations sensibles, Linkly AI peut les remplacer par des marqueurs `[REDACTED:<type>]`, selon vos réglages. Le masquage se fait à deux niveaux, réglés séparément :

* **Application de bureau** : quand un agent lit des fichiers de votre ordinateur, l'application de bureau masque ces informations avant de lui transmettre les résultats ; les titres et les chemins ne changent pas. Cliquez sur l'icône de bouclier en bas de la barre latérale gauche de la fenêtre principale pour ouvrir la page « **Protection des données privées** » : le réglage se trouve dans la section « Masquer automatiquement les données sensibles » de l'onglet « Paramètres ».
* **Web** : les résultats de l'accès distant et des bibliothèques cloud passent par la passerelle cloud, qui les masque une seconde fois selon l'option « Masquer les informations sensibles en accès distant » de la [page « Sécurité » du tableau de bord](https://linkly.ai/dashboard/security).

### Côté application de bureau

Dans « Ce qui est protégé », il y a un interrupteur par provenance de l'agent :

| Interrupteur | Par défaut | Description |
| - | - | - |
| Local | Masqué | Ce que les agents de cet ordinateur lisent via MCP ou la CLI Linkly AI |
| LAN | Masqué | Autres appareils du même Wi-Fi |
| Distant | Masqué | Accès par Internet |
| Chat intégré | Masqué | C'est le [Chatbot](https://linkly.ai/docs/fr/use-chatbot.md). Ce qu'il lit est envoyé au modèle d'IA ; vous pouvez le désactiver avec un modèle local |

* À côté de chaque interrupteur s'affiche son état actuel : « Protégé », « Non masqué » ou « Masquage en pause ». Désactiver n'importe lequel d'entre eux demande d'abord une confirmation.
* **Voir le texte d'origine un moment** : dans l'onglet « Aperçu », cliquez sur « Pause de 10 min » ; pendant ce temps, les quatre interrupteurs ne masquent plus rien. La pause ne concerne que le niveau de l'application de bureau : en accès distant, le niveau web continue de masquer. Pendant la pause, le temps restant s'affiche dans l'onglet « Aperçu », dans cette section et dans le menu de l'icône de la barre d'état. Cliquez sur « Reprendre » pour y mettre fin ; elle prend fin aussi à l'échéance ou au redémarrage de l'application.
* **Ce qui est masqué** : dans la même section, « Masqué quand des agents lisent les fichiers » propose un interrupteur par type d'information, valable pour tous les interrupteurs ci-dessus réglés sur le masquage. Les clés et jetons, mots de passe, codes et phrases de récupération, numéros de carte bancaire et numéros de pièce d'identité sont masqués par défaut ; les numéros de téléphone et les adresses e-mail ne le sont pas, car les agents en ont souvent besoin pour retrouver un contact ou trier des CV.
* **Dossiers laissés tels quels** : au même endroit, « Dossiers affichés tels quels » convient aux contenus souvent pris à tort pour des secrets, comme des exemples de code ou de la documentation technique.
* **Notes** : dans les notes, les marqueurs portent des numéros de ligne, par exemple `[REDACTED:github-pat L7]`. Tant qu'un agent qui modifie une note laisse le marqueur à sa place, l'enregistrement rétablit le texte d'origine au lieu de l'écraser.
* **Combien a été masqué** : dans l'onglet « Journal » de la page « Utilisation par les agents », chaque appel indique combien d'informations sensibles ont été masquées ; survolez-le pour voir le détail par type.

### Comment les deux niveaux se combinent

| Ce qui est lu | Qui le lit | Qui décide |
| - | - | - |
| Fichiers de votre ordinateur | Agents locaux et du réseau local | Les interrupteurs « Local » et « LAN » de l'application de bureau |
| Fichiers de votre ordinateur | Chat intégré | L'interrupteur « Chat intégré » de l'application de bureau |
| Fichiers de votre ordinateur | Agents distants | L'interrupteur « Distant » de l'application de bureau et l'option web : le texte d'origine n'est visible que si les deux sont désactivés |
| Vos propres bibliothèques cloud | Agents distants, chat intégré | L'option web |
| Bibliothèques cloud partagées par d'autres | Tout le monde | Toujours masqué |

* Les interrupteurs par type d'information et les dossiers laissés tels quels n'existent qu'au niveau de l'application de bureau. Quand un agent distant lit des fichiers de votre ordinateur, la passerelle continue de masquer ce qu'elle reconnaît tant que l'option web est activée ; seuls les numéros de téléphone et les adresses e-mail ne sont pas masqués par la passerelle.
* Pour qu'un agent distant voie le texte d'origine des fichiers de votre ordinateur, désactivez l'option web et mettez aussi en pause ou désactivez « Distant » dans l'application de bureau. L'application de bureau n'affiche pas l'état de l'option web : consultez-le sur la page « Sécurité » du tableau de bord.
* L'option web ne distingue pas les fichiers de votre ordinateur des bibliothèques cloud : tant qu'elle est activée, la passerelle masque tous les résultats distants. Il n'est donc pas possible de montrer aux agents distants le texte d'origine des fichiers de votre ordinateur tout en continuant de masquer les bibliothèques cloud.

> [!NOTE]
>
> Le masquage réduit le risque de fuite sans l'éliminer : il ne reconnaît que les formats courants. Pour les documents les plus importants, mieux vaut les tenir à l'écart de l'index avec des [règles d'exclusion](https://linkly.ai/docs/fr/index-scope.md#règles-dexclusion) ; les fichiers dont le nom ressemble à des mots de passe ou des clés ne sont pas indexés par défaut, voir [Fichiers de mots de passe probables](https://linkly.ai/docs/fr/index-scope.md#fichiers-de-mots-de-passe-probables).

## Description des paramètres

Le service MCP expose neuf outils (onze sur la passerelle cloud, qui ajoute `library_search` et `library_link`), formant un flux de travail progressif d'accès aux documents :

* `search` — recherche hybride (BM25 + vecteur), point d'entrée principal ; trouve aussi vos propres annotations sur les clips (`scope: "annotations"` ne cherche que dans celles-ci)
* `outline` — sommaire de document
* `grep` — correspondance par regex dans un seul document
* `read` — lecture de document ligne par ligne ; les surlignages, notes et commentaires d'un clip suivent la première page (`annotations_offset` les pagine)
* `list_libraries` — lister les bibliothèques de connaissances disponibles
* `explore` — vue d'ensemble d'une collection de documents
* `find_paths` — localiser des chemins de dossier par mot-clé pour alimenter le `path_glob` de `search`
* `list` — lister les entrées d'un conteneur : un répertoire du disque (`folder`), une bibliothèque (`library`) ou vos notes (`notes`)
* `note_save` — créer ou modifier une note, **écrit** (le seul outil d'écriture sur une connexion locale)
* `library_search` — rechercher dans le catalogue des bibliothèques cloud, y compris celles non encore liées (passerelle cloud uniquement)
* `library_link` — lier une bibliothèque cloud pour la rendre interrogeable, ou délier celle que vous avez nommée avec `action: "unlink"` (passerelle cloud uniquement, **écrit**)

À l'exception de `note_save` (et de `library_link` sur la passerelle cloud), tous sont en lecture seule : aucun de vos documents n'est modifié. Dans ce que lisent les agents, les clés, mots de passe et autres informations sensibles sont masqués par défaut, voir [Masquage des informations sensibles](#masquage-des-informations-sensibles).

Chaque réponse réussie porte un horodatage UTC : une ligne `[meta] now=...` à la fin de la sortie Markdown, ou un champ `_meta.now` au niveau supérieur de la sortie JSON, utile pour calculer des dates relatives comme « le mois dernier ». Les réponses d'erreur n'incluent pas ces métadonnées.

Pour les tableaux de paramètres complets, les champs de réponse, le format des métadonnées de réponse et des exemples d'utilisation, consultez [Présentation des outils MCP de Linkly AI](https://linkly.ai/docs/fr/tools-intro.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.