# Apple Vision Pro

Device MCP에서 visionOS 27 Apple Vision Pro 시뮬레이터를 시작하고 미러링하고 제어하세요. 마우스로 바라보고 핀치하며, AI 에이전트도 같은 MCP 도구로 visionOS 앱을 테스트합니다.

Device MCP는 Apple Vision Pro 시뮬레이터를 iPhone 시뮬레이터처럼 미러링하고 제어합니다. 같은 사이드바에 표시되고, 기기 고유의 프레임 안에 보이며, AI 에이전트도 같은 MCP 도구를 사용합니다. visionOS는 터치 대신 바라보기와 핀치로 조작하므로, 클릭이 바라보기와 핀치가 됩니다. 시뮬레이터에는 아무것도 설치하지 않습니다.

## 1. 요구 사항
* Mac에 **Xcode**와 **visionOS 27** 시뮬레이터 런타임이 있어야 합니다. 런타임은 **Xcode → Settings → Components**에서 추가합니다.
* visionOS 27 이상의 Apple Vision Pro 시뮬레이터를 지원합니다.
* Apple Vision Pro는 시뮬레이터만 지원합니다. Device MCP는 실제 Apple Vision Pro를 미러링하지 않습니다.

## 2. Apple Vision Pro 시뮬레이터 시작하기
1. 사이드바 위쪽의 **+** 버튼을 클릭하고 **New Simulator → Apple Vision Pro**를 고릅니다.
2. **Start**를 클릭합니다. Device MCP가 시뮬레이터를 부팅하고, 준비되는 대로 화면을 보여 줍니다.

Apple Vision Pro 시뮬레이터는 iPhone 시뮬레이터와 똑같이 목록에 표시되고, 시작하고 종료하며, 사이드바에는 바이저 아이콘으로 표시됩니다. [iOS 시뮬레이터](ios-simulator.md#2-start-a-simulator)를 참고하세요.

{% hint style="info" %}
Device MCP Free는 한 번에 기기 한 대를 미러링하며, Apple Vision Pro 시뮬레이터도 한 대로 셉니다. Device MCP Pro는 대수 제한 없이 미러링합니다. [라이선스](../license.md)를 참고하세요.
{% endhint %}

## 3. 미러링과 제어
* **착용자가 보는 그대로**: 미러링 화면은 시뮬레이터의 화면을 3840 × 2160 무손실, 초당 약 60프레임으로 얇고 둥근 프레임 안에 보여 줍니다.
* **클릭으로 바라보고 핀치하기**: Device MCP는 클릭한 지점을 바라본 다음 핀치합니다. 드래그하면 핀치한 채로 손을 움직입니다. 핀치한 대상이 손을 따라 움직이므로, 드래그하면 윈도우의 콘텐츠가 스크롤됩니다.
* **키보드**: 미러링 화면을 클릭한 다음, 포커스가 있는 필드에 입력합니다.
* **Digital Crown**: 도구 막대의 **Home**을 클릭하거나 <kbd>⇧⌘H</kbd>를 누르면 Digital Crown을 눌러 홈 뷰를 엽니다.
* **스크린샷과 화면 기록**: [스크린샷 및 화면 기록](../basic-features/screenshots-and-recording.md)을 참고하세요.

## 4. AI 에이전트와 함께 쓰기
에이전트는 iPhone과 같은 [MCP](../ai-agents/mcp.md) 서버로 Apple Vision Pro 시뮬레이터를 사용합니다.

* `tap`은 한 지점을 바라보고 핀치합니다. `swipe`, `scroll`, `drag`는 핀치한 채로 손을 움직입니다.
* `list_elements`는 화면의 텍스트를 읽습니다. visionOS는 윈도우를 3D 공간에 배치하므로, 사람이 보는 방식대로 화면을 읽으며, 에이전트는 `tap_text`로 그 단어를 탭합니다.
* `press_button home`은 Digital Crown을 누릅니다.
* `launch_app`은 앱을 엽니다. 홈 뷰의 아이콘은 바라보면 강조되지만 핀치에는 반응하지 않으므로, 에이전트는 대신 이름으로 앱을 엽니다.
* `start_simulator`는 Apple Vision Pro 시뮬레이터를 시작하거나 새로 만듭니다.

### ✅ 프롬프트 예시
* Apple Vision Pro 시뮬레이터를 시작하고 스크린샷을 찍어 줘.
* Vision Pro 시뮬레이터에서 내 앱을 열고 요리 프로그램을 찾아서 Up Next에 추가해 줘.
* Vision Pro에서 설정 › 손쉬운 사용을 열고 말하기까지 스크롤해 줘.

## 5. iPhone과 다른 점
* **터치가 아니라 바라보기와 핀치**: 앱 윈도우의 목록 행과 링크는 핀치에 반응합니다. 목록 밖의 버튼은 바라보면 강조되지만 아직 핀치에는 반응하지 않습니다. 필요한 컨트롤이 반응하지 않으면 [알려 주세요](/contact).
* **손쉬운 사용 트리 없음**: 에이전트는 대신 화면의 단어를 읽고, 그 단어나 위치로 탭합니다.
* **회전, 앱 전환기, 제어 센터, 잠금, 음량 버튼 없음**: Device MCP가 Vision Pro에서 누르는 버튼은 Digital Crown 하나뿐입니다.
* **Settings 탭, 깔끔한 상태 막대 없음**: visionOS에는 전환할 라이트 모드가 없습니다. 설정은 시뮬레이터의 **설정** 앱에서 바꾸세요.
* **Full로 시작**: [Slim 시뮬레이터](ios-simulator.md#6-slim-simulators)는 iOS와 watchOS에만 적용됩니다.
