클로드 코드(Claude Code)와 MCP로 숏폼 드라마 콘티 자동화하기: 대본에서 캔버스 분경까지

숏폼 드라마 제작에서 클로드 코드(Claude Code)와 MCP가 주목받는 이유

이 글은 Say Action 팀이 작성했습니다. 추천 및 파이프라인 가이드는 숏폼 드라마 제작에서 대본·콘티·MCP 도구 연동과 컷별 영상 생성의 실무 경험을 바탕으로 하며 독립적인 벤치마크 결과가 아닙니다. 숏폼 드라마(Vertical Short Drama) 제작 환경이 1인 창작자 중심에서 주당 수십 편을 공급하는 기업형 스튜디오 체제로 빠르게 진화하면서, 기획과 연출 파이프라인에서 가장 극심한 병목으로 떠오른 단계는 '대본의 컷별 분해와 콘티 작성'입니다. 60~90초 분량의 단일 에피소드 하나에도 10~14개의 타이트한 컷이 요구되며, 50부작 시리즈 전체로는 수백 개에 달하는 컷을 기획해야 합니다. 기존 방식처럼 연출자가 대본 텍스트를 메모장에 띄워두고 수동으로 대사를 쪼갠 뒤, 생성 AI 툴마다 프롬프트를 일일이 복사하고 카메라 지시어를 덧붙이는 작업은 막대한 인력 소모와 집중력 저하를 초래합니다. 결과적으로 씬(Scene) 간의 감정선이 단절되거나 컷 번호가 뒤섞이는 치명적인 인적 오류가 빈번히 발생합니다.

이러한 분경 작업의 비효율을 혁신하기 위해 국내 테크 연출가와 AI 크리에이터들이 주목하는 도구가 바로 앤트로픽(Anthropic)의 클로드 코드(Claude Code)와 오픈AI(OpenAI)의 코덱스(Codex)를 활용한 MCP(Model Context Protocol) 자동화입니다. MCP는 대규모 언어 모델(LLM) 에이전트가 웹 브라우저의 닫힌 채팅 창을 벗어나, 외부 개발 도구 및 제작 플랫폼과 안전하게 상호작용할 수 있도록 규격화한 오픈 프로토콜입니다. 에이전트에게 전체 대본을 전달하면 단순한 텍스트 요약을 넘어, 시청자의 시선을 초반에 빠르게 사로잡아야 하는 숏폼 드라마 특유의 템포와 씬의 서사적 긴장감을 분석하여 구조화된 분경 데이터로 즉각 재구성합니다.

특히 Say Action의 원격 MCP 서버와 클로드 코드를 직접 연결하면, 에이전트가 터미널 명령어 한 줄로 캔버스 작업 공간에 프로젝트를 생성하고 표준 콘티 행(Storyboard Rows)을 자동으로 채워 넣는 엔드투엔드 파이프라인이 완성됩니다. 에이전트는 기계적인 분경 분해와 카메라 운동 문법 배치를 도맡고, 연출 감독은 무한 캔버스 위에서 시각적 연출과 인물 감정선의 정밀 검토에 집중할 수 있습니다. 이는 AI 숏폼 영상 제작의 진입 장벽을 획기적으로 낮추는 동시에, 프로덕션의 속도와 완성도를 동시에 끌어올리는 현실적인 해결책이 됩니다.

Say Action MCP 서버 연결 구조와 권한 경계

Say Action의 MCP 파이프라인은 원격 스트리머블 HTTP(Streamable HTTP) 엔드포인트인 https://isayaction.com/api/mcp 를 통해 작동합니다. 브라우저 세션 쿠키 대신 정밀한 권한 제어가 가능한 개인 접근 키(Access Key)의 Bearer 인증 토큰을 사용하므로, 로컬 터미널이나 서버 환경 어디서든 안전하게 연동할 수 있습니다. 터미널 환경에서 발급받은 개인 키를 export ISAYACTION_API_KEY="yc_live_..." 형식으로 환경 변수에 등록한 뒤, claude mcp add --transport http isayaction "https://isayaction.com/api/mcp" --header "Authorization: Bearer $ISAYACTION_API_KEY" 명령어를 실행하면 클로드 코드가 Say Action의 공식 툴셋을 즉시 탐색하고 등록합니다.

