Linux에 HIOB MCP 설치하기
Linux에서 필요한 프로그램 준비부터 HIOB MCP 설치, Codex 등록과 렌더 환경 확인까지 순서대로 안내합니다.
Linux ARM64 가상 머신에서 설치·렌더를 확인했습니다. x64·WSL은 검증 전입니다. 지원 범위 보기
준비 프로그램 설치하기
Linux에서 Node.js 22.18 이상과 Codex를 설치하고 Codex에 로그인하세요. 이미 설치했다면 다음 단계로 넘어갑니다.
최종 영상 합성에는 Docker Engine과 Buildx도 필요합니다. 설치 후 실행하세요. Windows는 Linux 컨테이너 모드를 사용합니다.
HIOB 설치 명령 실행하기
Codex를 사용할 Linux 환경의 터미널을 여세요. 아래 명령을 복사해 붙여넣고 Enter를 누릅니다.
터미널에서 실행curl --fail --show-error --location --proto '=https' --tlsv1.2 'https://studio.hi-ob.com/downloads/mcp/install-tools-0.5.0.mjs' -o hiob-install.mjs && node ./hiob-install.mjs
설치가 파일과 도구 연결을 점검합니다. HIOB 비밀번호나 API 키를 입력하지 않습니다.
Codex 등록과 렌더 준비하기
설치가 끝나면 터미널에 표시되는 Codex 등록 명령과 setup-renderer 명령을 순서대로 복사해 실행하세요. 첫 렌더 준비는 수 분 걸릴 수 있습니다.
출력에서 어떤 명령을 찾나요?
등록 명령에는
mcp add hiob, 렌더 준비 명령에는setup-renderer가 포함됩니다. 경로는 컴퓨터마다 다르므로 설치 결과에 출력된 명령 전체를 사용하세요.등록 전
codex mcp get hiob로 기존 등록을 확인합니다. 이미 등록되어 있다면 업데이트 안내를 따르세요.이후 Codex를 완전히 종료했다가 다시 열고 새 대화를 시작하세요.
앱만 사용하거나 수동 설정이 필요한가요?Codex에서 설치 확인하기
Codex 대화창에 붙여넣기HIOB MCP의 runtime_check와 project_list를 실행해줘. 서버 버전, 운영체제, 프로젝트 조회 성공 여부, 최종 렌더 지원 여부를 따로 알려줘. 설치 확인 중에는 유료 생성이나 업로드를 실행하지 마. renderBackend와 ready를 확인해줘. Windows/Linux는 로컬 Docker Linux 엔진과 renderer_setup이 필요해. ready=false이면 원인과 설치 절차를 설명하고 보호 장치를 우회하지 마.
다음 단계로 넘어가는 기준HIOB 도구가 보이고, 버전 0.5.0과 프로젝트 조회가 확인되어야 합니다. 최종 영상 제작은 렌더 준비 결과
ready=true까지 확인한 뒤 진행하세요.