MadoHub Docs

Mac Companion

MadoHub Cloud 또는 암호화된 로컬 페어링으로 iPhone과 iPad를 호환되는 Mac에 연결합니다.

Companion으로 Mac 캔버스, Agent 상태와 터미널 출력을 확인하고 지원되는 작업을 보낼 수 있습니다. 모바일 작업 공간은 독립적으로 사용할 수 있습니다. Mac에서는 호환되는 MadoHub와 Companion을 켜고 연결 중 깨어 있는 상태와 네트워크를 유지하세요.

MadoHub Cloud로 연결하기

  1. 두 기기에서 같은 MadoHub 계정으로 로그인합니다.
  2. Mac의 Settings → General에서 Companion을 켜고 앱을 열어 둡니다.
  3. iOS의 Settings → Mac Connection에서 Connect signed-in Macs automatically를 켜고 필요하면 온라인 Mac을 선택합니다.
  4. Connected 상태를 확인한 뒤 사용합니다.

상태와 작업을 MadoHub Cloud가 중계하므로 서로 다른 네트워크에서도 사용할 수 있습니다. 양쪽에 인터넷이 필요합니다. iOS 1.1에서 저장된 설정이 없으면 자동 연결은 꺼져 있고 기존 선택은 유지됩니다.

iOS 1.1.2에서는 기기 목록에서 제어할 Mac을 선택합니다. 선택한 Mac은 다음 클라우드 연결을 위해 저장됩니다. 해당 Mac이 오프라인이면 다른 온라인 Mac을 직접 선택해야 하며, 앱이 제어 대상을 자동으로 바꾸지 않습니다. Mac이 연결을 새로 등록하면 다시 선택해야 할 수 있습니다.

로컬에서 페어링하기

  1. 같은 Wi-Fi에 연결하고 Mac의 Settings → General에 Companion QR 코드를 표시합니다.
  2. iOS의 Settings → Mac Connection → Scan QR Code를 사용하거나 전체 링크를 로컬 연결 입력란에 붙여 넣습니다.
  3. Mac에서 요청하면 계정과 기기를 확인하고 허용한 뒤 암호화 연결 확인을 기다립니다.

코드는 Mac 신원 정보를 포함합니다. 주소와 포트만으로는 부족하며 이전 프로토콜 링크는 다시 생성해야 합니다. 카메라 권한은 스캔할 때 사용합니다.

작업과 문제 해결

타일에서 터미널 상세 내용을 읽고 텍스트나 지원되는 키 동작을 보냅니다. 승인하거나 멈추기 전에 대상과 현재 요청을 확인하세요. Mac 이름 아래의 작업으로 터미널과 작업 공간을 만들고 사용 가능한 Flow를 실행합니다. 휴대폰에 없는 데스크톱 레이아웃 편집은 Mac에서 합니다. 연결만으로 모바일 전체 기록이 복사되지는 않습니다.

  • Mac이 없음: 같은 계정인지, Companion과 앱이 켜져 있는지, Mac이 깨어 있고 연결되는지 확인합니다.
  • 클라우드 재시도: 인터넷을 확인하고 Try Again을 사용합니다. 같은 Wi-Fi라면 로컬 연결도 시도합니다.
  • 로컬 실패: 네트워크 권한, Wi-Fi 기기 격리와 VPN을 확인하고 새 QR을 사용합니다.
  • 신원 또는 프로토콜 오류: 두 앱을 호환되는 버전으로 업데이트하고 다시 페어링합니다.
  • 카메라를 사용할 수 없음: 권한을 허용하거나 링크를 붙여 넣습니다.

모바일만 이용한다면 자동 연결을 꺼 두세요. 이전 버전에서 경고가 남으면 끄고 앱을 재실행합니다.

iOS 1.1.2에서는 넓은 터미널 출력을 가로로 스크롤할 수 있습니다. 긴 줄을 화면 너비에 맞추려면 자동 줄바꿈을 켜세요.

연결 해제와 개인정보

자동 연결을 끄면 클라우드 검색과 자동 클라우드 연결이 중단됩니다. Disconnect Local Connection은 로컬 연결을 끊습니다. Forget This Mac은 휴대폰의 저장된 페어링만 지우고 Mac 권한은 취소하지 않습니다. 권한은 Mac의 신뢰 기기 목록에서 제거합니다.

로컬 연결은 암호화되고 코드의 Mac 신원을 확인합니다. 클라우드 연결은 상태, 터미널 출력 일부와 작업을 MadoHub Cloud로 전달합니다. 처리와 보관은 개인정보 처리방침을 확인하세요.

해결되지 않으면 [email protected]으로 두 앱의 버전과 오류를 보내 주세요. 비공개 출력을 가리고 비밀번호나 페어링 링크는 보내지 마세요.

On this page