Outils MCP
Les 6 outils exposés par le serveur MCP de Grace et leur endpoint backend.
Le serveur MCP (platform/mcp/) est un adaptateur de protocole : il expose des outils
MCP en Streamable HTTP, valide le bearer, et traduit chaque appel en requête HTTP vers
le backend NestJS. Toute la logique vit dans le backend.
Les 6 outils
| Outil | Rôle | Endpoint backend |
|---|---|---|
grace_resolve_context(task, agent?, language?, depth?) | Bloc compilé des talents actifs, filtré par rôle, trié par pertinence à la tâche / priorité. depth = compact (défaut) / standard / full. | POST /resolve |
grace_search(query, k?) | Recherche dans les talents activés. | GET /search |
grace_get(uri, section?) | Contenu d'un fichier de talent (grace://talents/…) ; refusé si le talent n'est pas activé. | POST /talents/get |
grace_validate(files? | diff?, language?) | Checks structurels des talents enforceable activés → violations typées (sévérité). | POST /validate |
grace_configure(talent, enabled) | Active/désactive un talent (écrit en DB). | PATCH /projects/current/talents |
grace_doctor() | Prérequis manquants / conflits sur la sélection courante. | GET /doctor |
Le projet est déduit du bearer — les outils ne prennent jamais d'id de projet.
Altitudes (depth)
grace_resolve_context(depth=…) règle la quantité de contexte, guidée par le
token_budget du talent :
compact(défaut) — lecompact.md(toujours présent).standard— compact +rules.md.full— la doc complète (talent.md), sinon compact + règles + workflow.
Voir Concepts → Altitude pour le principe.
Coût contexte
Les schémas des 6 outils sont déférés par Claude Code (≈ 0 token au repos, ~900 chargés à la demande) — d'où la discipline « surface d'outils minimale ».
Boucle de bout en bout
grace_resolve_context ne renvoie que les talents actifs → grace_configure(talent, false)
depuis le LLM désactive un talent → le resolve suivant ne le renvoie plus → le dashboard
reflète le changement (même base). Bidirectionnel, temps réel.
→ Voir Moteur de résolution pour le détail de la
composition, et Validation pour grace_validate.