Démarrer

Configuration

acf-mcp est un serveur MCP local qui tourne sur le poste du client, lancé par npx en stdio. Il ne demande aucun secret et une seule variable d’environnement, pour la langue par défaut.

iNote

Aucun secret. acf-mcp ne stocke ni clé API, ni token, ni identifiant, et n’appelle aucun service distant pendant un appel d’outil : la doctrine, les règles et l’index de recherche sont embarqués dans le paquet.

Déclarer le serveur dans votre client

Tous les clients MCP (Claude Desktop, Cursor, Windsurf, Continue, Zed) utilisent la même déclaration : une commande et ses arguments. Le client lance le serveur et lui parle en stdio.

mcp-config.jsonjson

{
  "mcpServers": {
    "acf": {
      "command": "npx",
      "args": ["-y", "acf-mcp"],
      "env": {
        "ACF_MCP_LOCALE": "fr"
      }
    }
  }
}

Variable d’environnement

ACF_MCP_LOCALE"fr" | "en"default: "en"

Langue par défaut des ressources quand ni l’URI (?lang=) ni l’argument locale d’un outil ne la précisent. Le français et l’anglais sont servis ; toute autre valeur retombe sur l’anglais.

Choisir la langue appel par appel

L’ordre de priorité est le suivant : paramètre explicite (?lang= dans l’URI ou argument locale), puis ACF_MCP_LOCALE, puis l’anglais.

locale.tstypescript

// Per resource: ?lang=fr or ?lang=en
await client.readResource({ uri: "acf://fiche/ACF-13?lang=fr" });

// Per tool call: the locale argument
await client.callTool({
  name: "acf.glossary.define",
  arguments: { term: "DDAO", locale: "fr" },
});

Figer la version

npx -y acf-mcp prend la dernière version publiée. Pour un audit, figez la version : l’empreinte et la signature de la doctrine ne changent qu’avec elle.

mcp-config.jsonjson

{
  "mcpServers": {
    "acf": {
      "command": "npx",
      "args": ["-y", "acf-mcp@2.0.1"]
    }
  }
}

La version servie, son empreinte et sa clé publique se lisent dans la ressource acf://meta. Voir Signatures.