Outils MCP

Les outils Grace permettent à votre agent IA de consulter les bonnes consignes, puis de vérifier son travail. Vous lui expliquez ce que vous voulez faire ; il utilise les outils nécessaires.

MCP est le moyen de connexion entre votre agent IA et Grace. Si la connexion n’est pas encore prête, suivez le guide Brancher un projet.

Les outils

Quand en a-t-il besoin ?	Ce que l’agent IA peut faire
Avant de commencer une tâche	Consulter les consignes des talents qu’il a choisis pour cette tâche.
Une consigne demande une explication	Lire les détails de cette consigne.
Le travail est prêt à être relu	Obtenir les règles de vérification, puis les appliquer à ses changements.
Une décision d’architecture doit être comparée et ce mode est configuré	Présenter trois options distinctes avec leurs schémas, les mêmes critères et une recommandation qui vous laisse décider.
Votre organisation demande une trace de la revue	Enregistrer le résultat de la vérification des talents Grace et des Talents Custom.
Vous demandez de créer une règle durable pour l’organisation	Vous aider à rédiger une règle cohérente, vous faire valider son contenu exact, puis enregistrer un brouillon non publié. Cette possibilité est réservée aux owners et admins.
Vous avez validé de nouveaux talents	Ajouter ces talents au projet.
Un talent semble incomplet ou incompatible	Repérer les prérequis manquants et les conflits.
Il faut choisir les premiers talents	Examiner le projet et vous proposer des talents à valider.
Vous souhaitez signaler un problème ou proposer une idée	Préparer un retour limité aux informations utiles, vous montrer exactement ce qui sera envoyé, puis attendre votre accord explicite.

À retenir : Grace fournit les consignes. C’est l’agent IA qui effectue le travail et la revue. Obtenir une liste de règles ne signifie pas que les changements ont été vérifiés.

L'agent choisit les talents utiles à votre demande, puis reçoit la procédure détaillée lorsqu'il commence la revue. Cette revue doit rester centrée sur vos changements. Elle ne remplace pas les tests ni les contrôles de compilation et de style du projet après les dernières corrections. Si l'agent ne peut pas faire appel à un relecteur indépendant, il doit vous signaler cette limite.

À la fin d’une tâche accompagnée par Grace, la réponse de l’agent se termine par un bloc « Apports de Grace » composé uniquement d’un tableau. Chaque talent ayant réellement contribué occupe une ligne, sans limite arbitraire, avec son statut, son apport concret et la preuve observée. Les statuts distinguent ce qui a été amélioré ou vérifié de ce qui reste non appliqué, non vérifié ou non résolu. Les talents sans contribution sont omis. Sans talent contributeur, une ligne explicite indique qu’aucun apport n’a été observé.

Lorsque grace_prepare_task a fourni une URL, le bloc se termine par « Voir la résolution dans Grace ». Un membre du projet peut l’ouvrir pour retrouver le même détail que dans le drawer : parcours, constats, corrections et preuves. L’agent omet le lien si Grace n’en a pas fourni, sans essayer de le reconstruire.

Reconnaître les noms affichés dans mon agent IA

Nom affiché	À quoi cela sert
`grace_prepare_task`	Préparer les consignes de la tâche.
`grace_deepen`	Lire une consigne plus en détail.
`grace_review`	Obtenir le plan et les règles de revue.
`grace_record_validation`	Enregistrer les verdicts et les preuves de la revue.
`grace_present_architecture_comparison`	Présenter trois options d’architecture comparables et une recommandation argumentée, si votre préférence ou la règle du projet l’active.
`grace_create_organization_talent`	Après votre demande et votre accord explicites, enregistrer un brouillon de talent d’organisation sans l’activer.
`grace_install_talents`	Ajouter les talents que vous avez validés.
`grace_doctor`	Repérer les prérequis manquants et les conflits.
`grace_discover_codebase`	Aider à choisir les premiers talents du projet.
`grace-feedback`	Démarrer la préparation guidée d’un retour volontaire.
`grace_submit_feedback`	Envoyer uniquement le contenu que vous venez d’approuver.

