영상 편집 MCP 서버: AI 에이전트로 트림·필터·조립하기

https://mcp.sume.com/mcp의 Sume 호스팅 MCP 서버는 영상 편집 MCP 서버로 쓸 수 있습니다. 에이전트는 클립을 검사하고(video_inspect), 정확한 프레임을 뽑고(video_frames_create), 구간을 자르고(video_trim), 어둡게 하거나 크롭하고(video_filter), 오디오를 분리하고(audio_detach), 스틸과 영상을 한 화면에 넣고(timeline_compose), 오디오를 잇거나 나누고(timeline_audio), 오디오 스파인과 순서대로 놓은 클립으로 MP4 하나를 렌더링할 수 있습니다(timeline_create). Sume가 자체 워커에서 ffmpeg를 컴파일하므로, 에이전트는 ffmpeg 인수를 보내지 않습니다.

도구 목록은 MCP 도구와 게이트와 각 도구의 문서 페이지를 바탕으로 하며, 2026-09-26에 확인했습니다. 같은 도구가 HTTP 엔드포인트로도 있으며, 기초 페이지는 CLI와 호스팅 MCP가 여전히 동작하지만 현재 주 연동 경로는 아니라고 설명합니다. 클라이언트 연결 방법은 Claude Code·Cursor·Codex를 호스팅 MCP로 Sume에 연결에서 다룹니다.

영상을 편집하는 MCP 도구는 무엇인가요?

편집은 각각 Job으로 실행되며, 대부분 같은 경로를 따릅니다. 제출하고, jobs_wait로 기다린 뒤, 결과를 읽습니다.

에이전트는 어떤 미디어를 편집할 수 있나요?

모든 편집 도구는 이미 이 워크스페이스의 media.sume.com에 있는 미디어를 받습니다. Sume가 생성 결과물을 돌려주는 곳이 여기이므로, 앞선 Sume Job의 결과를 그대로 입력으로 쓸 수 있습니다. 공개 인터넷에서 가져오는 기능은 없습니다. https://example.com/… 같은 호스트 밖 URL은 접수 단계에서 거부되며, 호스팅 MCP는 노트북의 파일을 읽을 수 없습니다.

도구 문서는 외부 미디어를 먼저 가져오라고 안내합니다. MCP에서 가져오기 도구는 문서가 소셜 URL 미러라고 부르는 media-imports_create입니다. 유료 도구이고, 현재 도구 설명은 대상을 공개 TikTok·Instagram 영상 URL로 한정하므로 일반 업로드 경로가 아닙니다.

에이전트는 편집을 처음부터 끝까지 어떻게 실행하나요?

모든 쓰기에는 각자의 idempotency_key가 필요하고, OAuth라면 mcp:write가 있는 세션도 필요합니다. 현재 도구는 아래 video_trim 호출처럼 HTTP 요청 본문을 idempotency_key 옆의 payload 안에 받습니다. 자르고 조립하는 한 번의 작업은 다음과 같습니다.

• video_inspect로 소스를 검사합니다. frames: false는 프로브 정보만 반환하며, probe.has_audio를 확인하기에는 그것으로 충분합니다.
• video_trim으로 구간마다 자릅니다. start와 함께 end나 duration 중 정확히 하나를 보냅니다. 새 MP4는 source_in 0으로 timeline_create video[]에 넣습니다.
• dim이나 crop은 video_filter에 check_only: true를 넣어 검사한 뒤 인코드합니다.
• 음성은 audio_detach로 한 번 분리하고, 재사용할 조각이 필요하면 timeline_audio로 나눕니다. 렌더 하나 안에서만 필요한 이어 붙이기는 audio.parts[]에 둡니다.
• timeline_create로 렌더링합니다. video[0].start는 0이어야 하고, 전환 효과는 첫 번째 슬롯 이후의 슬롯에만 넣습니다.
• 클립마다 트림 한 번처럼 같은 모양의 호출이 많다면, script_run이 스크립트 하나에서 실행합니다.

{
  "idempotency_key": "trim-intro-001",
  "payload": {
    "video_url": "https://media.sume.com/artifacts/artf_demo/talk.mp4",
    "start": 2,
    "duration": 8
  }
}

MCP로 편집하면 비용은 얼마나 드나요?

과금은 각 도구의 문서 페이지를 따릅니다.

• video_inspect의 프로브와 스틸은 과금되지 않으며, transcribe: true는 오디오 분당 과금됩니다.
• video_frames_create는 과금되지 않고, check_only: true로 호출한 video_filter는 무료입니다.
• video_trim, video_filter 인코드, audio_detach, timeline_compose, timeline_audio는 Job당 과금됩니다. 문서는 그 요율을 GET /v1/catalog에서 실시간으로 확인하라고 안내합니다.
• API 요금에는 타임라인 렌더가 출력 분당 $0.10로 나와 있으며, 렌더는 ceil(audio.duration_seconds / 60)분을 예약합니다.
• 트림, 필터, 분리, 합성, 타임라인 오디오, 렌더는 프로바이더 추론 없이 워커의 ffmpeg만 씁니다. 유료 호출은 비용 프리뷰용 dry_run과 상한용 max_spend_usd를 받습니다.

이 도구로 에이전트가 할 수 없는 일은 무엇인가요?

문서가 정한 경계는 다음과 같습니다. 트림, 필터, 오디오 분리의 도구별 거부 코드는 영상 트림, 필터, 오디오 분리하기에 있습니다.

• ffmpeg 인수 보내기. 검사, 프레임, 트림, 필터, 분리에서는 filter, ffmpeg, cmd, codec 같은 필드가 ffmpeg_fields_rejected로 실패하고, Timeline 도구는 filtergraph, codec, crf 같은 키를 400으로 거부합니다.
• filtergraph에 trim, setpts, drawtext, subtitles, movie, lut3d, 또는 파일이나 소켓을 읽는 무언가를 넣기.
• tools_list에서 자막 생성 도구 찾기. 자막 생성 도구는 호스팅 MCP 목록에서 빠져 있고(진행 중인 클라이언트를 위해 이름으로 호출은 가능), 목록에는 video-captions_get만 있습니다. HTTP에서 자막은 POST /v1/video-captions입니다. 영상에 자막을 입히는 방법을 참고하세요.
• 렌더 안에서 dim이나 crop 하기. 픽셀 패스는 렌더 옵션이 아니므로 video_filter를 먼저 실행하세요.
• 상한 넘기기. 트림은 소스 최대 1800초에 컷 최대 900초, 필터와 프레임은 소스 최대 300초, 합성은 출력 최대 300초, 렌더는 1–1800초입니다.