에이전트에게 Mac·adb·페어링 없이 클라우드의 진짜 iPhone이나 Android 에뮬레이터를 쥐여 주는 mcp 서버. 도구 이름과 모양은 2026-10-02-github-mobile-next-mobile-mcp를 따르지만, 폰이 내 책상 위가 아니라 유료 클라우드에 있다.
개요
Phone Harness가 만든 Python MCP 서버(MIT, phone-harness-mcp 0.1.0, 개발 상태 Alpha)다. 2026-11-03 수집 기준 ★369, 포크 27, 생성 2026-10-23, 마지막 push 2026-11-02, 열린 이슈 0이다. 서버 자체는 폰을 들고 있지 않고, 모든 도구 호출을 Phone Harness Cloud API로 넘기는 얇은 중계 계층이다.
연결은 https://mcp.phone-harness.com/mcp(Streamable HTTP)에 OAuth 로그인(phone:drive 스코프)을 하면 끝이다. Claude, Cursor, ChatGPT, Codex, VS Code, Gemini CLI, Copilot 등 수십 개 클라이언트별 설정법이 README에 있고, Claude Code는 claude mcp add --transport http phone-harness https://mcp.phone-harness.com/mcp 한 줄이다. OAuth 대신 API 키(pck_…)를 bearer 토큰으로 보내도 된다.
도구와 동작
호스트 서버는 도구 14개를 등록한다. 첫 두 개(목록 조회, 시작)를 뺀 나머지는 phone_list_available_devices에서 받은 device id를 인자로 받는다.
| 범주 | 도구 |
|---|---|
| 세션 | phone_list_available_devices, phone_start_device, phone_stop_device |
| 화면 읽기 | phone_get_screen_size, phone_take_screenshot, phone_list_elements_on_screen |
| 입력 | phone_click_on_screen_at_coordinates, phone_long_press_on_screen_at_coordinates, phone_swipe_on_screen, phone_type_keys, phone_press_button |
| 앱 | phone_list_apps, phone_launch_app, phone_get_foreground_app |
phone_start_device는 인자 없이 부르면 임시 Android 에뮬레이터를 띄운다. iPhone은platform=ios,kind=device로, 앱과 로그인이 유지되는 저장 폰은device_id로 고른다.- 화면 요소 목록은 Android에서는 접근성 트리이고 iPhone에서는 텍스트 인식(OCR)이다. 같은 도구라도 iPhone 쪽은 접근성 트리 기반이 아니라는 점이 mobile-mcp와 다르다.
- 스크린샷은 JPEG이고, 이미지 앞 텍스트가 이미지 좌표를 화면 좌표로 바꾸는 식을 알려 준다.
- URL 열기, 앱 설치, 클립보드 읽기, 화면 녹화 도구는 없다. 로컬 stdio 서버에만
phone_save_screenshot이 추가된다. - 다른 작업 중인 폰(409)은 최대 12초, 입력 서비스 503은 2초 뒤 한 번 재시도한다(CHANGELOG).
비용 구조
| 플랫폼 | 방식 | 요금 |
|---|---|---|
| Cloud Android 에뮬레이터 | 시작 무료, 종량제 | 분당 5센트 |
| Cloud iPhone (실기기) | 월 구독 | 100/월 (연 결제 시 80) |
phone_start_device의 minutes는 세션 길이(기본 30)이지 과금 단위가 아니다. 계정이 있어야 쓸 수 있는 서비스라서, 오픈소스인 것은 MCP 중계 서버뿐이다. 요금은 README 기준이며 현재 요금은 phone-harness.com/pricing에서 확인해야 한다.
자체 호스팅 구성
- 로컬 stdio:
uvx phone-harness-mcp+PHONE_HARNESS_API_KEY.phone-harness cloud login으로 로그인했다면 키를 생략한다. - HTTP 서버:
--port로 Streamable HTTP를 띄우면 서버가 자격 증명을 들고 있지 않다. 요청마다Authorization: Bearer를 받아 클라우드 API로 그대로 전달하므로 한 프로세스가 여러 계정을 처리하고 키를 남기지 않는다. 베어러가 없으면 401이다. - 호스트 서버
mcp.phone-harness.com은 이 코드를 Vercel Function으로 배포하고 Clerk을 인증 서버로 쓴 것이다. 그래서 직접 호스팅해도 폰은 여전히 Phone Harness 클라우드의 것이다. - 같은 계정을 쓰는 CLI(phone-harness/phone-harness, 0.3.3에서 ShawnPana/phone-harness에서 이전, “let your agent control your phone”)가 따로 있고, 이 MCP는 그 클라우드 계정을 MCP로 감싼 것이다. CLI는 2026-11-14-github-phone-harness-phone-harness.
평가와 주의점
- 이 노트의 근거는 README,
docs/self-hosting.md, CHANGELOG,pyproject.toml, 최근 커밋뿐이다. 저장소를 clone해 실행하거나 계정을 만들어 보지 않았고, 클라우드 폰의 지연·안정성·요금 청구는 검증하지 않았다. - 로컬 폰 대신 클라우드 폰을 고르는 선택이다. 2026-10-02-github-mobile-next-mobile-mcp나 2026-10-10-github-zhongerxin-iphone-use는 내 Mac과 내 기기가 필요하지만 무료이고 데이터가 밖으로 나가지 않는다. 이쪽은 설정이 없고 실제 iPhone을 빌릴 수 있는 대신 월 $80부터이며, 화면과 로그인 정보가 제3자 클라우드를 지난다. 개인 계정 로그인을 폰에 남기는 저장 폰 기능은 이 점을 따져 보고 써야 한다.
- 프로젝트가 만 2주 된 Alpha(0.1.0, GitHub 릴리스 없음)라 인터페이스가 바뀔 수 있다. 도구 이름이 mobile-mcp와 같아서 두 서버 사이를 옮기기는 쉬울 것으로 보이나 확인하지는 않았다.
- ChatGPT는 Business·Enterprise·Edu 워크스페이스에서만 폰 조작이 된다. Pro 계정은 읽기·가져오기 도구만 연결할 수 있다고 README가 적는다.
- 에이전트가 폰으로 실제 계정에 로그인해 행동하는 만큼, 같은 종류의 모바일 에이전트 도구가 갖는 권한 문제(결제·메시지 전송 등)는 그대로 남는다.
- 출시 소개는 제작자 @shawn_pana의 X 게시물(2026-11-03)이다. “설치할 것 없이 URL을 붙이고 로그인하면 끝”, Claude·ChatGPT·Cursor·Codex에서 커스텀 커넥터로 동작, phone-harness 0.3.3부터 제공이라고 밝혔다.
관련 노트
- 2026-11-14-github-phone-harness-phone-harness — 같은 회사의 로컬·클라우드 폰 조작 CLI 본체
- 2026-10-02-github-mobile-next-mobile-mcp — 도구 이름의 원형인 로컬 모바일 MCP
- 2026-10-10-github-zhongerxin-iphone-use — 로컬 USB iPhone을 Codex로 조작하는 플러그인
- 2026-10-10-github-mobai-app-mobai-dev — 클라우드 에이전트가 iOS 앱을 다루는 CLI
- moc-mobile-ai
- moc-mcp