Comparer des architectures

Ce mode se configure dans Grace, indépendamment des talents. La préférence est activée par défaut dans Profil > Comparaisons d’architecture, où chaque utilisateur peut la désactiver. Un projet peut aussi l’imposer à toute l’équipe dans Projet > Paramètres > Comparaison d’architecture. La règle du projet est prioritaire ; si elle n’est pas activée, chaque membre suit sa préférence. Lorsque la préférence est désactivée et que le projet ne l’impose pas, l’outil n’est pas exposé à l’agent.

Demandez ensuite à votre agent IA de comparer une décision d’architecture. Il présente exactement trois propositions backend avec, pour chacune, un schéma, les composants principaux, les avantages, les risques, la complexité, l’exploitation et la migration. Un tableau applique les mêmes critères aux trois propositions avant la recommandation.

La recommandation explique son adéquation à vos contraintes et le compromis principal. Elle ne valide pas la décision à votre place.

Sur un client compatible avec les interfaces MCP Apps, la comparaison apparaît aussi dans une vue visuelle intégrée à la conversation. Sur les autres clients, le même contenu reste disponible en Markdown avec les diagrammes Mermaid : l’interface enrichie n’est jamais nécessaire pour obtenir la comparaison complète.

Ce mode de présentation ne remplace pas un ADR. Le talent Architecture Decision Records documente les options réellement considérées, sans en imposer le nombre, et conserve uniquement une décision confirmée avec son contexte et ses conséquences.

Envoyer un feedback depuis votre agent

Le prompt et l’outil d’envoi sont proposés uniquement lorsque votre agent est connecté avec votre compte Grace par OAuth. Une clé API de projet ne peut ni les découvrir ni envoyer de feedback.

Lancez le prompt grace-feedback depuis l’interface MCP de votre agent. Décrivez le problème ou l’idée ; pour un problème, précisez le résultat attendu, le résultat observé et l’impact.

L’agent retire localement les secrets et les informations personnelles, puis affiche le contenu exact avant envoi. Vérifiez chaque champ : la suppression automatique peut laisser passer une information sensible. Une capture PNG ou JPEG est facultative, limitée à 2 Mio et doit être recadrée ou masquée avant approbation. Décrivez aussi dans le texte toute information nécessaire visible sur l’image : la capture reste un complément visuel.

Rien n’est envoyé sans votre accord explicite. Le rapport est remis aux administrateurs de la plateforme Grace avec son lien vers votre compte, votre organisation, votre projet et le client utilisé. Le rapport et sa capture sont supprimés après 30 jours. En cas d’échec, l’agent conserve le brouillon dans la conversation et ne peut annoncer un succès qu’avec une référence FB-….

Outil du mode pentest

Le mode pentest utilise une connexion MCP séparée qui n'expose qu'un outil :

Nom affiché	À quoi cela sert
`grace_pentest_guidance`	Obtenir les consignes versionnées d'une phase de test de sécurité. L'appel accepte uniquement la phase, l'agent IA et la langue parmi des choix prédéfinis.

Le serveur Grace général doit être désactivé dans cette session. Le test, les subagents, les outils, les preuves et le rapport restent sous la responsabilité de votre agent IA et de votre environnement client. Consultez Brancher un projet pour l'activer.

Ce que vous devez valider

L’agent IA vous propose les talents à installer. Il attend votre accord avant leur ajout. Une découverte de projet ne les installe pas à elle seule.

Pour créer un talent d’organisation, il vous montre d’abord le nom, la consigne, le mode d’application et les déclencheurs exacts. Toute modification de cet ensemble exige un nouvel accord. L’outil enregistre seulement un brouillon : la publication reste une action distincte dans le dashboard Grace.

Si Grace ne répond pas ou refuse l’accès, consultez le dépannage. Pour comprendre les expertises proposées, lisez Qu’est-ce qu’un talent ?.