Documentação: Primeiros passos

Ver como Markdown

Documentação do Astral

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.

1. Instale o Astral

Baixe o instalador para o seu sistema na seção de downloads. 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 --client claude-code --project .

Escreve .mcp.json no projeto. Sem --project, imprime o comando oficial claude mcp add --scope user em vez de editar o arquivo de estado do próprio Claude Code.

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.

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 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, 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, um índice de todas as páginas.