Ce que votre assistant peut faire avec Aggrega
Une fois votre assistant connecté au serveur MCP d’Aggrega, il travaille avec le même binaire aggrega que vous exécuteriez dans un terminal : il lit les schémas et la documentation, rédige des brouillons de vos fichiers et les vérifie, construit une Release et, lorsque vous l’y autorisez, publie. Cette page indique ce que cela couvre, par groupes. La liste complète est la réponse du serveur lui-même, et c’est à elle qu’il faut se fier : appelez describe-capabilities sans arguments, ou demandez-le à votre assistant, et le serveur liste chaque outil qu’il vous propose, chacun avec son objet en une ligne, les types d’entité qu’il sert et s’il écrit. Compatibilité indique ce qu’une release peut modifier dans les outils.
Lire les schémas et la documentation
Le serveur fournit la documentation de référence qu’un assistant lit avant d’écrire du YAML : le JSON Schema d’une entité (schema://<kind>), toute page de la référence du langage (langref://<path>), le guide de rédaction (authoring://<topic>), le YAML rédigé d’une entité du catalogue (catalog://<kind>/<name>) et l’aide de toute commande (cli://<command>). Les schémas sont intégrés au binaire, et les pages proviennent d’une copie de la documentation que le serveur conserve dans le cache de votre machine. Ce qu’il fait liste chaque famille.
Endosser un rôle ou suivre un workflow
Les prompts de rédaction placent l’assistant dans le rôle d’un développeur, d’un architecte ou d’un auteur d’exploitation, ou le concentrent sur un seul type d’entité, de sorte que ses suggestions restent dans ce que ce rôle rédige. Les prompts de workflow établissent l’ordre des appels pour un objectif qui en demande plusieurs : composer un nouvel Aggregate et sa Release, faire entrer dans Aggrega un chart, un module d’infrastructure ou un fichier Compose existant, ou comprendre pourquoi un build échoue. Votre client les liste comme les prompts du serveur.
Découvrir ce que contient un espace de travail
list-entities et list-releases indiquent ce que contient votre espace de travail et en quelle quantité, puis remettent les enregistrements une page à la fois ; describe montre une entité ou tout ce qu’atteint une Release ; config-show rapporte la configuration en vigueur et l’origine de chaque paramètre. Le serveur rapporte aussi les caches, les registres configurés et les plugins qu’il résout. Voir Découvrir ce que contient un espace de travail.
Rédiger et vérifier vos fichiers
scaffold rédige un document de départ pour un type d’entité, avec les champs que ce type exige, ou écrit l’un des exemples exécutables de la documentation dans un nouveau répertoire. get-schema renvoie le JSON Schema d’un type, validate vérifie un brouillon et nomme chaque espace réservé qui s’y trouve encore, lint vérifie les conventions de publication du catalogue, et explain-error développe un diagnostic en la correction qu’il appelle. D’autres outils répondent aux questions qui se posent pendant l’édition : quelles Features peuvent s’attacher à un composant et à quoi celui-ci peut se connecter, où une nouvelle entrée doit se placer dans un fichier, et une modification délimitée unique appliquée à un document, chaque octet qu’elle ne touche pas restant tel quel. Voir Demander ce qui peut s’attacher, et ce qui peut se connecter à quoi et Appliquer une modification délimitée unique à un document.
Résoudre et construire une Release
pull résout les dépendances d’une Release dans le cache et écrit son fichier de verrouillage, et build produit le rendu de la Release en ses artefacts, en mémoire par défaut ou dans dist/ à la racine de l’espace de travail lorsque l’assistant lui demande de les écrire. Un build refusé renvoie les diagnostics qui disent quoi corriger. Voir Résoudre ce dont dépend une Release et Construire à partir du contenu qu’une Release épingle déjà.
Importer un projet depuis un autre outil
import lit une description produite par un autre outil et écrit des brouillons de fichiers Aggrega dans l’espace de travail, pour que vous les relisiez. Voir Transformer une description étrangère en brouillons d’entités et aggrega import pour les formats qu’il lit.
Publier, signer et retirer
Quatre outils placent une entité ou un artefact dans un registre, signent ce qui y est publié, ou le retirent avec un marqueur signé. Ce qu’ils modifient atteint toute personne qui résout depuis ce registre, et rien de tout cela ne peut être repris à quelqu’un qui l’a déjà ; ce sont donc les outils auxquels réfléchir avant de les autoriser. Voir Publier, signer et retirer.
Exécuter n’importe quelle commande
Pour un client qui a démarré le serveur sur votre propre machine, via l’entrée et la sortie standard, le serveur propose aussi un outil pour chaque commande que vous pourriez taper, nommé d’après elle : cli-build exécute aggrega build, cli-validate exécute aggrega validate, et ainsi de suite. Un serveur joint via HTTPS n’en propose aucun.
Ce qu’il peut faire sans vous demander
Un assistant connecté via l’entrée et la sortie standard peut appeler chaque outil que propose le serveur sans vous demander, sauf si votre client est configuré pour le refuser. C’est dans votre client que vous autorisez et refusez les outils par leur nom. Ce qu’un assistant peut faire sans vous demander d’abord nomme les opérations qui vont au-delà de votre espace de travail, et Restreindre ce que le serveur annonce raccourcit la liste des outils lorsque votre client ne l’accepte pas en entier.