ACF
acfstandard.io
Developer docs
EN
Integration

Windsurf

Connectez acf-mcp à Windsurf (Codeium) pour que Cascade dispose des outils de gouvernance ACF dans ses workflows agentiques.

iNote
Windsurf est l’IDE agentique de Codeium. Son agent intégré, Cascade, lit les serveurs MCP déclarés dans ~/.codeium/windsurf/mcp_config.json. La configuration est globale (pas de fichier par projet à ce jour).

Pré-requis

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

Installation

  1. Ouvrez le panneau Cascade

    Cliquez sur l’icône Cascade dans la barre latérale, puis sur l’icône en haut à droite : Settings → MCP Servers.

  2. Éditez mcp_config.json

    Le bouton « Add Server » ouvre le fichier JSON. Sinon, ouvrez-le directement :

    bash
    ~/.codeium/windsurf/mcp_config.json
    mcp_config.jsonjson
    {
  "mcpServers": {
    "acf": {
      "command": "npx",
      "args": ["-y", "acf-mcp"]
    }
  }
}

  3. Rafraîchissez les serveurs MCP

    Dans Cascade → Settings → MCP Servers, cliquez sur « Refresh ». Windsurf relit le fichier sans redémarrage.

Vérifier

  1. Confirmez que acf est listé

    Cascade → MCP Servers : l’entrée acf doit afficher 13 outils détectés (8 REASON + 5 READ).

  2. Lancez un prompt de test

    Dans la conversation Cascade, tapez : « Utilise acf.advisor pour évaluer la gouvernance d’un agent qui qualifie des leads B2B ».

    Cascade demande l’autorisation d’appeler l’outil, puis affiche la réponse signée (doctrine_hash, doctrine_signature, generated_at).

Configuration avancée

Variables d’environnement

mcp_config.jsonjson
{
  "mcpServers": {
    "acf": {
      "command": "npx",
      "args": ["-y", "acf-mcp"],
      "env": {
        "ACF_LOG_LEVEL": "debug"
      }
    }
  }
}

Utile pour activer le mode debug pendant le premier branchement (logs verbeux dans la console Cascade).

Transport

Windsurf supporte uniquement stdio à date. Pour un endpoint HTTP partagé en équipe, utilisez Cursor ou Continue côté client et déployez acf-mcp en HTTP — voir /docs/authentication.

Cascade rules

Ajoutez à votre .windsurfrules projet : « When the user asks about agent governance, compliance or AI-Act conformity, prefer calling acf.advisor before answering ». Cascade s’y conformera dans tous les workflows agentiques.

Dépannage

  • « 0 tools detected ». Le serveur a démarré mais a planté sur le handshake initial. Activez ACF_LOG_LEVEL=debug et cliquez Refresh pour voir l’erreur côté Cascade.
  • Refresh sans effet. Sur certaines versions, un quit/relaunch complet de Windsurf reste nécessaire après modification du JSON.
  • Permissions refusées en boucle. Activez « Always allow » pour acf dans les réglages Cascade. Tous les outils ACF sont read-only côté agent (pas de write filesystem, pas d’appel HTTP sortant).
  • Erreur ENOENT npx. Cascade ne charge pas votre PATH shell. Mettez le chemin complet : /usr/local/bin/npx (macOS/Linux) ou C:\Program Files\nodejs\npx.cmd (Windows).
  • Modèle qui n’utilise pas les outils. Certains modèles plus petits dans Cascade ignorent MCP. Basculez sur Claude Sonnet 4.5 ou GPT-4o dans les réglages Cascade.