Aller au contenu
Documentation

MCP pour le code, l’intégration continue, le parc de serveurs d’exécution et l’assurance qualité

Le CHAMPREP Serveur MCP permet à votre assistant IA de travailler avec CHAMPREP Code, Ferme d’exécution et Assurance qualité en votre nom : recherchez les projets et leurs URL de clonage, vérifiez les pipelines, consultez les journaux de tâches, surveillez les exécuteurs et les pools d’exécuteurs, suivez les analyses d’assurance qualité et triez les résultats. L’assistant agit toujours en tant que vous: vos rôles, votre plan, les politiques de votre organisation et (avec une API clé) les portées de la clé s’appliquent exactement comme dans les applications web.

Connectez votre client IA à https://ai-api.champrep.com/mcp/v1 comme décrit dans Serveur MCP. La connexion via le navigateur fonctionne pour les utilisateurs disposant d’un clavier ; pour les scripts et l’intégration continue (CI), utilisez une API clé. Les portées qui importent ici sont les suivantes :

ServiceLecture seuleLire et modifier
CHAMPREP Codecode:read_apicode:api
Ferme de runnersrunner_farm:readrunner_farm:write
Assurance qualitéqa:readqa:write

Lorsque votre compte a accès à un catalogue volumineux (plus d’environ 1 000 opérations, ce que Code à lui seul atteint presque), votre client voit s’afficher deux outils d’aide au lieu d’un seul outil par lecture : champrep_search_tools et champrep_read. Votre assistant effectue une recherche à l’aide de quelques mots simples, lit les données exactes dont il a besoin, puis exécute l’opération. Des recherches telles que journal des tâches, dernier pipeline, balises « runner », projets de groupe ou contrôle qualité Fonctionnement : chaque mot est mis en correspondance séparément et les meilleures correspondances apparaissent en premier. Dans ce mode, les lectures passent par champrep_read; avec un catalogue plus restreint, chaque opération est répertoriée comme un outil distinct. Chaque modification dispose toujours de son propre outil nommé, ce qui permet à votre client de vous demander votre avis avant de l’exécuter.

  • Répertoriez les projets auxquels vous avez accès, ou l’ensemble des projets d’un groupe avec tous ses sous-groupes. Chaque projet est accompagné de ses URL de clonage HTTPS et SSH.
  • Clonez un groupe entier. MCP ne peut pas s’exécuter git sur votre machine. Demandez plutôt un plan de clonage : code_clone_group_plan répertorie tous les projets du groupe (sous-groupes compris) et renvoie des commandes prêtes à l’exécution git clone commandes qui conservent la structure des dossiers du groupe. Les dossiers qui existent déjà sont ignorés, ce qui vous permet de relancer la liste. Exécutez-les vous-même dans un shell POSIX, ou demandez à un agent de codage local (Claude Code, Codex, Cursor) de les exécuter dans votre terminal.
  • Le clonage via SSH nécessite une clé SSH associée à votre profil Code. Le clonage via HTTPS vous demande votre nom d’utilisateur et un jeton d’accès personnel que vous créez dans Code : ne collez jamais un jeton dans le chat.

  • État du pipeline par branche, dernier pipeline d’une branche, tâches d’un pipeline et résumé du rapport de test.
  • Journaux des tâches. Lisez le journal d’un travail ; pour les journaux volumineux, l’assistant les lit par parties en indiquant une plage d’octets, ce qui lui permet de passer directement à la fin d’un travail ayant échoué.
  • Exécutez un nouveau pipeline, réessayez ou annulez un pipeline, lancez une tâche manuelle, réessayez ou annulez une tâche.
  • Répertoriez et téléchargez les artefacts des tâches (petites archives ; les grandes archives sont téléchargées depuis Code).
  • Répertoriez vos runners, les runners d’un projet (les siens, ceux de ses groupes et les runners de l’instance qu’il peut utiliser) ainsi que les runners d’un groupe, avec leur statut, leur état en ligne, leurs balises, leur état de pause et leur dernier contact.
  • Consultez les détails d’un runner et les tâches qu’il a exécutées, ainsi que le nombre de tâches en attente sur ce runner.
  • Enregistrez un nouveau runner. L’assistant ouvre la page « Nouveau runner » de Code pour le projet ou le groupe. Vous y obtenez le jeton du runner : celui-ci n’est jamais affiché à l’assistant.
  • Modifier un runner: ajoutez ou supprimez des balises, mettez-le en pause ou reprenez-le, modifiez sa description, indiquez s’il exécute des tâches sans balise, sa protection ou son délai d’expiration maximal. Les balises sont envoyées sous la forme d’une nouvelle liste complète ; l’assistant lit donc d’abord le runner. Chaque modification n’est appliquée qu’après votre validation.
  • Attribuer un exécuteur de projet existant vers un autre projet dont vous avez la charge.
  • Supprimer un runner, ou le détachez d’un projet : actions destructrices (voir Ce qui nécessite votre validation).
  • Le code détermine qui peut modifier quel runner : les runners de projet et de groupe nécessitent le rôle de responsable de maintenance ou de propriétaire, tandis que les runners d’instance nécessitent un administrateur de code.
  • L’assistant peut également vous fournir un lien direct vers la page de paramètres d’un runner dans Code.