숏폼 드라마 분경 작업에 투입되는 Say Action의 핵심 MCP 도구는 체계적인 계층 구조를 갖추고 있습니다. get_account와 list_models로 현재 크레딧 잔액과 사용 가능한 최신 모델 목록을 확인한 뒤, create_project 도구로 해당 회차를 위한 9:16 비율의 캔버스 프로젝트를 초기화합니다. 이후 import_script나 batch_add_storyboard_cards, set_unit_shots 등의 명령을 호출하여 대본에서 추출된 씬 정보, 컷 번호(Shot ID), 인물 배정, 대사 자막, 렌즈 및 카메라 모션 프롬프트를 캔버스 콘티 테이블의 개별 행으로 일괄 삽입합니다. expert 프로필(?profile=expert)을 활성화하면 이미 존재하는 인물 참조 노드 ID를 읽어와 각 컷에 연결하는 고도화된 연동도 지원됩니다.

이 아키텍처에서 가장 중요한 설계 철학은 '안전한 권한 경계(Permission Boundary)'입니다. 클로드 코드는 대본을 분석하여 콘티 행을 생성하고 텍스트 프롬프트를 배치하는 권한을 갖지만, 고비용이 발생하는 비디오 생성(Generate Video)은 에이전트의 단독 판단으로 자동 일괄 실행되지 않도록 격리되어 있습니다. 대본 파싱 단계에서 에이전트의 무한 루프나 프롬프트 오해석으로 인해 수십 개의 비디오 생성 작업이 무단 호출되어 크레딧이 낭비되는 사태를 구조적으로 방지하기 위함입니다. 생성 실행은 인간 감독이 웹 캔버스에서 컷 구성과 프롬프트를 시각적으로 최종 확인한 뒤 승인하는 2단계 검증 체계를 유지합니다.

클로드 코드에 내리는 12컷 분경 지시 프롬프트 템플릿

클로드 코드가 숏폼 드라마의 호흡에 최적화된 분경을 생성하도록 유도하려면, 전통적인 3막 구조 대신 60초 모바일 시청 환경에 맞춘 '12컷 호흡 규칙'을 명시해야 합니다. 숏폼 시청자는 영상 시작 후 초반에 이탈 여부를 결정하기 쉬우므로, 1~2컷은 강렬한 시각적 충격이나 인물의 클로즈업(Hook)으로 시선을 끄는 구성이 효과적입니다. 3~7컷은 두 인물 간의 빠른 대화 티키타카와 오버숄더(OTS) 리버스 샷으로 갈등을 고조시키고, 8~10컷은 비밀 폭로나 물리적 충돌이 발생하는 클라이맥스 액션을 배치하며, 11~12컷은 다음 화 시청을 유도하는 긴박한 클리프행어(Cliffhanger) 표정으로 마무리하는 구조가 표준입니다.

실제 클로드 코드 터미널에서 실행하는 표준 12컷 분경 지시 프롬프트 예시는 다음과 같습니다. "Say Action 도구를 사용하여 '재벌 3세의 복수' 1화 대본을 9:16 세로형 12개 콘티 컷으로 분해하라. 컷 1은 2초 이내의 긴박한 익스트림 클로즈업 충격 오프닝(Hook)으로 시작하고, 컷 2~7은 주인공 민준과 비서의 빠른 대사를 교차 쇼트로 배치하라. 컷 8~10은 서류를 내던지는 클라이맥스 샷, 컷 11~12는 서늘한 미소의 클리프행어로 구성하라. 각 컷마다 고유한 멱등성 키(idempotencyKey)를 부여하고, 대사는 원문을 보존하며, 카메라 샷과 렌즈 지시어를 정밀하게 구분하여 콘티 테이블을 생성하라. 비디오 생성은 호출하지 마라."

프롬프트 작성 시 가장 중요한 테크닉은 '카메라 운동 지시어와 인물 동작의 분리'입니다. 생성 비디오 모델이 카메라 이동과 인물의 물리적 움직임을 혼동하면 화면 전체가 왜곡되거나 인물 얼굴이 뭉개지는 현상이 발생합니다. 따라서 클로드 코드에게 "Dolly In 45mm Lens / Subject Min-jun turns his head sharply"처럼 카메라 장비의 광학적 움직임(Dolly, Pan, Tilt, Roll, Tracking)과 인물의 신체 연기를 명확한 구분자로 분리하도록 규칙을 부여해야 합니다. 이는 차후 캔버스에서 생성 모델을 실행할 때 모델이 카메라 모션 벡터를 독립적으로 연산할 수 있게 만드는 핵심 기초가 됩니다.

