Zum Inhalt springen
Documentation

MCP für Code, CI, Runner-Farm und QA

Die CHAMPREP MCP-Server ermöglicht es Ihrem KI-Assistenten, mit CHAMPREP Code, Runner-Farm und QA in Ihrem Auftrag: Suchen Sie Projekte und deren Klon-URLs, überprüfen Sie Pipelines, lesen Sie Jobprotokolle, kümmern Sie sich um Runner und Runner-Pools, verfolgen Sie QA-Scans und werten Sie die Ergebnisse aus. Der Assistent handelt stets als Sie: Ihre Rollen, Ihr Plan, die Richtlinien Ihrer Organisation sowie (bei Verwendung eines SchlüsselsAPI) die Geltungsbereiche des Schlüssels gelten genau wie in den Webanwendungen.

Verbinden Sie Ihren KI-Client mit https://ai-api.champrep.com/mcp/v1 wie beschrieben in MCP-Server. Die Anmeldung über den Browser funktioniert für Personen, die eine Tastatur verwenden; für Skripte und CI verwenden Sie bitte einen API Schlüssel. Die hier relevanten Bereiche:

DienstNur-Lese-ModusLesen und ändern
CHAMPREP Codecode:read_apicode:api
Runner-Farmrunner_farm:readrunner_farm:write
QAqa:readqa:write

Wenn Ihr Konto auf einen umfangreichen Katalog zugreifen kann (mehr als etwa 1.000 Operationen, was allein bei „Code“ fast der Fall ist), sieht Ihr Client zwei Hilfsprogramme anstelle eines Programms pro Lesevorgang: champrep_search_tools und champrep_read. Ihr Assistent führt die Suche mit wenigen einfachen Wörtern durch, liest die genau benötigten Eingaben ein und führt anschließend den Vorgang aus. Suchanfragen wie Auftragsprotokoll, Aktuelle Pipeline, Runner-Tags, Gruppenprojekte oder Qualitätsprüfung Funktionsweise: Jedes Wort wird für sich abgleichen, und die besten Übereinstimmungen werden zuerst angezeigt. In diesem Modus durchlaufen die Lesevorgänge champrep_read; bei einem kleineren Katalog wird jeder Vorgang als eigenes Tool aufgeführt. Jede Änderung hat stets ein eigenes, benanntes Tool, sodass Ihr Kunde Sie vor der Ausführung um Erlaubnis fragen kann.

  • Lassen Sie sich die Projekte auflisten, auf die Sie Zugriff haben, oder jedes Projekt einer Gruppe mit all ihren Untergruppen. Zu jedem Projekt gehören die entsprechenden HTTPS- und SSH-Klon-URLs.
  • Klonen Sie eine ganze Gruppe. MCP kann nicht ausgeführt werden git auf Ihrem Rechner. Bitten Sie stattdessen um einen Klonplan: code_clone_group_plan listet jedes Projekt der Gruppe auf (einschließlich Untergruppen) und gibt ausführungsbereite git clone Befehle, die die Ordnerstruktur der Gruppe beibehalten. Bereits vorhandene Ordner werden übersprungen, sodass Sie die Liste erneut ausführen können. Führen Sie sie selbst in einer POSIX-Shell aus oder lassen Sie sie von einem lokalen Programmieragenten (Claude Code, Codex, Cursor) in Ihrem Terminal ausführen.
  • Für das SSH-Klonen ist ein SSH-Schlüssel in Ihrem Code-Profil erforderlich. Beim HTTPS-Klonen werden Ihr Benutzername und ein persönliches Zugriffstoken abgefragt, das Sie in Code erstellen: Fügen Sie ein Token niemals in den Chat ein.

  • Pipeline-Status pro Zweig, die aktuellste Pipeline eines Zweigs, die Jobs einer Pipeline und die Zusammenfassung des Testberichts.
  • Job-Protokolle. Lesen Sie das Protokoll eines Jobs; bei langen Protokollen liest der Assistent diese stückweise anhand eines Byte-Bereichs ein, sodass er zum Ende eines fehlgeschlagenen Jobs springen kann.
  • Führen Sie eine neue Pipeline aus, wiederholen oder brechen Sie eine Pipeline ab, führen Sie einen manuellen Job aus, wiederholen oder brechen Sie einen Job ab.
  • Job-Artefakte auflisten und herunterladen (kleine Archive; große Archive werden aus Code heruntergeladen).

  • Listen Sie Ihre Runner, die Runner eines Projekts (die eigenen, die der zugehörigen Gruppen sowie die Instanz-Runner, die es nutzen kann) und die Runner einer Gruppe auf, einschließlich Status, Online-Status, Tags, Pausenzustand und letzter Kontakt.
  • Sehen Sie sich die Details eines Runners und die von ihm ausgeführten Jobs an sowie die Anzahl der Jobs, die auf einen Runner warten.
  • Registrieren Sie einen neuen Runner. Der Assistent öffnet die Seite „New Runner“ von Code für das Projekt oder die Gruppe. Dort erhalten Sie das Runner-Token: Es wird dem Assistenten niemals angezeigt.
  • Runner ändern: Fügen Sie Tags hinzu oder entfernen Sie sie, pausieren oder setzen Sie den Lauf fort, ändern Sie dessen Beschreibung, legen Sie fest, ob er Jobs ohne Tags ausführt, sowie dessen Schutz oder dessen maximale Zeitüberschreitung. Tags werden als vollständige neue Liste gesendet, sodass der Assistent den Runner zuerst ausliest. Jede Änderung wird erst ausgeführt, nachdem Sie sie genehmigt haben.
  • Zuweisen einen bestehenden Projekt-Runner auf ein anderes Projekt, das Sie betreuen.
  • Löschen einen Runner oder trennen Sie ihn von einem Projekt: destruktive Aktionen (siehe Was Ihrer Genehmigung bedarf).
  • Der Code legt fest, wer welche Runner ändern darf: Für Projekt- und Gruppen-Runner ist die Rolle „Maintainer“ oder „Owner“ erforderlich, für Instanz-Runner ist ein Code-Administrator erforderlich.
  • Der Assistent kann Ihnen außerdem einen direkten Link zur Einstellungsseite eines Runners in Code bereitstellen.

