Dokumentation

Sicherheit über MCP und Chat

Lesen Sie die Ergebnisse und handeln Sie darauf basierend im Chat oder mit Ihrem eigenen Assistenten gemäß den Regeln des Portals – und erfahren Sie, warum einige Aktionen stets Ihre Zustimmung erfordern.

Sie können die Ergebnisse der Sicherheit im Chat-Assistenten oder mit Ihrem eigenen Assistenten lesen und darauf reagieren, über CoRoid als MCP-Server: Claude Code, Codex, Cursor oder ein anderer MCP-Client. Die Tools folgen denselben Regeln wie das Portal, daher liefern sie dieselben Antworten und lehnen dasselbe ab.

Lesen

Die Sicherheit hat eigene Bereiche; eine Verbindung für andere Aufgaben sieht die Ergebnisse nicht. Diese Tools benötigen die Rolle „Rezensent“ und mcp.security.read. Keines davon erfordert eine Genehmigung. Sie folgen den eigenen Regeln von CoRoid Sicherheit: Sie sehen die Projekte, die Sie im Portal einsehen können. Eine auf bestimmte Projekte beschränkte Verbindung muss eines davon oder ein zugehöriges Ergebnis angeben.

ToolWas es antwortet
get_security_overviewPro Projekt: offene Ergebnisse nach Schweregrad, jenseits ihres Behebungsdatums, Behauptungen ohne Bestätigung, Testcode sowie die Anzahl der auf Sie wartenden Einträge
list_security_findingsErgebnisse nach Projekt, Art, Schweregrad und Status, zuerst die ausgenutzten, dann nach Schweregrad sortiert; needsYou zeigt nur diejenigen an, die auf eine Person warten
list_security_needsDie Entscheidungen, die auf eine menschliche Prüfung warten – dringend zuerst –, enthalten jeweils die Antwort von CoRoid sowie einen Link zum Öffnen dieser Entscheidung: Es handelt sich um dieselbe Liste wie unter Sicherheit → Entscheidungen.
get_security_findingEin einzelnes Ergebnis: wo es sich befindet, ob es bestätigt wurde, wann die Frist abläuft und welche Behebungsarbeiten nötig sind. Der Wert eines Geheimnisses wird nie angezeigt.
get_security_settingsJeder Schutz eines Projekts wird entsprechend den Prüfungen angewendet: deaktiviert, beobachtend, durchsetzend oder nicht ausführbar – samt Grund und der vom Projekt gewählten Konfiguration.
list_security_runsDie Ausführungen der Sicherheit, neueste zuerst, wie der Laufprotokoll sie auflistet: laufend, wartend, abgeschlossen, fehlgeschlagen oder ersetzt – samt Grund für ein Fehlschlagen.
get_attack_surfaceDie Einstiegspunkte jedes Projekt sowie die Anzahl der auf eine Exposition wartenden Einträge; für ein Projekt alle Einstiegspunkte mit dem darin enthaltenen Code und den getroffenen Entscheidungen, Deployment-Vorschlägen sowie dem von pull request Guard festgestellten Ergebnis.
get_threat_modelDie Version des Bedrohungsmodells jedes Projekts sowie die auf eine Rezension wartenden Einträge; für ein Projekt das Modell, der ausstehende Vorschlag und die neuesten Versionen.
list_security_packagesDie aktuellen Abhängigkeitsinventare jedes Projekts mit der Anzahl installierter Pakete und der Anzahl vulnerabler Pakete; für ein Projekt die Pakete, Seite für Seite, zuerst die vulnerablen.

Jedes Ergebnis verlinkt zur entsprechenden Seite in CoRoid.

Handeln bezüglich der Ergebnisse

Diese Tools wirken auf Ergebnisse ein. Sie benötigen mcp.security.write sowie einen Besitzer oder Administrator, wie im Portal üblich.

ToolWas es tutGenehmigung
start_security_fixBehebung, wie im Portal: Behebungsarbeiten für eine vulnerabile Abhängigkeit, eine Aufgabe mit einem Regressionstest für ein Code-Ergebnis, die Rotations-Checkliste für ein geleaktes Kennwort. Eine zweite Behebung antwortet auf die bereits erstellte Aufgabe.Nein
run_security_scanScannen Sie jetzt ein Projekt: alles Aktive, Abhängigkeiten, den Geheimnisverlauf, die Angriffsfläche, die Audits (wo sie aktiv sind) oder gespeicherte Nachweise.Nein
confirm_real_secretBestätigen Sie, dass ein geleaktes Kennwort echt ist. Es bleibt offen, bis jemand bestätigt, dass es rotiert wurde.Nein
revoke_security_exceptionBeenden Sie eine Ausnahme: Das Ergebnis wird wieder geöffnet.Nein
dismiss_security_findingMarkieren Sie ein Ergebnis als „Kein Problem“ mit einem Grund.Immer
add_security_exceptionAkzeptieren Sie das Risiko eines Ergebnisses bis zu einem Datum mit einem Grund.Immer
attest_secret_rotatedBestätigen Sie, dass ein geleaktes Kennwort rotiert oder widerrufen wurde – dadurch wird es geschlossen. CoRoid prüft ein gefundenes Kennwort nie.Immer

Handeln bezüglich der Angriffsfläche und des Bedrohungsmodells

Dafür werden mcp.security.write sowie ein Besitzer oder Administrator benötigt. Wo im Portal eine Steuerung sowohl verstärkt als auch schwächt, gibt es zwei Tools: Das verstärkende Tool lehnt eine Schwächung ab, sodass eine solche Änderung stets Ihre Zustimmung erfordert.

