Apps Android con un agente de programación

Un agente de programación puede probar el registro de tu app Android como lo haría una persona: compilarla, ejecutarla en el Android Emulator, llenar el formulario con una dirección de prueba de Proxy Mail QA y luego introducir el código o abrir el enlace del correo. Proxy Mail QA le da al agente la dirección y el código o enlace del correo; el agente controla el emulador con sus propias herramientas, normalmente adb.

Cada configuración de abajo empieza con Proxy Mail QA conectado al agente: pega la configuración de un solo prompt o conecta el MCP server a mano.

Claude Code, Codex o Cursor con adb

Cualquier agente que pueda ejecutar comandos de shell puede controlar el emulador mediante adb, de las platform tools del SDK de Android. Inicia un emulador desde el Device Manager de Android Studio (o emulator -avd con su nombre), abre tu proyecto en el agente con Proxy Mail QA conectado y pide:

Compila la app de depuración, instálala en el emulador en ejecución y ábrela. Regístrate con una nueva dirección de prueba de Proxy Mail QA, usando la contraseña que te da, luego introduce el código de verificación del correo y comprueba que la app muestre la cuenta como verificada. Haz una captura de pantalla en cada paso.

Luego el agente normalmente:

1. Compila e instala con ./gradlew installDebug, y abre la app con adb shell am start.
2. Llama a create_address con password: true.
3. Encuentra los campos con adb shell uiautomator dump (o una captura de adb exec-out screencap -p), los toca con adb shell input tap y escribe con adb shell input text.
4. Envía el formulario y luego llama a wait_for_code o wait_for_link.
5. Escribe el código, o abre el enlace en la app con adb shell am start -a android.intent.action.VIEW -d y el enlace, para que tu App Link o esquema personalizado lo gestione.
6. Hace una captura de pantalla y comprueba que la pantalla muestre la cuenta como verificada.

adb shell input text necesita que los espacios se escriban como %s y que algunos caracteres se escapen, así que pide al agente que revise cada campo después de escribir, sobre todo las contraseñas.

El agente Gemini de Android Studio

El modo agente de Android Studio puede usar servidores MCP remotos (guía de Google). En Settings → Tools → AI → MCP Servers, selecciona Enable MCP Servers y agrega:

mcp.json

{
  "mcpServers": {
    "proxymail-qa": {
      "httpUrl": "https://api.proxymail.qa/mcp"
    }
  }
}

Elige Start Login para iniciar sesión en tu navegador. Android Studio no admite plantillas de prompt de MCP, así que pide con palabras sencillas en lugar de elegir un prompt como test_signup_flow. Aún no hemos probado el agente de Android Studio; si su inicio de sesión no se completa, usa Claude Code o Codex junto con Android Studio.

Qué más puedes pedir

• Un servidor de desarrollo en tu computadora. El emulador llega a tu computadora en 10.0.2.2, así que es normal que una compilación de desarrollo tenga enlaces a 10.0.2.2:3000. Pide al agente que lo marque como entorno de desarrollo (mark_dev_host), y check_email aprueba esos enlaces en lugar de marcarlos como fallidos.
• App Links. Cuando llega el enlace, check_email con expect_host configurado con tu dominio de App Link comprueba que el enlace vaya ahí, y count_emails detecta un segundo correo enviado por error. Si el enlace abre Chrome en lugar de la app, la causa habitual es el assetlinks.json del dominio o el intent filter de la app.
• Un código dividido en casillas. El agente toca la primera casilla y escribe el código completo, y luego comprueba que cada dígito haya quedado antes de seguir.
• Un formulario de registro más largo. Para un nombre de usuario con reglas, una fecha de nacimiento o un país, form_values da un valor para cada campo a partir de una dirección nueva creada para ello.
• La misma cuenta la próxima vez. Pide al agente que registre dónde se usa la cuenta (environment, como staging, y etiquetas como android) al crearla, para que list_addresses la vuelva a encontrar. Con una clave de API autorizada a leer contraseñas guardadas, get_sign_in devuelve la cuenta y su contraseña en una sola llamada.
• Un informe. El agente llama primero a start_run y a finish_run al final, que devuelve el informe en Markdown.

Ofertas y correos de marketing

• El cupón. Después de registrarse en una oferta en la app, wait_for_code con kind: coupon devuelve el cupón con su descuento, fecha de fin y cuánto tardó. El agente lo escribe en el campo de promoción de la app.
• Pago, solo con pagos de prueba. Usa los license testers y tarjetas de prueba de Google Play, o el modo de prueba de la propia app, nunca una tarjeta real ni una compra real. El agente registra lo que hizo la app con record_coupon_result.
• Un cupón como enlace que abre la app, como myapp://redeem?code=…: wait_for_link con app: true lo devuelve, y el agente lo abre con adb shell am start -a android.intent.action.VIEW -d y el enlace.
• Una oferta por persona. Registrarse de nuevo con una variante de la misma dirección (get_address_variants), y luego check_offers, muestra si la app dio la oferta dos veces.
• Nombres y contraseñas difíciles. get_name_variants y get_password_variants dan valores para los demás campos del formulario (apóstrofos, acentos, otros alfabetos, cada clase de símbolo, los límites del campo); el agente escribe cada uno e informa lo que hizo la app.
• Consentimiento y baja. El agente registra lo que eligió en el registro con record_consent, se da de baja desde la configuración de la app o el enlace del correo, llama a mark_unsubscribed, y más tarde check_unsubscribe lista cualquier correo de marketing que haya llegado después.

Escribirlo como prueba

Para conservar la comprobación como una prueba de UI que se ejecute en CI, consulta Android (Espresso), o Maestro para un flujo que también cubra iOS.