본문 바로가기
AI.Codeing

Claude Code + 힉스필드(Higgsfield) MCP 연동 유튜브 쇼츠 완전 자동화 2026

by Mi_meon 2026. 7. 8.

Claude Code + 힉스필드(Higgsfield) MCP 연동 유튜브 쇼츠 완전 자동화 2026

📅 2026년 7월  |  ⏱️ 읽는 시간 약 15분  |  🏷️ 힉스필드, HiggsfieldMCP, ClaudeCode, Cowork, 유튜브쇼츠, 완전자동화

💡 이 글에서 얻을 수 있는 것
2026년 4월 30일, 힉스필드(Higgsfield)가 공식 MCP 서버를 출시하면서 Claude가 직접 영상을 생성하는 것이 가능해졌습니다. 더 이상 힉스필드 웹사이트를 따로 열 필요가 없습니다. 이 글에서는 Claude Code와 Cowork에서 힉스필드 MCP를 연동해 기획 → 대본 → 영상 생성 → 유튜브 업로드까지 하나의 대화·세션 안에서 완전 자동화하는 방법을 정리합니다.

1. 힉스필드 MCP란?

힉스필드는 2026년 4월 30일 공식 MCP(Model Context Protocol) 서버를 출시했습니다. MCP는 Claude 같은 AI 에이전트가 외부 도구를 직접 호출할 수 있게 해주는 개방형 표준입니다. 힉스필드 MCP가 연동되면 Claude가 대화 안에서 바로 영상·이미지를 생성하고, 결과물을 다시 대화 맥락에서 활용할 수 있습니다.

항목 내용
출시일 2026년 4월 30일
지원 클라이언트 Claude (웹·데스크톱·모바일), Cowork, Claude Code, OpenClaw, Hermes Agent
MCP 서버 주소 https://mcp.higgsfield.ai/mcp
API 키 필요 여부 ❌ 불필요 (OAuth 계정 인증)
지원 모델 30개 이상 (Soul, Cinema Studio, Kling 3.0, Veo 3.1, Seedance 2.0 등)
과금 방식 힉스필드 기존 크레딧 시스템 그대로 사용

주요 MCP 도구(Tools)

도구 기능
generate_image / generate_video 텍스트·이미지 기반 이미지·영상 생성
generate_and_animate 이미지 생성 후 자동으로 모션 적용
create_character / list_characters Soul 캐릭터 학습 및 재사용 (동일 인물 유지)
get_generation_status 비동기 생성 작업 진행 상태 확인
search_motions 카메라 모션 프리셋 검색
Personal Clipper (Shorts Studio) 긴 영상을 세로형 숏폼 클립으로 자동 분할
💡 핵심 변화: 기존에는 대본만 자동화하고 영상은 사람이 직접 힉스필드 웹사이트에서 만들어야 했습니다. 이제는 Claude Code 세션 안에서 "이 대본으로 영상 만들어줘"라고 말하면 Claude가 직접 힉스필드를 호출해서 영상까지 만들어줍니다.

2. 완전 자동화 아키텍처

Claude Code, Cowork, 힉스필드 MCP, YouTube MCP(또는 n8n)를 조합하면 사람의 개입을 최소화한 파이프라인을 구성할 수 있습니다.

Cowork (오케스트레이션) 매일 쇼츠 주제 선정 지시
Claude Code 대본·나레이션·영상 프롬프트 작성
Higgsfield MCP generate_video 호출, 영상 생성
Higgsfield MCP get_generation_status로 완료 대기
Claude Code 생성된 영상 다운로드, 로컬 저장
YouTube 연동 제목·설명·태그와 함께 업로드
Cowork 결과 요약 보고 및 다음 작업 대기
📌 Cowork와 Claude Code의 역할 차이: Cowork는 여러 도구·파일을 넘나드는 장시간 작업을 위임받아 처리하는 데스크톱 에이전트이고, Claude Code는 터미널 기반으로 코드와 파일을 직접 다루는 에이전트입니다. 이 글에서는 Cowork가 전체 파이프라인을 지휘하고, 세부 스크립트 작업은 Claude Code가 처리하는 구조로 설명합니다.

3. 힉스필드 MCP 연동 설정

3-1. Claude(웹/데스크톱/Cowork)에 연동하기

