Guia de integração · Conecte qualquer ferramenta de IA ao StarReel MCP

01 · WHAT IS THIS

Em uma frase

O StarReel é uma plataforma que gera minisséries com IA de forma totalmente automática. Nós a transformamos em um plugin (MCP): conecte-o à sua ferramenta de IA e você poderá pedir em linguagem comum que ele crie projetos, storyboards, imagens, vídeo, dublagem e a montagem final.

🔌

Conecte uma vez, use sempre

Conecte o plugin uma vez na sua ferramenta de IA e ele estará pronto sempre que você abrir.

💬

É só falar naturalmente

Sem comandos nem código. Descreva o que quer, como se conversasse com um produtor.

💰

Pague pelo que usar

Cobrança por uso · gerações que falham não são cobradas · os créditos não expiram, sem mensalidade.

02 · GET READY

Três passos antes de começar

Cadastre-se e pegue uma chave

Cadastre-se em starreel.ai e crie uma chave (começa com srk_live_) na página «Chaves de API» do painel. Essa chave representa sua conta e seu saldo: guarde-a bem e não compartilhe.

Instale uma ferramenta de IA

Escolha um app de IA compatível com plugins (MCP) — a seção 3 traz uma lista internacional e nacional.

Conecte o plugin

Informe sua chave e conecte nosso plugin (seção 4; uma frase basta para a IA fazer sozinha). Depois é só trabalhar.

03 · PICK A TOOL

Qual ferramenta de IA instalar?

Serve qualquer ferramenta de IA compatível com plugins (MCP). Veja as opções mais comuns e escolha a que combina com você.

Internacional · opções populares

Software / Plataforma	Tipo	Observações
Claude Desktop	App de desktop	App oficial da Anthropic; interface amigável, ideal para iniciantes.
Claude Code	Linha de comando	Um comando para conectar, para quem usa o terminal.
Cursor / Cline / Windsurf	Editor	Comum em times de desenvolvimento; a IA se conecta sozinha.

China · pronto para conversar

Software / Plataforma	Tipo	Observações
Feishu Aily (ByteDance)	Espaço de trabalho de IA	Documentos / base de conhecimento / reuniões integrados, com mercado MCP.
Tencent WorkBuddy	Agente de desktop	MCP nativo, opera o computador, forte integração corporativa.
Alibaba QwenWork / Wukong	Agente corporativo	Conecta OA / CRM / DingTalk e outros sistemas.
Baidu DuMate	Agente de desktop	Sandbox local e permissões de arquivo, foco em segurança.

China · monte um fluxo automatizado (times técnicos)

Software / Plataforma	Tipo	Observações
Coze / Dify	Plataforma de agentes	Integre o plugin para montar um «fluxo de produção de séries».
FastGPT / n8n	Fluxo de trabalho	Auto-hospedado, produção em lote, orquestração de fluxos.

O suporte a MCP nessas plataformas evolui rápido; use sempre a versão mais recente. Sem conhecimento técnico? Escolha Claude Desktop no cenário internacional, ou Feishu Aily / Tencent WorkBuddy na China.

04 · CONNECT

Como conectar o plugin

O jeito mais fácil: envie uma frase e deixe a IA instalar e conectar tudo. Você não toca em nenhum arquivo de configuração.

Método A · Envie uma frase e deixe a IA se conectar (recomendado)

Copie a mensagem abaixo inteira e envie, trocando a chave pela sua. Uma IA que consegue operar seu computador (Claude Code, Cursor, Tencent WorkBuddy…) cuida de tudo, da instalação à conexão.

Conecte o plugin MCP de produção de minisséries do StarReel e deixe pronto do início ao fim:

1) Se o Node.js não estiver instalado, me ensine a instalar ou instale para mim;

2) Inicie o plugin com: npx -y @starreel/mcp

3) Defina a variável de ambiente STARREEL_API_KEY com a minha chave srk_live_[coloque sua chave aqui];

4) Adicione à configuração MCP, conecte e me diga se ficou conectado.

Método B · Adicione manualmente no app (para apps só gráficos)

Se o app é só gráfico e a IA dele não muda as configurações (Claude Desktop, Feishu Aily…), abra o «mercado MCP / plugins» e busque «StarReel» para adicionar com um clique; se não aparecer, clique em «Adicionar» e preencha estes três campos, salve e reinicie.

Comando	`npx`
Argumentos	`-y @starreel/mcp`
Chave	`STARREEL_API_KEY = srk_live_sua-chave`

✔ Como sei que conectou?

Diga à IA «liste meus projetos de minissérie» ou «qual é o meu saldo?»; se ela responder, deu certo.

Sobre o Node.js

