Claude Code를 이용해 하나의 MCP 서버로 팟캐스트를 세로형 Shorts 클립으로 자르는 방법
요약
이 글은 Claude Code를 활용하여 팟캐스트와 같은 긴 오디오 콘텐츠를 세로형 Shorts 클립으로 자동 자르고 게시하는 방법을 설명합니다. MCP 서버에 연결하고, `create_clip_job`부터 `publish_clip`까지의 네 가지 핵심 도구 호출 패턴을 이해하면 터미널에서 모든 작업을 처리할 수 있습니다.
핵심 포인트
- Claude Code를 이용해 팟캐스트 클립 제작 과정을 자동화합니다.
- MCP 서버는 비디오 링크 전송, 상태 확인, 클립 다운로드, 게시 기능을 제공합니다.
- 도구 호출 패턴을 이해하고, 긴 작업 시간을 고려하여 사용자에게 명시적인 확인 절차를 거치도록 설계해야 합니다.
저는 짧은 형식의 비디오 도구인 Prolifik을 운영하고 있습니다. 이 게시물은 여러분이 터미널을 벗어나지 않고도 Claude에게 90분짜리 팟캐스트를 세로형 클립으로 잘라달라고 요청할 수 있게 해주는 MCP 서버에 관한 내용입니다. 아래에는 설정 방법과 클립 작업 뒤에 숨겨진 네 가지 도구 호출(tool calls)이 나와 있으니, 직접 시도해 보거나 여러분의 서버에 이 패턴을 가져다 쓸 수 있습니다.
서버가 하는 일
https://app.getprolifik.com/mcp는 60개의 도구를 가진 호스팅된 상태 비저장(stateless) Streamable HTTP 서버입니다. 클립 작업에 중요한 도구들은 다음과 같습니다:
create_clip_job: 최대 10개의 비디오 링크(YouTube, Twitch, Kick) 또는 업로드한 파일을 전송합니다.get_clip_job_status: 작업이 완료될 때까지 폴링(poll)합니다.get_clip_job: 자른 클립과 캡션이 포함된 내용을 읽어옵니다.publish_clip: Prolifik에 연결한 TikTok, Instagram 또는 YouTube 계정에 클립을 게시하거나 예약합니다.
또한 브랜드용 도구, 여섯 가지 형식의 브랜디드 비디오, 그리고 스케줄링을 위한 도구들도 있습니다. Anthropic의 디렉토리 규칙 때문에 Claude 클라이언트는 60개 중 39개를 볼 수 있으며, AI 이미지 및 비디오 생성 도구는 제외됩니다. ChatGPT, Codex, API-key 클라이언트들은 모든 도구를 볼 수 있습니다.
연결하기
Claude Code:
claude mcp add --transport http prolifik https://app.getprolifik.com/mcp
/mcp를 실행하고, prolifik을 선택한 다음, 인증(Authenticate)을 선택하여 로그인합니다. 모든 프로젝트에서 사용하려면 첫 번째 명령어에 --scope user를 추가하세요.
Claude 웹 또는 데스크톱: 설정 > 커넥터 > 사용자 지정 커넥터 추가로 이동하여 URL을 붙여넣고 OAuth 필드는 비워둡니다.
Codex:
codex mcp add prolifik --url https://app.getprolifik.com/mcp
codex mcp login prolifik
Cursor 및 JSON 설정을 사용하는 다른 클라이언트들은 대신 API 키를 사용할 수 있습니다:
{
다음 내용을 참고하여 [https://www.youtube.com/watch?v=]의 가장 좋은 순간 5개를 자막이 포함된 세로형 클립으로 만들고, 각 클립의 후킹 포인트(hook)를 알려줘.
배경에서는 Claude가 네 번의 호출을 수행합니다:
1. URL과 함께 `create_clip_job`을 호출합니다. 즉시 작업 ID를 반환하며, 작업은 백그라운드에서 실행됩니다.
2. 작업이 완료될 때까지 반복적으로 `get_clip_job_status`를 호출합니다. 긴 팟캐스트는 몇 분이 걸립니다.
3. `get_clip_job`은 클립과 해당 다운로드 링크를 반환합니다.
4. 마음에 드는 클립이 있다면, 클립 ID, `list_publish_destinations`에서 가져온 목적지, 자막, 시간과 함께 `publish_clip`을 호출합니다.
Claude는 게시하기 전에 사용자에게 확인을 요청합니다. 서버 지침은 실제 공개 게시물을 생성하는 것이므로, 모델이 publish 도구를 호출하기 전에 계정, 시간, 자막에 대해 확인하도록 지시합니다.
## 다시 하고 싶은 세 가지 것들
- **모든 create 호출이 빠르게 반환되도록 하세요.** 클리핑에는 몇 분이 걸리며, 이러한 긴 시간을 차단하는 도구는 클라이언트 타임아웃을 유발할 수 있습니다. ID를 반환하고 모델에게 상태(status) 도구를 제공하며, 서버 지침에 이를 명시하세요.
- **모든 도구에 힌트(hint)를 설정하세요.** `readOnlyHint`, `destructiveHint` 및 `openWorldHint`는 클라이언트가 사용자에게 먼저 요청할지 여부를 결정하며, ChatGPT의 앱 검토에서는 이 세 가지 모두 명시적으로 설정하는 것을 요구합니다.
- **앱과 동일한 코드로 MCP를 실행하세요.** 서버는 대시보드와 REST API와 동일한 서비스 코드, 플랜 제한 및 소유권 확인을 사용하므로, 세 요소가 분리되지 않도록 해야 합니다.
## 시도해 보세요
새로운 Prolifik 계정은 카드 없이 7일 무료 체험을 제공하며, 체험 기간 동안 OAuth 연결이 작동합니다. 그 이후에는 월 €20부터 플랜이 시작됩니다. 모든 도구는 문서를 참조하세요: [getprolifik.com/docs/mcp](https://getprolifik.com/docs/mcp).
연결하는 동안 문제가 발생하면, 사용한 클라이언트를 언급하며 댓글을 남겨주세요.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기