MCP: Estudio de creativos
Producciones del Estudio de creativos por el MCP. 8 herramientas.
Herramientas de esta área, generadas del código del servidor. Las descripciones vienen de ese código, en portugués. Para conectar, mira el MCP de XBASE.
studio_cancel_production
Cancela uma produção em andamento (para na próxima etapa).
| Parámetro | Obligatorio | Descripción |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
productionId | sí | — |
studio_create_production
Cria uma produção a partir de um briefing. target "script" (padrão) só escreve o roteiro com IA para revisar; target "produce" faz tudo em um clique (roteiro, voz, legenda, trilha, visuais, render e conferência). mode "agent" põe o Claude para conduzir as ferramentas e revisar o render (precisa de chave da Anthropic). Use editorialLineId de studio_get_settings e um hookTerm (as 5 primeiras palavras, ex.: "Donos de clínica no Sul"). Reels com apresentador: layout "split" (animação em cima, apresentador embaixo) ou "presenter" (apresentador em tela cheia) e presenterSource "avatar" (avatar de IA, precisa da HeyGen em Ferramentas) ou "upload" (a pessoa grava lendo o roteiro e envia a gravação na tela; aqui só dá para gerar o roteiro). Com layout "full" e presenterSource "upload", a gravação enviada (vídeo ou só áudio) vira a voz da animação. A gravação passa pela edição (ElevenLabs Scribe transcreve, o ffmpeg corta as pausas e acelera; a legenda é a fala). Use os videoTemplates de studio_get_settings. productImages = até 4 URLs https públicas de fotos do produto real (ex.: a capa revisada do produto no site): as imagens geradas mostram exatamente esse produto (a IA descreve só a cena). aspect "9:16" = imagem única para Story (1080×1920). Reels com o canal meta_ads sai no padrão dos Reels ads da Meta: 9:16 com som, texto e legenda acima dos 35% de baixo (área segura) e a conferência ganha reels-9x16, reels-sound e reels-safe-zone; pronto, vira anúncio com ads_draft_mutation kind create_ad. Gasta créditos dos provedores e conta no limite diário. O job é assíncrono: acompanhe com studio_get_production.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
format | sí | reel = Reels/Shorts 9:16; carousel = carrossel 4:5; image = imagem única (4:5 ou 9:16, ver aspect). |
channels | sí | Onde a peça vai rodar. |
brief | sí | O que a peça precisa dizer, para quem, oferta e destino do clique. |
editorialLineId | no | Linha editorial (studio_get_settings). |
personaId | no | Persona para quem a peça fala (studio_get_settings). Sem ela, vale a da linha. |
hookTerm | no | Termo-chave do início. |
mode | no | Padrão: o modo configurado no workspace. |
target | no | Padrão "script". Com presenterSource "upload", só "script". |
layout | no | Só Reels. full (padrão) = animação em tela cheia; split = tela dividida; presenter = apresentador em tela cheia. |
presenterSource | no | Só Reels. Obrigatório com layout split/presenter: avatar ou upload (gravação da pessoa, enviada na tela). Com full, só upload (a voz). |
productImages | no | Até 4 URLs https públicas de fotos do produto real. As imagens geradas mostram esse produto, sem inventar detalhes. |
aspect | no | Só format "image". 4:5 (padrão) = feed; 9:16 para Story. |
studio_get_production
Uma produção completa: briefing, roteiro (plan), conferência automática (checks), custo conhecido, registro do agente, publicações e links das saídas. Use para acompanhar um job (status queued/scripting/producing/rendering) até ready ou failed.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
productionId | sí | Id da produção. |
studio_get_settings
Configuração do Estúdio de criativos do workspace: linhas editoriais (id, nome, objetivo, estrutura, formatos, público, tom), personas (cliente ideal: dores e palavras que usa), modelos de linha disponíveis, modelos de vídeo (formato + layout + quem fala), ferramentas (modelo do roteiro, modo um clique/agente, voz, trilha, vídeo por IA, imagens), marca, regras de conteúdo, limite diário, de onde vem cada chave de provedor e se o renderizador está no ar. Ferramentas se editam em XBASE → Produção → Estúdio → Ferramentas; personas e linhas editoriais, em XBASE → Marketing (marketing_update_personas e marketing_update_editorial_lines).
| Parámetro | Obligatorio | Descripción |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
studio_list_productions
Produções do Estúdio (mais recentes primeiro): status, etapa, progresso, erro e links do vídeo/prancha/imagens.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
status | no | Filtra por status. |
limit | no | Padrão 20. |
studio_produce
Produz (ou produz de novo) a peça de uma produção parada a partir do roteiro atual: voz, legenda, trilha, visuais, render e conferência. Gasta créditos e conta no limite diário. Publicar: studio_publish_production (token autorizado) ou XBASE → Produção → Estúdio → Produções.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
productionId | sí | — |
mode | no | — |
studio_publish_production
AÇÃO EXTERNA — publica ou agenda no Instagram uma produção pronta do Estúdio (Reels, imagem ou carrossel), com a legenda e as hashtags do roteiro; target "meta_ads" envia o vídeo para a biblioteca de anúncios (para virar ANÚNCIO num conjunto, use ads_draft_mutation kind create_ad com studioProductionId). Sem scheduledAt, sai em ~1 minuto; com scheduledAt (ISO 8601, até 75 dias), entra no agendador. Só funciona se quem criou o token marcou esta ferramenta (é a autorização para publicar); sem ela, publique em XBASE → Produção → Estúdio → Produções. Contas: list-instagram-connections. Revise a peça (studio_get_production) antes: depois de publicado, não volta.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
productionId | sí | — |
target | no | — |
connectionId | no | Conta do Instagram (obrigatória com target instagram). |
scheduledAt | no | Agendar (ISO 8601, futuro). Sem ele, publica agora. |
studio_update_plan
Substitui o roteiro (plan) de uma produção parada (não em andamento). Mande o plan inteiro, no mesmo formato de studio_get_production. Salvar descarta voz, visuais e render anteriores; depois chame studio_produce.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
productionId | sí | — |
plan | sí | Roteiro completo. |