Utiliser Linkly AI dans ZCode

Ce que vous pouvez faire

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.

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.

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.

Prérequis

ZCode installé
Linkly AI Desktop en cours d’exécution avec le service MCP actif

Étapes de configuration

MCP HTTP local (Recommandé)
MCP distant
CLI Stdio (Alternative)

Ouvrir la page MCP Servers

Ouvrez les Settings de ZCode, puis accédez à la page MCP Servers et cliquez sur New MCP Server.

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.

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.

Complétez d’abord la configuration de l’accès distant, avec le tunnel de bureau affichant ● Connecté.

Ouvrir la page MCP Servers

Ouvrez les Settings de ZCode, puis accédez à la page MCP Servers et cliquez sur New MCP Server.

Remplir la configuration distante

Remplissez les informations suivantes :

Type : HTTP
Name : linkly-ai
URL : https://mcp.linkly.ai/mcp

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 et commence par lkai_. Cliquez sur Add pour terminer.

Installez d’abord Linkly AI 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

{
  "mcp": {
    "servers": {
      "linkly-ai": {
        "command": "linkly",
        "args": ["mcp"],
        "env": {}
      }
    }
  }
}

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.

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.

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 :

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.

Consultez Utiliser les Skills pour découvrir d’autres méthodes d’installation et le fonctionnement des Skills.

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

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.

É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é.

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.

La méthode Stdio indique qu'elle ne trouve pas la commande linkly

Assurez-vous d’avoir installé Linkly AI CLI et que la commande linkly est disponible dans votre PATH. Vérifiez avec linkly --version.

Assistants IA

Agents IA de codage

Flux de travail IA

Autres

Utiliser Linkly AI dans ZCode

Ce que vous pouvez faire

Prérequis

Étapes de configuration

Installer les Skills

Premiers pas

Questions fréquentes

​Ce que vous pouvez faire

​Prérequis

​Étapes de configuration

​Installer les Skills

​Premiers pas

​Questions fréquentes

Ce que vous pouvez faire

Prérequis

Étapes de configuration

Installer les Skills

Premiers pas

Questions fréquentes