# 문제 해결

기기가 표시되지 않는 문제부터 에이전트가 연결되지 않는 문제까지, Device MCP에서 자주 발생하는 문제의 해결 방법입니다.

## 1. 기기가 표시되지 않습니다
* 기기가 iOS 27 또는 iPadOS 27 이상인지 확인하세요.
* 기기의 잠금을 해제하고, 메시지가 나타나면 **신뢰**를 탭하세요.
* macOS에서 **Allow accessory to connect?**(액세서리 연결 허용) 메시지가 나타났다면 **허용**을 클릭하세요.
* 다른 케이블이나 포트를 사용해 보세요. 충전만 되는 케이블도 있습니다.
* Wi-Fi로 연결하는 경우 Mac과 기기가 같은 네트워크에 있는지 확인하고, Device MCP의 **Settings → General → Connection**을 확인하세요.

## 2. 미러링이 중지되거나 멈췄습니다
**More (…)** 메뉴에서 **Reconnect**를 클릭하거나 <kbd>⇧⌘R</kbd>를 누르세요.

Xcode의 Device Hub처럼 다른 앱이 기기를 미러링하고 있다고 Device MCP에 표시되면, 해당 앱에서 미러링을 닫은 다음 **Reconnect**를 클릭하세요. 기기는 한 번에 하나의 앱에서만 미러링할 수 있습니다.

## 3. 탭이나 입력이 작동하지 않습니다
* 키 입력이 기기로 전달되도록 미러링 화면을 한 번 클릭하세요.
* 다른 언어나 이모지를 입력할 때 iOS에서 **붙여넣기 허용** 여부를 물으면 **붙여넣기 허용**을 탭하세요.
* 기기에서 **설정 → 개발자**를 열고 **Enable UI Automation**(UI 자동화 활성화)이 켜져 있는지 확인하세요. [iPhone & iPad](../devices/iphone-and-ipad.md#1-prepare-your-device)를 참고하세요.

## 4. 기기가 회전된 상태로 유지되지 않습니다
iOS는 기기가 평평하게 놓여 있을 때만 회전 상태를 유지합니다. 기기를 탁자 위에 눕혀 놓고 다시 회전하세요.

## 5. 에이전트가 Device MCP를 찾지 못합니다
* Device MCP를 열고 **Settings → MCP → Enable MCP Server**를 켜세요.
* [Device MCP Pro](../license.md)가 있는지 확인하세요.
* Device MCP가 **응용 프로그램** 폴더에 있는지 확인하세요. [MCP](../ai-agents/mcp.md) 페이지의 설정은 이 위치를 가리킵니다.
* Device MCP를 추가한 후 에이전트를 다시 시작하세요.

## 6. 에이전트가 기다리다가 중단됩니다
앱을 빌드하거나 사용자의 승인을 기다리는 데 몇 분이 걸릴 수 있습니다. Codex에서는 [MCP](../ai-agents/mcp.md#codex) 페이지에 나온 대로 `tool_timeout_sec = 900`을 설정하세요.

## 7. Build & Run이 실패합니다
* Xcode에서 프로젝트를 열고, 자동 서명으로 기기용 빌드가 되는지 확인하세요.
* **Build & Run** 탭의 로그를 읽고 원인을 확인하세요.
* Wi-Fi로 연결한 경우 케이블을 연결하고 다시 시도하세요.

## 8. 도움이 더 필요하신가요?
Device MCP에서 **Help → Export Diagnostics…** 메뉴를 선택하세요. Mac에 파일이 저장되며 아무것도 전송되지 않습니다. 그런 다음 파일을 첨부해 [문의해 주시면](/contact) 답변드리겠습니다.