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

> Connectez votre base de connaissances locale Linkly AI à ZCode pour permettre à l'agent de codage propulsé par GLM de rechercher et lire vos documents privés

## Ce que vous pouvez faire

<AccordionGroup>
  <Accordion title="Laisser l'agent lire les spécifications avant d'écrire du code">
    Utilisez l'outil `search` de Linkly AI pour trouver les journaux de
    décisions d'architecture et les documents d'exigences, puis `read` pour lire
    les sections pertinentes. L'agent ZCode écrit du code en ayant vos
    conventions de projet sous les yeux, au lieu de les deviner.
  </Accordion>

  <Accordion title="Ancrer le Goal Mode et les Subagents dans des ressources réelles">
    ZCode exécute des tâches de longue haleine de manière autonome grâce au Goal
    Mode et aux Subagents. Avec Linkly AI connecté, ces exécutions peuvent
    récupérer des ressources locales à la demande — ainsi, un refactoring ou une
    migration en plusieurs étapes reste ancré à votre documentation réelle.
  </Accordion>

  <Accordion title="Partager une seule base de connaissances dans tous les espaces de travail">
    Configurez Linkly AI une fois à la portée utilisateur, et chaque espace de
    travail ZCode peut accéder aux mêmes documents locaux. Pas de pièces jointes
    à re-télécharger, pas de configuration par projet.
  </Accordion>
</AccordionGroup>

## Prérequis

* [ZCode](https://zcode.z.ai) 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 page MCP Servers">
        Ouvrez les **Settings** de ZCode, puis accédez à la page **MCP Servers**
        et cliquez sur **New MCP Server**.
      </Step>

      <Step title="Choisir la portée">
        Choisissez **User** pour rendre Linkly AI disponible dans tous les
        espaces de travail, ou **Workspace** pour le limiter au projet en cours.
      </Step>

      <Step title="Remplir la configuration et ajouter">
        Remplissez les informations suivantes :

        * **Type** : `HTTP`
        * **Name** : `linkly-ai`
        * **URL** : `http://127.0.0.1:60606/mcp`

        Cliquez sur **Add** pour terminer, puis vérifiez que l'interrupteur situé
        à côté de `linkly-ai` est activé dans la liste des serveurs.
      </Step>
    </Steps>
  </Tab>

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

    <Steps>
      <Step title="Ouvrir la page MCP Servers">
        Ouvrez les **Settings** de ZCode, puis accédez à la page **MCP Servers**
        et cliquez sur **New MCP Server**.
      </Step>

      <Step title="Remplir la configuration distante">
        Remplissez les informations suivantes :

        * **Type** : `HTTP`
        * **Name** : `linkly-ai`
        * **URL** : `https://mcp.linkly.ai/mcp`
      </Step>

      <Step title="Ajouter l'en-tête d'authentification">
        Développez **Request headers (optional)** et ajoutez :

        * **Key** : `Authorization`
        * **Value** : `Bearer <votre clé API>`

        Votre clé API se crée sur le
        [tableau de bord Linkly AI](https://linkly.ai/dashboard/integrations) et
        commence par `lkai_`. Cliquez sur **Add** pour terminer.
      </Step>
    </Steps>
  </Tab>

  <Tab title="CLI Stdio (Alternative)" icon="terminal">
    [Installez d'abord Linkly AI CLI](/docs/fr/use-cli), puis modifiez directement le
    fichier de configuration de ZCode :

    * Portée utilisateur : `~/.zcode/cli/config.json`
    * Portée espace de travail : `<racine du projet>/.zcode/config.json`

    ```json theme={null}
    {
      "mcp": {
        "servers": {
          "linkly-ai": {
            "command": "linkly",
            "args": ["mcp"],
            "env": {}
          }
        }
      }
    }
    ```

    <Note>
      Les deux fichiers portent le même nom mais se situent à des niveaux
      différents — la configuration utilisateur se trouve sous `.zcode/cli/`,
      tandis que la configuration de l'espace de travail se trouve directement
      sous `.zcode/`. Modifier le mauvais fichier est l'erreur la plus courante
      ici.
    </Note>

    Vous pouvez obtenir le même résultat depuis l'interface : sur la page **MCP
    Servers**, cliquez sur **New MCP Server**, gardez **Type** sur `stdio`,
    définissez **Command** sur `linkly` et **Args** sur `mcp`.
  </Tab>
</Tabs>

## Installer les Skills

ZCode prend en charge les Agent Skills, vous pouvez donc aussi installer les
Skills Linkly AI pour apprendre à l'agent à utiliser ces outils efficacement :

```bash theme={null}
git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.zcode/skills/linkly-ai
```

Retournez dans **Settings → Skills** et cliquez sur **Refresh**, puis saisissez
`$` dans la zone de saisie et sélectionnez `linkly-ai` pour l'invoquer.

<Tip>
  Consultez [Utiliser les Skills](/docs/fr/use-skills) pour découvrir d'autres
  méthodes d'installation et le fonctionnement des Skills.
</Tip>

## Premiers pas

Une fois la configuration terminée, posez directement vos questions dans ZCode et
l'agent appellera les outils Linkly AI de lui-même. Par exemple :

* « Recherche dans mes documents les décisions d'architecture concernant ce
  module »
* « Lis ma spécification d'API et vérifie si cette implémentation y correspond »

## Questions fréquentes

<AccordionGroup>
  <Accordion title="Les serveurs configurés dans .agents/mcp.json ont disparu">
    Au sein d'une même portée, la configuration `.zcode` est prioritaire : dès
    que ZCode lit un serveur MCP depuis le fichier de configuration `.zcode`, le
    fichier `.agents/mcp.json` de cette portée est entièrement ignoré au lieu
    d'être fusionné. Déplacez ces serveurs dans le fichier de configuration
    `.zcode`.
  </Accordion>

  <Accordion title="Échec de connexion avec la méthode HTTP">
    Vérifiez que Linkly AI Desktop est en cours d'exécution et que le service
    MCP est actif. Vous pouvez exécuter `curl http://127.0.0.1:60606/mcp` dans
    un terminal pour tester la connectivité.
  </Accordion>

  <Accordion title="Le serveur est listé mais ses outils sont indisponibles">
    Un serveur désactivé est marqué par `"enable": false` dans l'objet de
    configuration. Réactivez-le depuis la page **MCP Servers**, ou supprimez ce
    champ du fichier de configuration.
  </Accordion>

  <Accordion title="La méthode Stdio indique qu'elle ne trouve pas la commande linkly">
    Assurez-vous d'avoir [installé Linkly AI CLI](/docs/fr/use-cli) et que la
    commande `linkly` est disponible dans votre PATH. Vérifiez avec `linkly     --version`.
  </Accordion>
</AccordionGroup>