Highlights

• 12 KI-Backends — Burp AI (integriert), Anthropic, Ollama, LM Studio, NVIDIA NIM, Perplexity, generisch OpenAI-kompatibel, Gemini CLI, Claude CLI, Codex CLI, OpenCode CLI, Copilot CLI.
• 59 MCP-Tools — Lassen Sie Claude Desktop (oder einen beliebigen MCP-Client) Burp autonom steuern (8 erweiterungsnative KI-Tools im Store-Build, alle 59 im vollständigen Build).
• Scope-begrenzter MCP-Zugriff — Begrenzen Sie optional jedes MCP-Tool auf Ihre In-Scope-Hosts, damit externe KI-Clients über Burp keine Out-of-Scope-Ziele erreichen können.
• 62 Schwachstellenklassen — Passive und aktive KI-Scanner für Injection, Authentifizierung, Kryptografie und mehr. Der passive Scanner läuft als Burp-PassiveScanCheck (Burp Pro).
• Installation über Releases — Laden Sie das JAR von Releases herunter. Nicht im BApp Store: Die Einreichung ist seit Januar 2026 offen.
• Theme-bewusste Benutzeroberfläche — Ein internes Designsystem gestaltet das Einstellungsfenster und passt das Theme automatisch an Burps Hell/Dunkel-Umschalter an.
• Burp-Scan-Skill — Verwenden Sie Ihren bevorzugten KI-Codierungsassistenten (Claude Code, Gemini CLI, Codex usw.) über MCP als Scanner.
• 3 Datenschutzmodi — STRICT / BALANCED / OFF. Redigieren Sie sensible Daten, bevor sie Burp verlassen.
• Benutzerdefinierte Prompt-Bibliothek — Speichern Sie frei formulierte Prompts pro Kontext (HTTP-Anforderung oder Scanner-Befund); starten Sie sie über das Kontextmenü oder geben Sie Ad-hoc-Prompts über Custom… ein.
• Audit-Protokollierung — JSONL mit SHA-256-Integritäts-Hashing für Compliance; jeder Start wird zur Reproduzierbarkeit mit promptSource / contextKind markiert.

Schnellstart

1. Installation

Laden Sie das neueste JAR von Releases herunter oder erstellen Sie es aus dem Quellcode (Java 21):

2. In Burp laden

1. Öffnen Sie Burp Suite (Community oder Professional).
2. Gehen Sie zu Erweiterungen > Installiert > Hinzufügen.
3. Wählen Sie Java als Erweiterungstyp und die .jar-Datei aus.

Die Erweiterung registriert sich in Burp als Custom AI Agent (der Name in der Erweiterungsliste und im Suite-Tab), um sie vom integrierten Burp AI-Provider von Burp Suite zu unterscheiden.

3. Agent-Profile

Die Erweiterung installiert beim ersten Start automatisch die gebündelten Profile in ~/.burp-ai-agent/AGENTS/. Legen Sie zusätzliche *.md-Dateien in diesem Verzeichnis ab, um benutzerdefinierte Profile hinzuzufügen.

4. Ein Backend konfigurieren

Öffnen Sie den Tab AI Agent und gehen Sie zu Einstellungen. Wählen Sie ein Backend:

Für NVIDIA NIM erwartet das Backend denselben Chat-Completions-Ablauf wie der gehostete NVIDIA-Endpunkt. Eine funktionierende Konfiguration ist:

Lassen Sie zusätzliche Header leer, es sei denn, Ihr Gateway erfordert sie. Die Erweiterung sendet Anforderungen an /v1/chat/completions und verwendet automatisch den konfigurierten Bearer-Token.

5. Führen Sie Ihre erste Analyse aus

1. Durchsuchen Sie ein Ziel über den Burp-Proxy.
2. Klicken Sie in Proxy > HTTP-Verlauf mit der rechten Maustaste auf eine beliebige Anforderung.
3. Wählen Sie Erweiterungen > Custom AI Agent > Diese Anforderung analysieren.
4. Es öffnet sich eine Chat-Sitzung mit der KI-Analyse.

