# Mit dem KI-Agent prüfen

> So richtest du deinen KI-Agenten für ein WCAG-Audit ein: der passende Agent, agent-browser, der Start-Prompt, Erlaubnisse und Adressen.

Du kannst deine Website zusammen mit deinem KI-Agenten nach WCAG prüfen. Der Agent geht die Prüfschritte durch, öffnet die Seiten in einem Browser und hält Funde mit Screenshots direkt in einem sitebrunch Audit fest.

> **Info:** Diese Funktion ist noch in einer frühen Phase. Die Ergebnisse sind noch nicht immer zuverlässig, und sie ist nur für Workspaces freigeschaltet, die sie testen. Wenn du sie ausprobieren willst, schreib uns an support@sitebrunch.com.

Klappt etwas nicht, findest du die häufigsten Probleme und ihre Lösung in [Probleme mit dem KI-Agent lösen](/hilfecenter/ki-agent/einrichten/probleme-mit-dem-ki-agent-loesen#beim-prufen-mit-dem-ki-agenten).

## Was dein Agent dafür braucht

- **Lesen und schreiben:** Dein Agent ist mit sitebrunch verbunden, mit »Lesen und schreiben«.

- **Einen Browser:** Dein Agent kann einen Browser steuern: Seiten öffnen, Tasten drücken, Skripte ausführen und Screenshots machen. Am besten mit agent-browser, es geht aber auch mit Chrome DevTools MCP, Playwright MCP oder dem Browser, der in deinem Agenten eingebaut ist.

- **Subagenten:** Dein Agent kann Subagenten starten, also Hilfs-Agenten, die einzelne Prüfschritte übernehmen. Ohne sie reicht der Speicher eines einzelnen Agenten nicht für ein ganzes Audit.

- **Subagenten, die selbst Subagenten starten:** Jeder Tester gibt die Bewertung von Screenshots an einen eigenen Subagenten weiter. Dein Agent prüft vor dem Start, ob das geht, und sagt dir sonst, was du einstellen musst.

## Welcher Agent sich eignet

- **Claude Code mit Opus 5.5 (empfohlen):** Im Terminal oder in der Claude Desktop-App im Bereich »Code«. Startet Subagenten von selbst, auch Subagenten in Subagenten, nutzt agent-browser auf deinem Computer und erreicht jede Website ohne zusätzliche Freigaben.

- **Codex, auch in der ChatGPT Desktop-App:** Funktioniert gut, wenn du im Prompt ausdrücklich nach Subagenten fragst und Codex einmal erlaubst, Subagenten in Subagenten zu starten (siehe unten). agent-browser läuft dort nur, wenn du erlaubst, dass es außerhalb der Sandbox läuft.

- **ChatGPT im Modus »Work«:** Startet Subagenten nur, wenn du darum bittest. ChatGPT nutzt dann seinen eigenen Browser.

**Nicht geeignet** sind diese beiden:

- **Der normale Chat in ChatGPT:** Er kann keine Subagenten starten. Wechsle in »Work« oder zu Codex.

- **Claude im Chat** (claude.ai oder der Bereich »Chat« in der Desktop-App): Ein Audit ist dort umständlich. Du musst jede Adresse der Website erst in den Einstellungen freigeben und danach einen neuen Chat starten. Nimm Claude Code, das gibt es auch in der Desktop-App.

> **Tipp:** **Wir empfehlen Claude Code mit Opus 5.5.** Damit bekommst du die besten Ergebnisse und verbrauchst am wenigsten Tokens. Das Modell wählst du in Claude Code mit `/model`.

### Subagenten in Subagenten erlauben

Die Tester sind selbst Subagenten. Ob ein Fokus-Rahmen sichtbar ist oder ein Alt-Text zum Bild passt, entscheidet für sie ein weiterer Subagent, der die Screenshots ansieht. Kann ein Tester keinen Subagenten starten, hört er sofort auf und meldet „Cannot start subagents.“ Er bewertet Screenshots nie selbst, damit keine Barriere übersehen wird.

- **Claude Code:** Geht ohne Einstellung. Nur wenn in deiner `settings.json` die Variable `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` auf 1 steht, entferne sie oder setz sie auf 2. Starte danach eine neue Sitzung.

- **Codex:** Trag diese Zeilen in `~/.codex/config.toml` ein und starte Codex neu:

```
[agents]
max_depth = 2
```

Bei anderen Agenten nennt dir dein Agent die passende Einstellung, wenn er sie kennt.

## agent-browser installieren

agent-browser ist ein Browser für KI-Agenten. Mit ihm testen bis zu 3 Subagenten gleichzeitig, und das Audit ist schneller fertig. Er läuft ohne sichtbares Fenster, du kannst also nebenbei weiterarbeiten. Du brauchst dafür Node.js. Führe diesen Befehl einmal im Terminal aus:

```bash
npm install -g agent-browser && agent-browser install
```

Fehlt agent-browser, fragt dein Agent, ob er es installieren darf. Erlaube es, oder führ den Befehl selbst aus. Manche Agenten lehnen Installationen von selbst ab, wenn sie Befehle automatisch freigeben. Dein Agent umgeht das nicht, sondern fragt dich.

Sagst du nein, prüft er mit einem anderen Browser, den er hat, zum Beispiel Chrome DevTools MCP. Das dauert deutlich länger, weil die Subagenten dann nacheinander testen.

Kann agent-browser seinen eigenen Chrome nicht herunterladen, nutzt es den Chrome, der schon auf deinem Computer ist. An den Ergebnissen ändert das nichts.

> **Tipp:** Läuft das Audit in einem sichtbaren Browserfenster, zum Beispiel mit Chrome DevTools MCP, arbeite währenddessen nicht am Computer. Sobald du in ein anderes Programm klickst, verliert das Fenster den Fokus. Dann zeigt der Browser keine Fokus-Rahmen mehr, und die Prüfung der Tastaturbedienung liefert falsche Ergebnisse.

In Codex und in der ChatGPT Desktop-App laufen Befehle in einer Sandbox. Dort startet agent-browser nur, wenn du den Befehl außerhalb der Sandbox ausführen lässt. Bestätige das, wenn Codex danach fragt. Sonst stürzt Chrome beim Start ab.

Installiert dein Agent agent-browser in einer Sandbox selbst, braucht er Zugriff auf diese Adressen: registry.npmjs.org, googlechromelabs.github.io und storage.googleapis.com.

## Erlaubnisse einmal erteilen

Ein Audit ruft die Werkzeuge von sitebrunch hunderte Male auf. Ohne Freigabe fragt dein Agent jedes Mal nach. Stell das vor dem Start ein:

- **Claude:** Öffne **»Customize«**, **»Connectors«** und sitebrunch. Stell bei **»Tool permissions«** die Werkzeuge auf **»Always allow«**. In Claude Team und Enterprise muss ein Admin zuerst in den Einstellungen der Organisation **»Allow ›Always allow‹ for connector tools«** einschalten.

- **ChatGPT und Codex:** ChatGPT merkt sich eine Erlaubnis nur für den aktuellen Chat. Erlaube die sitebrunch Werkzeuge bei der ersten Frage für den ganzen Chat.

Solange eine Frage nach Erlaubnis offen ist, warten die Subagenten.

## Das Audit starten

Starte einen neuen Chat und kopiere diesen Prompt hinein. Ersetze <Projektname> durch den Namen deines Projekts:

```
Führe mit dem sitebrunch MCP ein WCAG-Audit für das Projekt <Projektname> durch.

1. Prüf vor dem Start, ob agent-browser installiert ist. Fehlt es, halte an und bitte mich, es zu installieren. Nenn mir dafür diesen Befehl, den ich einmal im Terminal ausführe (er braucht Node.js): npm install -g agent-browser && agent-browser install. Sag ich nein, prüf mit dem Browser, den du hast.
2. Wähle das Projekt, starte mit select_workflow den Workflow "auditing" und folge seinen Anweisungen genau.
3. Führe das Audit mit Subagenten durch, wie es die Anweisungen sagen: pro Durchgang ein Subagent für das Rezept und ein Tester pro Seite. Mit agent-browser laufen bis zu 3 Tester gleichzeitig.
4. Arbeite alle Schritte ohne Pause ab. Frag mich zwischen den Schritten nicht nach Bestätigung und halte nicht an, um Zwischenstände zu melden. Halte nur an, wenn der Browser Adressen nicht laden kann, die die Seiten brauchen, wenn die Website eine Anmeldung braucht, oder wenn alle Schritte fertig sind und du mich fragst, ob du das Audit abschließen sollst.
```

Welche Seiten geprüft werden, legst du mit deinem Agenten fest. Gib sie als Pfad an, zum Beispiel /kontakt, oder als volle Adresse deiner Website. Seiten von Subdomains gehen auch. Seiten anderer Websites lehnt sitebrunch ab.

Der Prompt prüft zuerst, ob agent-browser installiert ist, und sagt dir sonst, wie du es installierst. Er bittet ausdrücklich um Subagenten. ChatGPT und Codex starten sie nur, wenn du darum bittest. Und er sagt dem Agenten, dass er alle Schritte ohne Pause abarbeiten soll.

> **Tipp:** Die Tester füllen Formulare aus und schicken sie ab, um Fehlermeldungen zu prüfen. Dabei können echte Anfragen, Anmeldungen oder Bestellungen entstehen. Schreib in den Prompt, welche Formulare dein Agent nicht abschicken soll.

## Wenn dein Agent Adressen freischalten will

Vor dem ersten Prüfschritt testet dein Agent, ob sein Browser die Seiten mit allen Bildern, Schriften und Styles laden kann. Ist eine Adresse gesperrt, nennt er dir die genauen Adressen. Das sind die Website selbst, die Adressen für Bilder und Schriften und die Adresse, an die er Screenshots hochlädt. So gibst du sie frei:

- **Claude Code auf deinem Computer:** Fragt die Sandbox nach einer Adresse, erlaube sie.

- **Claude Code im Web:** Öffne **»Environment«** und **»Network access«** und trag die Adressen ein. Starte dann eine neue Sitzung.

- **Andere Agenten:** Dein Agent nennt dir die Einstellung, in der du Adressen freigibst.

Bei diesem Test prüft er auch, ob er Screenshots zu sitebrunch hochladen kann. So gibst du alle Adressen auf einmal frei. Ein Fund gilt erst dann als „mit Screenshot“, wenn das Bild wirklich bei sitebrunch angekommen ist.

Manchmal ist nur ein einzelnes Skript gesperrt, zum Beispiel ein Tracking-Skript von einer anderen Adresse. Dein Agent fragt dich dann, ob es für die Prüfung zählt. Sammelt das Skript nur Statistiken, kann er ohne es weiterprüfen. Fügt es sichtbare Elemente ein, etwa einen Cookie-Banner, ein Chat-Fenster oder ein Feedback-Tool, gib die Adresse frei. Sonst prüfen die Tester eine Seite, der genau diese Elemente fehlen.

Sag deinem Agenten Bescheid, wenn du die Adressen freigegeben hast. Er prüft sie dann noch einmal. Klappt es im laufenden Chat nicht, starte einen neuen und schreib: „Setze das sitebrunch-Audit <Audit-ID> fort.“

## So läuft eine Prüfung ab

- Dein Agent wählt das Projekt und startet das Audit.

- Die Prüfschritte sind in Durchgänge gruppiert. Ein Durchgang fasst Schritte zusammen, die sich mit denselben Handgriffen prüfen lassen. Ein einziger Durchlauf mit der Tab-Taste beantwortet zum Beispiel sichtbaren Fokus, Fokus-Reihenfolge und Tastaturfallen.

- Für jeden Durchgang schreibt ein Subagent ein Rezept, also die genaue Prüfmethode. Danach testet ein Tester pro Seite alle Schritte dieses Durchgangs.

- Manche Durchgänge gelten nur, wenn es etwas auf der Seite gibt, zum Beispiel Video oder Audio, Anrufe oder Werkzeuge zum Erstellen von Inhalten. Dann prüft ein Subagent zuerst, ob es das gibt. Fehlt es, gelten die Schritte als nicht anwendbar.

- Jeden Fund legt er mit Beschreibung, betroffenem Element und Screenshot im Audit an, in der Sprache deines Projekts.

- Wenn alle Durchgänge erledigt sind, zeigt er dir eine Zusammenfassung und fragt, ob er das Audit abschließen soll. Ein abgeschlossenes Audit lässt sich nicht wieder öffnen. Bis dahin kannst du dir die Funde schon im Dashboard ansehen.

### Die Zusammenfassung am Ende

Dein Agent sagt dir, was er gut getestet hat, was er nicht getestet hat und welche Fehler unterwegs aufgetreten sind. Er nennt auch Schritte, die schwächer getestet sind, und Grenzfälle, die ein Mensch entscheiden sollte. Sieh dir genau diese Stellen an, bevor du das Audit abschließt.

Kommt dir ein Schritt unsicher vor, lass ihn nachtesten. Schreib zum Beispiel: „Teste die Schritte 1, 8 und 11 nach.“ Die Tester lassen bestehende Funde stehen. Hält einer einen Fund für falsch, sagt dein Agent dir Bescheid.

Prüfe die Funde danach selbst durch. Du kannst sie im Dashboard bearbeiten oder löschen wie bei einem Audit, das du selbst angelegt hast. Klappt etwas nicht, lies [Probleme mit dem KI-Agent lösen](/hilfecenter/ki-agent/einrichten/probleme-mit-dem-ki-agent-loesen#beim-prufen-mit-dem-ki-agenten).

### Ein Audit fortsetzen

Bricht ein Chat ab, starte einen neuen und schreib: „Setze das sitebrunch-Audit <Audit-ID> fort.“ Die Audit-ID steht im Dashboard in der Adresse des Audits, hinter /a11y-audit/. Dein Agent macht beim nächsten offenen Durchgang weiter.

Den Rest erledigt dein Agent: Er findet das Projekt des Audits über die Audit-ID selbst.

Ein neuer Chat kennt die Berichte des alten nicht. Schritte, die schon getestet, aber noch nicht abgeschlossen waren, markiert dein Agent deshalb zur Prüfung durch dich. Willst du sicher sein, lass sie nachtesten.

---

- Vorheriger Artikel: [Ergebnisse der automatisierten Prüfung abrufen](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/accessibility/ergebnisse-der-automatisierten-pruefung-abrufen.md)
- Nächster Artikel: [Kommentare mit dem KI-Agent bearbeiten](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/accessibility/kommentare-mit-dem-ki-agent-bearbeiten.md)

## Hilfecenter: Inhalt

- [Accessibility](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility.md)
  - [Erste Schritte](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/erste-schritte.md)
    - [Ein Projekt erstellen](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/erste-schritte/ein-projekt-erstellen.md)
    - [WCAG-Monitoring einrichten](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/erste-schritte/wcag-monitoring-einrichten.md)
    - [PDF prüfen](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/erste-schritte/pdf-pruefen.md)
  - [WCAG-Monitoring](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/wcag-monitoring.md)
    - [Die Monitoring-Übersicht](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/wcag-monitoring/das-monitoring-dashboard.md)
    - [Seiten zum Monitoring hinzufügen](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/wcag-monitoring/seiten-zum-monitoring-hinzufuegen.md)
    - [E-Mail Benachrichtigungen](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/wcag-monitoring/e-mail-benachrichtigungen.md)
    - [Was die automatisierte Prüfung testet](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/wcag-monitoring/was-die-automatisierte-pruefung-testet.md)
  - [Audits](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/audits.md)
    - [Ein Audit anlegen](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/audits/ein-audit-anlegen.md)
    - [Einen Prüfschritt durchführen](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/audits/einen-pruefschritt-durchfuehren.md)
    - [Der Prüfbericht](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/audits/der-pruefbericht.md)
    - [Ein Re-Audit erstellen](https://staging.frontend.sitebrunch.de/hilfecenter/accessibility/audits/ein-re-audit-erstellen.md)
- [User Experience](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience.md)
  - [Erste Schritte](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/erste-schritte.md)
    - [Ein Projekt anlegen](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/erste-schritte/ein-projekt-anlegen.md)
    - [Das Snippet einbauen](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/erste-schritte/das-snippet-einbauen.md)
    - [Vom Einbau bis zum ersten Besuch](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/erste-schritte/vom-einbau-bis-zum-ersten-besuch.md)
    - [Die Wochenübersicht lesen](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/erste-schritte/die-wochenuebersicht-lesen.md)
  - [Metrics](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/metrics.md)
    - [Die Metrics-Übersicht](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/metrics/die-metrics-uebersicht.md)
    - [Filtern und vergleichen](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/metrics/filtern-und-vergleichen.md)
    - [Seiten und Bereiche](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/metrics/seiten-und-bereiche.md)
    - [Kampagnen auswerten](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/metrics/kampagnen-auswerten.md)
  - [Conversions](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/conversions.md)
    - [Ereignisse und Ziele einrichten](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/conversions/ereignisse-und-ziele-einrichten.md)
    - [Die Conversions-Übersicht](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/conversions/die-conversions-uebersicht.md)
    - [Interaktionen auswerten](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/conversions/interaktionen-auswerten.md)
    - [Einen Trichter anlegen](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/conversions/einen-trichter-anlegen.md)
  - [Journeys](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/journeys.md)
    - [Journeys im Überblick](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/journeys/journeys-im-ueberblick.md)
    - [Sehen, wohin Besuche gehen](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/journeys/wohin-besuche-gehen.md)
    - [Eine Strecke anlegen](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/journeys/eine-strecke-anlegen.md)
    - [Vom Ziel rückwärts lesen](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/journeys/vom-ziel-rueckwaerts-lesen.md)
  - [Live Heatmaps](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/live-heatmaps.md)
    - [Live Heatmaps im Überblick](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/live-heatmaps/live-heatmaps-im-ueberblick.md)
    - [Klicks lesen](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/live-heatmaps/klicks-lesen.md)
    - [Scrolltiefe und Geräte](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/live-heatmaps/scrolltiefe-und-geraete.md)
    - [Nach Herkunft und Zielen filtern](https://staging.frontend.sitebrunch.de/hilfecenter/user-experience/live-heatmaps/nach-herkunft-und-zielen-filtern.md)
- [KI-Agent (MCP)](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent.md)
  - [Einrichten](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/einrichten.md)
    - [Mit Claude verbinden](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/einrichten/mit-claude-verbinden.md)
    - [Mit ChatGPT verbinden](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/einrichten/mit-chatgpt-verbinden.md)
    - [Eigenen KI-Agenten verbinden](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/einrichten/eigenen-ki-agenten-verbinden.md)
    - [Beispiel-Prompts](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/einrichten/beispiel-prompts.md)
    - [Probleme mit dem KI-Agent lösen](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/einrichten/probleme-mit-dem-ki-agent-loesen.md)
  - [Accessibility](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/accessibility.md)
    - [Audit-Funde mit dem KI-Agent beheben](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/accessibility/audit-funde-mit-dem-ki-agent-beheben.md)
    - [Ergebnisse der automatisierten Prüfung abrufen](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/accessibility/ergebnisse-der-automatisierten-pruefung-abrufen.md)
    - [Mit dem KI-Agent prüfen](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/accessibility/mit-dem-ki-agent-pruefen.md) (dieser Artikel)
    - [Kommentare mit dem KI-Agent bearbeiten](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/accessibility/kommentare-mit-dem-ki-agent-bearbeiten.md)
    - [Scans starten und Ergebnisse abfragen](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/accessibility/scans-starten-und-ergebnisse-abfragen.md)
  - [User Experience](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/user-experience.md)
    - [Analytics und Conversions abfragen](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/user-experience/analytics-und-conversions-abfragen.md)
    - [Notizen im Diagramm setzen](https://staging.frontend.sitebrunch.de/hilfecenter/ki-agent/user-experience/notizen-im-diagramm-setzen.md)
