MCP 커넥터
HFLUX는 표준 MCP 규격을 따르는 원격 커넥터를 제공합니다. 계정 화면에서 서버 주소를 복사해 Claude나 Codex에 등록하면 대화창에서 이미지와 영상 생성을 요청할 수 있습니다. Claude와 Codex에서 연결을 확인했습니다.
크레딧은 웹에서 쓸 때와 같은 기준으로 차감됩니다.
Claude에 연결하기
- Claude에서 Customize에서 Connectors로 이동합니다
- ＋에서 Add custom connector를 누르고 HFLUX 계정 화면에서 복사한 MCP 서버 주소를 붙여넣습니다
- Add를 누르면 열리는 인증 화면에서 허용을 누릅니다
Claude 무료 플랜은 커넥터를 1개까지 연결할 수 있습니다.
Codex에 연결하기
- 터미널을 열고 계정 화면에 표시된
codex mcp add hflux --url …명령을 붙여넣어 실행합니다 - 자동으로 열리는 브라우저 인증 화면에서 허용을 누릅니다
- Codex 설정의 MCP 서버 목록에
hflux가 보이면 완료입니다
쓸 수 있는 도구 13개
| 갈래 | 도구 |
|---|---|
| 둘러보기 | hflux_list_models · hflux_get_credits · hflux_estimate_credits |
| 만들기 | hflux_write_prompt · hflux_prompt101 · hflux_generate_image · hflux_submit_video · hflux_generate_audio |
| 확인하기 | hflux_get_job · hflux_list_jobs |
| FLOW | hflux_flow_plan · hflux_flow_start · hflux_flow_get |
생성 전에 hflux_estimate_credits로 먼저 견적을 받을 수 있어, 대화창에서 얼마가 나갈지 확인한 뒤 진행할 수 있습니다.
크레딧 상한
대화형 에이전트가 연달아 생성하는 사고를 지갑에 닿기 전에 끊기 위해 사용자별 상한을 둡니다.
| 항목 | 상한 |
|---|---|
| 한 번의 호출 | 1,500크레딧 |
| 시간당 합계 | 20,000크레딧 |
| 생성 도구 호출 | 분당 20회 |
| 읽기 도구 호출 | 분당 60회 |
읽기와 생성은 버킷을 나누어 셉니다. 작업 상태를 자주 확인해도 생성 호출 여지를 잠식하지 않습니다. 어느 경우든 잔액을 넘으면 서버가 차단하므로 잔액 이상의 손실은 생기지 않습니다.
인증과 연결 해제
OAuth로 발급된 토큰만 받습니다. MCP 규격이 금지하는 토큰 전달 방식을 쓰지 않고 HFLUX 자원에 유효한 토큰만 검증하며, 브라우저 로그인 세션 토큰으로는 접근되지 않습니다.
연결한 앱은 계정 화면의 연결된 앱 목록에서 언제든 해제할 수 있습니다. 해제하면 그 앱에서 더 이상 크레딧을 사용할 수 없습니다.
자주 묻는 질문
Claude나 Codex에서 HFLUX를 바로 쓸 수 있나요?
가능합니다. HFLUX는 MCP 원격 커넥터를 제공합니다. 계정 화면에서 서버 주소를 복사해 Claude나 Codex에 등록하면 대화창에서 이미지와 영상 생성을 요청할 수 있습니다. 표준 MCP 규격을 따르며 Claude와 Codex에서 연결을 확인했습니다. 크레딧은 웹에서 쓸 때와 같은 기준으로 차감됩니다.
Claude에 어떻게 연결하나요?
Claude에서 Customize에서 Connectors로 이동한 뒤, 더하기 버튼에서 Add custom connector를 누르고 HFLUX 계정 화면에서 복사한 MCP 서버 주소를 붙여넣습니다. Add를 누르면 열리는 인증 화면에서 허용을 누르면 연결됩니다. Claude 무료 플랜은 커넥터를 1개까지 연결할 수 있습니다.
Codex에 어떻게 연결하나요?
터미널을 열고 HFLUX 계정 화면에 표시된 codex mcp add 명령을 붙여넣어 실행합니다. 자동으로 열리는 브라우저 인증 화면에서 허용을 누르고, Codex 설정의 MCP 서버 목록에 hflux가 보이면 완료입니다.
어떤 도구를 쓸 수 있나요?
도구는 13개입니다. 모델 목록 조회, 크레딧 잔액 조회, 크레딧 견적, 프롬프트 작성, 프롬프트101, 이미지 생성, 영상 제출, 오디오 생성, 작업 상태 조회, 작업 목록 조회, FLOW 계획과 시작과 결과 조회입니다.
대화형 에이전트가 크레딧을 과하게 쓰지 않나요?
사용자별 상한이 걸려 있습니다. 한 번의 호출은 1,500크레딧을 넘을 수 없고 시간당 합계는 20,000크레딧까지입니다. 생성 도구는 분당 20회, 읽기 도구는 분당 60회로 나누어 제한합니다. 어느 경우든 잔액을 넘으면 서버가 차단하므로 잔액 이상의 손실은 생기지 않습니다.
연결을 해제할 수 있나요?
계정 화면의 연결된 앱 목록에서 언제든 해제할 수 있습니다. 해제하면 그 앱에서 더 이상 회원님의 크레딧을 사용할 수 없습니다.
인증은 어떻게 되나요?
OAuth로 발급된 토큰만 받습니다. MCP 규격이 금지하는 토큰 전달 방식을 쓰지 않고, HFLUX 자원에 유효한 토큰만 검증합니다. 브라우저 로그인 세션 토큰으로는 접근되지 않습니다.