# Documentação do Astral

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

O modo desenvolvedor do Astral permite que um agente de IA controle uma aba real do navegador via MCP (Model Context Protocol). O agente pode ler uma página, clicar e digitar, observar a rede e o console, tirar capturas de tela e executar um teste que deixa um relatório com evidências. Esta página deixa você conectado.

## O que um agente conectado pode fazer

- Abrir abas, navegar e esperar a página carregar, e depois lê-la como texto ou como um snapshot de acessibilidade.
- Clicar, digitar, pressionar teclas, rolar e selecionar, com entrada confiável, como uma pessoa faria.
- Inspecionar requisições, mensagens do console e erros de página agrupados, e ler o desempenho da página.
- Verificar o layout responsivo de uma página e obter a correção de CSS para cada problema encontrado.
- Escrever e executar um teste: passos, expectativas, capturas de tela e uma gravação, e salvá-lo para que você, outro agente ou o CI possam reproduzi-lo.

São 46 ferramentas em 10 grupos. Cada grupo é uma permissão que você liga ou desliga, e alguns vêm desligados por padrão. Veja a [referência de ferramentas](https://astrallab.dev/pt/docs/tools.md).

## 1\. Instale o Astral

Baixe o instalador para o seu sistema na [seção de downloads](https://astrallab.dev/#download). A ponte MCP, `astral-mcp`, já vem dentro do instalador: não há mais nada a instalar para conectar um agente.

## 2\. Ative o modo desenvolvedor

1. Abra **Settings → Developer** e ative o Developer mode.
2. O cartão **Connection** mostra o comando que registra o Astral no seu agente, por exemplo `claude mcp add --scope user astral -- "/Applications/Astral.app/Contents/MacOS/astral-mcp"`.
3. Use **Share with AI** no cabeçalho do painel para escolher quais abas o agente pode ver. O escopo é escolhido na mesma tela.

Toda chamada que um agente faz aparece no feed de atividade e no registro de auditoria. Cada grupo de ferramentas (read, navigate, interact, network, console, screenshot, evaluate, script, tests) pode ser ligado ou desligado em Settings → Developer.

## 3\. Conecte seu agente

O `astral-mcp setup` escreve a entrada certa para o cliente que você usa. Escolha o seu, copie o comando e execute-o em um terminal.

`astral-mcp setup --list` mostra todos os clientes compatíveis e se estão instalados; `--client all-detected` configura todos eles, e `--dry-run` mostra o diff antes. Os trechos manuais, a verificação de que funcionou e os clientes que não estão na lista (OpenCode, qualquer outro cliente MCP) estão em [Conecte seu agente](https://astrallab.dev/pt/docs/connect.md).

## 4\. Um primeiro prompt para testar

Com uma aba compartilhada e seu agente conectado, peça algo como:

```
Abra https://example.com no Astral, leia a página e me diga
o que há nela. Depois verifique o layout em um viewport mobile e
liste os problemas que encontrar.
```

Quando isso funcionar, peça um teste de verdade:

```
Teste o fluxo de cadastro no meu app local em http://localhost:3000.
Escreva-o como um teste com um passo por tela, espere que não haja
erros de console nem de rede, grave as ações e me mostre o relatório.
```

Continue com as [execuções de teste](https://astrallab.dev/pt/docs/test-runs.md) para ver o que o agente escreve e o que ele deixa como resultado.

Cada página da documentação também está disponível em [Markdown](https://astrallab.dev/pt/docs.md), para que você possa passar a URL a um agente de IA: acrescente `.md` à URL da página, ou entregue ao agente o [llms.txt](https://astrallab.dev/llms.txt), um índice de todas as páginas.