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
- Settings → Apps → Advanced settings → Developer mode를 켭니다.
- Plugins → Browse directory → Add → Add custom MCP server. 이름은
freebeat, URL은https://freebeat.ai/api/mcp, 인증은 OAuth로 설정하고 Connect를 누릅니다. - freebeat에 로그인한 뒤 Allow를 클릭합니다.
Codex (CLI, IDE 확장 프로그램, 앱)
codex mcp add freebeat --url https://freebeat.ai/api/mcp
codex mcp login freebeatClaude (웹 및 데스크톱)
- Customize → Connectors → Add → Add custom connector.
- 이름은
freebeat, URL은https://freebeat.ai/api/mcp를 입력하고 Add, Connect를 차례로 누릅니다. - 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를 제거하세요. 연결을 해제하면 해당 연결의 계정 접근 권한이 취소됩니다.