agent-device — MCP-сервер для Claude Code: автоматизация мобильных
Даёт агенту живой доступ к запущенному приложению: посмотреть состояние экрана, нажать, заполнить поле, снять скриншот и сохранить доказательства.
claude mcp add agent-device -- npx -y agent-deviceЧто делает agent-device
agent-device — MCP-сервер и CLI для автоматизации мобильных приложений. Агент читает снимок дерева доступности вместо того, чтобы угадывать по скриншотам, действует через ссылки на элементы и селекторы, а результат складывает в файлы для проверки. Работает с iOS, Android, HarmonyOS, tvOS, Android TV, Fire TV, Amazon Vega OS TV, а также с вебом, macOS и Linux.
Внутри три способа подключения: CLI, встроенный stdio MCP-сервер (agent-device mcp) и типизированный Node.js API через createAgentDeviceClient(). Команды одни и те же, путь исполнения общий. Есть координация доступа к устройствам между параллельными рабочими копиями агентов и подключение к удалённым облакам устройств.
Перед первым запуском нужен Node.js 22.12 или новее, для веб-автоматизации — 24 или новее. Сначала прогоните agent-device doctor сами: без рабочего окружения агент упрётся в ошибку на первом же шаге. Снимки строятся по дереву доступности, поэтому понятные подписи, роли и тестовые идентификаторы в приложении заметно повышают шанс, что агент попадёт по нужному элементу.
Какие задачи решает
- проверить правку в запущенном приложении, а не в теории
- найти, что тормозит конкретное взаимодействие в React Native
- собрать скриншоты и видео как доказательства к пул-реквесту
- записать удачную последовательность шагов в
.ad-скрипт для CI - развести доступ к устройствам между параллельными агентами
Примеры запросов агенту
- Открой приложение Contacts на iOS и покажи интерактивные элементы
- Нажми на кнопку добавления и заполни поле имени значением Ada
- Сделай скриншот формы и закрой сессию
Как установить agent-device
Командой платформы
claude mcp add agent-device -- npx -y agent-deviceКомандой платформы
codex mcp add agent-device -- npx -y agent-deviceФайл настроек
{
"mcpServers": {
"agent-device": {
"command": "npx",
"args": [
"-y",
"agent-device"
]
}
}
}Файл настроек
{
"servers": {
"agent-device": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"agent-device"
]
}
}
}Командой платформы
gemini mcp add agent-device npx -y agent-deviceПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о agent-device
Как установить agent-device в Claude Code?
Одной командой: claude mcp add agent-device -- npx -y agent-device. После этого сервер поднимется как stdio MCP и отдаст команды агенту.
Что делает agent-device?
Даёт агенту управлять приложением на устройстве или симуляторе: смотреть состояние экрана, нажимать, заполнять поля, ждать, проверять утверждения и сохранять доказательства. Те же команды доступны из CLI и из Node.js.
Что нужно для работы?
Node.js 22.12 или новее, для веб-автоматизации — 24 или новее. Перед передачей CLI агенту стоит самому запустить agent-device doctor и убедиться, что окружение готово.
