Skip to main content

​
Qu’est-ce que l’accès distant

Linkly AI s’exécute sur votre machine locale, tandis que les applications IA en ligne comme ChatGPT et Claude.ai fonctionnent dans le cloud — elles ne peuvent pas accéder directement à votre service MCP de base de connaissances locale. L’accès distant établit un tunnel sécurisé entre votre application de bureau et le cloud pour assurer le relais via l’internet public :
  1. L’application de bureau établit une connexion tunnel WebSocket vers mcp.linkly.ai
  2. Les applications IA en ligne envoient des requêtes MCP vers https://mcp.linkly.ai/mcp après autorisation OAuth
  3. Le service cloud relaie les requêtes vers votre application de bureau via le tunnel, qui les exécute et retourne les résultats
Vos données documentaires restent toujours en local ; le tunnel ne fait que relayer les requêtes et réponses MCP, sans stocker aucun contenu de document.
L’accès distant est réservé aux comptes Pro. Un compte gratuit peut bien activer l’interrupteur « Autoriser l’accès distant (internet) », mais la connexion est refusée par le serveur : l’interrupteur se désactive de lui-même et le statut affiche Pro requis.Si votre objectif se limite à faire lire un ensemble de documents précis par une IA en ligne, inutile de passer à Pro : les bibliothèques cloud sont accessibles aux comptes gratuits et ne demandent même pas que votre ordinateur soit allumé. La comparaison des deux figure ci-dessous, dans Lequel choisir.
mcp.linkly.ai est un service MCP de relais cloud, maintenu officiellement par Linkly AI. Les données y transitent de manière anonyme ; Linkly AI enregistre uniquement le nombre d’utilisations à des fins d’affichage.

​
Lequel choisir

L’accès distant et les bibliothèques cloud permettent tous deux à une IA hébergée dans le cloud de lire vos documents, mais ils répondent à des besoins différents : Les deux peuvent parfaitement coexister.
Un troisième cas est souvent oublié : si votre client IA est installé sur la même machine (Claude Code, Cursor, Cherry Studio…), aucun tunnel n’est nécessaire — connectez-vous directement à http://127.0.0.1:60606/mcp, c’est gratuit et plus rapide. Voir Utiliser MCP.

​
Étapes de configuration

1

Se connecter à son compte Linkly AI et passer à Pro

Dans l’application de bureau, ouvrez Paramètres → Compte et cliquez sur Se connecter. Une fois l’autorisation validée dans le navigateur, vous revenez automatiquement dans l’application. La clé API est alors récupérée toute seule : aucun copier-coller depuis la console n’est nécessaire.L’accès distant réclame un abonnement Pro, souscrivable depuis la page des tarifs.
En cas de besoin particulier — utiliser une clé précise, par exemple — la mention Facultatif : connectez votre compte en saisissant une clé API manuellement, au bas de Paramètres → Compte, conserve le point d’entrée manuel. La clé commence par lkai_ et se génère depuis la console.
2

Activer l'accès distant depuis l'application de bureau

  1. 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 »
  2. Dans la zone « Gestion », activez « Autoriser l’accès distant (internet) ». « Autoriser l’accès local » doit rester activé lui aussi, sinon cet interrupteur ne peut pas être activé
  3. Attendez que le statut affiche ● Connecté. S’il affiche « Non connecté » et que l’interrupteur se désactive de lui-même, c’est que vous n’êtes pas encore connecté à votre compte : terminez d’abord l’étape précédente
  4. L’adresse publique se trouve dans « Voir la configuration de connexion MCP », dans la zone « Intégration » : la section « Distant (internet) » de la fenêtre affiche l’adresse ainsi qu’une configuration prête à copier
3

Ajouter le service MCP dans votre application IA

Dans les applications IA supportant MCP (ChatGPT, Claude.ai, etc.), ajoutez le point de terminaison MCP suivant :
Lors du premier ajout, un flux d’autorisation OAuth sera déclenché. Suivez les instructions pour vous connecter et autoriser dans le navigateur.Pour les instructions de configuration spécifiques à chaque application, consultez la vue d’ensemble des intégrations.
Vous passez plutôt par le CLI Linkly AI, par exemple sur un serveur ou dans un conteneur ? Exécutez-y linkly auth login : la commande affiche un lien à ouvrir sur n’importe quel appareil et enregistre une nouvelle API Key dès que vous autorisez. Ajoutez ensuite --remote à n’importe quelle commande. Pour coller une clé existante, exécutez vous-même linkly auth set-key lkai_… dans votre propre terminal, sans le confier à un assistant IA. Voir Utiliser le CLI → Mode distant.

​
Les statuts de connexion

La ligne « Autoriser l’accès distant (internet) » affiche l’état de connexion du tunnel, tout comme la section « Distant (internet) » de la fenêtre de configuration de connexion. Savoir lire cet état permet de situer immédiatement le problème :

​
À propos de l’autorisation OAuth

Lorsque les applications IA en ligne comme ChatGPT et Claude.ai se connectent pour la première fois à un service MCP distant, un flux d’autorisation OAuth 2.1 est automatiquement déclenché :
  1. L’application IA détecte que le point de terminaison MCP requiert une autorisation
  2. Redirection automatique vers la page de connexion de linkly.ai. À la première connexion, un nouveau compte passe d’abord par la page « Complétez votre profil » pour choisir un nom d’affichage et un nom d’utilisateur
  3. La page d’autorisation indique vers quel domaine vous serez redirigé après autorisation : vérifiez qu’il s’agit bien de l’application IA que vous utilisez (par exemple claude.ai ou chatgpt.com) avant d’accepter
  4. L’application IA obtient un jeton d’accès, que les requêtes suivantes incluent automatiquement, sans avoir besoin de réautoriser
