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.

Gestion des secrets et variables avec mise

Plutôt que d'écrire le secret en clair dans le .mcp.json, tu peux y référencer une variable d'environnement ("API_KEY": "${MON_API_KEY}") et laisser mise l'injecter depuis un fichier local :

1. Déclare mise.toml à la racine de ton projet :

[env]
# Fichiers absents : silencieusement ignorés. `redact` masque les valeurs dans la sortie.
_.file = [".env", { path = ".env.local", redact = true }]

2. Place tes clés secrètes dans .env.local — ignoré par Git : MON_API_KEY="ma_cle_secrete".
3. mise injecte la variable lors de l'exécution de Claude Code, Codex ou Antigravity.

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_prepare_task(task, agent, language)` et suis les règles renvoyées.
2. Si aucun talent n'est actif — n'écris pas de code : appelle `grace_discover_codebase` et suis la
   procédure renvoyée jusqu'à l'installation, après validation explicite de l'utilisateur.
3. Au besoin — approfondis avec `grace_deepen({ uri })` (lignes « Quand approfondir »).
4. Avant de terminer — appelle `grace_validate(files | diff)` et corrige toute violation.

Le stub complet servi par le dashboard vit dans platform/backend/src/web/mcp-snippet.ts — c'est lui qui fait foi.

4. Activer des talents

Depuis le dashboard (page projet) ou depuis le LLM via grace_install_talents({ talents: [...] }), qui installe seulement : désactiver et désinstaller restent au dashboard. Le MCP ne sert au LLM que les talents actifs. Voir le modèle « installé vs catalogue » dans Gérer les spécialisations.

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.