Brancher un projet

Ce guide branche un repo existant sur Grace pour que ton agent de code consulte les talents au bon moment.

1. Créer le projet dans le dashboard

Dans le dashboard (/projects/new), crée un projet. L'onboarding se fait en deux étapes : le .mcp.json et le stub CLAUDE.md.

2. Déposer le .mcp.json à la racine du repo

Le token est généré à la création et affiché une seule fois (seul son hash est stocké). Copie le fichier généré à la racine de ton repo :

{
  "mcpServers": {
    "grace": {
      "type": "http",
      "url": "http://localhost:3001/mcp",
      "headers": { "Authorization": "Bearer <TOKEN_PROJET>" }
    }
  }
}

En production, l'URL devient https://mcp.<domaine>/mcp.

Le projet est déduit du bearer : les outils MCP ne prennent jamais d'id de projet.

3. Ajouter le stub d'amorçage au CLAUDE.md

Sans cette consigne, l'agent ne sait pas qu'il doit consulter Grace. Colle ce bloc dans le CLAUDE.md du repo (le dashboard le fournit) :

## Talents Grace (MCP)
Pour toute tâche de code :
1. Au début — appelle `grace_resolve_context(task, agent, language)` et suis les règles renvoyées.
2. Au besoin — approfondis avec `grace_get(uri)` (lignes « Quand approfondir »).
3. Avant de terminer — appelle `grace_validate(files | diff)` et corrige toute violation.

4. Activer des talents

Depuis le dashboard (page projet) ou depuis le LLM via grace_configure(talent, enabled). Le MCP ne sert au LLM que les talents actifs. Voir le modèle « installé vs catalogue » dans Gérer les personas.

5. Enregistrer le serveur dans Claude Code

Le .mcp.json à la racine suffit (scope projet). Au démarrage de la session, Claude Code le charge ; approuve le serveur grace une fois. Les outils grace_* deviennent alors disponibles, scopés au projet du token.

→ La référence complète des outils est dans Outils MCP.