Línea de comandos

device-mcp-cli es la línea de comandos de Device MCP. Lo que haces en la app, o le pides a tu agente de IA, también lo puedes ejecutar desde Terminal, un script de shell, un Makefile o CI: ver la lista de tus dispositivos, hacer capturas de pantalla, leer la pantalla, tocar y escribir, abrir e instalar apps, simular la ubicación y gestionar tu licencia.

Todos los comandos pueden responder en JSON, así que tus scripts leen el resultado con jq en lugar de analizar texto.

1. Instalación#

• Homebrew: brew install --cask device-mcp añade device-mcp-cli a tu PATH.
• Descargado desde el sitio web: ejecuta esto una vez en Terminal para añadirlo a tu PATH:

sudo ln -sf "/Applications/Device MCP.app/Contents/MacOS/device-mcp-cli" /usr/local/bin/device-mcp-cli

El enlace sigue funcionando cuando Device MCP se actualiza. Compruébalo con:

device-mcp-cli --version
device-mcp-cli --help                  # every command
device-mcp-cli help apps launch        # one command, with its options

2. Cómo funciona#

• Device MCP ejecuta tus comandos. Los comandos de dispositivo van a la app Device MCP de tu Mac. Si no se está ejecutando, el comando pregunta antes de abrirla: --launch la abre sin preguntar (úsalo en scripts) y --no-launch nunca la abre. status, mcp, tools y logs nunca la abren.
• Qué dispositivo: añade --device (o -d) con el nombre o el UDID de un dispositivo. Sin él, los comandos usan el dispositivo que elegiste con devices select o, si no, el que está seleccionado en Device MCP.
• JSON: añade --json a cualquier comando. Los errores también llegan en JSON.
• Tú tienes el control: instalar y eliminar apps, abrir enlaces, leer o cambiar el portapapeles y Build & Run te piden permiso primero en Device MCP, igual que con un agente de IA. Consulta Aprobaciones. Desvincular un dispositivo y desactivar tu licencia siempre piden permiso.
• Free y Pro: todos los comandos funcionan con Device MCP Free, salvo Build & Run, la instalación de apps y el inspector de vistas 3D, que requieren Device MCP Pro. Free duplica un dispositivo a la vez.

3. Comandos#

<device> es el nombre o el UDID de un dispositivo. Todos los comandos aceptan --json; los comandos de dispositivo aceptan --device.

Dispositivos#

La pantalla#

Toques y teclas#

Apps#

Ajustes del dispositivo#

Device MCP#

Todo lo demás#

4. Ejemplos#

Inicia sesión y comprueba el resultado#

Una prueba de humo (smoke test) para tu app, en un script de shell o un paso de CI:

set -e
device-mcp-cli apps launch com.example.myapp --launch
device-mcp-cli wait-for "Sign In"
device-mcp-cli type "[email protected]" --field "Email"
device-mcp-cli type - --field "Password" < password.txt
device-mcp-cli tap --text "Sign In"
device-mcp-cli wait-for "Welcome" --timeout 20 || {
  device-mcp-cli screenshot -o failure.png
  exit 1
}

Haz una captura de pantalla de cada dispositivo#

device-mcp-cli devices --json |
  jq -r '.devices[] | select(.state == "ready" or .state == "running") | .udid' |
  while read -r udid; do device-mcp-cli screenshot --device "$udid" -o ~/Desktop/; done

Toca un elemento de la pantalla#

elements muestra la pantalla con sus referencias. Busca una con jq y tócala:

REF=$(device-mcp-cli elements --json | jq -r '.elements[] | select(.label == "General") | .ref')
device-mcp-cli tap --ref "$REF"

Prueba tu app en otro idioma y otro lugar#

device-mcp-cli apps launch com.example.myapp --language fr --locale fr_FR
device-mcp-cli location set 48.8584 2.2945
device-mcp-cli open-url "myapp://map"
device-mcp-cli appearance dark

Compila y ejecuta en un simulador nuevo#

device-mcp-cli simulators start --model "iPhone 17 Pro" --launch
device-mcp-cli build-and-run ~/Projects/MyApp/MyApp.xcodeproj --scheme MyApp
device-mcp-cli screenshot -o ~/Desktop/myapp.png

Graba un error#

device-mcp-cli record start
# reproduce the bug on the device
device-mcp-cli record stop

Configura un Mac#

En un Mac de CI o en el Mac de un nuevo compañero de equipo:

device-mcp-cli license activate --launch < license-key.txt
device-mcp-cli mcp on
device-mcp-cli mcp setup claude
device-mcp-cli status

5. JSON y códigos de salida#

Con --json, un comando muestra un solo objeto JSON. Por ejemplo, device-mcp-cli devices --json:

{
  "devices" : [
    {
      "connection" : "USB",
      "current" : true,
      "kind" : "iphone",
      "mirroringStopped" : false,
      "model" : "iPhone 17 Pro",
      "name" : "My iPhone",
      "osVersion" : "27.0.1",
      "platform" : "iOS",
      "state" : "ready",
      "udid" : "00008150-000A1B2C3D4E5F60"
    }
  ]
}

El kind de un dispositivo es iphone, ipad, watch, android, simulator o emulator. Su state es ready, locked, blocked (con issue y fix, que indican por qué y qué hacer), connecting, running, shut_down, booting, shutting_down, creating o starting.

Un error muestra {"error": {"code": "…", "message": "…"}}:

Un comando que funciona sale con el código 0.

6. Con tu agente de IA#

Tu agente también puede usar la línea de comandos, por ejemplo para escribir un script de prueba o un paso de CI para tu app:

• "Escribe un script que inicie sesión en mi iPhone y falle si la pantalla principal no se carga."
• "Añade un paso de CI que haga una captura de cada pantalla del onboarding."

Los comandos que ejecuta tu agente aparecen en la pestaña Agent como device-mcp-cli. Consulta Actividad del agente.