6. Claude Desktop über MCP verbinden (optional)

Aktivieren Sie den MCP-Server in Einstellungen > MCP-Server und fügen Sie dies zu Ihrer Claude-Desktop-Konfiguration hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Erfordert Node.js 18+. Wenn Sie Externen Zugriff aktivieren, muss der MCP-Client bei jeder Anforderung Authorization: Bearer <token> senden.

Sie können auch externe oder benutzerdefinierte MCP-Server in Einstellungen > MCP > Externe Server registrieren (SSE- oder stdio-Transporte). Authentifizierungstoken externer Server werden im Ruhezustand verschlüsselt gespeichert, mit dem unter Hinweise zu Datenschutz und Sicherheit beschriebenen Vorbehalt. Einzelheiten zur Einrichtung und Sicherheitshinweise finden Sie unter docs/external-mcp-servers.md.

Burp-Scan-Skill (KI-Scanning über das Terminal)

Die burp-scan-Skill ermöglicht es Ihnen, jeden KI-Codierungsassistenten (Claude Code, Gemini CLI, Codex usw.) von Ihrem Terminal aus als Burp-Scanner zu verwenden. Anstelle der integrierten KI des Plugins wird Ihre Terminal-KI zur Reasoning-Engine, während Burp die Tools über MCP bereitstellt.

Was die Skill enthält

• MCP-Tool-Referenz (bis zu allen 59 Tools im vollständigen Build), organisiert nach Scan-Aktion
• Passives Analyseprotokoll (Datenverkehrsanalyse ohne Senden von Anforderungen)
• Payload-Bibliothek für aktive Tests (200+ Payloads für 62 Schwachstellenklassen mit Erkennungsmustern)
• End-to-End-Scan-Workflow (Scope -> passiv -> aktiv -> OOB -> Bericht)
• Issue-Erstellungsprotokoll mit Schweregrad-/Konfidenz-Zuordnung

Installation für Claude Code

Kopieren Sie die Skill in das Skills-Verzeichnis von Claude Code:

Verwenden Sie dann /burp-scan in Claude Code oder lassen Sie sie automatisch auslösen, wenn Sie Burp-Scanning erwähnen.

Installation für andere KI-Assistenten

Die Skill ist eine eigenständige Markdown-Datei unter skills/burp-scan/SKILL.md. Sie können sie mit jedem KI-Assistenten verwenden, der Systemprompts oder Kontextdateien unterstützt:

• Gemini CLI / Codex / OpenCode: Als Kontextdatei hinzufügen oder in Ihren Systemprompt einfügen
• Benutzerdefinierte MCP-Clients: Den Inhalt der Skill als Systemkontext zusammen mit Ihrer MCP-Verbindung einbeziehen
• Beliebiges LLM: Die Datei ist in sich geschlossen — geben Sie sie zusammen mit Ihren MCP-Tool-Definitionen als Kontext an

Verwendungsbeispiel

Die Skill und der integrierte Scanner des Plugins ergänzen sich gegenseitig: Das Plugin führt automatische Hintergrund-Scans aus, während die Skill interaktives, analystengeführtes Scannen von Ihrem Terminal aus ermöglicht.

Dokumentation

Die vollständige Dokumentation ist unter burp-ai-agent.six2dez.com verfügbar.

• Installation
• Schnellstart
• UI-Tour
• Agent-Profile
• Passiver Scanner
• Aktiver Scanner
• MCP-Überblick
• Datenschutzmodi
• Einstellungsreferenz
• Fehlerbehebung
• Burp-Scan-Skill

Operator-Playbooks

• MCP-Härtung
• UI-Sicherheitsleitfaden
• Backend-Fehlerbehebung
• Anthropic-Backend-Einrichtung
• Externe MCP-Server

Hinweise zu Datenschutz und Sicherheit

