Passer au contenu principal

Outils disponibles sur le serveur MCP de Thunders

Écrit par Ines

Tout ce que le serveur Thunders MCP met à disposition : 53 outils. Si votre rôle dans l'organisation est Lecture seule, votre assistant ne voit que les outils marqués Lecture.

Projets et applications

Outil

Accès

Fonctionnalités

Paramètres

get_all_projects

Lire

Liste tous les projets auxquels vous avez accès.

filter, orderBy, first: tous facultatifs. Filtrer et trier par id, nom, url.

get_apps_by_project_id

Lecture

Répertorie les applications configurées dans un projet.

projectId

Cas de test

Outil

Accès

Fonctionnalité

Paramètres

get_all_test_cases

Lire

Répertorie les cas de test avec leurs étiquettes, leurs ensembles de test et leurs étapes. La réponse est volumineuse : pour trouver un cas de test, utilisez search_test_cases.

projectId (fortement recommandé), first, orderBy, fields, tous facultatifs. Utilisez fields pour ne garder que les champs utiles.

search_test_cases

Lecture

Trouve les cas de test d'un projet par texte, étiquettes et statut. Renvoie un court résumé de chaque résultat, du plus récemment modifié au plus ancien. Utilisez get_test_case_by_id pour lire les étapes d'un résultat.

projectId. Facultatif : query (texte contenu dans le nom ou la description), labels (un cas de test doit porter toutes ces étiquettes), status, fields, first.

get_test_case_by_id

Lecture

Récupérer un cas de test, y compris ses étapes.

id. Facultatif : fields.

get_test_cases_by_label

Lecture

Répertorier tous les cas de test d'un projet portant une étiquette donnée.

projectId, labelName

create_test_case

Écriture

Créer un cas de test vide.

projectId. Facultatif : name, description, executionPlatform (Web ou Mobile), reusedTests.

clone_test_case

Écrire

Dupliquer un cas de test avec ses étapes, ses paramètres et ses ensembles de tests. La copie est un brouillon nommé « (Copie) ».

id

add_label_to_test_case

Écriture

Attribuer une étiquette à un cas de test. Crée l'étiquette si le projet ne la possède pas encore.

testCaseId, projectId, labelName

delete_test_case

Destructeur

Supprime un ou plusieurs cas de test. Un cas de test réutilisé par un autre cas de test n’ est pas supprimé : il réapparaît dans reusedIds et reste en place ; vérifiez donc deletedIds pour confirmer ce qui a réellement été supprimé. Si un identifiant appartient à une autre organisation, l’appel est entièrement rejeté.

testCaseIds (une liste, ce qui permet d’en supprimer plusieurs en un seul appel)

queue_test_cases

Destructeur

Mettre en file d’attente les cas de test pour exécution. La réponse donne les testRunIds des nouvelles exécutions : passez-les à wait_for_test_runs ou à get_test_run_status.

