ACF
acfstandard.io
Developer docs
EN
Integration

Cursor

Ajoutez acf-mcp à Cursor pour que son agent appelle les outils de gouvernance ACF directement dans votre IDE.

iNote
Cursor est un IDE basé sur VS Code avec un agent intégré. Il supporte MCP en stdio et en HTTP, et accepte une configuration globale (~/.cursor/mcp.json) ou par projet (.cursor/mcp.json à la racine du repo).

Pré-requis

  • Node.js ≥ 18 (vérifiez avec node --version)
  • Cursor — cursor.com (macOS, Windows, Linux)

Installation

  1. Ouvrez les réglages MCP

    Deux options : interface graphique (Cursor → Settings → Features → MCP Servers → Add new server) ou édition directe du fichier JSON.

  2. Collez la configuration

    Éditez ~/.cursor/mcp.json (créez le fichier s’il n’existe pas). S’applique à tous les projets.

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

  3. Activez le serveur dans les réglages

    Settings → Features → MCP Servers : basculez le toggle acf sur ON. Cursor démarre le process et liste les outils détectés.

  4. Rechargez Cursor

    Cmd/Ctrl+Shift+P → « Developer: Reload Window » suffit. Pas besoin de quitter l’app.

Vérifier

  1. Vérifiez la liste d’outils

    Settings → MCP Servers : l’entrée acf doit afficher un point vert et le nombre d’outils détectés (13 attendus).

  2. Prompt de test dans le chat de l’agent

    Ouvrez le chat agent (Cmd/Ctrl+L), passez en mode Agent et tapez : « Utilise acf.advisor pour évaluer la gouvernance d’un agent qui qualifie des leads B2B ».

    L’agent doit appeler l’outil et retourner une réponse signée (doctrine_hash, doctrine_signature, generated_at).

Configuration avancée

Transport HTTP

Cursor accepte un endpoint HTTP distant. Utile pour mutualiser acf-mcp côté serveur ou enforcer une clé API par utilisateur.

~/.cursor/mcp.jsonjson
{
  "mcpServers": {
    "acf": {
      "url": "https://your-acf-mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACF_API_KEY"
      }
    }
  }
}

Voir /docs/authentication pour déployer acf-mcp en HTTP avec authentification par clé.

Auto-approbation

Par défaut Cursor demande approbation à chaque appel d’outil. Settings → Features → MCP → cochez les outils acf à auto-approuver. Tous les outils ACF sont déterministes et read-only côté agent : pas de risque d’effet de bord.

Dépannage

  • Point rouge à côté d’acf. Cliquez dessus pour ouvrir les logs du serveur. Cause la plus fréquente : Node introuvable ou JSON malformé.
  • L’agent n’affiche pas les outils MCP. Vérifiez que vous êtes en mode Agent (pas Chat). Le mode Chat ignore les outils MCP.
  • Conflit avec .cursor/mcp.json projet. La config projet écrase la config globale pour les serveurs portant le même nom. Renommez l’entrée (acf-local, acf-prod) si vous voulez les deux.
  • Cursor sur Windows ne trouve pas npx. Remplacez npx par npx.cmd dans la clé command.
  • Timeout au démarrage. Premier npx = téléchargement du paquet. Patientez ~10 s, rechargez la fenêtre. Les exécutions suivantes sont instantanées (cache npx).