Skip to Content
MCP Documentation

freebeat MCP

freebeat는 가장 큰 뮤직비디오 생성기이며, MCP 서버를 통해 AI 에이전트가 직접 사용할 수 있습니다. 어떤 노래든 뮤직비디오, 가사 비디오, 댄스 비디오로 만들 수 있고, 작곡, 노래하는 사진, 립싱크, 이미지, 비디오 클립도 지원합니다.

  • 서버 URL: https://freebeat.ai/api/mcp (원격, Streamable HTTP)
  • 로그인: freebeat 계정으로 OAuth 로그인. API 키는 필요 없습니다.
  • 지원: ChatGPT, Codex, Claude, Claude Code, Cursor, 그리고 OAuth로 원격 MCP 서버에 연결하는 모든 에이전트.

연결

ChatGPT

  1. Settings → Apps → Advanced settings → Developer mode를 켭니다.
  2. Plugins → Browse directory → Add → Add custom MCP server. 이름은 freebeat, URL은 https://freebeat.ai/api/mcp, 인증은 OAuth로 설정하고 Connect를 누릅니다.
  3. freebeat에 로그인한 뒤 Allow를 클릭합니다.

Codex (CLI, IDE 확장 프로그램, 앱)

codex mcp add freebeat --url https://freebeat.ai/api/mcp codex mcp login freebeat

Claude (웹 및 데스크톱)

  1. Customize → Connectors → Add → Add custom connector.
  2. 이름은 freebeat, URL은 https://freebeat.ai/api/mcp를 입력하고 Add, Connect를 차례로 누릅니다.
  3. freebeat에 로그인한 뒤 Allow를 클릭합니다.

Claude Code

claude mcp add --transport http freebeat https://freebeat.ai/api/mcp

그런 다음 Claude Code에서 /mcp를 실행하고 freebeat를 선택해 로그인합니다.

Cursor

Cursor에 freebeat 추가를 누르거나, 아래 내용을 ~/.cursor/mcp.json에 넣고 Cursor의 MCP 설정에서 Connect를 클릭하세요.

{ "mcpServers": { "freebeat": { "url": "https://freebeat.ai/api/mcp" } } }

기타 에이전트

URL https://freebeat.ai/api/mcp로 원격 MCP 서버를 추가하세요. 서버는 OAuth 메타데이터(/.well-known/oauth-protected-resource/api/mcp 및 /.well-known/oauth-authorization-server)를 공개하고 PKCE를 사용한 동적 클라이언트 등록을 지원하므로, MCP 인증 사양을 따르는 모든 클라이언트가 로그인할 수 있습니다.

크레딧

비디오와 기타 생성에는 freebeat 크레딧이 사용되며, 신규 계정에는 500 크레딧이 제공됩니다. 에이전트는 쓰기 전에 먼저 묻습니다. 모든 유료 도구는 max_credits(허용하는 최대 사용량)를 받고, 사전에 총액을 안내할 수 없을 때는 accept_unknown_cost를 받습니다. 뮤직비디오, 가사 비디오, 댄스 비디오는 단계별로 과금되므로 총액을 미리 알 수 없고 accept_unknown_cost가 필요합니다. get_credit_balance로 잔액을, quote_generation으로 견적을 낼 수 있는 도구의 가격을 확인할 수 있습니다.

도구

뮤직비디오, 가사 비디오, 댄스 비디오

도구기능
generate_music_video노래에 맞춰 편집된 멀티 씬 뮤직비디오. 사진(최대 5장)을 추가하면 아티스트나 캐릭터가 등장합니다. 720p 또는 1080p.
generate_lyric_video보컬에 맞춰 움직이는 애니메이션 가사, 768p 또는 2K.
generate_dance_video사진 속 인물이 노래에 맞춰 춤을 춥니다(9:16 또는 3:4, 720p).
get_video_session진행 중인 비디오의 디렉터 메시지, 단계, 미디어.
send_video_agent_message디렉터에게 메모를 보내거나 세션을 자동으로 전환합니다.

세 가지 비디오 도구 모두 노래(upload_audio 또는 generate_music에서 받은 music_id), 선택 사항인 프롬프트와 사진, 그리고 auto_mode를 받습니다. true이면 디렉터가 모든 것을 결정하고, false이면 각 단계에서 멈추고 당신의 메모를 기다립니다(공동 제작). 기본값은 노래의 처음 15초이며, 다른 구간을 쓰려면 start_ms와 end_ms를 설정하세요(계정 한도까지). 비디오는 보통 15분에서 60분이 걸리며 freebeat 서버에서 실행됩니다. 결과에는 비디오 링크와 freebeat.ai의 해당 페이지가 포함됩니다.

음악

도구기능
list_music_models사용할 수 있는 음악 모델.
generate_music프롬프트로 만드는 오리지널 곡. 가사를 주면 그 가사를 사용합니다.

노래와 립싱크

도구기능
generate_singing_video사진 한 장, 반려동물, 또는 두 사람(듀엣)이 트랙을 노래합니다.
generate_lip_sync_video기존 비디오 클립을 오디오에 맞춰 립싱크합니다.

이미지, 비디오 클립, 텍스트

도구기능
list_models, get_model_help사용 가능한 이미지 및 비디오 모델과 각각의 사용법.
generate_image, edit_image이미지를 만들거나 편집합니다.
generate_video노래 없는 비디오 클립(텍스트 또는 이미지에서 비디오).
generate_text언어 모델이 만든 텍스트.
list_effects, generate_effect노래와 이미지 한 장으로 만드는 이펙트 템플릿 비디오.

입력, 진행 상황, 크레딧

도구기능
upload_audio첨부 파일, HTTPS 오디오 링크, 또는 SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio, Riffusion 페이지의 노래. music_id를 반환합니다.
upload_image, upload_video참고 이미지와 비디오 클립.
get_task_status, get_task_result작업의 진행 상황과 완성된 결과.
get_credit_balance, quote_generation잔액과 생성 가격.

연결 해제

에이전트의 커넥터 또는 MCP 설정에서 freebeat를 제거하세요. 연결을 해제하면 해당 연결의 계정 접근 권한이 취소됩니다.

Last updated on