Passer au contenu principal

​
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. La fonctionnalité 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 s’authentifie via une API Key et é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.
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.

​
Étapes de configuration

1

Créer un compte Linkly AI

Rendez-vous sur linkly.ai pour créer un compte et vous connecter.
2

Générer une API Key

Dans le Dashboard, sous « Gestion des API Keys », cliquez sur « Nouvelle API Key » pour générer une clé commençant par lkai_.
Conservez votre API Key en lieu sûr et ne la divulguez à personne. Une clé compromise pourrait être utilisée pour accéder à votre base de connaissances locale.
3

Connecter le tunnel depuis l'application de bureau

Ouvrez Linkly AI Desktop, allez dans Paramètres → MCP, trouvez la section « Accès distant » :
  1. Collez la clé générée dans le champ API Key
  2. Cliquez sur le bouton « Connecter le tunnel public »
  3. Attendez que le statut affiche ● Connecté
4

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 :
https://mcp.linkly.ai/mcp
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 documentation d’intégration.

​
À 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 de l’API Key : l’API Key équivaut à vos identifiants de tunnel, ne la partagez pas avec d’autres personnes. En cas de compromission suspectée, révoquez-la et regénérez-en une nouvelle dans le Dashboard
  • Transmission HTTPS : le tunnel distant utilise exclusivement le chiffrement HTTPS/WSS pour garantir la sécurité des données
  • Révocable à tout moment : vous pouvez déconnecter le tunnel depuis l’application de bureau à tout moment. Révoquer l’API Key dans le Dashboard 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

Vérifiez :
  1. Que l’API Key a été copiée intégralement (doit commencer par lkai_)
  2. Que l’API Key n’a pas été révoquée dans le Dashboard
  3. Essayez de générer une nouvelle API Key dans le Dashboard
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 en cours d’exécution (affiché comme Running dans les paramètres)
  • Le statut du tunnel est ● Connecté
Le tunnel dispose d’un mécanisme de reconnexion automatique (jusqu’à 10 tentatives, avec une stratégie de backoff exponentiel). En cas de déconnexions fréquentes, vérifiez :
  • La stabilité de votre connexion réseau
  • La validité de votre API Key
Si les déconnexions persistent, essayez de déconnecter manuellement 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.