Merge-Anfragen auflisten, lesen, öffnen, aktualisieren, genehmigen und zusammenführen; Merge-Anfragen und Issues kommentieren; Issues auflisten, erstellen und aktualisieren. Bei der Genehmigung wird der Zielzweig angegeben, den der Assistent gelesen hat, sodass eine Merge-Anfrage mit geändertem Ziel nicht versehentlich genehmigt wird.

  • Ihre Runner-Farm-Konten und -Arbeitsbereiche, Ihre Rolle sowie die Maschinenklassen und Obergrenzen Ihres Tarifs.
  • Verbindungen zu Code-Hosts: Listen Sie diese auf und lesen Sie sie ein; benennen Sie eine Verbindung um, pausieren, setzen Sie sie fort oder versehen Sie sie mit einer Kennzeichnung.
  • Pools: Listen Sie diese auf und lesen Sie sie ein (einschließlich Wartezeiten), erstellen Sie einen Pool, benennen Sie ihn um, halten Sie ihn an, setzen Sie ihn fort oder Skalierung (Parallelität und Job-Timeout) und stellen Sie einen Pool oder eine Verbindung aus dem Bereich „Zuletzt gelöscht“ wieder her.
  • Guthaben und Nutzung: Ihr Guthaben, die Nutzung pro Monat, Klasse, Pool oder Projekt sowie das Guthabenkonto.
  • Aufträge: aktive, zurückgestellte und abgelehnte Aufträge sowie die Details eines einzelnen Auftrags.
  • Verbindung eines Code-Hosts mit seinem Runner-Token und den Connector-Geheimnissen, werden in der Runner-Farm-App durchgeführt: Der Assistent stellt Ihnen einen sicheren Link zur Verfügung und hat zu keinem Zeitpunkt Einsicht in die Anmeldedaten.
  • Repositorys: Listen Sie verbundene und verfügbare Repositorys auf, aktivieren Sie diese und synchronisieren Sie sie; ebenso CHAMPREPCode-Projekte.
  • Scans: Starten Sie einen Scan, verfolgen Sie dessen Status, lesen Sie das Protokoll (geheime Daten werden unkenntlich gemacht) und sehen Sie sich Ihre Scan-Gesamtzahlen an.
  • Befunde: Befunde mit Filtern auflisten, Abweisen einen Befund mit einer Begründung und einem Kommentar ablehnen oder ihn wieder öffnen.
  • Qualitätsgate: Das Ergebnis des Gates für ein Repository oder einen Zweig, einschließlich aller Bedingungen und der Gründe für das Scheitern. Dies gilt für Repositorys von CHAMPREP Code, GitHub undGitLab Bitbucket, die mit der QA-App verbunden sind.
  • Vorschauen: Starten Sie einen Vorschau-Build eines Zweigs, listen Sie Vorschauen auf, lesen Sie deren Protokolle und Build-Protokolle, verlängern Sie eine Vorschau oder ändern Sie deren Sichtbarkeit. Repositorys, die Geheimnisse erfordern, werden über die QA-App gestartet.
  • Cloud-IDE: Starten Sie eine IDE-Sitzung in einem Repository oder einem leeren Arbeitsbereich, öffnen Sie diesen dann über den Link zu seiner Seite in der QA-App; listen Sie Ihre Sitzungen auf und lesen Sie diese. Das Zugriffstoken der Sitzung wird dem Assistenten niemals angezeigt.
  • Das Starten einer Vorschau oder einer IDE-Sitzung verbraucht das QA-Kontingent Ihres Tarifs und wird erst ausgeführt, nachdem Sie dies genehmigt haben.

  • „Listen Sie den aktuellen Pipeline-Status für jedes Projekt in der Gruppe acme/platform auf.“
  • „Zeigen Sie das Protokoll des fehlgeschlagenen Auftrags in der letzten Pipeline von acme/web an.“
  • „Versuchen Sie die fehlgeschlagenen Jobs der Pipeline 4211 in acme/web erneut.“
  • „Welche Runner verwendet acme/web, und welche sind offline?“
  • „Fügen Sie dem Runner 12 das Tag ‚gpu‘ hinzu.“ (Der Assistent liest die aktuellen Tags aus und fordert Sie auf, die neue Liste zu genehmigen.)
  • „Pausieren Sie Runner 12, bis die morgige Wartung abgeschlossen ist.“
  • „Starten Sie eine QA-Vorschau des Feature-/Login-Zweigs von acme/web.“
  • „Öffnen Sie eine Cloud-IDE-Sitzung auf acme/web.“
  • „Registrieren Sie einen neuen Runner für die Gruppe acme.“ (Sie gelangen auf die Seite „New Runner“ von Code.)
  • „Geben Sie mir die Klonbefehle für jedes Projekt in der Gruppe „acme“, einschließlich der Untergruppen.“
  • „Wie viele Jobs warten derzeit in acme/web auf einen Runner?“
  • „Skalieren Sie meinen Runner-Farm-Pool ‚build-large‘ auf 20 gleichzeitige Aufträge.“
  • „Wie viele Runner-Farm-Credits habe ich diesen Monat pro Maschinenklasse verbraucht?“
  • „Starten Sie einen QA-Scan von acme/web und informieren Sie mich, sobald dieser abgeschlossen ist.“
  • „Listen Sie die offenen QA-Befunde mit hohem Schweregrad in acme/web auf.“
  • „QA-0970 als Fehlalarm abtun: Der Schlüssel ist eine Testvorrichtung.“
  • „Hat acme/web die Qualitätsprüfung auf dem Main-Zweig bestanden?“

  • Liest (Listen, Details, Protokolle, Verwendung) bewirken keine Änderungen. In großen Katalogen werden sie über champrep_read.
  • Änderungen (Pipelines und Jobs ausführen, erneut versuchen oder abbrechen, Merge-Anfragen öffnen oder zusammenführen, Runner kommentieren, ändern, anhalten, fortsetzen oder zuweisen, Pools erstellen oder skalieren , Scans starten, Befunde verwerfen, QA-Vorschauen und IDE-Sitzungen starten) jeweils ein eigenes Tool. Ihr MCP-Client entscheidet, wie er Sie um Bestätigung bittet: Überprüfen Sie dessen Genehmigungs-Einstellungen, bevor Sie Änderungen zulassen.
  • Destruktive Aktionen (Löschen einer Pipeline, Löschen eines Runners oder Trennen desselben von einem Projekt, Löschen eines Pools, Stoppen aller laufenden Runner-Farm-Jobs) bleiben ausgeblendet, bis die Verbindung destruktive Aktionen zulässt und die URL mit ?destructive=true. Siehe MCP-Server.
  • Jede Änderung wird vom Dienst erneut anhand Ihrer Rolle und Ihres Plans überprüft.

