Claude·Codex·Cursor MCP로 숏드라마 콘티와 영상 작업하기

샷 계획부터 검토하고 생성하기

Claude Code, Codex, Cursor는 Say Action MCP 서버를 통해 프로젝트와 캔버스를 다루고 이미지·영상 작업을 요청할 수 있습니다. 에이전트는 제작 요구사항을 해석하고, MCP 도구는 작업 공간을 읽고 쓰며 생성 작업을 제출합니다. 결과는 여전히 모델과 참고 에셋에 따라 달라집니다.

에피소드 하나와 몇 개의 샷부터 시작하세요. 생성 전에 콘티를 검토합니다. 이 가이드는 연결 설정과 운영 시 제약을 다루며, 기존 영어 튜토리얼에는 에이전트에 순서대로 요청하는 구체적인 예시가 있습니다.

키를 만들고 클라이언트 연결하기

/ko/mcp에서 Claude Code, Codex 또는 Cursor 카드를 선택하고 키 발급 버튼을 눌러 로그인하세요. 키가 한 번만 표시되는 대화상자에서 연결 설정을 복사하기 전에 사용 한도를 저장합니다. 이후 /access-keys에서 권한 범위를 관리하고 한도를 수정하거나 접근을 철회할 수 있습니다. yc_live_ 키는 로컬 ISAYACTION_API_KEY 환경 변수에 보관하고 에이전트 프롬프트에 넣지 마세요.

엔드포인트: https://isayaction.com/api/mcp. 서버는 Streamable HTTP와 Authorization: Bearer yc_live_... 인증을 사용합니다. 브라우저 쿠키로 키를 대신할 수는 없습니다.

Claude Code (Unix 셸): claude mcp add --transport http isayaction https://isayaction.com/api/mcp --header "Authorization: Bearer $ISAYACTION_API_KEY"

Codex: codex mcp add isayaction --url https://isayaction.com/api/mcp --bearer-token-env-var ISAYACTION_API_KEY

Cursor MCP 설정: { "mcpServers": { "isayaction": { "url": "https://isayaction.com/api/mcp", "headers": { "Authorization": "Bearer ${env:ISAYACTION_API_KEY}" } } } }

사용자 개입 없이 codex exec를 실행하려면 ~/.codex/config.toml의 [mcp_servers.isayaction] 아래에 default_tools_approval_mode = "approve"를 설정하세요. 도구 자동 실행을 허용하는 설정이므로 먼저 키의 사용 한도를 정해야 합니다. 클라이언트 승인 설정과 서버 과금은 별도의 제어 항목입니다.

도구를 순서에 맞게 사용하기

get_account와 list_models로 잔액과 모델 기능을 확인한 뒤, list_projects / create_project와 list_canvases / create_canvas로 작업 공간을 선택하세요. import_script를 호출하기 전에 에이전트에게 원본 대본을 에피소드별로 나눠 달라고 요청합니다. 이 도구는 준비된 유닛을 저장하며, 모델을 호출해 텍스트를 분할하지 않습니다. list_units와 get_unit_workspace로 유닛을 확인하고 set_unit_shots, create_shot, revise_shot으로 샷을 작업하세요.

캔버스를 편집하기 전에 canvas_list_node_types와 canvas_get_state를 읽으세요. canvas_create_storyboard로 표를 만들고, canvas_read_storyboard로 행을 읽고, canvas_edit_storyboard로 샷을 편집합니다. canvas_apply_ops로 노드를 추가하고 지원되는 필드를 수정하며 노드를 연결할 수 있습니다. 기존 노드를 삭제하거나 위치를 옮길 수는 없습니다. 스냅샷이 필요한 쓰기 작업에는 현재 snapshotHash를 사용해야 합니다. 결과를 열 수 있도록 get_canvas_link를 반환하게 하세요.