ToolWas es tutGenehmigung
raise_entry_point_exposureEinstiegspunkte stärker exponieren, für das Audit fixieren oder wieder in den Geltungsbereich aufnehmen.Nein
lower_entry_point_exposureEinstiegspunkte weniger exponieren, eine Fixierung aufheben oder aus dem Geltungsbereich entfernen – mit einem Grund.Immer
refresh_threat_modelDen Code des Projekts erneut lesen; die dabei gefundenen Ergebnisse werden als Vorschlag gespeichert.Nein
add_threat_model_entriesEinträge zum Bedrohungsmodell hinzufügen.Nein
accept_threat_model_proposalDen aus einer neuen Code-Analyse resultierenden Vorschlag akzeptieren.Nein
update_threat_model_entriesDen Titel oder die Details eines Eintrags ändern.Immer
remove_threat_model_entriesEinträge aus dem Bedrohungsmodell entfernen.Immer
dismiss_threat_model_proposalDen aus einer neuen Code-Analyse resultierenden Vorschlag ablehnen.Immer
keep_security_proofEinen Nachweis, der ein Ergebnis reproduziert hat, als Regressionstest speichern.Nein

Schutzmaßnahmen ändern

Die Einstellungen einer Schutzmaßnahme für ein Projekt oder die Organisationsvorgabe finden sich in denselben beiden Tools: tighten_security_protection stärkt eine Schutzmaßnahme und lehnt jegliche Änderung ab, die sie schwächt, und relax_security_protection schwächt sie oder sorgt dafür, dass das Projekt wieder die Organisationsvorgabe übernimmt – dabei wird stets eine Person benötigt. Eine Änderung schwächt die Schutzmaßnahme, wenn die Erkennung oder Durchsetzung reduziert wird, der Schweregrad-Schwellenwert erhöht wird, weniger Fix-Pull-Requests geöffnet werden können, die Überprüfung deaktiviert oder seltener ausgeführt wird, der Geheimnis-Scan weniger Daten auswertet, das Sandbox-Netzwerk geöffnet wird oder mehr Hosts zugelassen werden, oder wenn ein „nicht festgelegter“ Endpunkt nicht mehr als internetfähig gilt. Der Eintrag „Ihr eigener Scan-Befehl“ wird in der Qualitätskontrolle konfiguriert.

Kontakte und Offenlegung

Die Sicherheitskontakte eines Projekts besitzen neben den Eigentümern und Administratoren die Befugnis zur Offenlegung: Sie sehen die privaten Fixes, die CoRoid für noch nicht offengelegte Schwachstellen bereithält, können diese veröffentlichen oder löschen, Entwürfe von GitHub-Sicherheitshinweisen erstellen und Berichte an die Maintainer von Abhängigkeiten weiterleiten. Über MCP und Chat erfolgen diese Aufrufe durch Eigentümer und Administratoren – dabei wird stets eine Person benötigt: Ein Kontakt kann Schwachstellen offenlegen, wobei eine bereits erfolgte Offenlegung nicht rückgängig gemacht werden kann.

WerkzeugWas es bewirktFreigabe
list_security_contactsSicherheitskontakte eines Projekts und wer dazu gehören kannNein
get_security_disclosureDie privaten Fixes einer Schwachstelle (Größe und Status, niemals ihr Inhalt), der zugehörige GitHub-Hinweis sowie die an die Maintainer gesendeten Berichte – alles für die Befugnis zur Offenlegung.Nein
add_security_contactEin Projektmitglied zum Sicherheitskontakt machenImmer
remove_security_contactEinen Sicherheitskontakt entfernenImmer
publish_private_fixEin zurückgehaltenes Fix veröffentlichen: Die Schwachstelle wird offengelegt und ein Task öffnet seinen pull request.Immer
discard_private_fixEin zurückgehaltenes Fix löschenImmer
draft_github_security_advisoryEin GitHub-Sicherheitshinweis im Repository als Entwurf erstellen – sichtbar für die Maintainer.Immer
record_maintainer_reportDen Ort festhalten, an dem Sie die Schwachstelle den Maintainern einer Abhängigkeit gemeldet haben. CoRoid sendet nichts.Immer

Warum einige Aktionen eine Person benötigen

Ein „kein Problem“-Status, ein akzeptiertes Risiko oder ein rotierter Zugangsdatenwert entfernen eine Schwachstelle aus der Liste der offenen Fälle ohne Fix; ein weniger exponierter Endpunkt oder ein kleineres Bedrohungsmodell reduzieren den Umfang der von der Überprüfung betrachteten Bereiche. Ein Assistent sollte das nicht eigenständig tun können – daher warten diese Werkzeuge stets auf eine Person, unabhängig von den Verbindungseinstellungen:

  • Von einem MCP-Client aus wartet der Aufruf auf einen Eigentümer oder Administrator. Einstellungen → Verbindungen → CoRoid MCP-Server → Freigaben, und sie erhalten eine Benachrichtigung. Die Anfrage verfällt nach 10 Minuten.
  • Im Chat bittet der Assistent Sie vor der Ausführung um Bestätigung im Chat.

Die Freigabe beschreibt in einfachen Worten, was geschieht, basierend auf den eigenen Aufzeichnungen von CoRoid zur Schwachstelle: „Fehlerhafte Zugriffskontrolle in src/routes/admin.ts:76 (Shop) Kein Problem“, gefolgt vom Grund in Anführungszeichen. Die Wörter um den Grund herum stammen von CoRoid, niemals vom Assistenten – außerdem wird der Wert eines Zugangsdatens niemals angezeigt: CoRoid speichert ihn nicht.