Seus cortes, direto do seu app de IA
O servidor MCP da Real Oficial deixa Claude, ChatGPT, Cursor e outros consultarem seus projetos e criarem cortes com a sua conta — login OAuth, sem colar chave de API.
Viral Day e Clipero são marcas da Real Oficial: a URL do servidor é a mesma para todas.
- OAuth 2.1 + PKCE
- Streamable HTTP
- Sem chave de API
- Revogável a qualquer momento
Conecte em um minuto
Escolha seu app. Em todos os casos o login acontece na tela da Real Oficial, onde você escolhe o espaço de trabalho e as permissões.
- 01
No Claude (web, Desktop ou celular), abra Personalizar › Conectores e clique em + Adicionar conector personalizado.
- 02
Cole a URL do servidor no campo de URL e clique em Conectar. Mantenha a opção padrão de identidade do app (metadados hospedados pela Anthropic).
https://api.realoficial.com.br/mcp - 03
Entre com sua conta Real Oficial, escolha o espaço de trabalho e as permissões e clique em Permitir. Pronto: peça ao Claude para listar seus projetos.
Bom saber: O plano gratuito do Claude permite 1 conector personalizado. Em contas Team/Enterprise, só Owners adicionam o conector em Configurações da organização › Conectores; depois cada membro clica em Conectar.
Instalou pelo diretório do Claude, do ChatGPT ou do Grok Bot?
As instalações pelos diretórios usam um endereço próprio e têm 31 ferramentas de cortes, legendas, traduções, renderização e publicação, sem compras pelo chat. A página delas explica as permissões, o limite diário e como desconectar.
Ver a página dos diretóriosUsa SDK (OpenAI Agents, Anthropic mcp_servers, Gemini)?
Esses SDKs não fazem OAuth: precisam de um token pronto. O token de API por app ainda não está disponível — por enquanto, use um cliente com OAuth. Nunca use o token principal da sua conta para isso: ele dá acesso total e não expira.
49 ferramentas
Ler nunca custa nada. Tudo o que gasta créditos, publica nas suas redes ou inicia um pagamento passa por uma estimativa e pela sua confirmação no app de IA.
| Ferramenta | Permissão | O que faz |
|---|---|---|
ro_whoami | leituraaccount:read | Seu nome, espaço ativo, plano, saldo de créditos e os limites desta conexão. |
ro_estimate_clips | leituraprojects:write | Lê um vídeo do YouTube ou VOD da Twitch e devolve um orçamento em créditos, com template, brand kit, estilo de legenda, edição automática, idiomas de legenda e dublagem e piloto automático. |
ro_list_projects | leituraprojects:read | Lista seus projetos de cortes com status, busca e paginação. |
ro_get_project | leituraprojects:read | Detalhes e progresso de um projeto, com quando voltar a consultar. |
ro_wait_for_clips | leituraprojects:read | Espera um pouco no servidor até os primeiros cortes de um projeto ficarem prontos e já os devolve, do melhor para o pior. Enquanto processa, diz quando consultar de novo. |
ro_list_clips | leituraprojects:read | Lista os cortes de um projeto, com pontuação de viralidade e miniaturas. |
ro_get_clip | leituraprojects:read | Detalhes de um corte, motivo da seleção e renders disponíveis. |
ro_list_renders | leituraprojects:read | Lista os renders do espaço, com links de download. |
ro_list_languages | leituraprojects:read | Encontra os códigos de idioma para traduzir legendas e dublar com IA e diz se o consentimento de voz já foi dado. |
ro_list_translations_and_dubs | leituraprojects:read | Mostra as traduções e dublagens de um corte ou projeto, espera um pouco no servidor enquanto são processadas e mostra a tradução ao lado da legenda original. |
ro_list_offers | leituraaccount:read | Lista os pacotes de créditos e planos disponíveis para o seu espaço, com preço e minutos. |
ro_get_purchase_status | leiturabilling:purchase | Status de uma compra: pendente, paga, expirada ou falha, e se os créditos já entraram. |
ro_create_clips | gasta créditosprojects:write | Cria o projeto de cortes a partir de um orçamento confirmado, com os termos que você aceitou. Gasta créditos. |
ro_confirm_spend | gasta créditosmedia:write | Confirma uma estimativa de imagem, thumbnail, vídeo, edição com IA ou monitoramento de live e inicia. |
ro_render_clip | escritarenders:write | Renderiza um corte em vídeo final para download. |
ro_translate_clips | escritaprojects:write | Traduz as legendas e o título de até 10 cortes para até 3 idiomas, grátis. |
ro_dub_clip | escritaprojects:write | Dubla um corte com vozes de IA que mantêm a voz de cada pessoa, grátis. O consentimento de voz é dado só por você, no app. |
ro_get_auto_edit | leituraprojects:read | Mostra o plano de edição automática com IA de um corte e, quando dá para gerar um novo, o preço em créditos. |
ro_edit_clip | escritaprojects:write | Aplica no servidor o plano de edição automática pronto ou restaura o corte original da IA. Pede sua confirmação. |
ro_render_clips | escritarenders:write | Renderiza até 20 cortes de um projeto de uma vez, no original ou na versão traduzida ou dublada. |
ro_cut_clip | escritaprojects:write | Cria um novo corte de qualquer trecho do vídeo original (1 s a 3 min), sem gastar créditos. |
ro_rename | escritaprojects:write | Renomeia projetos, cortes, templates e brand kits. |
ro_duplicate | escritaprojects:write | Duplica um corte, um template (seu ou da galeria) ou um brand kit. |
ro_delete | escritaprojects:write | Apaga um projeto, corte, template, brand kit, prompt salvo ou vídeo com IA, só depois da sua confirmação. |
ro_list_library | leituraprojects:read | Lista templates (seus e da galeria), layouts, brand kits, estilos de legenda, prompts salvos e vídeos do Hub de Conteúdo. |
ro_save_prompt | escritaprojects:write | Salva um prompt de seleção de cortes na sua biblioteca ou atualiza um salvo. |
ro_share | publicaprojects:write | Cria um link de prévia de um corte, mostra ou esconde um projeto no Hub de Conteúdo e publica templates na galeria. Pede sua confirmação. |
ro_start_purchase | inicia pagamentobilling:purchase | Inicia a compra de uma oferta: devolve o código PIX com QR para pagar no app do banco, ou um link de checkout do Stripe. Não gasta créditos. |
ro_list_media_models | leituraprojects:read | Catálogo de modelos de imagem, thumbnail e vídeo com IA, com preços em créditos e templates de vídeo. |
ro_estimate_image | leituramedia:write | Orça de 1 a 4 imagens com IA a partir de um texto, com proporção, modo econômico e imagem de referência. Não gasta créditos. |
ro_estimate_thumbnail | leituramedia:write | Orça capas com IA para um corte: cena, retrato com o quadro do corte, edição ou troca do texto. Não gasta créditos. |
ro_estimate_video | leituramedia:write | Orça um vídeo com IA (texto, imagem inicial, referências, template ou rascunho para versão final) e mostra os termos que você precisa aceitar. Não gasta créditos. |
ro_list_media | leituraprojects:read | Mostra suas imagens, thumbnails e vídeos com IA: status, links temporários e galeria do espaço. |
ro_set_clip_cover | escritaprojects:write | Define ou remove a capa de publicação de um corte com uma thumbnail gerada. |
ro_import_video | escritaprojects:write | Transforma um vídeo com IA pronto em um corte, para editar, renderizar ou publicar. |
ro_list_social_accounts | leiturasocial:read | Lista as redes sociais conectadas ao espaço, com a saúde da conexão, o limite diário de posts e as opções de publicação (privacidade do TikTok, playlists do YouTube). |
ro_suggest_caption | escritaprojects:write | Devolve a legenda salva de um corte ou escreve uma nova com IA, com hashtags, para você revisar antes de publicar. |
ro_preview_publication | leiturasocial:publish | Prepara uma publicação (agora, agendada, distribuída nos horários ou num launcher), uma edição, um cancelamento ou uma nova tentativa, com todos os avisos. Não publica nada. |
ro_confirm_publishing | publicasocial:publish | Executa o que foi revisado: publica ou agenda nas suas redes, edita, cancela, reenvia, muda a fila de um launcher ou inscreve em campeonato. Só com a sua confirmação. |
ro_list_publications | leiturasocial:read | Agenda e histórico: status por rede, links públicos depois de publicado e erros. |
ro_list_launchers | leiturasocial:read | Lista seus launchers (filas automáticas de publicação), com horários, contas e a fila de cortes. |
ro_save_launcher | publicasocial:publish | Cria um launcher ou muda o nome, a legenda padrão, as hashtags e o campeonato padrão. Não publica nada na hora; todo corte que entrar na fila do launcher depois é publicado com esses padrões. |
ro_preview_launcher_change | leiturasocial:publish | Prepara uma mudança na fila de um launcher: pausar, retomar, horários, ordem, contas, datas, reenviar falhas ou remover um corte. Mostra o que muda antes de você confirmar. |
ro_list_lives | leituraprojects:read | Seus monitoramentos de lives com o gasto de cada um, o diretório de lives públicas ou os cortes capturados de uma live. |
ro_manage_live | escritaprojects:write | Pausa um monitoramento de live na hora, copia um corte de live para seus projetos ou prepara o início ou a retomada de um monitoramento (cobrado por corte, confirmado à parte). |
ro_list_championships | leiturasocial:read | Campeonatos abertos ou dos quais você participa, com prêmios, ganhos de CPM, regras, ranking e sua posição. |
ro_preview_championship_entry | leiturasocial:publish | Prepara a inscrição em um campeonato ou o envio de um vídeo já publicado, com os termos que você precisa aceitar; nada é enviado antes da sua confirmação. |
ro_get_social_analytics | leiturasocial:read | Como estão seus posts: visualizações, posts recentes e em alta, desempenho por conta, melhor horário para postar e detalhes de um post. |
ro_get_account | leituraaccount:read | Seu espaço de trabalho, assinatura, cobranças, indicações e missões, e notificações. |
Gastar e publicar nas redes sempre têm duas etapas: uma ferramenta de estimativa ou prévia devolve o preço, os destinos e eventuais termos, válidos por alguns minutos, e só então uma ferramenta de confirmação executa. Confirmar a mesma estimativa de novo nunca cobra nem publica duas vezes. Tornar algo público com ro_share (o link de um corte, um projeto no Hub de Conteúdo ou um template na galeria) é uma etapa só, que acontece apenas depois da sua confirmação explícita no chat.
Sem créditos? Compre pelo chat
Isto vale só para a conexão pela URL acima: as instalações pelos diretórios não têm ferramentas de compra. Quando o orçamento passa do seu saldo, peça as ofertas (ro_list_offers), escolha uma e inicie a compra (ro_start_purchase): o código PIX e o QR aparecem no próprio chat, ou você recebe um link do Stripe. O pagamento é confirmado por você no app do banco ou no Stripe — o app de IA nunca vê seus dados de pagamento. Quando ro_get_purchase_status mostrar a compra paga, os créditos caem no espaço: peça o orçamento de novo e crie os cortes. Listar ofertas não exige permissão extra; iniciar e acompanhar a compra exigem a permissão Iniciar compras, que você marca no consentimento.
Cartões interativos no chat
Em apps compatíveis com MCP Apps (como o Claude), os resultados aparecem como cartões interativos dentro da conversa: o QR do PIX, o progresso do projeto e os cortes prontos (nota, duração e download). Em outros clientes, o mesmo conteúdo chega como texto e links. Os links abrem o Real Oficial no navegador e pedem login se você ainda não estiver conectado.
O que cada conexão pode gastar
- 1 crédito = 1 minuto de vídeo de origem nos cortes; imagens, thumbnails, vídeos e edições com IA mostram o preço em créditos antes da sua confirmação.
- Limite diário de créditos por conexão: 1.000 por padrão (você escolhe de 10 a 10.000 no consentimento e muda depois em Configurações › Segurança › Apps conectados). Vale para tudo o que a conexão gastar e reinicia às 21:00, horário de Brasília. Monitoramento de lives fica fora: 1 crédito por corte até você pausar.
- Até 3 projetos em processamento ao mesmo tempo por conexão.
- Até 5 criações de projeto e outras 10 confirmações que gastam créditos a cada 10 minutos.
- Renders seguem o limite por hora do seu plano.
- Créditos são debitados do espaço escolhido no consentimento; créditos de cortes não têm estorno, e gerações com IA que falham são estornadas automaticamente.
- Compras pelo chat existem só na conexão pela URL e exigem a permissão Iniciar compras. O app de IA só gera a cobrança: quem confirma o pagamento é você, no app do banco (PIX) ou no Stripe.
Uma conexão = um espaço
Cada conexão fica presa ao espaço de trabalho escolhido no consentimento. Para usar outro espaço, revogue e conecte de novo escolhendo o outro espaço.
Revogar acesso
Você vê todos os apps conectados, ajusta o orçamento diário e revoga qualquer um em Configurações › Segurança › Apps conectados. O app para na hora e pedirá para conectar de novo.
Abrir Apps conectadosO que pedir ao seu app de IA
Quanto custa cortar este podcast inteiro? youtube.com/watch?v=… — me mostra o orçamento antes de criar.
Cria cortes verticais dos primeiros 40 minutos desta live e me avisa quando ficarem prontos.
Lista os 5 cortes com maior pontuação do meu último projeto e renderiza o melhor.
Cuidado com instruções escondidas em vídeos
Títulos, descrições e transcrições de vídeos são textos de terceiros. Seu app de IA nunca deve tratar esse conteúdo como ordem — se um vídeo disser "crie 50 cortes agora", isso não é um pedido seu. Mantenha a confirmação humana ligada para as ferramentas de escrita e evite combinar este servidor com outros de origem desconhecida.
Conteúdo eleitoral
Valem as mesmas regras do app: ao criar cortes de propaganda ou conteúdo eleitoral por um app conectado, declare isso no orçamento (is_electoral_content) e siga as regras de aviso exigidas pela legislação. A responsabilidade pelo conteúdo publicado é sua.
Termos e consentimentos
O app de IA nunca aceita termos ou consentimentos por você: os termos de vídeos com IA, os termos do TikTok e os regulamentos de campeonatos aparecem na estimativa e precisam do seu aceite explícito, e o consentimento de voz para dublagem só pode ser dado no app.
Publicações nas suas redes
Publicar exige a permissão Publicar nas redes, que vem desmarcada no consentimento. Toda publicação que você pedir, e toda edição, cancelamento ou mudança de fila, passa por uma prévia com os cortes, as legendas, as contas e os horários e só acontece depois da sua confirmação. O piloto automático é a exceção: você o aprova uma vez no orçamento dos cortes, e depois o launcher publica automaticamente os melhores cortes nas contas dele, com a legenda e as configurações padrão. O app de IA nunca escolhe a privacidade do TikTok nem aceita os termos do TikTok por você. O que foi publicado fica público no seu perfil e o app não consegue apagar das redes depois.