STEP 1 – 힉스필드 MCP 주소 복사
https://mcp.higgsfield.ai/mcp
STEP 2 – Claude 설정에서 커넥터 추가
Claude 설정 → Connectors → Add custom connector
이름: Higgsfield → 위 URL 붙여넣기 → Add
STEP 3 – 연결 및 로그인
Add → Connect 클릭 → 힉스필드 계정으로 로그인 (OAuth)
완료 후 Claude에게 바로 "이미지 생성해줘"라고 요청하면 작동합니다.
✅ Cowork는 Claude Desktop 상의 커넥터를 그대로 사용하므로, 위 설정이 완료되면 Cowork 작업 중에도 힉스필드 도구를 호출할 수 있습니다.

3-2. Claude Code에 연동하기 (CLI 방식)

Claude Code, Cursor 등 CLI 환경에서는 Higgsfield CLI 명령어로 더 간편하게 연동합니다.

터미널에서 MCP 서버 등록
# 사용자 전역 등록 (모든 프로젝트에서 사용) claude mcp add higgsfield https://mcp.higgsfield.ai/mcp \ --transport http --scope user # 특정 프로젝트에만 등록 (팀 공유 시 .mcp.json에 기록) claude mcp add higgsfield https://mcp.higgsfield.ai/mcp \ --transport http --scope project
최초 인증
Claude Code에서 힉스필드 도구를 처음 호출하면 로컬 포트(8080)로 OAuth 콜백이 열리며 브라우저 로그인 창이 자동으로 뜹니다. 로그인 후 터미널로 돌아오면 연동이 완료됩니다.
⚠️ 연동 후 도구가 /mcp 목록에는 보이는데 호출 시 "unauthorized" 오류가 난다면, /mcp 명령으로 Higgsfield를 선택 후 Re-authenticate를 실행하세요. OAuth 토큰은 몇 주마다 만료됩니다.

4. Claude Code에서 쇼츠 자동 생성

연동이 끝나면 Claude Code 터미널에서 자연어로 지시하는 것만으로 대본 작성부터 영상 생성까지 이어집니다.

실전 프롬프트 예시 1 – 기획부터 영상까지 한 번에
"n8n 자동화를 처음 접하는 직장인 대상으로 15초 유튜브 쇼츠를 기획해줘. 1. 후킹 멘트 + 핵심 내용 대본을 먼저 써줘 2. 대본에 맞는 영상 프롬프트를 만들어줘 (카메라 무빙 포함, 시네마틱 스타일) 3. Higgsfield로 9:16 세로 영상을 생성해줘 (Kling 3.0 모델 사용) 4. 생성 완료되면 다운로드해서 ./shorts_output/ 폴더에 저장해줘"

Claude Code는 위 지시를 받으면 다음과 같이 동작합니다.

1단계 대본 텍스트 작성 (Claude 자체 생성)
2단계 영상 프롬프트 영문 변환
3단계 higgsfield: generate_video 도구 호출
4단계 higgsfield: get_generation_status 폴링 (완료까지 대기)
5단계 완료된 영상 URL을 로컬 파일로 다운로드

캐릭터 일관성이 필요한 시리즈 콘텐츠

Soul 캐릭터로 매번 같은 얼굴 유지하기
"참고 이미지 3장으로 'Jiwon'이라는 캐릭터를 학습시켜줘. [이미지1] [이미지2] [이미지3] 학습 완료되면 이 캐릭터로 '아침 루틴 브이로그' 쇼츠 영상을 만들어줘."
Claude는 create_character로 캐릭터를 등록하고, 이후 모든 generate_video 호출에 캐릭터 ID를 자동으로 참조해 시리즈 전체에서 동일 인물을 유지합니다. 학습에는 3~5분 정도 소요되며 Claude가 자동으로 완료 상태를 확인합니다.

영상 분석으로 스타일 벤치마킹

참고 영상 스타일 그대로 재현하기
"이 유튜브 영상을 분석해서 비슷한 스타일로 쇼츠 프롬프트를 만들어줘: https://youtube.com/watch?v=XXXXX"
힉스필드의 비디오 분석기가 참고 영상의 장면 구성, 카메라 워크, 페이싱을 분해해서 바로 사용 가능한 프롬프트로 돌려줍니다.

5. Cowork로 파이프라인 오케스트레이션

Cowork는 여러 단계에 걸친 작업을 하나의 세션에서 위임 처리하는 데 적합합니다. 매일 반복되는 쇼츠 제작·업로드 루틴을 Cowork에 맡기면, 진행 상황을 대시보드에서 확인하며 필요한 순간에만 개입할 수 있습니다.

