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
Abschnitt betitelt „Verbinden“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:
| Dienst | Nur-Lese-Modus | Lesen und ändern |
|---|---|---|
| CHAMPREP Code | code:read_api | code:api |
| Runner-Farm | runner_farm:read | runner_farm:write |
| QA | qa:read | qa:write |
Die richtige Operation finden
Abschnitt betitelt „Die richtige Operation finden“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.
CHAMPREP Code
Abschnitt betitelt „CHAMPREP Code“
Projekte, Gruppen und Klonen
Abschnitt betitelt „Projekte, Gruppen und Klonen“- 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
gitauf Ihrem Rechner. Bitten Sie stattdessen um einen Klonplan:code_clone_group_planlistet jedes Projekt der Gruppe auf (einschließlich Untergruppen) und gibt ausführungsbereitegit cloneBefehle, 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.
Pipelines und Aufträge
Abschnitt betitelt „Pipelines und Aufträge“- 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 und Issues
Abschnitt betitelt „Merge-Anfragen und Issues“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.
Runner-Farm
Abschnitt betitelt „Runner-Farm“- 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.
Beispielaufforderungen
Abschnitt betitelt „Beispielaufforderungen“- „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?“
Was Ihrer Zustimmung bedarf
Abschnitt betitelt „Was Ihrer Zustimmung bedarf“- 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.
Was ist nicht verfügbar und warum?
Abschnitt betitelt „Was ist nicht verfügbar und warum?“| Nicht über MCP verfügbar | Warum | Wo dies durchgeführt werden kann |
|---|---|---|
Ausführen git (Klonen, Pushen) auf Ihrem Rechner | MCP-Tools werden in [] ausgeführtCHAMPREP, nicht auf Ihrem Computer | Fü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-Tokens | Anmeldedaten dürfen niemals in einem Chat, einer Eingabeaufforderung oder einem Protokoll erscheinen | Die 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önnen | Die CI/CD-Einstellungen des Projekts in Code |
| Ausführen von Befehlen oder Bearbeiten von Dateien innerhalb einer Cloud-IDE-Sitzung | Die Ausführung von beliebigem Code erfolgt weiterhin in der von Ihnen geöffneten IDE | Die QA-Cloud-IDE |
| Erstellen von Zugriffstoken, Deployment-Token oder Schlüsseln, Auslesen von CI/CD-Variablen | Anmeldedaten und Geheimnisse verbleiben in „Code“ | Code-Einstellungen |
| Schutzmaßnahmen ändern (geschützte Zweige, Genehmigungsregeln, Mitglieder, Sichtbarkeit) | Code fordert eine zusätzliche Bestätigung an | Code-Einstellungen |
| Einen geheimen Befund zurückweisen | Die Bestätigung, dass ein Geheimnis widerrufen wurde, erfolgt durch Ihre eigene Bescheinigung | Die QA-App |
| Kopplung von Code mit Runner Farm und dessen Konnektor-Geheimnis | Der Pairing-Code und das Geheimnis sind Anmeldedaten | Der 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.