ACF
acfstandard.io
Developer docs
EN
Référence

Erreurs

Ce que renvoie acf-mcp quand un appel échoue : une erreur JSON-RPC dont le message dit précisément ce qui ne va pas. Le serveur ne devine jamais une valeur à votre place.

iNote
Toutes les erreurs arrivent avec le code JSON-RPC -32603. Il n’y a pas de code d’erreur propre à ACF® : c’est le texte du message qui distingue les cas et il est fait pour être lu par un agent comme par un humain.

Paramètres invalides

Chaque outil valide ses entrées contre son schéma avant tout calcul. Une valeur hors énumération, un champ manquant ou une longueur hors bornes fait échouer l’appel ; le message est la liste des problèmes, chacun avec le champ en cause (path), la valeur reçue et les valeurs admises.

validation-error.jsonjson
{
  "jsonrpc": "2.0",
  "id": 2,
  "error": {
    "code": -32603,
    "message": "[\n  {\n    \"received\": \"N2\",\n    \"code\": \"invalid_enum_value\",\n    \"options\": [\n      \"suggestive\",\n      \"co_decision\",\n      \"supervised_autonomous\",\n      \"autonomous\"\n    ],\n    \"path\": [\n      \"autonomy_level\"\n    ],\n    \"message\": \"Invalid enum value. Expected 'suggestive' | 'co_decision' | 'supervised_autonomous' | 'autonomous', received 'N2'\"\n  }\n]"
  }
}

Cas fréquent depuis la 2.0.0 : l’ancien acf_level (N0 à N3) est refusé ; le champ s’appelle autonomy_level et prend les 4 niveaux d’autonomie déléguée. Voir Autonomie et maturité.

Ressource introuvable

Un code ou un terme valide en forme mais absent du corpus produit un message explicite :

not-found.jsonjson
{
  "jsonrpc": "2.0",
  "id": 4,
  "error": {
    "code": -32603,
    "message": "Fiche ACF-00 not found in any locale chain for en"
  }
}
  • Fiche ACF-XX not found in any locale chain : fiche absente, par exemple l’ancien ACF-00.
  • Glossary entry not found: … : terme hors glossaire ; passez par acf.search.
  • Article … not found. Available articles for … : article non couvert ; le message liste ceux qui le sont.
  • Invalid scheme: expected acf://, Unknown ACF URI : URI mal formée ; récupérez-la avec resources/list ou acf.search.
  • Unknown tool: … : nom d’outil inconnu ; la liste des 13 outils se lit avec tools/list.

Que faire

  • Corrigez la valeur indiquée par le message et rappelez l’outil : aucun appel n’a d’effet de bord, il peut être rejoué sans risque.
  • Quand un outil répond mais avec confidence à low, ce n’est pas une erreur : lisez assumptions et gaps_to_validate, puis complétez l’entrée.
  • Vérifiez la version installée (npx acf-mcp@latest) si une fiche ou un outil attendu manque.

Voir aussi