> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Accès distant à Linkly AI

> Accédez à distance à votre base de connaissances locale en toute sécurité depuis des applications IA en ligne comme ChatGPT et Claude.ai, grâce à un tunnel public et une authentification Auth

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

<Note>
  `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.
</Note>

## Étapes de configuration

<Steps>
  <Step title="Créer un compte Linkly AI">
    Rendez-vous sur [linkly.ai](https://linkly.ai) pour créer un compte et vous connecter.
  </Step>

  <Step title="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_`.

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="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 <Badge stroke color="green">● Connecté</Badge>
  </Step>

  <Step title="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](/docs/fr/integration/use-in-claude).
  </Step>
</Steps>

## À 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

<Tip>
  Si vous êtes déjà connecté à linkly.ai dans votre navigateur, le processus
  d'autorisation sera plus rapide.
</Tip>

## 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

<AccordionGroup>
  <Accordion title="Message « API Key invalide »">
    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
  </Accordion>

  <Accordion title="L'application de bureau est hors ligne, les appels distants retournent une erreur">
    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 <Badge stroke color="green">● Connecté</Badge>
  </Accordion>

  <Accordion title="Déconnexion du tunnel">
    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.
  </Accordion>

  <Accordion title="Échec de l'autorisation OAuth">
    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.
  </Accordion>
</AccordionGroup>