지시를 받은 클로드 코드는 Say Action MCP의 batch_add_storyboard_cards 도구를 순차적으로 호출하여, 캔버스 위에 Shot_01부터 Shot_12까지 정렬된 콘티 행을 생성합니다. 각 행에는 컷 번호, 예상 재생 시간(예: 2.5초, 4초), 대사 텍스트, 인물 배정 태그, 영문 시각 프롬프트가 정교하게 채워집니다. 터미널에는 각 호출의 결과 상태와 캔버스 세션 링크가 반환되며, 감독은 브라우저를 열어 에이전트가 완성한 전체 에피소드 분경 테이블의 구조적 배치를 즉시 확인할 수 있습니다.

인간의 검토 단계(Human-in-the-Loop)와 키프레임 프리뷰

아무리 우수한 LLM이라 할지라도 텍스트 기반의 프롬프트만으로는 감독이 머릿속에 구상한 조명 톤, 인물의 미묘한 눈빛, 미술 소품의 디테일까지 온전히 시각화하기는 어렵습니다. 따라서 에이전트가 채워 넣은 콘티 표를 바탕으로 인간 연출가가 개입하는 '휴먼 인 더 루프(Human-in-the-Loop)' 검토 단계는 완성도 높은 숏폼 드라마를 제작하기 위한 중요한 관문입니다. Say Action의 캔버스는 MCP 도구로 생성된 모든 노드가 시각적으로 투명하게 노출되므로, 연출가는 직관적으로 마우스를 조작하며 컷의 배치와 타이밍을 점검할 수 있습니다.

실무 감독이 비디오 생성을 시작하기 전 점검하기 좋은 '3단계 연출 점검 체크리스트'는 다음과 같습니다. 1단계: 배역 및 대사 무결성 확인. 에이전트가 대사를 컷에 분배하면서 누락된 문장이 없는지, 인물 태그가 기존 캐릭터 레퍼런스 노드와 정확히 매칭되었는지 확인합니다. 2단계: 카메라 동선 적합성 검토. 하나의 컷 안에 '달리 인'과 '패닝 좌측' 등 상충하는 모션 키워드가 중복되지 않았는지 단일 동선으로 정돈합니다. 3단계: 정지 이미지 키프레임 프리뷰. 비디오를 직접 생성하기 전, Say Action 캔버스에서 지원하는 Nano Banana나 GPT Image 노드를 활용해 컷당 1장의 키프레임 이미지를 먼저 렌더링하여 12개 컷의 조명과 인물 비주얼의 일관성을 시각적으로 사전 검증합니다.

키프레임 이미지가 통과되면 각 컷의 특성에 맞춰 최적의 비디오 생성 모델을 라우팅합니다. Say Action에서는 컷별로 상이한 상용 영상 모델을 유연하게 지정할 수 있습니다. 인물의 섬세한 감정 표현과 대화 립싱크가 중요한 클로즈업 샷에는 MiniMax Hailuo 모델을 연결하고, 격렬한 신체 충돌이나 역동적인 카메라 무브가 요구되는 클라이맥스 액션 샷에는 Kling v3 텍스트 투 비디오나 Kling v3 Turbo 텍스트 투 비디오를 배정하며, 시네마틱한 공간 연속성이 필요한 씬에는 Seedance 2.0/2.5 또는 Wan 3.0(wan3.0-*) 모델을 선택합니다. 특정 컷의 모션이 부자연스럽더라도 전체 테이블을 처음부터 다시 생성할 필요 없이, 오직 해당 컷의 노드만 선택하여 프롬프트를 교정한 뒤 단독 재시도할 수 있습니다.

에이전트 토큰 비용과 캔버스 크레딧 관리

클로드 코드와 MCP를 결합한 파이프라인을 운영할 때 창작자가 미리 이해해두면 유용한 경제적 개념은 '이중 비용 구조(Dual Cost Architecture)'입니다. 대본을 분석하고 분경을 기획하는 작업은 앤트로픽의 언어 모델 토큰을 소비하며, 캔버스에서 키프레임 이미지를 뽑거나 영상을 렌더링하는 작업은 Say Action의 플랫폼 크레딧을 소모합니다. 텍스트 분경 단계는 토큰 비용이 매우 저렴한 영역이므로, 클로드 코드와 대본을 수차례 다듬으며 최상의 12컷 구조를 완성한 뒤 시각 생성 단계로 넘어가는 것이 전체 제작 예산을 절감하는 효과적인 방법입니다.

