Dokumentation: Erste Schritte

Als Markdown anzeigen

Astral-Dokumentation

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.

1. Astral installieren

Laden Sie das Installationsprogramm für Ihr System im Download-Bereich 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 --client claude-code --project .

Schreibt .mcp.json im Projekt. Ohne --project wird stattdessen der offizielle Befehl claude mcp add --scope user ausgegeben, statt die eigene Statusdatei von Claude Code zu bearbeiten.

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.

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: Dort sehen Sie, was der Agent schreibt und was er hinterlässt.

Jede Seite der Dokumentation gibt es auch als Markdown, 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, ein Verzeichnis aller Seiten.