문제 해결

1. 기기가 표시되지 않습니다#

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

2. 미러링이 중지되거나 멈췄습니다#

More (…) 메뉴에서 Reconnect를 클릭하거나 ⇧⌘R를 누르세요.

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

3. 탭이나 입력이 작동하지 않습니다#

• 키 입력이 기기로 전달되도록 미러링 화면을 한 번 클릭하세요.
• 다른 언어나 이모지를 입력할 때 iOS에서 붙여넣기 허용 여부를 물으면 붙여넣기 허용을 탭하세요.
• 기기에서 설정 → 개발자를 열고 Enable UI Automation(UI 자동화 활성화)이 켜져 있는지 확인하세요. iPhone & iPad를 참고하세요.

4. 기기가 회전된 상태로 유지되지 않습니다#

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

5. 에이전트가 Device MCP를 찾지 못합니다#

• Device MCP를 열고 Settings → MCP → Enable MCP Server를 켜세요.
• Device MCP Pro가 있는지 확인하세요.
• Device MCP가 응용 프로그램 폴더에 있는지 확인하세요. MCP 페이지의 설정은 이 위치를 가리킵니다.
• Device MCP를 추가한 후 에이전트를 다시 시작하세요.

6. 에이전트가 기다리다가 중단됩니다#

앱을 빌드하거나 사용자의 승인을 기다리는 데 몇 분이 걸릴 수 있습니다. Codex에서는 MCP 페이지에 나온 대로 tool_timeout_sec = 900을 설정하세요.

7. Build & Run이 실패합니다#

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

8. 도움이 더 필요하신가요?#

Device MCP에서 Help → Export Diagnostics… 메뉴를 선택하세요. Mac에 파일이 저장되며 아무것도 전송되지 않습니다. 그런 다음 파일을 첨부해 문의해 주시면 답변드리겠습니다.