MCP-Server / get_scan_report

get_scan_report

Zweck

Gibt die Befunde eines fertigen Laufs zurück, dazu eine kurzlebige URL auf das PDF. Das Werkzeug ruft GET /v1/scans/{id}/findings und GET /v1/scans/{id}/artifacts/{kind}/url auf.

Parameter

Name	Typ	Bedeutung
`scan_id`	string	Kennung des Laufs. Pflicht.
`severity`	enum[]	Nur Befunde dieser Schweregrade: `critical` · `high` · `medium` · `low` · `info`.
`include_positives`	boolean	Auch die Positives ausgeben. Vorgabe `false`.

Rückgabe

Beispiel

{
"scan_id": "3f9a1c20-5e4b-4d8a-9a11-0c21e7b4c21e",
"domain": "shop.beispiel.de",
"status": "done",
"counts": { "critical": 1, "high": 2, "medium": 4, "low": 3, "info": 5 },
"findings": [
  {
    "report_id": "F-01",
    "catalog_id": "EOL-COMPONENT",
    "severity": "critical",
    "title": "Eingesetzte Komponente erhält keine Sicherheitsupdates mehr (WordPress 5.8.2)",
    "category": "Software-Stand",
    "confidence": "confirmed",
    "effort_level": "hoch",
    "remediation_short": "Auf eine unterstützte Version wechseln oder verlängerten Support einkaufen."
  }
],
"report_pdf_url": "https://…",
"expires_at": "2026-09-03T09:19:22Z"
}

Beschreibung, Auswirkung, Behebung und Evidenz stehen vollständig in findings.json. Über MCP kommt eine gekürzte Fassung, damit ein einzelner Bericht das Kontextfenster eines Modells nicht füllt.

Grenzen

Läuft der Scan noch, antwortet das Werkzeug mit dem Zustand statt mit Befunden. Fragen Sie vorher get_scan_status.
Ist die Aufbewahrung abgelaufen, gibt es keinen PDF-Link mehr (artifact_expired). Die Zähler bleiben trotzdem.
report_pdf_url ist rund fünf Minuten gültig. Laden Sie sofort herunter oder holen Sie sich die URL neu.