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 voit bien le bouton Connecter le tunnel et peut cliquer dessus, mais la connexion est refusée par le serveur : le statut passe à Mise à niveau requise et le message « L’accès distant nécessite un abonnement Pro. » s’affiche.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

Connecter le tunnel depuis l'application de bureau

Allez dans Paramètres → MCP, repérez la section Accès distant et dépliez-la avec l’interrupteur situé à sa droite :
  1. Si vous n’êtes pas encore connecté, le message « Connectez-vous d’abord à votre compte pour activer l’accès distant. » s’affiche : cliquez sur Ouvrir les paramètres du compte pour terminer l’étape précédente
  2. Cliquez sur le bouton Connecter le tunnel
  3. Attendez que le statut affiche ● Connecté ; le Point de terminaison MCP public apparaît alors en dessous
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.

​
Les statuts de connexion

Le libellé d’état de la section Accès distant prend les valeurs suivantes ; savoir les lire 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
  3. Après votre connexion et confirmation d’autorisation, l’application IA obtient un jeton d’accès
  4. Les requêtes suivantes incluent automatiquement le jeton, sans avoir besoin de réautoriser
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. 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
  • 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 : cliquez sur Passer à Pro → sous le statut, ou rendez-vous directement sur la page des tarifs
  • 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. Sans connexion, la section d’accès distant indique directement « Connectez-vous d’abord à votre compte pour activer l’accès distant. »
  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 (Paramètres → MCP affiche En cours d’exécution en haut de page)
  • 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.
Le tunnel dispose d’un mécanisme de reconnexion automatique (jusqu’à 10 tentatives, avec une stratégie de backoff exponentiel) ; pendant ce temps, le statut affiche Reconnexion (tentative N). 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 cliquer sur Déconnecter le tunnel puis de vous reconnecter.
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