Pour une application que vous n’utilisez plus, révoquez l’accès dans « Applications autorisées », sur la page « Intégrations » du tableau de bord. L’application garde l’accès pendant une heure au plus, puis devra obtenir à nouveau votre autorisation.
Si vous êtes déjà connecté à linkly.ai dans votre navigateur, le processus d’autorisation sera plus rapide.

​
Considérations de sécurité

  • Conservation des identifiants : les identifiants du tunnel équivalent à une clé donnant accès à votre base de connaissances locale, ne les partagez pas et ne les collez dans aucune conversation avec une IA (ChatGPT, Claude, Cursor, Codex, Doubao, Kimi, etc.) : le contenu des conversations est envoyé au fournisseur du modèle et conservé dans l’historique. Les applications IA en ligne se raccordent par OAuth et les assistants IA qui utilisent le CLI se connectent avec linkly auth login : vous n’avez jamais à copier la clé. Si la clé est apparue dans une conversation ou en cas de compromission suspectée, révoquez la clé API depuis la console et regénérez-en une nouvelle
  • Transmission HTTPS : le tunnel distant utilise exclusivement le chiffrement HTTPS/WSS
  • Révocable à tout moment : vous pouvez déconnecter le tunnel depuis l’application de bureau à tout moment. Révoquer la clé API dans la console empêchera les nouvelles connexions et reconnexions, mais ne déconnectera pas immédiatement une session de tunnel déjà établie ; pour les applications IA connectées via OAuth, la révocation se fait dans « Applications autorisées », sur la page « Intégrations »
  • Masquage automatique des informations sensibles : avant d’être transmis à l’application IA, le contenu renvoyé par le MCP distant voit plus de 200 types d’informations sensibles — clés API, mots de passe, clés privées, numéros de carte bancaire, numéros de pièces d’identité, etc. — remplacés par un marqueur [REDACTED:type]. Les notes ne sont pas encore masquées, pour éviter que l’IA n’écrase le texte d’origine en les modifiant. Cela réduit le risque de fuite sans l’éliminer : pour les documents les plus importants, mieux vaut les tenir à l’écart de l’index avec des règles d’exclusion. Les connexions locales et en réseau local ne passent pas par le cloud et ne font l’objet d’aucun remplacement
  • Les données restent en local : vos données documentaires restent toujours sur votre ordinateur ; le tunnel ne relaie que les requêtes et réponses des appels d’outils MCP

​
Questions fréquentes

Cela signifie que le compte n’est pas Pro : l’établissement du tunnel est refusé d’emblée par le serveur (HTTP 402).Deux possibilités :
  • Passer à Pro : rendez-vous sur la page des tarifs, puis réactivez l’interrupteur « Autoriser l’accès distant (internet) »
  • Utiliser plutôt une bibliothèque cloud : envoyez dans le cloud l’ensemble de documents que vous vouliez rendre accessible à distance. C’est accessible aux comptes gratuits, et interrogeable même ordinateur éteint
Attention à un piège fréquent : même avec une bibliothèque cloud, la recherche doit désigner explicitement la bibliothèque (library="cloud://owner/slug"). Sans ce paramètre, la requête est routée par défaut vers votre machine, c’est-à-dire par le tunnel — et un compte gratuit reçoit alors l’invitation à passer à Pro.
Procédez dans cet ordre :
  1. Vérifiez que Paramètres → Compte affiche bien Connecté à Linkly AI Cloud ; sinon, connectez-vous d’abord
  2. Si vous avez saisi la clé API à la main, vérifiez qu’elle a été collée intégralement (elle commence par lkai_) et qu’elle n’a pas été révoquée depuis la console
  3. Générez une nouvelle clé API depuis la console, ou déconnectez-vous puis reconnectez-vous simplement pour qu’elle soit récupérée automatiquement
Le service MCP distant nécessite que l’application de bureau soit en cours d’exécution et connectée au tunnel. Si l’application de bureau est fermée ou que le tunnel est déconnecté, les appels distants retourneront immédiatement une erreur 503.Assurez-vous que :
  • Linkly AI Desktop est démarré
  • Le service MCP est actif (dans la zone « Gestion » de la page « Utilisation par les agents », la ligne « Autoriser l’accès local » affiche « En cours »)
  • Le statut du tunnel est ● Connecté
Si ce que vous cherchez, c’est « pouvoir interroger même ordinateur éteint », alors ce qu’il vous faut n’est pas le tunnel mais une bibliothèque cloud.
Après une coupure, le tunnel se reconnecte automatiquement, sans limite de tentatives : l’intervalle entre deux essais commence à 1 seconde et double à chaque fois, jusqu’à 120 secondes au maximum. Pendant la reconnexion, le statut affiche Connexion. En cas de déconnexions fréquentes, vérifiez :
  • La stabilité de votre connexion réseau
  • La validité de vos identifiants
Si les déconnexions persistent, essayez de désactiver l’interrupteur « Autoriser l’accès distant (internet) », puis de le réactiver.
Si l’autorisation échoue après avoir ajouté le MCP dans ChatGPT ou Claude.ai :
  1. Assurez-vous que le tunnel de l’application de bureau est en état connecté
  2. Essayez de vous connecter d’abord à linkly.ai dans votre navigateur
  3. Ajoutez à nouveau le serveur MCP dans l’application IA
Si le problème persiste, supprimez le serveur MCP déjà ajouté et ajoutez-le à nouveau.

​
Pour aller plus loin