Documentación de longarm

Esta página es el punto de entrada rápido a la documentación de longarm. Usa estas páginas cuando necesites controlar un dispositivo Android desde un script, herramienta de escritorio, entorno de pruebas o agente compatible con MCP.

Páginas de documentación

• REST API
• Servidor MCP
• Tareas por lotes
• Registros e historial

Qué hace longarm

longarm se ejecuta en un dispositivo Android y expone:

• una REST API HTTP para control remoto directo
• un servidor MCP por HTTP streamable para flujos con agentes y herramientas
• tareas por lotes guardadas y reutilizables

Las acciones principales compatibles incluyen:

• toque y pulsación larga
• gestos Plus como deslizamiento, pellizco, deslizamiento con dos dedos y rotación
• capturas de pantalla
• apertura de apps e intents personalizados de Android
• inspección opcional de UI y acciones semánticas sobre la interfaz

Configuración inicial

1. Instala y abre longarm.
2. Activa el servicio de Accesibilidad de Android para longarm.
3. Concede permiso de superposición si quieres usar la burbuja flotante.
4. En Settings, revisa el puerto HTTP, el puerto MCP, la autenticación por bearer token, la dirección de escucha y las opciones de inspección de UI.
5. Inicia el servidor HTTP y/o el servidor MCP desde la app.

Modelo de seguridad

• Por defecto, longarm espera Authorization: Bearer <token>.
• Si la autenticación está desactivada, cualquiera en la red alcanzable puede llamar al servidor.
• La inspección de UI solo está disponible cuando la autenticación por token sigue activada y Allow UI inspection está habilitado.

REST API

El servidor HTTP expone endpoints bajo /api/... para gestos, capturas, apertura de apps, intents de Android, inspección de UI y automatización por lotes.

Leer la documentación de REST API.

MCP

longarm también expone un servidor MCP por HTTP streamable para que agentes y herramientas compatibles llamen acciones de control Android directamente.

Leer la documentación de MCP.

Tareas por lotes

Las tareas por lotes guardan flujos reutilizables de automatización Android que pueden ejecutarse desde la app, la REST API o MCP.

Leer la documentación de tareas por lotes.

Registros detallados e historial

longarm separa los registros REST/MCP del historial de ejecuciones por lotes para que puedas inspeccionar llamadas individuales y flujos completos.

Leer la documentación de registros e historial.

Flujo recomendado

1. Inicia el servidor HTTP o MCP.
2. Copia el host y el puerto mostrados en la app.
3. Usa la REST API para scripts directos, o MCP para integración con agentes.
4. Guarda los flujos repetidos como tareas por lotes.
5. Revisa la pestaña Logs y la pestaña Batch History dentro de longarm.