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.

​
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.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. Pour l’accès distant (public), consultez le guide d’accès distant.

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: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 :
claude mcp add --transport http linkly-ai http://127.0.0.1:60606/mcp
Le port 60606 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

​
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

Dans Linkly AI Desktop, allez dans Paramètres → MCP, trouvez la section « Accès réseau local » et activez le commutateur.
2

Obtenir l'URL locale et le jeton d'accès

Une fois activé, l’interface affichera :
  • URL locale : similaire à http://192.168.x.x:60606/mcp
  • Jeton d’accès : une chaîne de caractères aléatoire
Copiez ces deux informations sur l’appareil qui doit se connecter.
3

Configurer sur l'autre appareil

Lors de l’ajout du serveur MCP dans les outils IA de l’autre appareil, utilisez l’URL 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>
Si vous utilisez Linkly AI CLI, vous pouvez vous connecter ainsi :
linkly search "mot-clé" --endpoint http://192.168.x.x:60606/mcp --token <votre jeton d'accès>
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.

​
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 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 trois outils : search (recherche), outline (plan), 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