• Geheimnisse im Ruhezustand — was die Verschlüsselung leistet und was nicht. Alle gespeicherten API-Schlüssel und Token (Anthropic, MCP-Bearer-Token, TLS-Keystore-Passwort usw.) werden mit AES-256-GCM unter Verwendung eines pro Installation zufällig generierten Hauptschlüssels (SecretCipher) verschlüsselt. Dieser Hauptschlüssel selbst wird in den Burp-Einstellungen Base64-kodiert neben dem Chiffrat gespeichert, das er schützt (Einstellung secret.master.key.v1). Jeder, der Ihre Burp-Einstellungen lesen kann, kann daher auch den Schlüssel lesen und die Geheimnisse entschlüsseln. Es schützt nicht gegen einen lokalen Angreifer oder einen bösartigen Prozess, der unter Ihrem Benutzerkonto läuft; betrachten Sie es als Verschleierung gegen das beiläufige Einsehen einer Einstellungsdatei oder eines exportierten Projekts. Wenn eine Anmeldeinformation diesem Bedrohungsmodell standhalten muss, bewahren Sie sie in einem dedizierten Geheimnisspeicher auf und fügen Sie sie pro Sitzung ein.
• Vom Modell ausgegebene Tool-Aufrufe benötigen Ihre Genehmigung. Ein Tool-Aufruf, den die Erweiterung aus der Modellausgabe extrahiert, wird erst nach Ihrer Entscheidung gegen Burp ausgeführt. Jedes Tool trägt eine erforderliche Sicherheitsstufe: automatisch ausführen (nur lesend und mit begrenzter Ausgabe), mit einer Option Für Sitzung genehmigen bestätigen oder bei jedem einzelnen Aufruf bestätigen. Ein Toolname, den der Katalog nicht erkennt, wird immer als „bei jedem Aufruf bestätigen" aufgelöst, niemals als automatisch, und externe Tools mit ext:-Namespace bestätigen immer jeden Aufruf. Die Entscheidung erscheint als Karte inline im Chat-Transkript und nicht als modaler Dialog, und jede Entscheidung wird aufgezeichnet — ein Audit-Ereignis plus eine Zeile im Output-Tab von Burp, da die Audit-Protokollierung standardmäßig deaktiviert ist. Bei Verweigerung erhält das Modell ein neutrales Ergebnis „nicht autorisiert, nicht erneut versuchen" statt eines Fehlers. Diese Stufe ist unabhängig vom Unsafe Mode-Schalter: Der Unsafe Mode bestimmt, ob ein Tool jemals ausgeführt werden darf, die Stufe bestimmt, ob das Modell es ohne Nachfragen ausführen darf. Designbegründung: DECISIONS.md ADR-15. Operator-Runbook: docs/ui-safety-guide.md.
• Der STRICT-Datenschutzmodus anonymisiert Hosts mithilfe von echtem HKDF (HMAC-SHA256-Extrakt/Expand). Der BALANCED-Modus redigiert Cookies, Token und Auth-Header. Der OFF-Modus sendet Datenverkehr unverändert.
• Ausgaben externer MCP-Server werden vor dem Eintritt in den KI-Prompt in eine Vertrauensgrenzen-Markierung gehüllt, um Prompt-Injection durch nicht vertrauenswürdige Serverantworten zu verhindern.

Die Einstellungen sind intern schemaversioniert (settings.schema.version) und werden beim Laden additiv migriert, um sichere Upgrades zu gewährleisten.

Anforderungen

• Burp Suite Community oder Professional (2023.12+)
• Java 21 (bei modernem Burp für die Laufzeit enthalten; für das Erstellen aus dem Quellcode separat erforderlich)
• Mindestens ein konfiguriertes KI-Backend (siehe Tabelle oben)

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Haftungsausschluss

Die Verwendung von Custom AI Agent zum Angreifen von Zielen ohne vorherige Zustimmung ist illegal. Es liegt in der Verantwortung des Benutzers, alle geltenden Gesetze einzuhalten. Die Entwickler übernehmen keine Haftung für Missbrauch oder Schäden, die durch dieses Tool verursacht werden. Verwenden Sie es verantwortungsvoll.

Mitwirken

Issues und Pull Requests sind willkommen. Siehe CONTRIBUTING.md für Entwicklungseinrichtung und Richtlinien oder die Entwicklerdokumentation für Architekturdetails.