1
Claude Desktop 설정 열기
Claude Desktop을 실행하고 로컬 MCP 서버 설정을 여세요.
가격
30% 할인
로그인
Claude을 뮤직비디오 엔진으로
freebeat를 Claude, Cursor, Windsurf, Claude Code에 연결하고 대화 안에서 바로 뮤직비디오와 AI 효과를 생성하세요.
Claude Desktop
2
freebeat MCP 서버 추가
이름을 freebeat로 지정하고 로컬 MCP 서버 명령을 추가하세요:
3
FREEBEAT_API_KEY 설정
freebeat에서 API Key를 만들고 MCP 환경에 추가한 뒤 Claude에게 뮤직비디오 작업 시작을 요청하세요.
명령 세트
auth
freebeat API Key를 로컬에 저장하고 확인하거나, 필요할 때 명령별로 --api-key를 전달합니다.
set-api-keyshow--api-key
assets
로컬 파일이나 소스 URL에서 오디오를 업로드하고 한두 장의 레퍼런스 이미지를 추가합니다.
upload-audioupload-imagemusic_id
effects
사용 가능한 비디오 효과를 나열하고 effect_id, 미리보기, 기본 음악, 화면비를 확인합니다.
listeffect_idpreview
mv
업로드된 노래, 프롬프트, 레퍼런스, 화면비로 AI 뮤직비디오 생성을 제출하거나 실행합니다.
submitrun--json
effect
effect_id, music_id, 이미지 URL, 프롬프트로 효과 템플릿 클립을 생성합니다.
submitruneffect_id
task
상태를 확인하고 완료를 기다린 뒤 완료된 작업에서 video_url과 cover_url을 가져옵니다.
statuswaitresult
CLAUDE 안의 완전한 뮤직비디오 스튜디오
뮤직비디오 생성, AI 효과, 미디어 업로드, 작업 관리를 하나의 연결에서
터미널
> 이 트랙으로 네온 도시 뮤직비디오 생성
--aspect 9:16
--reference cover.png
● freebeat
오디오 업로드 중...
뮤직비디오 작업 생성 중...
→ ./output/neon_mv.mp4
생성형 미디어
뮤직비디오 생성
노래, 프롬프트, 음악 링크에서 시작해 에이전트가 freebeat를 호출하도록 하면 화면비, 레퍼런스, 효과, 비동기 렌더 결과가 포함된 완성 MV를 만들 수 있습니다.
효과 엔진
프롬프트 하나로 음악을 쇼츠로
에이전트에게 적합한 비디오 효과를 찾고 음악, 레퍼런스 이미지, 프롬프트를 채운 뒤 캠페인과 소셜 미디어용 게시 가능한 클립을 생성하게 하세요.
에이전트
> 제품 출시 티저에 맞는 효과 찾기
● freebeat
일치하는 효과 8개를 찾았습니다.
비디오 변형 3개 생성 중...
✓ 세로 티저
✓ 정사각형 소셜 클립
모드
upload_audio 오디오 또는 소스 URL 가져오기
upload_image 레퍼런스 이미지 1~2장 추가
list_effects effect_id 옵션 확인
generate_music_video MV 작업 시작
generate_effect 효과 작업 시작
get_task_status 작업 상태 폴링
get_task_result video_url + cover_url 가져오기
모드
효과를 고르고 설정은 건너뛰기
effect_id, 기본 음악, 추천 레퍼런스, 템플릿 지시로 시작하세요. 에이전트가 생성 전에 템플릿을 비교할 수 있습니다.
자동화
노래 폴더에서 비디오 파이프라인까지
CLI와 MCP는 같은 작업 모델을 공유합니다. Claude로 크리에이티브를 계획하고 터미널 스크립트로 일괄 업로드, 생성, 대기, 구조화 JSON 저장을 수행하세요.
터미널
> ./songs에서 뮤직비디오 5개 만들기
● freebeat
폴더 읽는 중...
작업 제출 중...
✓ 5 task ids 저장됨
✓ results.json 준비됨
당신의 에이전트 안의 완전한 뮤직비디오 스튜디오
오디오 업로드, 이미지 레퍼런스, 효과 템플릿, 렌더 결과를 하나의 MCP 연결에서
콘셉트에서 콘텐츠까지 한 번의 대화로
Claude에게 만들고 싶은 것을 말하세요. 적절한 freebeat MCP 도구를 선택하고 제작 가능한 뮤직비디오 결과를 제공합니다
아티스트 릴리스
완성된 트랙을 업로드하고 비주얼 방향을 선택한 뒤 릴리스 준비가 된 세로 또는 와이드스크린 비디오를 생성하세요.
소셜 미디어와 콘텐츠 제작
한 곡을 여러 쇼츠, 훅, 비주얼 루프, 템플릿 기반 효과 클립으로 바꾸세요.
마케팅 팀
노래, 레퍼런스 이미지, 짧은 브리프에서 제품 티저와 캠페인 변형을 생성하세요.
자동화 스크립트
반복 가능한 배치, 로컬 폴더, JSON 출력, 예약된 콘텐츠 파이프라인에 CLI를 사용하세요.
아이디어에서 뮤직비디오까지 한 번의 대화로
하나의 생성으로 작게 시작하거나 효과 탐색, 레퍼런스, 배치 작업, 작업 폴링까지 깊게 진행하세요. Claude가 워크플로를 처리합니다
몇 초 만에 뮤직비디오 작업 제출
무드, 화면비, 음악 소스를 설명하세요. Claude가 freebeat MCP 도구를 선택하고 task_id를 반환합니다.
이 트랙으로 9:16 사이버펑크 MV 생성
대화에서 릴리스 패키지 만들기
같은 비주얼 방향을 유지하며 메인 MV, 정사각형 컷, 짧은 변형을 만드세요.
소셜 컷 3개를 만들고 모든 비디오 링크 저장
효과를 비교하고 최고의 결과를 출시
freebeat 효과를 나열하고 변형을 생성하며 완료를 기다린 뒤 가장 강한 결과를 선택하세요.
효과 4개를 시도하고 완료된 비디오를 보여줘
궁금한 점이 더 있나요?
가장 자주 묻는 질문에 답했습니다
freebeat는 AI 에이전트와 어떻게 연결되나요?
freebeat MCP 서버를 MCP 호환 클라이언트에 추가하세요. 명령은 npx -y freebeat-mcp이며 FREEBEAT_API_KEY 환경 변수로 인증합니다.
API Key는 어디에서 만들 수 있나요?
freebeat에 로그인하고 /music-video-generator/profile을 여세요. API Keys 섹션에서 키를 만듭니다. 이 페이지의 API Keys 링크도 그곳으로 이동합니다.
어떤 에이전트를 지원하나요?
Claude Desktop, Cursor, Windsurf, Claude Code 및 다른 MCP 호환 클라이언트가 같은 freebeat 서버 설정을 사용할 수 있습니다.
MCP와 CLI의 차이는 무엇인가요?
MCP는 에이전트 대화용입니다. CLI는 터미널과 스크립트용입니다. 둘 다 업로드, 효과, 생성, 폴링, 결과 조회를 제공합니다.
생성 작업에 폴링이 필요한 이유는 무엇인가요?
뮤직비디오 렌더링에는 시간이 걸릴 수 있습니다. freebeat는 먼저 task_id를 반환하고, 에이전트 또는 CLI가 상태를 폴링해 완료 시 video_url을 가져옵니다.
무엇을 만들 수 있나요?
뮤직비디오, 효과 템플릿 클립, 세로형 소셜 비디오, 와이드스크린 MV, 레퍼런스 이미지 기반 스타일 버전을 만들 수 있습니다.
API Key를 프롬프트에 넣어야 하나요?
아니요. 키는 MCP 환경 설정 또는 CLI 인증 정보에 보관하세요. 프롬프트에는 창작 작업만 설명하면 됩니다.
결과를 자동화에 사용할 수 있나요?
네. 완료된 작업은 JSON 파일, 스프레드시트, 콘텐츠 캘린더, 스크립트와 잘 맞는 구조화된 링크와 상태 필드를 반환합니다.
AI 스택이 한 단계 업그레이드되었습니다
Claude, Cursor, Windsurf, Claude Code를 몇 초 만에 freebeat에 연결하세요. 뮤직비디오, AI 효과, 렌더 결과를 필요할 때 바로 사용하세요.
시작하기더 많은 AI 기능 살펴보기
제품
RANDOM MOTION TECHNOLOGY INC
3529 Old Conejo Road, Newbury Park, CA 91320