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.
Usa 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.
13 ferramentas: uma gasta créditos, uma inicia um pagamento
Leitura nunca custa nada. Criar cortes, renderizar e iniciar compras são as únicas ações de escrita — e o app de IA pede sua confirmação antes.
| 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:read | Lê um vídeo do YouTube ou VOD da Twitch e devolve um orçamento: duração, créditos necessários, cortes estimados e avisos. |
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 no servidor (até 25 s) 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_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. Gasta créditos. |
ro_render_clip | escritarenders:write | Renderiza um corte em vídeo final para download. |
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. |
Criar cortes passa sempre por duas etapas: ro_estimate_clips devolve um orçamento (minutos, créditos, cortes estimados) válido por 5 minutos e só então ro_create_clips confirma. O débito de créditos não tem estorno.
Sem créditos? Compre pelo chat
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, marcada 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. Se você marcar a permissão Abrir o app já conectado no consentimento, os links abrem o Real Oficial sem login de novo por 15 minutos; depois disso, ou sem a permissão, eles abrem a tela de login normal.
O que cada conexão pode gastar
- 1 crédito = 1 minuto de vídeo de origem. O trecho escolhido é arredondado para cima.
- Orçamento diário por conexão: 300 minutos por padrão (você escolhe de 10 a 1440 no consentimento e muda depois em Configurações › Apps conectados). O limite reinicia às 21:00, horário de Brasília.
- Até 3 projetos em processamento ao mesmo tempo por conexão.
- Até 5 criações de projeto a cada 10 minutos.
- Renders seguem o limite por hora do seu plano.
- Créditos são debitados do espaço escolhido no consentimento e não têm estorno.
- Compras pelo chat 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 › 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.