Documentazione: Per iniziare

Visualizza come Markdown

Documentazione di Astral

La modalità sviluppatore di Astral permette a un agente IA di pilotare una vera scheda del browser tramite MCP (il Model Context Protocol). L’agente può leggere una pagina, fare clic e digitare, esaminare la rete e la console, fare screenshot ed eseguire un test che lascia un report con prove. Questa pagina ti porta alla connessione.

Cosa può fare un agente collegato

  • Aprire schede, navigare e attendere la pagina, poi leggerla come testo o come snapshot di accessibilità.
  • Fare clic, digitare, premere tasti, scorrere e selezionare, con input attendibile come farebbe una persona.
  • Ispezionare richieste, messaggi della console ed errori di pagina raggruppati, e leggere le prestazioni della pagina.
  • Controllare il layout responsive di una pagina e ottenere la correzione CSS per ogni problema rilevato.
  • Scrivere ed eseguire un test: passaggi, aspettative, screenshot e una registrazione, poi salvarlo perché tu, un altro agente o la CI possiate riprodurlo.

Sono 46 strumenti in 10 gruppi. Ogni gruppo è un permesso che attivi o disattivi, e alcuni sono disattivati per impostazione predefinita. Vedi il riferimento degli strumenti.

1. Installa Astral

Scarica l’installer per il tuo sistema dalla sezione download. Il bridge MCP, astral-mcp, è incluso nell’installer: non c’è nient’altro da installare per collegare un agente.

2. Attiva la modalità sviluppatore

  1. Apri Settings → Developer e attiva il Developer mode.
  2. La scheda Connection mostra il comando che registra Astral nel tuo agente, per esempio claude mcp add --scope user astral -- "/Applications/Astral.app/Contents/MacOS/astral-mcp".
  3. Usa Share with AI nell’intestazione del pannello per scegliere quali schede l’agente può vedere. L’ambito si sceglie nella stessa schermata.

Ogni chiamata di un agente compare nel feed delle attività e nel registro di audit. Ogni gruppo di strumenti (read, navigate, interact, network, console, screenshot, evaluate, script, tests) può essere attivato o disattivato in Settings → Developer.

3. Collega il tuo agente

astral-mcp setup scrive la voce giusta per il client che usi. Scegli il tuo, copia il comando ed eseguilo in un terminale.

astral-mcp setup --client claude-code --project .

Scrive .mcp.json nel progetto. Senza --project stampa il comando ufficiale claude mcp add --scope user invece di modificare il file di stato di Claude Code.

astral-mcp setup --list mostra tutti i client supportati e se sono installati; --client all-detected li configura tutti, e --dry-run mostra prima il diff. Gli snippet manuali, la verifica che funzioni e i client non presenti nell’elenco (OpenCode, qualsiasi altro client MCP) sono in Collega il tuo agente.

4. Un primo prompt da provare

Con una scheda condivisa e il tuo agente collegato, chiedi qualcosa come:

Apri https://example.com in Astral, leggi la pagina e dimmi
cosa c’è. Poi controlla il layout in un viewport mobile e
elenca i problemi che trovi.

Quando funziona, chiedi un vero test:

Testa il flusso di registrazione sulla mia app locale a http://localhost:3000.
Scrivilo come un test con un passaggio per schermata, aspettati nessun errore
di console o di rete, registra le azioni e mostrami il report.

Continua con le esecuzioni di test per vedere cosa scrive l’agente e cosa lascia.

Ogni pagina della documentazione è disponibile anche in Markdown, così puoi passarne l’URL a un agente IA: aggiungi .md all’URL della pagina, oppure dai all’agente llms.txt, un indice di tutte le pagine.