Nicht über MCP verfügbarWarumWo dies durchgeführt werden kann
Ausführen git (Klonen, Pushen) auf Ihrem RechnerMCP-Tools werden in [] ausgeführtCHAMPREP, nicht auf Ihrem ComputerFühren Sie die Befehle aus code_clone_group_planoder nutzen Sie einen lokalen Programmieragenten
Das Anzeigen eines Runner-Tokens, eines Runner-Farm-Runner-Tokens oder eines Connector-Geheimnisses sowie das Ändern des Ablaufdatums eines Runner-TokensAnmeldedaten dürfen niemals in einem Chat, einer Eingabeaufforderung oder einem Protokoll erscheinenDie Runner-Seiten von Code und die Runner-Farm-App (der Assistent stellt Ihnen den Link zur Verfügung)
Änderung der CI/CD-Einstellungen eines Projekts (z. B. Aktivierung von Instanz- oder Gruppen-Runner)Code fordert eine zusätzliche Bestätigung an, die nur Sie erteilen könnenDie CI/CD-Einstellungen des Projekts in Code
Ausführen von Befehlen oder Bearbeiten von Dateien innerhalb einer Cloud-IDE-SitzungDie Ausführung von beliebigem Code erfolgt weiterhin in der von Ihnen geöffneten IDEDie QA-Cloud-IDE
Erstellen von Zugriffstoken, Deployment-Token oder Schlüsseln, Auslesen von CI/CD-VariablenAnmeldedaten und Geheimnisse verbleiben in „Code“Code-Einstellungen
Schutzmaßnahmen ändern (geschützte Zweige, Genehmigungsregeln, Mitglieder, Sichtbarkeit)Code fordert eine zusätzliche Bestätigung anCode-Einstellungen
Einen geheimen Befund zurückweisenDie Bestätigung, dass ein Geheimnis widerrufen wurde, erfolgt durch Ihre eigene BescheinigungDie QA-App
Kopplung von Code mit Runner Farm und dessen Konnektor-GeheimnisDer Pairing-Code und das Geheimnis sind AnmeldedatenDer Code-Admin-Bereich

Welche Vorgänge Ihnen angezeigt werden, hängt ebenfalls von Ihrem Tarif, den Richtlinien Ihrer Organisation, Ihren KI-Berechtigungen pro Dienst und – bei einem API-SchlüsselAPI – dessen Gültigkeitsbereichen ab.