Documentación: Primeros pasos

Ver como Markdown

Documentación de Astral

El modo desarrollador de Astral permite que un agente de IA controle una pestaña real del navegador mediante MCP (Model Context Protocol). El agente puede leer una página, hacer clic y escribir, mirar la red y la consola, tomar capturas de pantalla y ejecutar una prueba que deja un informe con evidencias. Esta página te deja conectado.

Qué puede hacer un agente conectado

  • Abrir pestañas, navegar y esperar a la página, y leerla como texto o como instantánea de accesibilidad.
  • Hacer clic, escribir, pulsar teclas, desplazarse y seleccionar, con entrada de confianza como lo haría una persona.
  • Inspeccionar peticiones, mensajes de la consola y errores de página agrupados, y leer el rendimiento de la página.
  • Comprobar el layout responsive de una página y obtener la corrección CSS de cada hallazgo.
  • Escribir y ejecutar una prueba: pasos, expectativas, capturas y una grabación, y guardarla para que tú, otro agente o el CI puedan reproducirla.

Son 46 herramientas en 10 grupos. Cada grupo es un permiso que activas o desactivas, y algunos vienen desactivados por defecto. Consulta la referencia de herramientas.

1. Instala Astral

Descarga el instalador para tu sistema desde la sección de descargas. El puente MCP, astral-mcp, viene dentro del instalador: no hay que instalar nada más para conectar un agente.

2. Activa el modo desarrollador

  1. Abre Ajustes → Desarrollador y activa el modo desarrollador.
  2. La tarjeta Conexión muestra el comando que registra Astral en tu agente, por ejemplo claude mcp add --scope user astral -- "/Applications/Astral.app/Contents/MacOS/astral-mcp".
  3. Usa Compartir con IA en la cabecera del panel para elegir qué pestañas puede ver el agente. El alcance se elige en la misma pantalla.

Cada llamada de un agente aparece en el registro de actividad y en el registro de auditoría. Cada grupo de herramientas (read, navigate, interact, network, console, screenshot, evaluate, script, tests) se puede activar o desactivar en Ajustes → Desarrollador.

3. Conecta tu agente

astral-mcp setup escribe la entrada correcta para el cliente que usas. Elige el tuyo, copia el comando y ejecútalo en una terminal.

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

Escribe .mcp.json en el proyecto. Sin --project imprime el comando oficial claude mcp add --scope user en lugar de editar el archivo de estado propio de Claude Code.

astral-mcp setup --list muestra todos los clientes compatibles y si están instalados; --client all-detected configura todos, y --dry-run muestra antes el diff. Los fragmentos manuales, la comprobación de que funciona y los clientes que no están en la lista (OpenCode, cualquier otro cliente MCP) están en Conecta tu agente.

4. Un primer prompt para probar

Con una pestaña compartida y tu agente conectado, pide algo como:

Abre https://example.com en Astral, lee la página y dime
qué hay en ella. Después comprueba su layout en un viewport móvil y
enuméra los problemas que encuentres.

Cuando eso funcione, pide una prueba de verdad:

Prueba el flujo de registro en mi app local en http://localhost:3000.
Escríbelo como una prueba con un paso por pantalla, espera que no haya
errores de consola ni de red, graba las acciones y muéstrame el informe.

Continúa con las ejecuciones de prueba para ver qué escribe el agente y qué deja como resultado.

Cada página de la documentación también está disponible en Markdown, para que puedas pasar su URL a un agente de IA: añade .md a la URL de la página, o dale al agente llms.txt, un índice de todas las páginas.