Skip to main content

​
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 :

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

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

Accès distant (public)

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 — 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, 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.

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

Stdio MCP

Certains assistants IA ne prennent en charge que le protocole de transport stdio et nécessitent le Linkly AI CLI comme passerelle
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 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
Si vous optez pour la méthode Stdio MCP, vous devez également installer le Linkly AI CLI.

​
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.
Exécutez dans le terminal :
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.
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, puis configurer linkly mcp comme commande de passerelle stdio dans votre assistant IA. Dans les exemples ci-dessous, --client indique le nom de l’application dans le journal d’accès de l’application de bureau.
Exécutez dans le terminal :

​
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 :
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 :
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

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

​
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
  • outline — sommaire de document
  • grep — correspondance par regex dans un seul document
  • read — lecture de document ligne par ligne
  • 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é. 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.