Claude와 TapVid MCP로 모션 그래픽 영상을 만드는 법

01

Claude가 조율하고 TapVid가 렌더링합니다

여기서 Claude video generation은 Claude가 프레임을 그리고 MP4를 내보낸다는 뜻이 아닙니다. Claude는 목표를 해석하고 구조화 도구를 호출하고 결과를 관찰합니다. TapVid가 자료를 처리하고 장면을 구성하고 렌더링합니다. MCP는 두 시스템의 연결 계층입니다.

TapVid는 기존 기사, 문서, 대본, PDF, PRD, 제품 페이지를 구조화된 정보 영상으로 바꿉니다. 자료는 사실을, 프롬프트는 대상과 제약을 제공합니다. 정확성, 권리, 리듬, 공개는 사람이 승인합니다. 나머지를 유지한 채 한 장면만 다시 생성할 수 있습니다.

삽입된 영상은 Motion이 만든 외부 Motion MCP 참고 사례이며 이번 TapVid 테스트 결과가 아닙니다. 검증된 TapVid 근거는 뒤의 스크린샷과 시간 기록에 제시합니다.

02

Bearer API Key로 Claude를 연결합니다

현재 공개 설정은 REST와 MCP가 같은 Bearer API Key를 씁니다. API Keys에서 만들고 안전하게 저장한 뒤 Claude를 https://mcp.tapvid.ai/mcp에 연결합니다. 먼저 `get_account`로 연결과 크레딧을 확인합니다.

• `/developer/apikey`에서 키를 만들고 안전하게 저장합니다.
• `https://mcp.tapvid.ai/mcp`와 Bearer header를 Claude에 추가합니다.
• `get_account`로 연결과 credits를 확인합니다.
• `upload_material`로 승인된 HTTPS URL을 넣습니다.
• 길이, 비율, 언어, 대상, 금지 항목을 정한 뒤 생성합니다.

03

확인한 MCP 도구

측정한 create-and-export workflow에서는 다섯 도구를 사용했습니다. 현재 connector에는 `edit_video`도 있지만 이 여섯 번째 tool은 측정 테스트에서 호출하지 않았습니다.

브리프에는 30초, 16:9, 영어, 개발자 대상, TapVid 페이지를 사실 자료로 사용, 소재부터 비동기 생성과 다운로드까지 설명, 성능이나 고객 성과를 꾸미지 말라는 조건을 넣었습니다.

04

실제 30초 테스트 결과

2026년 8월 7일 테스트에서 URL 업로드는 약 0.4초, `create_video`는 약 0.3초였습니다. 약 60초 뒤 running 50%가 되어 18분 이상 유지되었고 약 28분 20초에 completed가 되었습니다. 첫 export는 36초간 recording이었고 이후 조회에서 signed URL이 준비되었습니다. 사용량은 90 credits 늘었습니다.

진행률은 선형 시계가 아닙니다. `pollAfterSeconds`를 지키고 video ID를 저장하고 전체 timeout을 두고 마지막 상태를 알려야 합니다. completed 전에 다운로드를 성공으로 선언하면 안 됩니다.

05

MCP 오류를 구분하는 방법

첫 계정 호출에는 일시적인 transport error도 있었습니다. 네트워크, 인증, 인수, credits, 장기 작업은 다르게 대응합니다. 일시적 읽기 오류만 제한적으로 재시도합니다.

응답이 끊겼다고 create가 실패한 것은 아닙니다. 서버가 수락했다면 새 작업 생성은 이중 비용을 만듭니다. material ID와 video ID를 다음 네트워크 호출 전에 저장합니다.

06

공개 전 영상을 검수합니다

완성 파일도 초안입니다. 자료와 사실, 장면 순서, 길이, 자막, 비율, 음악, 권리, CTA를 확인합니다. Claude는 체크를 도울 수 있지만 공개 책임을 대신하지 않습니다.

• 사실이 자료에 있습니다.
• 장면 순서가 맞습니다.
• 길이가 브리프와 가깝습니다.
• 16:9에서 글자가 읽힙니다.
• 권리와 브랜드를 확인합니다.
• 사람이 최종 공개를 승인합니다.

07

대화에는 MCP, 운영 코드에는 REST

MCP는 대화형 탐색에 좋고 REST는 영구 상태, 재시도, 지표, 큐, 예약 실행에 좋습니다. 차이는 생성 엔진보다 오케스트레이션의 소유자입니다.

프롬프트와 합격 기준은 MCP로 시험하고 반복 작업은 REST로 옮기는 방식이 실용적입니다. 새로움이 아니라 대화와 결정성 중 필요한 것을 고릅니다.

08

키와 크레딧을 보호합니다

API Key는 credits와 계정 자원에 접근합니다. 프롬프트, 캡처, 이슈, 저장소에 넣지 마세요. 읽기, 생성, 공개 권한을 분리하고 MCP security guidance를 확인하세요.

• 키를 secret store에 둡니다.
• 키, email, ID, signed URL을 공개하지 않습니다.
• 읽기와 과금을 분리합니다.
• 수락 ID를 즉시 저장합니다.
• 재시도를 제한합니다.
• header 없이 상태를 기록합니다.

09

한 자료와 측정 가능한 목표로 시작합니다

승인된 한 페이지, 한 대상, 한 메시지, 16:9, 30초로 시작합니다. Claude에게 도구 순서를 먼저 말하게 하고 상태와 credits를 기록하고 자료 충실도를 검수합니다. TapVid API/MCP overview에서 시작할 수 있습니다.

10

Frequently asked questions