Les 15 outils MCP pour les cas de test, les plans de test, les exécutions, les environnements et les preuves externes.

Autonomy MCP expose 15 outils générés à partir du même catalogue d’opérations que l’API HTTP. Les noms ci-dessous sont stables et utilisent le glossaire du produit : un cas de test est une séquence exécutable d’étapes, tandis qu’un plan de test est une sélection ordonnée de cas de test.

Cas de test

Outil	Objet
`autonomy_test_case_list`	Répertorier les cas de test de l’organisation, du plus récent au plus ancien. Filtrer par plateforme ou par recherche sur le nom. À utiliser avant de créer un cas afin de réutiliser la couverture existante.
`autonomy_test_case_get`	Récupérer un cas de test avec sa liste complète d’étapes.
`autonomy_test_case_create`	Créer un cas de test à partir d’étapes explicites. Les valeurs de remplissage sont `literal`, `agent` (choisie par l’agent au moment de l’exécution) ou `environment` (valeur d’exécution nommée de l’environnement) ; les littéraux ressemblant à des identifiants sont refusés, sauf s’ils sont explicitement déplacés vers un secret d’environnement.
`autonomy_test_case_update_steps`	Remplacer toute la liste d’étapes d’un cas de test. Nécessite `confirm: true` ; sans cela, la réponse décrit ce qui changerait et rien n’est écrit.

Plans de test

Outil	Objet
`autonomy_test_plan_list`	Répertorier les plans de test (sélections nommées de cas de test) de l’organisation.
`autonomy_test_plan_get`	Récupérer un plan de test avec ses cas de test membres ordonnés.
`autonomy_test_plan_create`	Créer un plan de test et, facultativement, ses cas de test membres initiaux ordonnés.
`autonomy_test_plan_set_members`	Remplacer les membres ordonnés d’un plan de test. La suppression de cas nécessite `confirm: true` ; sans cela, la réponse répertorie les cas qui seraient retirés et rien n’est écrit.

Exécutions et preuves

Outil	Objet
`autonomy_run_trigger`	Mettre des exécutions en file d’attente. Fournir exactement l’un de testCaseId ou testPlanId (un plan met en file une exécution par cas membre). Cibler un environnement enregistré par son slug, ou transmettre des cibles explicites pour un nouveau déploiement ou artefact. Renvoie immédiatement une réponse ; poursuivre avec run.get.
`autonomy_run_list`	Répertorier les exécutions récentes, de la plus récente à la plus ancienne. Filtrer par statut, cas de test, environnement ou branche. Vérifier ici avant de déclencher un travail en double.
`autonomy_run_get`	Récupérer l’état d’une exécution. Transmettre le `cursor` précédent et `waitMs` (≤ 25000) pour bloquer jusqu’à ce qu’un changement survienne ; `timedOut: true` signifie que rien n’a changé et ne constitue pas une erreur. `next` est un conseil, jamais une autorité.
`autonomy_run_evidence`	Preuves externes d’une exécution : pour chaque étape, ce que le produit a affiché, ce qui était attendu, le verdict et le diagnostic, les actions neutres et les liens de médias à courte durée de vie. Jamais d’informations internes sur le modèle, le prompt, les jetons ou le moteur d’exécution. Filtrer avec `step`.

Environnements

Outil	Objet
`autonomy_environment_list`	Répertorier les environnements (cibles de déploiement nommées) avec leurs cibles par plateforme. Les noms des valeurs d’exécution sont affichés, mais jamais leurs valeurs.
`autonomy_environment_get`	Récupérer un environnement par son slug.
`autonomy_environment_upsert`	Créer un environnement ou en mettre un à jour par son slug. La mise à jour d’un slug existant remplace les cibles fournies et nécessite `confirm: true` ; sans cela, la réponse décrit le changement et rien n’est écrit.

Les notes sont disponibles uniquement via l’API HTTP et ne sont pas des outils MCP.

Confirmation des remplacements

Autonomy ne demande pas de seconde confirmation interactive dans MCP. À la place, les opérations qui remplacent une configuration existante nécessitent un confirm: true explicite :