Répertoriez, consultez, ouvrez, mettez à jour, approuvez et fusionnez les demandes de fusion ; commentez les demandes de fusion et les tickets ; répertoriez, créez et mettez à jour les tickets. Lors de l’approbation, l’assistant précise la branche cible, ce qui évite qu’une demande de fusion réorientée ne soit approuvée par erreur.

  • Vos comptes et espaces de travail Runner Farm, votre rôle, ainsi que les classes de machines et les plafonds de votre forfait.
  • Connexions aux hébergeurs de code : les répertorier et les consulter ; renommer, mettre en pause, reprendre ou attribuer un libellé à une connexion.
  • Pools : les répertorier et les consulter (y compris les temps d’attente), créer un pool, le renommer, le mettre en pause, le reprendre ou Évolutivité (concurrence et délai d’expiration des tâches), et restaurez un pool ou une connexion à partir de la section « Récemment supprimés ».
  • Crédits et utilisation : votre solde de crédits, votre utilisation mensuelle, par classe, pool ou projet, ainsi que le registre des crédits.
  • Tâches : tâches en cours, en attente et refusées, ainsi que les détails d’une tâche.
  • Connexion d’un hébergeur de code et de son jeton d’exécution, ainsi que des secrets du connecteur, sont effectuées dans l’application Runner Farm : l’assistant vous fournit un lien sécurisé et n’a jamais accès aux identifiants.

  • Référentiels : répertoriez les référentiels connectés et disponibles, activez-les et synchronisez-les ; il en va de même pour les projets de codeCHAMPREP.
  • Analyses : lancez une analyse, suivez son statut, consultez son journal (les secrets sont masqués) et consultez vos statistiques d’analyse.
  • Résultats : répertoriez les résultats à l’aide de filtres, classer un résultat en indiquant un motif et un commentaire, ou le rouvrir.
  • Contrôle qualité : verdict du contrôle pour un référentiel ou une branche, avec chaque condition et la raison de l’échec. Cela fonctionne pour les référentiels provenant de CHAMPREP Code, GitHub etGitLab Bitbucket qui sont connectés à l’application QA.
  • Aperçus : Lancer une version de prévisualisation d’une branche, répertoriez les aperçus, consultez leurs journaux et leurs journaux de compilation, prolongez un aperçu ou modifiez sa visibilité. Les référentiels nécessitant des secrets sont lancés depuis l’application QA.
  • IDE cloud : Lancez une session IDE sur un référentiel ou un espace de travail vide, puis ouvrez-le à partir du lien vers sa page dans l’application QA ; répertoriez et consultez vos sessions. Le jeton d’accès de la session n’est jamais visible par l’assistant.
  • Le lancement d’un aperçu ou d’une session IDE utilise le quota QA de votre forfait et ne s’exécute qu’après votre validation.

  • « Affichez l’état des derniers pipelines pour chaque projet du groupe acme/platform. »
  • « Afficher le journal de la tâche ayant échoué dans le dernier pipeline de acme/web. »
  • « Réessayez les tâches ayant échoué du pipeline 4211 dans acme/web. »
  • « Quels runners acme/web utilise-t-il, et lesquels sont hors ligne ? »
  • « Ajoutez le tag gpu au runner 12. » (L’assistant lit les balises actuelles et vous demande de valider la nouvelle liste.)
  • « Mettez le runner 12 en pause jusqu’à la fin de la maintenance de demain. »
  • « Lancer un aperçu QA de la branche feature/login de acme/web. »
  • « Ouvrez une session IDE cloud sur acme/web. »
  • « Enregistrer un nouveau runner pour le groupe acme. » (Vous accédez à la page « new-runner » de Code.)
  • « Donnez-moi les commandes de clonage pour chaque projet du groupe acme, y compris les sous-groupes. »
  • « Combien de tâches attendent actuellement un exécuteur dans acme/web ? »
  • « Faites évoluer mon pool « build-large » de Runner Farm à 20 tâches simultanées. »
  • « Combien de crédits Runner Farm ai-je utilisés ce mois-ci, par classe de machine ? »
  • « Lancez une analyse QA de acme/web et prévenez-moi lorsqu’elle sera terminée. »
  • « Répertoriez les constatations d’assurance qualité ouvertes de gravité élevée dans acme/web. »
  • « Classer le ticket QA-0970 comme faux positif : la clé est un dispositif de test. »
  • « Le projet acme/web a-t-il passé le contrôle qualité sur la branche principale ? »

  • Lecture (listes, détails, journaux, utilisation) ne modifient rien. Dans les catalogues volumineux, ils s’exécutent via champrep_read.
  • Modifications (exécuter, réessayer ou annuler des pipelines et des tâches, ouvrir ou fusionner des demandes de fusion, commenter, modifier, mettre en pause, reprendre ou affecter des runners, créer ou redimensionner des pools, lancer des analyses, rejeter des résultats, lancer des aperçus QA et des sessions IDE) chacune dispose de son propre outil. Votre client MCP détermine la manière dont il vous demande de confirmer : vérifiez ses paramètres de validation avant d’autoriser les modifications.
  • Actions destructrices (supprimer un pipeline, supprimer un exécuteur ou le dissocier d’un projet, supprimer un pool, arrêter toutes les tâches en cours d’exécution dans la ferme d’exécuteurs) restent masquées jusqu’à ce que la connexion autorise les actions destructrices et que l’URL se termine par ?destructive=true. Voir Serveur MCP.
  • Chaque modification est à nouveau vérifiée par le service en fonction de votre rôle et de votre plan.