O plugin funciona com o Node.js, um software base gratuito (é de onde vem o npx). Com o Método A, deixe a IA instalar; se preferir fazer você mesmo, acesse nodejs.org e clique em «avançar» até o fim: instala uma vez e fica para sempre.

05 · HOW TO TALK

Já conectado, como «falar» com ele

O segredo: fale naturalmente e a IA trabalha. Descreva o que quer, como com um produtor que domina o ofício.

①Configurações básicas do projetoGrátis · a IA já configura

Tipo de projeto, formato (vertical / horizontal), universo, aparência dos personagens, estilo visual geral. São grátis e formam a «base»; definidos uma vez ao criar o projeto.

②O tronco da produçãoPago · primeiro cotiza, executa após sua confirmação

Personagens → storyboard → imagens → vídeo → dublagem → corte final. Em cada passo pago ele informa o custo aproximado e só continua quando você diz «confirmar».

③Extras opcionaisPago · a IA propõe, você decide

Arte conceitual do universo, imagens de cena, música de fundo, pôsteres… Melhoram o resultado, mas não são obrigatórios: ele diz «dá para fazer, custa mais ou menos isto» e só faz se você concordar.

Prompts prontos para copiar (troque o que está entre [ ])

① Criar um projeto

Crie uma nova minissérie chamada «[Título]», romance urbano, vertical 9:16, 5 episódios no total. Universo de cidade moderna, em chinês, personagens do Leste Asiático.

Ele cria o projeto e define de uma vez a base: formato, universo etc. (grátis). Depois de definido o formato, não mude (seção 6).

② Transformar um roteiro em um episódio pronto

Este é o roteiro do episódio 1, transforme em um corte final: [cole seu roteiro aqui]

Ele executa todo o processo; nos passos pagos grandes (sobretudo o vídeo) cotiza primeiro e continua após sua confirmação.

③ Fazer um anúncio comercial

Faça um anúncio comercial de 30 segundos. O produto é [nome do produto], os diferenciais são [diferenciais], estilo jovem e animado.

Para anúncios ele também cria uma «biblioteca de produto»; senão o produto muda de uma tomada para outra.

④ Ver andamento / ajustar / adicionar

Como está o episódio 1, o que falta?　Coloque música de fundo neste episódio.　Gere uma imagem de conceito do universo.

Ver o andamento é grátis; música e arte conceitual são opcionais e cotizados antes.

06 · TWO RULES

Duas regras para lembrar sempre

⚠ Regra ① Definido o formato, não mude no meio

O formato (vertical 9:16 / horizontal 16:9) é travado ao criar o projeto e todas as imagens o seguem. Não mude no meio do caminho — o que já foi feito e o novo não vão casar (um vertical, outro horizontal). Para mudar, crie um novo projeto.

⚠ Regra ② Não deixe refazer o storyboard só porque uma tomada «parece longa»

Nossas tomadas duram cerca de 5-7 segundos cada, uma duração normal otimizada para vídeo com IA (mais longa que os 2-3 s das minisséries tradicionais). Algumas IAs acham «está longo demais, vamos refazer», mas refazer substitui todo o storyboard do episódio e as imagens já geradas são descartadas e cobradas de novo. A menos que você realmente queira recomeçar, deixe como está.

07 · FAQ

Perguntas frequentes

Conectar custa dinheiro?

Conectar é grátis. Só o conteúdo gerado (imagens, vídeo, dublagem…) é cobrado por uso, e gerações que falham não são cobradas.

Quanto custa um episódio, mais ou menos?

Depende da resolução e do número de tomadas. Um episódio de ~2 min (cerca de 26 tomadas) custa cerca de ¥150 em 480p ou ¥320 em 720p, bem menos que uma filmagem tradicional. Vale a cotização em tempo real no momento do pedido.

Minha chave é segura? Posso ser cobrado a mais?

Sua chave (começa com srk_live_) representa seu saldo: coloque-a só na configuração da sua ferramenta de IA, nunca cole em chat nem suba a um repositório. É pré-pago, sem cheque especial; para quando o saldo acaba.

Não sou técnico, posso conectar sozinho?

Pode. Use o «Método A» da seção 4: envie aquela mensagem à IA e ela se conecta sozinha; ou peça ajuda a um colega técnico, ou solicite a nós uma «configuração de um clique».

Qual ferramenta de IA é a mais fácil?

Claude Desktop no cenário internacional, ou Feishu Aily / Tencent WorkBuddy na China: todas gráficas e no mouse.

Tudo pronto?

Cadastre-se, pegue uma chave e em poucos minutos sua IA já pode começar a fazer minisséries.

Cadastro grátis

Documentação para desenvolvedores: api.shortreelai.com/docs/mcp

Conecte sua ferramenta de IA favorita ao StarReel