ACF
acfstandard.io
Developer docs
EN
Integration

Claude Desktop

Branchez acf-mcp à Claude Desktop en une minute. Configuration locale via stdio, aucune clé API requise.

iNote
Claude Desktop est l’application bureau officielle d’Anthropic (macOS et Windows). Elle supporte nativement MCP via un fichier JSON local.acf-mcp y tourne en stdio : Claude le démarre lui-même via npx, aucune route HTTP à provisionner.

Pré-requis

  • Node.js ≥ 18 (vérifiez avec node --version)
  • Claude Desktop — claude.ai/download (macOS ou Windows)

Installation

  1. Ouvrez le fichier de configuration

    Le fichier est créé au premier lancement. S’il n’existe pas, créez-le.

    bash
    ~/Library/Application Support/Claude/claude_desktop_config.json

    Raccourci dans l’app : Claude → Settings → Developer → Edit Config.

  2. Collez le bloc de configuration

    Si le fichier contient déjà des serveurs MCP, ajoutez l’entrée acf à l’objet mcpServers existant.

    claude_desktop_config.jsonjson
    {
  "mcpServers": {
    "acf": {
      "command": "npx",
      "args": ["-y", "acf-mcp"]
    }
  }
}

  3. Quittez et relancez Claude Desktop

    Cmd+Q sur macOS, fermer toutes les fenêtres puis quitter via la barre des tâches sur Windows. Un simple rafraîchissement de fenêtre ne recharge pas la config MCP.

Vérifier

  1. Cherchez l’icône MCP en bas du chat

    Une petite icône marteau/outil apparaît sous la zone de saisie. Cliquez dessus : vous devez voir acf listé avec ses outils (acf.advisor, acf.search, etc.).

  2. Demandez une preuve de vie signée

    Tapez : « Utilise acf.advisor pour évaluer la gouvernance d’un agent qui qualifie des leads B2B ».

    La réponse doit contenir un footer signé avec doctrine_hash, doctrine_signature et generated_at.

Configuration avancée

Variables d’environnement

Passez des variables via le champ env. Toutes sont optionnelles.

claude_desktop_config.jsonjson
{
  "mcpServers": {
    "acf": {
      "command": "npx",
      "args": ["-y", "acf-mcp"],
      "env": {
        "ACF_LOG_LEVEL": "info"
      }
    }
  }
}
  • ACF_LOG_LEVEL — verbosité des logs (debug | info | warn | error). Par défaut info.

Transport

Claude Desktop ne supporte que le transport stdio. Pour HTTP (multi-utilisateurs, auth API key), déployez acf-mcp derrière un proxy et utilisez un autre client (Cursor, Continue) — voir /docs/authentication.

Dépannage

  • L’icône MCP n’apparaît pas. Le JSON est invalide. Validez-le avec jq ou un linter ; une virgule manquante suffit à désactiver TOUS les serveurs MCP silencieusement.
  • « Server disconnected » dans Developer logs. npx ne trouve pas Node. Sur macOS, lancez Claude depuis le Finder (pas depuis un terminal qui modifie PATH) et vérifiez que /usr/local/bin/node existe.
  • Tail des logs MCP. macOS :
    bash
    tail -f ~/Library/Logs/Claude/mcp*.log
    Windows :
    powershell
    Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Wait
  • L’agent ignore l’outil. Nommez explicitement l’outil dans le prompt (« utilise acf.advisor… »). Claude choisit ses outils ; il faut parfois l’y inviter au premier essai.
  • Première exécution lente. npx télécharge le paquet la première fois (~3–10 s). Les exécutions suivantes utilisent le cache.