연동 가이드 · 서드파티 AI 도구로 StarReel MCP 연결

01 · WHAT IS THIS

한마디로

StarReel은 AI로 숏드라마를 전자동 생성하는 플랫폼입니다. 이를 「플러그인(MCP)」으로 만들었습니다——쓰시는 AI 도구에 연결하면 프로젝트 생성, 스토리보드, 이미지, 동영상, 더빙, 합성까지 평범한 말로 지시할 수 있습니다.

🔌

한 번 연결하면 계속 사용

AI 도구에 한 번 연결하면 다음부터 바로 쓸 수 있습니다.

💬

그냥 말하면 됩니다

명령어도 코드도 필요 없습니다. 제작 어시스턴트와 대화하듯 요청하세요.

💰

쓴 만큼만 과금

사용량 기반 과금 · 생성 실패는 무료 · 충전은 무기한, 월정액 없음.

02 · GET READY

시작 전 3단계 준비

계정 가입, 키 받기

공식 사이트 starreel.ai에서 가입하고 관리자 「API 키」 페이지에서 키(srk_live_로 시작)를 발급하세요. 이 키는 계정과 잔액을 나타냅니다. 잘 보관하고 외부에 공유하지 마세요.

AI 도구 설치

플러그인(MCP)을 지원하는 AI 소프트웨어를 설치하세요——3절에 국제·국내 추천 목록이 있습니다.

플러그인 연결

키를 입력하고 플러그인을 연결하세요(4절, 한마디로 AI가 스스로 연결). 연결되면 바로 작업할 수 있습니다.

03 · PICK A TOOL

어떤 AI 도구를 설치할까

플러그인(MCP)을 지원하는 AI 도구라면 무엇이든 연결됩니다. 아래에서 상황에 맞는 것을 고르세요.

국제 · 주요 선택

소프트웨어 / 플랫폼	형태	설명
Claude Desktop	데스크톱 앱	Anthropic 공식 앱. 사용하기 쉬워 초보자에게 최적.
Claude Code	명령줄	터미널 사용자용, 한 줄로 연결.
Cursor / Cline / Windsurf	에디터	개발팀이 즐겨 사용, AI가 자동 연결.

국내 · 대화로 바로 사용

소프트웨어 / 플랫폼	형태	설명
Feishu Aily(바이트댄스)	기업 AI 워크스페이스	문서 / 지식베이스 / 회의 통합, MCP 마켓 있음.
Tencent WorkBuddy	데스크톱 Agent	네이티브 MCP, PC 조작 가능, 기업 연동 강력.
Alibaba QwenWork / Wukong	기업 Agent	OA / CRM / DingTalk 등 기업 시스템 연결.
Baidu DuMate	데스크톱 Agent	로컬 샌드박스와 파일 권한, 보안 중시.

국내 · 자동화 플로우 구축(기술팀)

소프트웨어 / 플랫폼	형태	설명
Coze / Dify	Agent 플랫폼	플러그인을 넣어 「드라마 제작 플로우」 구축.
FastGPT / n8n	워크플로우	자체 호스팅, 일괄 제작, 플로우 편성.

각 플랫폼의 MCP 지원은 빠르게 발전 중입니다. 최신 버전을 확인하세요. 기술을 잘 모르면: 국제는 Claude Desktop, 국내는 Feishu Aily나 Tencent WorkBuddy를 추천합니다.

04 · CONNECT

플러그인 연결 방법

가장 쉬운 방법: 한마디만 보내면 AI가 스스로 설치하고 연결합니다. 설정 파일을 건드릴 필요가 없습니다.

방법 A · 한마디 보내 AI가 스스로 연결(추천)

아래 문장을 통째로 복사해 보내고, 키를 본인 것으로 바꾸세요. PC를 조작할 수 있는 AI(Claude Code, Cursor, Tencent WorkBuddy 등)가 환경 구성부터 연결까지 한 번에 처리합니다.

StarReel 숏드라마 제작 MCP 플러그인을 처음부터 끝까지 연결해 주세요:

1) Node.js가 없으면 설치 방법을 알려주거나 설치해 주고;

2) 명령어 npx -y @starreel/mcp로 플러그인을 실행;

3) 환경 변수 STARREEL_API_KEY에 제 키 srk_live_〔본인 키로 교체〕를 설정;

4) MCP 설정에 추가해 연결하고, 마지막에 「연결됐는지」 알려줘.

방법 B · 앱에서 수동 추가(GUI 전용 앱 대비)

앱이 GUI 전용이라 AI가 설정을 못 바꾸면(Claude Desktop, Feishu Aily 등) 「MCP 마켓 / 플러그인」에서 「StarReel」을 검색해 원클릭 추가하세요. 없으면 「추가」를 눌러 아래 3항목을 입력하고 저장 후 재시작합니다.

실행 명령	`npx`
인자	`-y @starreel/mcp`
키	`STARREEL_API_KEY = srk_live_본인_키`

✔ 연결됐는지 확인하려면?

연결 후 AI에게 「내 숏드라마 프로젝트 목록 보여줘」 또는 「잔액이 얼마야」라고 물어 답하면 성공입니다.

Node.js에 대해

