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

# Intégrer aux assistants IA via MCP

> Découvrez comment utiliser Linkly AI MCP pour bénéficier d'une plus grande flexibilité et d'une expérience plus avancée.

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

<CardGroup cols={3}>
  <Card title="Accès local" icon="computer" iconType="duotone">
    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`
  </Card>

  <Card title="Accès réseau local" icon="wifi" iconType="duotone">
    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`
  </Card>

  <Card title="Accès distant (public)" icon="globe" iconType="duotone" href="/fr/use-in-remote">
    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`
  </Card>
</CardGroup>

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](/fr/use-in-remote).

<CardGroup cols={2}>
  <Card title="HTTP MCP (recommandé)" icon="globe" iconType="duotone">
    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
  </Card>

  <Card title="Stdio MCP" icon="terminal" iconType="duotone">
    Certains assistants IA ne prennent en charge que le protocole de transport
    stdio et nécessitent le Linkly AI CLI comme passerelle
  </Card>
</CardGroup>

<Tip>
  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.
</Tip>

## Prérequis

<Steps>
  <Step title="Installer et lancer Linkly AI Desktop">
    Rendez-vous sur [linkly.ai](https://linkly.ai/#download) 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.
  </Step>

  <Step title="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`
  </Step>
</Steps>

<Note>
  Si vous optez pour la méthode Stdio MCP, vous devez également [installer le
  Linkly AI CLI](./use-cli).
</Note>

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

<Tabs>
  <Tab title="Claude Code" icon="terminal">
    Exécutez dans le terminal :

    ```bash theme={null}
    claude mcp add --transport http linkly-ai http://127.0.0.1:60606/mcp
    ```
  </Tab>

  <Tab title="Cursor" icon="code">
    1. Ouvrez Settings → MCP Servers → Add Server
    2. Name: `linkly-ai`
    3. Type: `StreamableHTTP`
    4. URL: `http://127.0.0.1:60606/mcp`
  </Tab>

  <Tab title="Codex" icon="robot">
    Exécutez dans le terminal :

    ```bash theme={null}
    codex mcp add linkly-ai --url http://127.0.0.1:60606/mcp
    ```
  </Tab>

  <Tab title="Cherry Studio" icon="star">
    1. Ouvrez Settings → MCP Servers → Add
    2. Name: `linkly-ai`
    3. Type: `StreamableHTTP`
    4. URL: `http://127.0.0.1:60606/mcp`
  </Tab>
</Tabs>

<Tip>
  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.
</Tip>

### Stdio MCP

Compatible avec les assistants IA prenant en charge le protocole de transport stdio. Vous devez d'abord [installer le Linkly AI CLI](./use-cli#installation), puis configurer `linkly mcp` comme commande de passerelle stdio dans votre assistant IA.

<Tabs>
  <Tab title="Claude Code" icon="terminal">
    Exécutez dans le terminal :

    ```bash theme={null}
    claude mcp add linkly-ai -- linkly mcp
    ```
  </Tab>

  <Tab title="Codex" icon="robot">
    Exécutez dans le terminal :

    ```bash theme={null}
    codex mcp add linkly-ai -- linkly mcp
    ```
  </Tab>

  <Tab title="Cherry Studio" icon="star">
    1. Ouvrez Settings → MCP Servers → Add
    2. Name: `linkly-ai`
    3. Type: `stdio`
    4. Command: `linkly`
    5. Args: `mcp`
  </Tab>

  <Tab title="Autres assistants IA" icon="puzzle-piece">
    Pour les autres assistants IA compatibles stdio MCP, configurez simplement la commande suivante comme serveur MCP :

    * Commande : `linkly`
    * Arguments : `mcp`

    Le CLI découvrira automatiquement l'instance locale de Linkly AI Desktop et établira la connexion.
  </Tab>
</Tabs>

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

<Steps>
  <Step title="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.
  </Step>

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

  <Step title="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 :

    ```bash theme={null}
    linkly search "mot-clé" --endpoint http://192.168.x.x:60606/mcp --token <votre jeton d'accès>
    ```
  </Step>
</Steps>

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

### Vérifier l'intégration

Une fois la configuration terminée, vous pouvez envoyer le prompt suivant dans votre assistant IA pour vérifier :

<Prompt description="Recherche dans mes documents le contenu relatif à XX">
  Recherche dans mes documents le contenu relatif à la gestion de projet
</Prompt>

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](./use-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.

<Prompt description="Veuillez installer l'Agent Skill linkly-ai-skills et compléter l'intégration des outils LinklyAI...">
  Veuillez installer l'Agent Skill linkly-ai-skills et compléter l'intégration
  des outils LinklyAI, en référence : [https://linkly.ai/docs/fr/use-skills](https://linkly.ai/docs/fr/use-skills)
</Prompt>

## Description des paramètres

Le service MCP expose sept outils, formant un flux de travail progressif d'accès aux documents :

* `search` — recherche hybride (BM25 + vecteur), point d'entrée principal
* `outline` — sommaire de document
* `grep` — correspondance par regex dans un seul document
* `read` — lecture de document ligne par ligne
* `list_libraries` — lister les bibliothèques de connaissances disponibles
* `explore` — vue d'ensemble d'une collection de documents
* `find_paths` — localiser des chemins de dossier par mot-clé pour alimenter le `path_glob` de `search`

Chaque réponse réussie porte un horodatage UTC : une ligne `[meta] now=...` à la fin de la sortie Markdown, ou un champ `_meta.now` au niveau supérieur de la sortie JSON, utile pour calculer des dates relatives comme « le mois dernier ». Les réponses d'erreur n'incluent pas ces métadonnées.

Pour les tableaux de paramètres complets, les champs de réponse, le format des métadonnées de réponse et des exemples d'utilisation, consultez [Présentation des outils MCP de Linkly AI](./tools-intro).