MCP

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.

https://api.realoficial.com.br/mcp

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
Conectar

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.

  1. 01

    No Claude (web, Desktop ou celular), abra Personalizar › Conectores e clique em + Adicionar conector personalizado.

  2. 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
  3. 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.

Deu problema? Se o botão Conectar falha ou as ferramentas somem, remova o conector e adicione de novo. O Claude guarda os dados de descoberta por cerca de 5 minutos — espere e tente outra vez.

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.

Ferramentas

9 ferramentas, duas de escrita, uma gasta créditos

Leitura nunca custa nada. Criar cortes e renderizar são as únicas ações de escrita — e o app de IA pede sua confirmação antes.

FerramentaPermissãoO que faz
ro_whoamileituraaccount:readSeu nome, espaço ativo, plano, saldo de créditos e os limites desta conexão.
ro_estimate_clipsleituraprojects:readLê 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_projectsleituraprojects:readLista seus projetos de cortes com status, busca e paginação.
ro_get_projectleituraprojects:readDetalhes e progresso de um projeto, com quando voltar a consultar.
ro_list_clipsleituraprojects:readLista os cortes de um projeto, com pontuação de viralidade e miniaturas.
ro_get_clipleituraprojects:readDetalhes de um corte, motivo da seleção e renders disponíveis.
ro_list_rendersleituraprojects:readLista os renders do espaço, com links de download.
ro_create_clipsescritaprojects:writeCria o projeto de cortes a partir de um orçamento confirmado. Gasta créditos.
ro_render_clipescritarenders:writeRenderiza um corte em vídeo final para download.

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.

Créditos e limites

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.

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 conectados
Exemplos

O 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.