플러그인은 Node.js라는 무료 기반 소프트웨어로 작동합니다(명령어의 npx가 여기서 옵니다). 방법 A라면 AI에게 맡기세요. 직접 설치하려면 nodejs.org에서 「다음」을 누르며 진행하면 되고, 한 번 설치하면 계속 사용됩니다.

05 · HOW TO TALK

연결 후, 「말하는」 법

핵심은: 그냥 말하면 AI가 합니다. 실력 있는 제작 어시스턴트와 대화하듯 원하는 것을 말하세요.

①프로젝트 기본 설정무료 · AI가 직접 설정

프로젝트 유형, 화면비(세로형 / 가로형), 세계관, 캐릭터 외모, 전체 비주얼. 무료이며 「토대」입니다. 생성 시 한 번 설정합니다.

②제작 본줄기유료 · 먼저 견적, 확인 후 실행

캐릭터 → 스토리보드 → 이미지 → 동영상 → 더빙 → 완성본. 유료 단계마다 대략 비용을 먼저 알려주고 「확인」이라 하면 실행합니다.

③더하기 옵션유료 · AI가 먼저 제안, 실행은 본인 결정

세계관 콘셉트 아트, 장면 이미지, 배경 음악, 포스터 등. 품질을 높이지만 필수는 아닙니다. 「가능하고 대략 이 정도」라고 알려주고 동의하면 실행합니다.

그대로 쓰는 프롬프트(〔〕 안을 본인 내용으로)

① 프로젝트 생성

새 숏드라마 「〔제목〕」을 만들어 줘. 도시 로맨스, 세로형 9:16, 총 5화. 세계관은 현대 도시, 중국어, 캐릭터는 동아시아인.

화면비와 세계관 등 토대를 한 번에 설정합니다(무료). 화면비는 정하면 바꾸지 마세요(6절).

② 대본을 한 화 완성본으로

이건 1화 대본, 완성본으로 만들어 줘: 〔여기에 대본 붙여넣기〕

전체 공정을 실행합니다. 비용이 드는 큰 단계(특히 동영상)에서는 먼저 견적하고 확인 후 계속합니다.

③ 상업 광고 제작

30초 상업 광고 만들어 줘. 제품은 〔제품명〕, 강점은 〔강점〕, 젊고 활발한 스타일로.

광고에서는 「제품 라이브러리」도 만들어 줍니다. 그러지 않으면 컷마다 제품이 흐트러집니다.

④ 진행 확인 / 미세 조정 / 추가

1화 어디까지 됐어, 뭐가 남았어?　이 화에 배경 음악 넣어 줘.　세계관 콘셉트 아트 한 장 만들어 봐.

진행 확인은 무료. 음악·콘셉트 아트는 선택이며 먼저 견적합니다.

06 · TWO RULES

꼭 기억할 두 가지 규칙

⚠ 규칙 ① 화면비는 정하면 도중에 바꾸지 않기

화면비(세로형 9:16 / 가로형 16:9)는 생성 시 한 번 고정되고 이후 모든 화면이 이를 따릅니다. 도중에 바꾸지 마세요——앞뒤가 세로·가로로 어긋납니다. 바꾸려면 새 프로젝트를 만드세요.

⚠ 규칙 ② 「컷이 조금 길다」는 이유로 스토리보드를 다시 나누게 하지 않기

이 플랫폼의 컷은 하나에 약 5-7초로, AI 동영상에 최적화된 정상 길이입니다(기존 숏드라마의 2-3초보다 김). 일부 AI는 「너무 길다, 다시 나누자」고 하지만, 다시 나누면 화 전체 스토리보드가 교체되고 이미 생성된 이미지가 폐기되어 다시 과금됩니다. 정말 다시 할 게 아니면 그대로 두세요.

07 · FAQ

자주 묻는 질문

연동에 돈이 드나요?

연동 자체는 무료입니다. 콘텐츠 생성(이미지·동영상·더빙 등)만 사용량 기반 과금이며, 생성 실패는 과금되지 않습니다.

한 화에 대략 얼마인가요?

해상도와 컷 수에 따릅니다. 약 2분 분량 한 화(컷 약 26개)에 480p 약 ¥150, 720p 약 ¥320으로 기존 촬영보다 훨씬 저렴합니다. 주문 시 실시간 견적이 정식입니다.

키는 안전한가요? 임의로 과금되나요?

키(srk_live_로 시작)는 잔액을 나타냅니다. AI 도구 설정에만 입력하고 채팅창에 붙이거나 코드 저장소에 commit하지 마세요. 선불·초과 없음, 잔액이 떨어지면 정지합니다.

기술을 몰라도 직접 연결할 수 있나요?

가능합니다. 4절 「방법 A」로 그 문장을 AI에 보내면 스스로 연결합니다. 또는 기술 담당에게 부탁하거나 저희에게 「원클릭 설정」을 요청하세요.

어떤 AI 도구가 가장 쉽나요?

국제는 Claude Desktop, 국내는 Feishu Aily나 Tencent WorkBuddy. 모두 GUI에 마우스 조작입니다.

준비되셨나요?

계정을 만들고 키를 받으면 몇 분 안에 AI가 숏드라마를 만들기 시작합니다.

무료 가입

기술 담당자용 개발자 문서: api.shortreelai.com/docs/mcp

자주 쓰는 AI 도구를 StarReel에 연결하세요