Introduction
Démarrage rapide
Lancer la plateforme Grace en local avec Docker Compose.
Lancer la plateforme
cd platform
cp .env.example .env
docker compose up --buildUne fois les services démarrés :
| Service | URL | Détail |
|---|---|---|
| Dashboard | http://localhost:8080 | connexion e-mail/mot de passe, Google ou SSO d'org |
| API backend | http://localhost:3000/health | santé du backend NestJS |
| Endpoint MCP | http://localhost:3001/mcp | point d'entrée du serveur MCP |
| Ingress Caddy (HTTPS local) | https://localhost · https://mcp.localhost/mcp | accès via le reverse-proxy |
En local, le compte démo seedé (GRACE_OWNER_EMAIL / GRACE_OWNER_PASSWORD) se connecte
immédiatement en e-mail/mot de passe, dans une organisation démo déjà approuvée. La
connexion Google nécessite un client OAuth configuré (GRACE_GOOGLE_CLIENT_ID /
GRACE_GOOGLE_CLIENT_SECRET). Après connexion, on crée ou rejoint une organisation ; l'accès au
serveur MCP nécessite qu'elle soit approuvée par un admin plateforme
(GRACE_PLATFORM_ADMIN_EMAILS). Voir Variables d'environnement → Auth.
Le détail des services, ports, ingress, base de données et seed est couvert dans Déploiement → Dev local.
Brancher un projet
- Dans le dashboard, crée (ou rejoins) une organisation, crée un projet dedans, puis copie le
.mcp.jsongénéré à la racine de ton repo (ajoute-le au.gitignore: il contient un token). Le serveur MCP ne répond que si l'organisation est approuvée. - Ajoute le stub d'amorçage à ton
CLAUDE.md(fourni par le dashboard) pour que l'agent appelle Grace au bon moment. - Active des talents (dashboard ou
grace_configure) ; l'agent appelle ensuitegrace_resolve_contextpuisgrace_validate.
Le pas-à-pas complet est dans Guides → Brancher un projet.