macOS에 HIOB MCP 설치하기

Apple Silicon Mac에서 설치·영상·음원 합성을 확인했습니다. Intel Mac은 검증 전입니다. 지원 범위 보기

1. 준비 프로그램 설치하기

   macOS에서 Node.js 22.18 이상과 Codex를 설치하고 Codex에 로그인하세요. 이미 설치했다면 다음 단계로 넘어갑니다.

   Mac 영상 렌더에 필요한 프로그램

   FFmpeg·FFprobe와 Xcode Command Line Tools가 필요합니다. Homebrew가 설치되어 있다면 아래 명령을 사용하세요. Xcode 설치 창이 열리면 설치를 마친 뒤 나머지를 실행합니다.

   터미널에서 실행macOS 준비 명령 복사

   xcode-select --install
   brew install node ffmpeg

   Homebrew 공식 설치 안내

2. HIOB 설치 명령 실행하기

   Spotlight에서 터미널을 검색해 여세요. 아래 명령을 복사해 붙여넣고 Enter를 누릅니다.

   터미널에서 실행macOS 설치 명령 복사

   curl --fail --show-error --location --proto '=https' --tlsv1.2 'https://studio.hi-ob.com/downloads/mcp/install-0.5.0.sh' -o hiob-install.sh &&
   sh hiob-install.sh --codex

   설치가 파일과 도구 연결을 점검합니다. HIOB 비밀번호나 API 키를 입력하지 않습니다.

3. Codex 등록과 렌더 준비하기

   설치가 Codex 등록과 렌더 준비를 함께 처리합니다. 기존 hiob 등록 때문에 멈췄다면 업데이트 안내를 확인하세요.

   이후 Codex를 완전히 종료했다가 다시 열고 새 대화를 시작하세요.

   앱만 사용하거나 수동 설정이 필요한가요?

4. Codex에서 설치 확인하기

   Codex 대화창에 붙여넣기무료 설치 점검 요청 복사

   HIOB MCP의 runtime_check와 project_list를 실행해줘. 서버 버전, 운영체제, 프로젝트 조회 성공 여부, 최종 렌더 지원 여부를 따로 알려줘. 설치 확인 중에는 유료 생성이나 업로드를 실행하지 마. renderBackend와 ready를 확인해줘. Windows/Linux는 로컬 Docker Linux 엔진과 renderer_setup이 필요해. ready=false이면 원인과 설치 절차를 설명하고 보호 장치를 우회하지 마.

   다음 단계로 넘어가는 기준

   HIOB 도구가 보이고, 버전 0.5.0과 프로젝트 조회가 확인되어야 합니다. 최종 영상 제작은 렌더 준비 결과 ready=true까지 확인한 뒤 진행하세요.

   도구가 안 보이나요? · 렌더 준비가 안 되나요?