# Documentazione di Astral

> Fonte: https://astrallab.dev/it/docs

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](https://astrallab.dev/it/docs/tools.md).

## 1\. Installa Astral

Scarica l’installer per il tuo sistema dalla [sezione download](https://astrallab.dev/#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 --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](https://astrallab.dev/it/docs/connect.md).

## 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](https://astrallab.dev/it/docs/test-runs.md) per vedere cosa scrive l’agente e cosa lascia.

Ogni pagina della documentazione è disponibile anche in [Markdown](https://astrallab.dev/it/docs.md), così puoi passarne l’URL a un agente IA: aggiungi `.md` all’URL della pagina, oppure dai all’agente [llms.txt](https://astrallab.dev/llms.txt), un indice di tutte le pagine.