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-vous
Section intitulée « Connectez-vous »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 :
| Service | Lecture seule | Lire et modifier |
|---|---|---|
| CHAMPREP Code | code:read_api | code:api |
| Ferme de runners | runner_farm:read | runner_farm:write |
| Assurance qualité | qa:read | qa:write |
Trouver la bonne opération
Section intitulée « Trouver la bonne opération »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.
CHAMPREP Code
Section intitulée « CHAMPREP Code »
Projets, groupes et clonage
Section intitulée « Projets, groupes et clonage »- 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
gitsur votre machine. Demandez plutôt un plan de clonage :code_clone_group_planrépertorie tous les projets du groupe (sous-groupes compris) et renvoie des commandes prêtes à l’exécutiongit clonecommandes 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.
Pipelines et tâches
Section intitulée « Pipelines et tâches »- É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.
Demandes de fusion et tickets
Section intitulée « Demandes de fusion et tickets »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.
Ferme de runners
Section intitulée « Ferme de runners »- 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.
Assurance qualité
Section intitulée « Assurance qualité »- 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.
Exemples de messages d’invite
Section intitulée « Exemples de messages d’invite »- « 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 ? »
Ce qui nécessite votre validation
Section intitulée « Ce qui nécessite votre validation »- 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.
Ce qui n’est pas disponible, et pourquoi
Section intitulée « Ce qui n’est pas disponible, et pourquoi »| Non disponible via MCP | Pourquoi | Où effectuer ces opérations |
|---|---|---|
Exécution git (cloner, pousser) sur votre machine | Les outils MCP s’exécutent dans CHAMPREP, et non sur votre ordinateur | Exé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 runner | Les identifiants ne doivent en aucun cas être mentionnés dans un chat, une invite ou un journal | Les 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 fournir | Les 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 cloud | L’exécution de code arbitraire reste dans l’IDE que vous ouvrez | L’IDE cloud QA |
| Création de jetons d’accès, de jetons de déploiement ou de clés, lecture des variables CI/CD | Les identifiants et les secrets restent dans Code | Paramètres du code |
| Modification des protections (branches protégées, règles d’approbation, membres, visibilité) | Code demande une confirmation supplémentaire | Paramètres du code |
| Ignorer une détection de secret | La confirmation de la révocation d’un secret relève de votre propre attestation | L’application QA |
| Association de Code à Runner Farm et à son secret de connecteur | Le code d’appairage et le secret constituent des identifiants d’authentification | L’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.