testCaseIds, projectId, environmentId, personaId. Facultatif : browserSettings, maxParallelism, maxRetries, alwaysRerun, executionMode (parallèle ou séquentiel), failureBehavior (continuer ou s'arrêter), variables, testAssetReferences.

Guide de rédaction

Outil

Accès

Fonction

Paramètres

get_authoring_guide

Lecture

Comment rédiger des étapes de test Thunders : les types d'étapes et leur JSON, les variables, le coût en crédits de chaque façon de rédiger les étapes, la manière dont une exécution est jugée et comment corriger une exécution en échec. Votre assistant le lit une fois, avant de rédiger ou de corriger des étapes.

Facultatif : platform (Web, par défaut, ou Mobile). Les types d'étapes dépendent de la plateforme.

Étapes de test

Outil

Accès

Fonction

Paramètres

generate_test_steps

Écrit

Transforme un scénario en langage naturel en étapes exécutables dans un cas de test. Par défaut, il ajoute des étapes et ne modifie aucune étape existante. Avec toolset défini sur browser (ou mobile_browser pour une application mobile), il ouvre l'application en direct et utilise les libellés affichés par la page. Un appel avec navigation coûte 0,20 crédit, un appel sans navigation coûte 0,05 crédit.

testCaseId. Facultatif : scenario, toolset, mode (Append, par défaut, ou Replace pour lui permettre de modifier ou de supprimer des étapes existantes), stage (Main ou Teardown), testCaseUpdatedAt pour la détection des conflits, personaId, projectId, language (par exemple en, fr), attachmentIds, mobileBrowsePlatform (android ou ios).

insert_step

Écrire

Insérer une nouvelle étape à une position donnée (0 correspond à la première). Thunders attribue l'identifiant de l'étape. Tous les types d’étapes sont pris en charge, y compris « Exécuter du JavaScript » : get_authoring_guide donne le JSON de chaque type.

testCaseId, step, position. Facultatif : knownUpdatedAt pour la détection des conflits.

update_test_step

Écrit

Réécrit une étape existante. Tous les types d’étapes sont pris en charge, y compris « Exécuter JavaScript ».

testCaseId, step. Facultatif : knownUpdatedAt pour la détection des conflits.

delete_step

Destructeur

Supprime une étape. Toutes les étapes imbriquées sous elle sont aussi supprimées, et une étape conditionnelle qui sautait vers une étape supprimée arrête désormais l'exécution.

testCaseId, stepId. Facultatif : knownUpdatedAt pour la détection des conflits.

set_test_steps

Destructeur

Remplace toute la liste des étapes d'un cas de test en une seule écriture. Gardez l'id de chaque étape conservée et omettez-le pour les nouvelles étapes. Les étapes omises sont supprimées.

testCaseId, steps (la liste complète et ordonnée), knownUpdatedAt (obligatoire : le dernier updatedAt connu du cas de test).

Ensembles de tests

Outil

Accès

Fonction

Paramètres

get_test_sets

Lire

Répertorie les ensembles de tests actifs d'un projet (ID et nom), à l'exclusion des ensembles et des plans supprimés. Utilisez cette fonction pour associer un nom d'ensemble de tests à son ID.

projectId

create_test_set

Écriture

Créer un ensemble de tests, éventuellement alimenté par des cas de test existants.

projectId. Facultatif : name, testCases.

add_test_case_to_test_set

Écriture

Ajoute un cas de test à un ensemble de tests. Ne fait rien s'il en fait déjà partie.

testCaseId, ainsi qu’exactement l’un des éléments suivants : testSetId ou testSetName. Un nom doit correspondre exactement à un ensemble de tests dans le projet du cas de test concerné.

remove_test_case_from_test_set

Destructeur

Supprimer un cas de test d’un ensemble de tests. Cette opération modifie uniquement l’appartenance : elle ne supprime ni le cas de test ni l’ensemble de tests.

testCaseId, plus exactement l’un des éléments suivants : testSetId ou testSetName.

Plannings

Outil

Accès

Fonction

Paramètres

get_schedules_by_test_set

Lecture

Répertorie les plannings d'un ensemble de tests, avec leur règle, leur statut et leur prochaine exécution.

testSetId

create_schedule

Écriture

Exécute un ensemble de tests selon une règle récurrente. Chaque exécution utilise les cas de test que l'ensemble contient au moment de l'exécution : un cas de test ajouté plus tard est donc inclus.

testSetId, frequency (Hourly, Daily, Weekdays, Weekly ou Monthly), timezone, environmentId, personaId. Selon la fréquence : minutePastHour, timeOfDay, daysOfWeek, daysOfMonth. Facultatif : name, executionSettings.

update_schedule

Écriture

Modifie la règle, l'environnement, le persona ou les paramètres d'exécution d'un planning. Envoyez la règle complète : un champ omis n'est pas conservé. L'ensemble de tests ne change jamais.

scheduleId, plus les mêmes champs que create_schedule, sauf testSetId.

pause_schedule

Écriture

Met un planning en pause. Les exécutions passées restent, et vous pouvez le reprendre plus tard.

scheduleId

resume_schedule

Écriture

Reprend un planning en pause. La prochaine exécution est calculée à partir de maintenant : les exécutions manquées ne sont pas lancées. Un planning mis en pause par Thunders reste en pause jusqu'à ce que vous corrigiez le problème.

scheduleId

duplicate_schedule

Écriture

Copie un planning sur le même ensemble de tests. La copie est créée en pause : elle ne peut pas s'exécuter avant que vous la vérifiiez.

scheduleId

run_now

Destructeur

Exécute immédiatement l'ensemble de tests d'un planning, avec l'environnement, le persona et les paramètres d'exécution enregistrés. Fonctionne aussi sur un planning en pause et ne décale pas la prochaine exécution planifiée. Refusé si une exécution du même planning est en cours, ou si votre organisation n'a plus de crédits.

scheduleId

delete_schedule

Destructeur

Supprime définitivement un planning. Ses exécutions passées restent.

scheduleId

Ressources de test

Outil

Accès

Fonction

Paramètres

list_test_assets

Lecture

Répertorie les fichiers de données téléchargés disponibles dans un projet.

projectId

upload_test_asset

Écriture

Téléchargez un fichier de données (CSV, JSON, PDF, image, etc., 20 Mo maximum). Faites-y référence depuis une étape de test via sa variable de fichier, par exemple [FILE_CUSTOMERS_CSV].

projectId, fileName (avec extension), contentBase64. Facultatif : testId pour l'associer à un cas de test.

Suggestions relatives à la qualité des étapes

Thunders vérifie la conformité des étapes créées avec ses bonnes pratiques de création avant que vous ne les exécutiez.

Outil

Accès

Fonctionnalité

Paramètres

get_test_case_suggestions

Écriture

Affiche la liste des suggestions préalables à l'exécution d'un cas de test, chacune accompagnée d'un score, de la règle enfreinte et d'une étape réécrite. Cette opération est considérée comme une écriture, car le premier appel génère et stocke l'évaluation.

testCaseId

apply_test_case_suggestion

Destructeur

Remplacer le texte de l'étape par la reformulation suggérée.

testCaseId, suggestionId

dismiss_test_case_suggestion

Écrire

Masquer une suggestion. L'étape reste inchangée.

testCaseId, suggestionId

Exécutions de test

Outil

Accès

Fonction

Paramètres

get_test_runs_by_project_id

Lire

Répertorie les exécutions d'un projet, de la plus récente à la plus ancienne, une page à la fois. L'exécution d'un ensemble de tests apparaît sur une seule ligne.

projectId. Facultatif : filter, orderBy, first, after, label. Passez l'endCursor d'une page comme after pour lire la page suivante.

get_all_test_runs

Lecture

Liste des exécutions pour l'ensemble des données auxquelles vous avez accès, de la plus récente à la plus ancienne, une page à la fois.

filter, orderBy, first, after, label, tous facultatifs. Filtrer par id, test_case_id, test_set_id, status, run_at.

get_test_run_by_id

Lecture

Récupère l'enregistrement d'une exécution, avec le nom de son statut et, pour une exécution en échec, l'étape en échec et la raison. Le récapitulatif des étapes n'est inclus que si vous le demandez.

id. Facultatif : include (recap, context).

get_test_run_context

Lecture

Vue d'ensemble complète du débogage pour une exécution : scénario, étapes créées, environnement, persona, variables (informations confidentielles masquées), récapitulatifs par étape avec rapports de bogues et journaux de console. C'est l'option à utiliser lors de l'analyse d'un échec.

id

get_test_runs_by_ids

Lecture

Récupère jusqu'à 50 exécutions en un seul appel, avec les mêmes champs que get_test_run_by_id.

ids. Facultatif : include (recap).

get_test_run_status

Lecture

Vérifie le statut de jusqu'à 50 exécutions en un seul appel, sans récapitulatif des étapes.

ids

wait_for_test_runs

Lecture

Attend la fin de toutes les exécutions données, puis renvoie leur statut. L'attente dure 220 secondes au maximum : si timedOut vaut true, appelez-le de nouveau.

ids. Facultatif : timeoutSec (120 par défaut, 220 au maximum), pollSec (15 par défaut).

get_run_evidence

Lecture

Vue compacte d'une exécution, pour juger si elle prouve quelque chose : chaque étape avec son statut, son raisonnement et ses rapports de bogues, ainsi que les hôtes atteints par l'exécution. Il signale une assertion qui pourrait ne rien prouver, pour que vous vérifiiez sa capture d'écran.

runId

get_step_screenshot

Lecture

La capture d'écran prise après une action d'une étape, sous forme d'image, pour vérifier l'écran plutôt que le texte du raisonnement. Par défaut, la dernière action de l'étape qui en possède une.

runId, stepIndex. Facultatif : actionIndex.

get_test_case_history

Lecture

Les dernières exécutions d'un cas de test, de la plus récente à la plus ancienne, avec leur statut et leur environnement.

testCaseId. Facultatif : since, environmentId, limit (20 par défaut, 100 au maximum).

Environnements

Outil

Accès

Fonctionnalité

Paramètres

get_environments_by_project_id

Lecture

Répertorie les environnements d'un projet.

projectId

get_environment_by_id

Lecture

Récupère un environnement avec ses variables et ses identifiants. Les valeurs secrètes sont masquées.

environmentId

create_environment

Écriture

Créer un environnement et associer une URL à chaque application.

projectId, name. Facultatif : description, apps (un appId et une URL par application).

update_environment

Écriture

Renommer un environnement ou modifier ses URL par application.

environmentId, nom. Facultatif : description, applications.

clone_environment

Écriture

Copier un environnement avec toutes ses variables et ses identifiants. Par défaut : « (Clone) ».

environmentId. Facultatif : name.

Variables d’environnement et identifiants

Outil

Accès

Fonction

Paramètres

create_environment_variable

Écriture

Ajoute une variable ou un identifiant secret.

environmentId, projectId, name, value, isSecret. Facultatif : description. Les noms doivent être composés de lettres majuscules de A à Z, de chiffres de 0 à 9 et de traits de soulignement, pour un maximum de 30 caractères.

create_environment_variables

Écriture

Ajouter plusieurs variables en un seul appel.

Une liste des éléments ci-dessus.

Profils authentifiés

Outil

Accès

Fonction

Paramètres

list_authenticated_profiles

Lecture

Répertorie les profils authentifiés enregistrés d'un projet. Un test peut restaurer un profil au lieu d'exécuter les étapes de connexion. Un profil dont le expiresAt est dépassé doit être enregistré de nouveau.

projectId

Personnages

Outil

Accès

Fonction

Paramètres

get_all_personas

Lecture

Répertorie les personas disponibles pour exécution.

Aucun

Avez-vous trouvé la réponse à votre question ?