샷 검토와 모델 선택을 마치면 generate_media로 작업을 제출하고 get_generation 또는 wait_generations로 결과를 확인하세요. 최근 작업은 list_recent_generations로 살펴봅니다. retry_generation은 새 시도를 시작하며 추가 비용이 발생할 수 있습니다. 첫 요청은 이렇게 해 보세요. ‘이 장면을 샷 3개로 나누고 대사를 유지한 뒤 캔버스 링크를 돌려줘. 영상 생성은 내 검토가 끝날 때까지 기다려.’

유료 호출은 즉시 과금되며 새 키에는 기본 한도가 없음

유료 MCP 호출은 크레딧을 바로 차감하며 서버가 호출마다 승인을 기다리지 않습니다. 새 키는 기본적으로 한도가 없습니다. 에이전트의 반복 실행, 실수, 키 유출로 지출이 계속될 수 있습니다. 외부 클라이언트나 해당 모델의 이용료는 별도입니다. 내장 Agent의 작업 예산과 키의 누적 사용 한도도 서로 다른 설정입니다.

키 대화상자에서 사용 한도 저장 버튼을 누르거나, /access-keys에서 한도 수정을 선택해 저장하세요. 한도는 월간 한도가 아닌 해당 키의 누적 한도이며, 환불이나 키 교체로 사용량이 초기화되지 않습니다. 키 페이지에는 80%와 100%에서 사용량 경고가 표시됩니다. API 한도 알림을 켜면 서비스 알림도 생성되며 이메일 발송 여부는 메일 설정에 따라 달라집니다. 한도에 도달하면 새 유료 호출이 차단됩니다. 한도를 0으로 설정하면 이미 제출한 작업은 취소하지 않고 유료 호출을 차단합니다.

크레딧은 채널 가격 기준 추정치이며, 실제 차감은 관리자 백엔드에 설정된 가격 등급을 따릅니다. 초 단위 영상 과금은 요청 초 수 기준 사전 승인입니다. 업스트림 실제 출력이 요청을 초과하면 소액의 차액이 발생할 수 있습니다.

모델 제공업체가 생성 실패를 명확히 확인하면 임시로 확보한 크레딧을 돌려드립니다. 연결이 끊기는 등 결과나 요금을 확인할 수 없을 때는 중복 정산을 막기 위해 확인 대기 상태로 둡니다.

네트워크 재시도와 새 생성 작업 구분하기

유료 생성 도구를 포함한 쓰기 도구에는 8–128자의 idempotencyKey가 필요합니다. 네트워크 오류가 발생하면 원래 키와 동일한 인자로 같은 작업을 재시도하세요. 키를 바꿔 무작정 다시 제출하지 마세요. 인자가 달라지면 새 작업이므로 새 키가 필요합니다.

idempotency_key_pending이면 기다린 뒤 현재 상태를 확인하세요. outcome_unknown은 결과가 불확실하다는 뜻입니다. 다시 실행하기 전에 작업이나 객체를 확인해야 합니다. 저장된 결과는 그대로 반환되며, idempotency_key_conflict는 같은 키에 다른 인자를 사용했다는 뜻입니다. get_generation으로 경과를 확인할 수 있도록 작업 ID를 보관하세요.

신뢰하는 클라이언트에만 키 전달하기

키는 지정된 권한 범위 안에서 접근을 허용하므로 클라이언트에 필요한 권한만 선택하세요. 비밀 키는 생성하거나 교체할 때 표시됩니다. 공개 저장소, 공유 설정, 스크린샷, 캔버스, 채팅 기록에 남기지 마세요. 환경 변수를 사용하더라도 터미널 스크린샷을 안전하게 공유할 수 있는 것은 아닙니다.

쓰지 않는 키는 /access-keys에서 폐기하세요. 유출 가능성이 있다면 즉시 폐기하거나 교체하고 사용량과 작업을 확인합니다. 클라이언트는 프롬프트와 참고 에셋을 제출할 수 있으므로 시작 전에 사용할 프로젝트, 모델, 키를 확인하세요.

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

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

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

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