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

# Utiliser Linkly AI dans QwenPaw

> Connectez votre base de connaissances locale Linkly AI à l'agent QwenPaw pour lui permettre de rechercher et lire vos documents privés

## Ce que vous pouvez faire

<AccordionGroup>
  <Accordion title="Rechercher des documents locaux pendant l'exécution des tâches">
    QwenPaw permet d'étendre les capacités des outils via MCP. Après avoir
    connecté Linkly AI, l'agent peut rechercher vos documents locaux à tout
    moment lors de la planification et de l'exécution des tâches, combinant
    connaissances locales et informations en ligne pour améliorer la qualité des
    résultats.
  </Accordion>

  <Accordion title="Utiliser vos ressources locales en mode planification">
    En mode planification de QwenPaw, faites d'abord rechercher les documents
    pertinents à l'agent via Linkly AI, puis élaborer un plan d'exécution
    détaillé — garantissant que le plan s'appuie sur vos vraies ressources
    privées.
  </Accordion>

  <Accordion title="Partager une base de connaissances entre plusieurs agents">
    QwenPaw prend en charge la configuration de plusieurs agents indépendants.
    Après avoir connecté Linkly AI, chaque agent peut accéder aux mêmes
    documents locaux sans avoir à configurer une source de connaissances séparée
    pour chacun.
  </Accordion>
</AccordionGroup>

## Prérequis

* [QwenPaw](https://qwenpaw.agentscope.io/downloads) installé
* Linkly AI Desktop en cours d'exécution avec le service MCP actif

## Étapes de configuration

<Tabs>
  <Tab title="MCP HTTP local (Recommandé)" icon="globe">
    <Steps>
      <Step title="Ouvrir la configuration MCP">
        Ouvrez la console QwenPaw, accédez à **Agent → MCP** et cliquez sur
        **+ Créer**.
      </Step>

      <Step title="Coller la configuration et créer">
        Collez le JSON suivant dans la boîte de dialogue, puis cliquez sur
        **Créer** :

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "transport": "streamable_http",
              "url": "http://127.0.0.1:60606/mcp"
            }
          }
        }
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="MCP distant" icon="cloud">
    Complétez d'abord la [configuration de l'accès distant](/fr/use-in-remote),
    avec le tunnel de bureau affichant <Badge stroke color="green">● Connecté</Badge>.

    <Steps>
      <Step title="Ouvrir la configuration MCP">
        Ouvrez la console QwenPaw, accédez à **Agent → MCP** et cliquez sur
        **+ Créer**.
      </Step>

      <Step title="Coller la configuration distante et créer">
        Collez le JSON suivant dans la boîte de dialogue, puis cliquez sur
        **Créer** :

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "transport": "streamable_http",
              "url": "https://mcp.linkly.ai/mcp"
            }
          }
        }
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="CLI Stdio (Alternative)" icon="terminal">
    [Installez d'abord Linkly AI CLI](/fr/use-cli) et assurez-vous que Node.js
    18+ est installé localement.

    <Steps>
      <Step title="Ouvrir la configuration MCP">
        Ouvrez la console QwenPaw, accédez à **Agent → MCP** et cliquez sur
        **+ Créer**.
      </Step>

      <Step title="Coller la configuration CLI et créer">
        Collez le JSON suivant dans la boîte de dialogue, puis cliquez sur
        **Créer** :

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "command": "linkly",
              "args": ["mcp"]
            }
          }
        }
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Démarrage

Une fois configuré, posez des questions directement dans une conversation QwenPaw
et l'agent appellera automatiquement les outils Linkly AI pour rechercher et lire
vos documents locaux.

Exemples :

* « Recherche dans mes documents le contenu sur XX »
* « Vérifie si mes notes locales contiennent quelque chose sur YY et fais-en un résumé »

## Questions fréquentes

<AccordionGroup>
  <Accordion title="Les outils ne fonctionnent pas après la création">
    Accédez à **Agent → MCP** et vérifiez que le bouton d'activation du client
    linkly-ai est activé. Vérifiez également que Linkly AI Desktop est en cours
    d'exécution et que le service MCP affiche Running.
  </Accordion>

  <Accordion title="Mode CLI : commande introuvable">
    Vérifiez que Linkly AI CLI est correctement installé (avec `linkly     --version`) et que la version de Node.js est ≥ 18 (`node --version`).
  </Accordion>

  <Accordion title="Puis-je importer plusieurs configurations MCP à la fois">
    Oui. QwenPaw prend en charge la configuration de plusieurs clients MCP dans
    l'objet `mcpServers` d'un seul JSON — un clic crée tout en une seule fois.
  </Accordion>
</AccordionGroup>