# Astral-Dokumentation

> Quelle: https://astrallab.dev/de/docs

Mit dem Entwicklermodus von Astral kann ein KI-Agent über MCP (das Model Context Protocol) einen echten Browser-Tab steuern. Der Agent kann eine Seite lesen, klicken und tippen, Netzwerk und Konsole untersuchen, Screenshots aufnehmen und einen Test ausführen, der einen Bericht mit Nachweisen hinterlässt. Diese Seite bringt Sie zur Verbindung.

## Was ein verbundener Agent tun kann

- Tabs öffnen, navigieren und auf die Seite warten, sie dann als Text oder als Accessibility-Snapshot lesen.
- Klicken, tippen, Tasten drücken, scrollen und auswählen, mit vertrauenswürdigen Eingaben wie ein Mensch.
- Anfragen, Konsolenmeldungen und gruppierte Seitenfehler untersuchen und die Seitenleistung auslesen.
- Das responsive Layout einer Seite prüfen und zu jedem Befund die CSS-Korrektur erhalten.
- Einen Test schreiben und ausführen: Schritte, Erwartungen, Screenshots und eine Aufzeichnung, und ihn speichern, damit Sie, ein anderer Agent oder die CI ihn wiedergeben können.

Das sind 46 Tools in 10 Gruppen. Jede Gruppe ist eine Berechtigung, die Sie ein- oder ausschalten, und einige sind standardmäßig aus. Siehe die [Tool-Referenz](https://astrallab.dev/de/docs/tools.md).

## 1\. Astral installieren

Laden Sie das Installationsprogramm für Ihr System im [Download-Bereich](https://astrallab.dev/#download) herunter. Die MCP-Bridge `astral-mcp` ist im Installationsprogramm enthalten: Um einen Agenten zu verbinden, ist nichts weiter zu installieren.

## 2\. Entwicklermodus aktivieren

1. Öffnen Sie **Settings → Developer** und aktivieren Sie den Developer mode.
2. Die Karte **Connection** zeigt den Befehl, der Astral bei Ihrem Agenten registriert, zum Beispiel `claude mcp add --scope user astral -- "/Applications/Astral.app/Contents/MacOS/astral-mcp"`.
3. Mit **Share with AI** in der Kopfzeile des Panels legen Sie fest, welche Tabs der Agent sehen darf. Der Umfang wird auf demselben Bildschirm gewählt.

Jeder Aufruf eines Agenten erscheint im Aktivitäts-Feed und im Audit-Log. Jede Tool-Gruppe (read, navigate, interact, network, console, screenshot, evaluate, script, tests) lässt sich unter Settings → Developer ein- oder ausschalten.

## 3\. Agent verbinden

`astral-mcp setup` schreibt den passenden Eintrag für den Client, den Sie verwenden. Wählen Sie Ihren aus, kopieren Sie den Befehl und führen Sie ihn in einem Terminal aus.

`astral-mcp setup --list` zeigt alle unterstützten Clients und ob sie installiert sind; `--client all-detected` richtet alle ein, und `--dry-run` zeigt vorher den Diff. Manuelle Snippets, die Prüfung, ob es funktioniert hat, und Clients, die nicht in der Liste stehen (OpenCode, jeder andere MCP-Client), finden Sie unter [Agent verbinden](https://astrallab.dev/de/docs/connect.md).

## 4\. Ein erster Prompt zum Ausprobieren

Wenn ein Tab geteilt und Ihr Agent verbunden ist, fragen Sie zum Beispiel:

```
Öffne https://example.com in Astral, lies die Seite und sag mir,
was darauf steht. Prüfe dann ihr Layout in einem mobilen Viewport und
liste alle Probleme auf, die du findest.
```

Wenn das funktioniert, bitten Sie um einen richtigen Test:

```
Teste den Registrierungsablauf in meiner lokalen App unter http://localhost:3000.
Schreibe ihn als Test mit einem Schritt pro Bildschirm, erwarte keine Konsolen-
oder Netzwerkfehler, zeichne die Aktionen auf und zeige mir den Bericht.
```

Weiter geht es mit den [Testläufen](https://astrallab.dev/de/docs/test-runs.md): Dort sehen Sie, was der Agent schreibt und was er hinterlässt.

Jede Seite der Dokumentation gibt es auch als [Markdown](https://astrallab.dev/de/docs.md), damit Sie ihre URL an einen KI-Agenten weitergeben können: Hängen Sie `.md` an die URL der Seite an oder geben Sie dem Agenten [llms.txt](https://astrallab.dev/llms.txt), ein Verzeichnis aller Seiten.