Non disponible via MCPPourquoiOù effectuer ces opérations
Exécution git (cloner, pousser) sur votre machineLes outils MCP s’exécutent dans CHAMPREP, et non sur votre ordinateurExécutez les commandes à partir de code_clone_group_plan, ou utilisez un agent de codage local
Affichage d’un jeton de runner, d’un jeton de runner de Runner Farm ou d’un secret de connecteur, ou modification de la date d’expiration d’un jeton de runnerLes identifiants ne doivent en aucun cas être mentionnés dans un chat, une invite ou un journalLes pages des exécuteurs de Code et l’application Runner Farm (l’assistant vous fournit le lien)
Modification des paramètres CI/CD d’un projet (par exemple, activation des exécuteurs d’instance ou de groupe)Code vous demande une confirmation supplémentaire que vous seul pouvez fournirLes paramètres CI/CD du projet dans Code
Exécution de commandes ou modification de fichiers au sein d’une session d’IDE dans le cloudL’exécution de code arbitraire reste dans l’IDE que vous ouvrezL’IDE cloud QA
Création de jetons d’accès, de jetons de déploiement ou de clés, lecture des variables CI/CDLes identifiants et les secrets restent dans CodeParamètres du code
Modification des protections (branches protégées, règles d’approbation, membres, visibilité)Code demande une confirmation supplémentaireParamètres du code
Ignorer une détection de secretLa confirmation de la révocation d’un secret relève de votre propre attestationL’application QA
Association de Code à Runner Farm et à son secret de connecteurLe code d’appairage et le secret constituent des identifiants d’authentificationL’espace d’administration Code

Les opérations qui s’affichent dépendent également de votre forfait, des politiques de votre organisation, de vos autorisations d’IA par service et, pour une API clé, de ses champs d’application.