Cowork 위임 프롬프트 예시
"오늘의 쇼츠 제작 작업을 진행해줘. 1. 구글 시트 '쇼츠기획'에서 오늘 예정된 주제 확인 2. 주제별로 대본 + 영상 프롬프트 작성 3. Higgsfield로 각 영상 생성 (9:16, 15초, Kling 3.0) 4. 생성된 영상을 다운로드 5. 제목/설명/태그 초안 작성 6. 다운로드한 영상과 메타데이터를 ./youtube_upload_queue/ 폴더에 정리해서 저장 완료되면 요약 보고해줘. 유튜브 업로드는 내가 최종 확인 후 진행할게."
💡 Cowork 활용 팁: Cowork는 백그라운드에서 오래 걸리는 작업(영상 생성 대기, 여러 개 클립 순차 생성)을 처리하는 동안 다른 작업을 계속할 수 있게 해줍니다. 영상 생성 3~5개를 한 번에 맡기고 결과만 나중에 확인하는 방식이 효율적입니다.

6. 유튜브 자동 업로드 연동

영상 생성까지는 힉스필드 MCP로 대화 안에서 끝낼 수 있지만, 유튜브 업로드는 별도의 연동이 필요합니다. 두 가지 방식 중 선택할 수 있습니다.

방식 장점 설정 난이도
n8n + YouTube Data API 완전 무인 스케줄 업로드, 다른 자동화와 연계 쉬움 중간
Claude Code + 유튜브 업로드 스크립트 대화 세션 안에서 바로 업로드까지 완결 쉬움 (1회 설정)

방식 A – Claude Code에서 직접 업로드 (간단)

1회성 준비 – YouTube Data API 인증 파일 생성
Google Cloud Console에서 YouTube Data API v3 활성화 → OAuth 클라이언트(데스크톱 앱) 생성 → client_secret.json 다운로드 → 프로젝트 폴더에 저장
Claude Code에게 업로드 스크립트 실행 요청
"방금 생성한 영상을 유튜브에 업로드하는 파이썬 스크립트를 만들어서 실행해줘. 제목: {{생성된 쇼츠 제목}} 설명: {{생성된 설명}} 태그: {{생성된 태그}} 공개상태: private (검수 후 내가 직접 공개 전환)"
Claude Code는 google-api-python-client를 활용한 업로드 스크립트를 즉석에서 작성하고 실행까지 완료합니다.

방식 B – n8n으로 완전 무인 스케줄링

Google Drive Trigger 업로드 대기 폴더에 새 영상 감지
Google Sheets 해당 영상의 메타데이터 조회
YouTube 노드 제목/설명/태그 반영해 업로드
카카오워크 업로드 완료 알림 발송
📌 추천 조합: Cowork/Claude Code가 기획+영상 생성+폴더 저장까지 끝내고, n8n이 폴더 감지+업로드를 전담하면 각 도구가 잘하는 역할만 맡아 안정적으로 돌아갑니다.

7. 전체 자동화 시나리오 실습

실제로 Cowork에게 아래처럼 한 번에 지시하면, 대부분의 과정이 자동으로 진행됩니다.

완성형 지시 프롬프트
"이번 주 유튜브 쇼츠 5개를 제작해줘. 주제: n8n 자동화, Claude 활용법, ISA 계좌, IRP 계좌, 로블록스 게임 개발 각 주제별로: 1. 15초 대본 작성 (후킹 3초 + 본론 10초 + CTA 2초) 2. Higgsfield로 9:16 세로 영상 생성 - 캐릭터: 이전에 학습한 'Jiwon' 사용 - 모델: Kling 3.0 - 스타일: 밝고 친근한 브이로그 톤 3. 생성된 영상들을 ./shorts_queue/ 폴더에 번호를 붙여 저장 (01_n8n.mp4 형식) 4. 각 영상의 제목/설명/태그를 shorts_metadata.csv에 함께 기록 5개 다 완료되면 결과 요약해줘. 업로드는 내가 검수 후 별도로 진행할게."
✅ 이 지시 하나로 대본 작성 → 영어 프롬프트 변환 → 캐릭터 참조 영상 생성 → 상태 폴링 → 다운로드 → 파일 정리까지 사람 개입 없이 진행됩니다. 사람은 최종 결과물을 확인하고 업로드 여부만 결정하면 됩니다.

8. 매일 자동 발행 스케줄링

완전 무인 반복 실행을 원한다면 Claude Code를 cron 작업으로 예약하고, 업로드까지 n8n으로 넘기는 구조가 안정적입니다.

