Integration

Zed

Branchez acf-mcp à Zed via le système context_servers. Configuration minimaliste, alignée sur la philosophie de l’éditeur.

iNote

Zed est un éditeur natif (Rust) avec un agent intégré. Depuis fin 2025, il supporte MCP via la clé context_servers du fichier ~/.config/zed/settings.json (macOS/Linux) ou %APPDATA%\Zed\settings.json (Windows). Le mappage interne traduit context_servers en serveurs MCP — la sémantique est identique.

Pré-requis

Node.js ≥ 18 (vérifiez avec node --version)
Zed — zed.dev (macOS, Linux, preview Windows)

Installation

Ouvrez settings.json
Cmd/Ctrl+, (virgule) ouvre les réglages. Cliquez sur le lien « Open settings.json » en haut.
bash
~/.config/zed/settings.json
Ajoutez le bloc context_servers
Fusionnez avec vos réglages existants. La forme est { command: { path, args, env? } } — pas { command: "npx", args: [...] } comme dans Cursor/Claude Desktop.
settings.jsonjson
```
{
  "context_servers": {
    "acf": {
      "command": {
        "path": "npx",
        "args": ["-y", "acf-mcp"]
      }
    }
  }
}
```
Rechargez le projet
Zed recharge settings.json à chaque sauvegarde. Si l’Assistant Panel ne voit pas le serveur, faites Cmd/Ctrl+Shift+P → « workspace: reload ».

Vérifier

Ouvrez l’Assistant Panel
Cmd/Ctrl+? (ou icône étincelle dans la barre latérale). Tapez / pour voir les slash commands : les outils acf doivent y figurer en tant que /acf.advisor, /acf.search, etc.
Smoke test
Tapez : « Utilise acf.advisor pour évaluer la gouvernance d’un agent qui qualifie des leads B2B ».
La réponse insérée par l’assistant doit contenir le footer signé (doctrine_hash, doctrine_signature, generated_at) — Zed n’altère pas la sortie de l’outil.

Configuration avancée

Variables d’environnement

settings.jsonjson

{
  "context_servers": {
    "acf": {
      "command": {
        "path": "npx",
        "args": ["-y", "acf-mcp"],
        "env": {
          "ACF_LOG_LEVEL": "info"
        }
      }
    }
  }
}

Transport

Zed ne supporte que le transport stdio pour les context_servers à date. Pour HTTP, utilisez un autre client ou attendez la stabilisation MCP côté Zed.

Slash commands

Zed expose chaque outil MCP comme slash command dans l’Assistant Panel. C’est la façon idiomatique de les invoquer en raccourci : tapez /acf et complétez.

Dépannage

Schéma command incorrect. Erreur la plus fréquente. Zed exige command: { path, args } imbriqué, pas command: \"npx\", args: [...] au même niveau.
Slash command absente. Le serveur est probablement démarré mais sans outils. Reloadez la fenêtre. Si le problème persiste, lancez `zed --foreground` dans un terminal pour voir les logs en clair.
Zed ne lit pas la config. Vérifiez que vous éditez settings.json (réglages user) et pas project-settings.json. Les context_servers ne s’appliquent qu’au niveau user.
JSON5 vs JSON strict. Zed accepte JSON5 (commentaires, trailing commas) — mais le parser est strict sur les chaînes échappées. Préférez un éditeur qui colore JSON5 pour éviter les pièges.
Modèle sans tool-use. L’Assistant Panel doit être configuré sur un modèle qui supporte les outils (Claude Sonnet 4.5, GPT-4o). Les modèles legacy sans function-calling ignoreront acf-mcp.

Pré-requis

Installation

Ouvrez settings.json

Ajoutez le bloc context_servers

Rechargez le projet