Passer au contenu principal

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

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. Vous pouvez vérifier l’état et le numéro de port du service MCP dans les paramètres de l’application.Point de terminaison MCP par défaut : http://127.0.0.1:606060/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 :
claude mcp add --transport http linkly-ai http://127.0.0.1:606060/mcp
Le port 606060 est le port par défaut du service MCP de Linkly AI. Si la connexion échoue, vérifiez le numéro de port réel dans les paramètres de l’application.

​
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.
Exécutez dans le terminal :
claude mcp add linkly-ai -- linkly mcp

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

​
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 sommaire, 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 trois outils : search (recherche), outline (sommaire), read (lecture), formant un flux de travail progressif d’accès aux documents. Consultez la documentation des outils : Présentation des outils MCP de Linkly AI