autonomy_test_case_update_steps remplace toujours toute la liste d’étapes.
autonomy_test_plan_set_members nécessite une confirmation lorsque la nouvelle liste de membres retire des cas.
autonomy_environment_upsert nécessite une confirmation lorsque son slug existe déjà et que les champs fournis seraient mis à jour.

Sans confirmation, l’outil renvoie INVALID_ARGUMENT avec confirmRequired: true et un résumé wouldChange. Lisez ce résumé avant de réessayer avec confirm: true ; n’ajoutez pas de confirmation par réflexe.

Attendre une exécution

autonomy_run_trigger renvoie immédiatement une réponse. Poursuivez avec autonomy_run_get :

Appelez autonomy_run_get avec le runId renvoyé.
Enregistrez le cursor numérique de la réponse.
Tant que next vaut wait, rappelez-le avec ce cursor et une valeur waitMs pouvant aller jusqu’à 25000.
Une réponse avec timedOut: true signifie que l’exécution n’a pas changé pendant cette attente. Ce n’est pas une erreur ; recommencez avec le même curseur ou cessez d’attendre.
Lorsque next vaut evidence, appelez autonomy_run_evidence.

next est un conseil, pas une autorité. Utilisez le statut, le verdict, la validité, la progression et l’état des étapes renvoyés pour décider de la marche à suivre.

Preuves externes

autonomy_run_evidence renvoie uniquement les preuves qu’une organisation peut extraire d’Autonomy : actions et cibles des étapes, résultats observés et attendus, verdict et validité, diagnostic, nombre de récupérations, ainsi que des liens à courte durée de vie vers des captures d’écran, des images ou des vidéos. Les liens de médias expirent après 15 minutes ; rappelez l’outil pour obtenir de nouveaux liens.

Les preuves externes n’incluent jamais l’identité du modèle ou du fournisseur, les prompts, les chiffres relatifs aux jetons ou aux coûts, les erreurs brutes du moteur d’exécution, les noms d’outils internes ni les arborescences brutes de l’interface utilisateur.

Cibles de déclenchement

autonomy_run_trigger accepte platforms avec web, api, ios et android. Utilisez environmentSlug lorsque la cible est déjà enregistrée. Utilisez targets pour un nouveau déploiement ou artefact.

Plateforme	Champs de cible
Web	`targets.web.baseUrl`
API	`targets.api.baseUrl`, `targets.api.runtimeValues` facultatif
iOS	`targets.ios.artifactUrl` ou `targets.ios.storageId` analysé, ainsi que `targets.ios.bundleId`
Android	`targets.android.artifactUrl` ou `targets.android.storageId` analysé, ainsi que `targets.android.packageName`

Fournissez exactement l’un de testCaseId ou testPlanId. Ajoutez branch, pr et deployment.commitSha lorsque les exécutions doivent être rattachées à une pull request ou à un commit.

Portées OAuth

Les outils de lecture nécessitent autonomy:read. L’accès en écriture est séparé par ressource :

autonomy:test_cases:write
autonomy:test_plans:write
autonomy:runs:write
autonomy:environments:write

La portée autonomy:notes:write appartient aux opérations Notes accessibles uniquement via HTTP.

Recettes pour agents

Vérifier la couverture existante

Codetext

Use Autonomy MCP to list relevant Test Cases, Test Plans, and recent Runs.
If a relevant Run already exists for this branch or PR, summarize its status before triggering anything new.

Exécuter une prévisualisation de PR

Codetext

Use Autonomy MCP to trigger the relevant Test Case or Test Plan against this preview URL.
Pass the branch, PR number, and commit SHA. Wait for the Run to finish, then return its verdict and External Evidence.

Diagnostiquer un échec

Codetext

Fetch the Autonomy Run and its External Evidence before proposing a fix.
Cite the failing step, observed outcome, diagnosis, and media link that support your conclusion.

Actions disponibles

Cas de test

Plans de test

Exécutions et preuves

Environnements

Confirmation des remplacements

Attendre une exécution

Preuves externes

Cibles de déclenchement

Portées OAuth

Recettes pour agents

On this page