Que tu agente de IA vea, grabe y haga demos de tu Mac.
La herramienta de línea de comandos y el servidor MCP de Recoly dan a Claude Code, Codex, Cursor y cualquier cliente MCP un grabador de pantalla local: capturas que puede mirar, grabaciones para reproducir errores, vídeos de demo pulidos y transcripciones en el dispositivo.
Configúralo en un minuto
- 1
Instala Recoly 0.9 o posterior
Descárgalo, muévelo a Aplicaciones y ábrelo una vez.
- 2
Conecta tus agentes
En Recoly, abre "Settings" (el engranaje) → "Command line & AI agents" → "Connect Claude Code, Codex, Cursor". O usa los comandos de Terminal de abajo.
- 3
Reinicia tu agente
Cargará el servidor MCP de Recoly. Prueba a pedirle una captura de tu pantalla.
Desde la Terminal
curl -fsSL https://recoly.app/install-cli.sh | sh
recoly agents install --target claude --dry-run
recoly agents install --target claude --yes # or: codex · cursor · allAñade el comando recoly y después registra el servidor MCP (previsualiza antes con --dry-run).
Cualquier cliente MCP
{
"mcpServers": {
"recoly": {
"command": "/Applications/Recoly.app/Contents/Resources/native/bin/darwin-arm64/recoly",
"args": ["mcp", "serve"]
}
}
}Pégalo en la configuración MCP de tu cliente. Obtén la ruta exacta para tu Mac con recoly agents print-config.
O deja que lo haga tu agente
Pega esto en Claude Code, Codex o Cursor:
Lee https://recoly.app/agents y configura el servidor MCP de Recoly por mí. Muéstrame cada cambio de configuración y pregúntame antes de aplicarlo.Lo que puede hacer tu agente
| recoly_screenshot | Captura la pantalla, una ventana o un área — y mira la imagen. |
| recoly_record_start · recoly_record_stop | Graba la reproducción de un error o una demo. Ves los controles de grabación todo el tiempo. |
| recoly_export | Exporta MP4, GIF, WebM o ProRes con zoom automático, fondo, un preset guardado y cualquier relación de aspecto. |
| recoly_transcript | Transcripción con Whisper en el dispositivo, con marcas de tiempo. |
| recoly_targets | Lista las pantallas y ventanas que se pueden capturar. |
| recoly_doctor | Comprueba los permisos y da la solución exacta cuando falta alguno. |
| recoly_recordings_list · recoly_presets_list | Encuentra grabaciones recientes y estilos guardados. |
Cosas que pedirle a tu agente
- “Reproduce el error del pago, grábalo y dame un GIF para la issue.”
- “Haz una captura y dime por qué este modal se ve raro.”
- “Graba una demo de 30 segundos de la función que acabas de crear y exporta versiones 16:9 y 9:16 con mi preset Brand.”
- “Transcribe mi última grabación y enumera las tareas pendientes.”
- “Comprueba si Recoly tiene los permisos que necesita.”
- “Exporta mi última grabación como un GIF de 720p.”
Seguro por diseño
- Solo local: la CLI habla con la app por un socket privado que solo puede abrir tu usuario de macOS. Sin puertos, sin nube, sin cuenta.
- Tú tienes el control: desactiva el acceso de agentes en Settings cuando quieras. Aparece una notificación cuando un agente empieza a grabar, y ⌘⇧3 lo detiene.
- Las solicitudes de aprobación de tu propio agente siguen aplicándose a cada llamada a una herramienta.
- Los cambios de configuración se pueden previsualizar con --dry-run, y Recoly hace copia de los archivos antes de tocarlos.
- Se aplica tu plan: 4K, ProRes, WebM y la calidad Studio requieren Pro; las exportaciones Free llevan una pequeña marca de agua.
Línea de comandos
Todos los comandos aceptan --json. Los resultados van a stdout y el progreso a stderr. Códigos de salida: 0 correcto, 1 fallo, 2 uso no válido.
recoly doctor # permissions + fix hints
recoly targets # displays and windows
recoly screenshot --window window:1234:0 --output shot.png
recoly record start --window window:1234:0 --duration 30
recoly export --video ~/Movies/Recoly/recording-….mp4 --format gif --aspect 9:16
recoly transcript --video ~/Movies/Recoly/recording-….mp4
recoly guide --json # the full, machine-readable contract