OCI 서버 등에서 cron 설정 예시
# 매일 오전 7시 실행 0 7 * * * cd /home/user/shorts-project && \ claude code -p "오늘의 쇼츠 대본과 영상을 자동 생성해줘" \ >> /var/log/shorts-automation.log 2>&1
cron 트리거 Claude Code 자동 실행
Claude Code + Higgsfield MCP 대본·영상 자동 생성
지정 폴더 저장 n8n Google Drive Trigger 감지
n8n YouTube 자동 업로드 (private)
카카오워크 "오늘의 쇼츠 준비완료, 검수 후 공개하세요" 알림
⚠️ 완전 무인 발행보다는 업로드 상태를 private으로 두고 매일 아침 5분만 검수 후 공개 전환하는 반자동 방식을 권장합니다. AI 생성 영상이 의도치 않은 결과물을 내놓는 경우가 아직 존재하기 때문입니다.

9. 비용 구조

항목 비용 비고
힉스필드 크레딧 플랜별 상이 (무료 티어 있음) 모델·해상도·길이에 따라 크레딧 소모량 다름
Claude 요금제 Pro 이상 권장 Cowork·Claude Code 활용 시
n8n 셀프호스팅 시 무료 OCI 무료 서버 조합 추천
YouTube Data API 무료 일일 쿼터 존재 (업로드 수 제한 확인 필요)
💡 힉스필드 측은 고품질 UGC 영상 제작 대행 비용(월 400만 원 상당)과 비교했을 때 5~10배 비용 절감 효과가 있다고 설명합니다. 다만 대량 생성(영상 200개 이상)은 크레딧을 빠르게 소모하니, 배치 생성 전 Claude에게 예상 크레딧을 먼저 물어보는 것을 권장합니다.

10. 주의사항

  • 비동기 작업 특성: 영상 생성은 서버에서 비동기로 처리되므로 세션이 끊겨도 작업은 계속됩니다. 새 세션에서 get_generation_status로 이어서 확인하면 됩니다.
  • OAuth 토큰 만료: 몇 주 주기로 재인증이 필요할 수 있습니다.
  • 실패 상태 처리: 생성 결과는 queued, in_progress, completed, failed, nsfw 상태로 반환됩니다. Claude가 실패 시 더 완화된 프롬프트로 자동 재시도하지만, 반복 실패 시 직접 프롬프트를 조정해야 합니다.
  • AI 생성 콘텐츠 표시: 유튜브 정책상 AI 생성·변형 콘텐츠는 업로드 시 관련 표시가 필요할 수 있습니다.
  • 모델별 상업적 이용 약관: 힉스필드가 통합 제공하는 Sora, Veo, Kling 등 각 모델의 상업적 이용 조건을 개별 확인하세요.
  • Personal Clipper 캐릭터 초상권: Soul 캐릭터 학습 시 얼굴이 포함된 참고 이미지는 초상권·저작권 확인이 필요합니다.

11. 정리

🎬 Claude + 힉스필드 MCP 완전 자동화 핵심 요약

2026년 4월 30일 공식 MCP 출시 → Claude·Cowork·Claude Code에서 직접 영상 생성 가능

API 키 불필요 → OAuth 계정 인증만으로 연동

Cowork → 전체 파이프라인 위임 및 오케스트레이션에 적합

Claude Code → 세부 스크립트·자동 업로드 실행에 적합

유튜브 업로드 → Claude Code 직접 실행 또는 n8n 연계, 두 방식 모두 가능

권장 운영 방식 → private 업로드 후 사람이 최종 검수, 완전 무인보다 안전

  • Claude Desktop/Cowork에 Higgsfield 커넥터 추가
  • Claude Code에서 claude mcp add higgsfield 명령으로 연동
  • OAuth 최초 인증 완료
  • Soul 캐릭터 학습 (시리즈 콘텐츠용, 선택)
  • YouTube Data API 인증 파일 준비
  • Cowork에 주간 쇼츠 제작 위임 프롬프트 테스트
  • n8n 또는 Claude Code 업로드 스크립트 중 택1 구축
  • private 업로드 후 검수·공개 루틴 확립

힉스필드 MCP 덕분에 "대본은 자동, 영상은 수동"이라는 기존의 반쪽 자동화가 기획부터 영상 생성까지 하나의 대화·세션 안에서 끝나는 진짜 자동화로 바뀌었습니다. 다만 완전 무인 발행보다는 사람의 최종 검수를 한 단계 남겨두는 것이 콘텐츠 품질과 채널 신뢰도 관리에 안전합니다.

📌 이 글이 도움이 되셨나요?
구독하시면 Claude Code, Cowork, MCP 연동 실전 자동화 가이드를 매주 무료로 받아보실 수 있습니다.
반응형