자동화 도구 사용 시 발생할 수 있는 가장 큰 리스크는 스크립트 오류나 에이전트의 반복 루프로 인한 크레딧 오남용입니다. 이러한 위험을 줄이기 위해 Say Action은 /access-keys 관리 페이지에서 발급 키별로 '누적 사용 한도(Cumulative Spending Limit)'를 설정할 수 있도록 지원합니다. 예를 들어 200, 500, 혹은 1000 크레딧 단위의 상한선을 설정해두면, 에이전트가 예기치 않게 통제를 벗어나더라도 지정된 한도에 도달하는 즉시 추가 유료 호출이 자동 차단됩니다. 또한 모든 MCP 생성 요청에는 8~128자의 고유한 멱등성 키(idempotencyKey)를 부여하도록 설계되어 있어, 불안정한 네트워크 환경에서 재시도가 발생하더라도 중복 결제나 동일 노드의 중복 생성을 방지하는 데 도움이 됩니다.

플랫폼 요금제와 크레딧 정책, 환불 기준은 공식 안내를 철저히 준수해야 합니다. 비디오 생성 중 외부 모델 공급사의 시스템 오류로 작업이 실패할 경우 예약된 크레딧은 계정으로 투명하게 환불됩니다. 대규모 프로덕션을 운영하며 자체 API 키를 활용하고자 하는 팀은 BYOK 스튜디오 패스를 통해 고유 채널을 직접 연결할 수 있습니다. 플랫폼 결제와 요금 기준은 제품 안내를 확인하세요: 크레딧은 채널 가격 기준 추정치이며, 실제 차감은 관리자 백엔드에 설정된 가격 등급을 따릅니다. 초 단위 영상 과금은 요청 초 수 기준 사전 승인입니다. 업스트림 실제 출력이 요청을 초과하면 소액의 차액이 발생할 수 있습니다. 작업 공간 서비스 요금이며 모델 사용량은 포함하지 않습니다. API 비용은 별도입니다. 모델 제공업체가 생성 실패를 명확히 확인하면 임시로 확보한 크레딧을 돌려드립니다. 연결이 끊기는 등 결과나 요금을 확인할 수 없을 때는 중복 정산을 막기 위해 확인 대기 상태로 둡니다. BYOK에서는 API 주소, 모델 키와 사용자 지정 헤더를 설정할 수 있습니다. OneAPI나 NewAPI 같은 중계 서비스를 쓸 때는 실제 API에 맞는 OpenAI, Gemini 또는 Claude 방식을 선택하고 모델 ID와 이미지·영상 API 지원 여부를 확인하세요. 모든 중계 서비스나 비공개 규격이 자동으로 호환되는 것은 아닙니다. BYOK 모델 호출에는 플랫폼 추가 마진이나 생성 크레딧 차감이 없지만, 작업 공간과 모델 제공업체 이용료는 별도로 청구됩니다.

내 API 채널과 외부 API 중계 서비스 연결하기

모델 채널 설정에 Base URL과 API 키를 입력한 뒤 제공업체 문서에 따라 API 방식, 모델 ID와 필요한 헤더를 설정하세요. 생성 전에 원하는 이미지·영상 생성 방식을 지원하는지 확인하세요. 경로, 해상도와 시작·끝 프레임 입력은 연결한 채널에 따라 다릅니다. 미지원 채널의 연동 신청이 호환성 보장을 뜻하지는 않습니다.

BYOK에서는 API 주소, 모델 키와 사용자 지정 헤더를 설정할 수 있습니다. OneAPI나 NewAPI 같은 중계 서비스를 쓸 때는 실제 API에 맞는 OpenAI, Gemini 또는 Claude 방식을 선택하고 모델 ID와 이미지·영상 API 지원 여부를 확인하세요. 모든 중계 서비스나 비공개 규격이 자동으로 호환되는 것은 아닙니다. BYOK 모델 호출에는 플랫폼 추가 마진이나 생성 크레딧 차감이 없지만, 작업 공간과 모델 제공업체 이용료는 별도로 청구됩니다.

신뢰하는 제공업체만 연결하고 운영 환경에서는 HTTPS를 사용하세요. 요청은 로그인 인증된 백엔드를 거쳐 전달되며 필요한 프롬프트, 참고 자료와 인증 정보가 요청에 사용됩니다. API 키, 비밀번호나 비밀 정보가 든 헤더를 공개 캔버스, 스크린샷 또는 지원 신청에 포함하지 마세요.