Restream

Conecte o Restream MCP ao Claude ou ChatGPT para criar, agendar, gerenciar e analisar transmissões ao vivo em mais de 30 plataformas.

Documentação

Servidor MCP

Conecte assistentes de IA e agentes a uma conta Restream por meio do Model Context Protocol. O servidor MCP da Restream é um servidor remoto e protegido por OAuth que expõe os recursos de canais, eventos, destinos, gravações, armazenamento, clipes e análises da Restream como ferramentas MCP, permitindo que um cliente MCP leia e opere a conta de um usuário em seu nome.

https://mcp.restream.io/mcp

Como Funciona

  • Transporte: Servidor remoto via HTTP Streamable. Nada é instalado localmente; os clientes se conectam ao endpoint hospedado acima.
  • Autenticação: OAuth 2.1. No primeiro uso, o cliente abre uma janela do navegador para o usuário entrar na Restream e autorizar o acesso. O cliente armazena e renova o token, portanto não há chaves de API de longa duração para gerenciar na configuração.
  • Escopo: O servidor atua estritamente dentro da conta e do plano do usuário autenticado. Ele só pode fazer o que esse usuário já poderia fazer no painel.
  • Relação com a API REST: As ferramentas MCP são uma superfície selecionada e orientada a ações sobre os recursos da Restream. Para endpoints HTTP brutos, registro de aplicativos OAuth, escopos e webhooks, use a documentação da API Restream. O servidor MCP é para fluxos de trabalho de agentes; a API REST é para integrações de aplicativos.

Info

A instalação com um clique nos diretórios de conectores do Claude e do ChatGPT ainda não está disponível. Até lá, adicione o servidor manualmente com o endpoint acima. A configuração é idêntica fora isso.

Pré-requisitos

  • Uma conta Restream. Contas gratuitas podem conectar canais e criar eventos; alguns destinos e limites dependem do plano.
  • Um cliente compatível com MCP que suporte um servidor remoto.

Conectando

Etapa 1: Revise o Modelo de Segurança

Aviso

O servidor MCP pode criar projetos de clipes, criar e reagendar eventos, remover eventos e alternar destinos. Mantenha a confirmação humana habilitada no seu cliente e revise as chamadas de ferramentas de gravação antes de aprová-las.

Etapa 2: Configure Seu Cliente

Todos os clientes apontam para o mesmo endpoint: https://mcp.restream.io/mcp. A primeira chamada de ferramenta aciona o login no navegador via OAuth.

Claude Code

claude mcp add --transport http restream https://mcp.restream.io/mcp
# Then authorize:
/mcp

Claude.ai / Claude Desktop

Configurações -> Conectores -> Adicionar conector personalizado:

  • Nome: Restream
  • URL: https://mcp.restream.io/mcp

ChatGPT

Ative o Modo de desenvolvedor em Configurações -> Segurança e login -> Modo de desenvolvedor. Em seguida, vá para Configurações -> Plugins -> Procurar plugins e clique no ícone + ao lado da barra de pesquisa para criar um conector:

  • Nome: Restream
  • URL do servidor MCP: https://mcp.restream.io/mcp
  • Autenticação: OAuth

Cursor

Adicione o servidor a ~/.cursor/mcp.json para uso global ou .cursor/mcp.json para um projeto:

{
  "mcpServers": {
    "restream": {
      "url": "https://mcp.restream.io/mcp"
    }
  }
}

VS Code com GitHub Copilot

Adicione o servidor a .vscode/mcp.json:

{
  "servers": {
    "restream": {
      "type": "http",
      "url": "https://mcp.restream.io/mcp"
    }
  }
}

Codex

Em Configurações -> Servidores MCP, adicione um servidor HTTP Streamable chamado restream com URL https://mcp.restream.io/mcp.

Clientes somente stdio

Faça a ponte com o shim mcp-remote, que lida com o handshake OAuth:

{
  "mcpServers": {
    "restream": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.restream.io/mcp"]
    }
  }
}

Info

As interfaces dos clientes mudam com frequência. Se um rótulo de menu for diferente das etapas acima, consulte a documentação MCP do seu cliente.

Etapa 3: Verifique

Pergunte ao assistente: "Liste meus canais Restream conectados." Ele deve solicitar permissão para chamar as ferramentas Restream e retornar seus canais por platform e displayName. Se você os vir, está conectado.

Autenticação e Autorização

  • O servidor implementa OAuth 2.1; seu cliente MCP executa o fluxo de código de autorização no navegador e gerencia a renovação do token.
  • O acesso está vinculado ao usuário conectado. Não há caminho separado de chave de API ou token de portador para o servidor MCP. A autenticação é somente OAuth.
  • Por segurança, o servidor MCP deliberadamente não irá:
    • aceitar senhas, incluindo logins de conta ou canal;
    • aceitar credenciais RTMP/SRT para adicionar canais personalizados;
    • retornar chaves de transmissão ou outros IDs internos.

Execute essas ações no painel ou via API REST.

Referência de Ferramentas

O servidor expõe 26 ferramentas em seis áreas. As ferramentas são marcadas como leitura para sem efeitos colaterais ou gravação para ações que alteram o estado da conta. Seu cliente deve confirmar antes de executar ferramentas de gravação.

Conta e Canais

get_current_user - leitura

Retorna o perfil do usuário autenticado e o contexto do espaço de trabalho.

list_channels - leitura

Lista os canais conectados à conta.

check_channel_api_access - leitura

Verifica cada canal conectado quanto a problemas de acesso à API da plataforma e retorna etapas de correção voltadas ao usuário para qualquer um que precise de atenção.

Eventos

list_user_events - leitura

Encontra eventos em todos os estados do ciclo de vida.

get_event - leitura

Retorna um evento, incluindo seus destinos ativos.

create_event - gravação

Cria um evento Restream a partir da fonte escolhida pelo usuário, como Studio, codificador, vídeo enviado ou gravação salva.

edit_event - gravação

Atualiza detalhes do evento, como título e descrição.

reschedule_event - gravação

Agenda um evento rascunho ou move um evento agendado.

unschedule_event - gravação

Remove o horário de início, transformando o evento novamente em rascunho. A exclusão externa na plataforma permanece desativada.

remove_event - gravação

Remove o evento da conta Restream. Afeta apenas o estado da Restream; nunca exclui ou modifica transmissões ou publicações em plataformas externas.

set_event_loop_count - gravação

Define quantas vezes um evento baseado em arquivo ou gravação repete a reprodução.

enable_event_external_scheduled_broadcasts - gravação

Habilita a criação e sincronização de transmissões agendadas em plataformas externas compatíveis para um evento já agendado. Isso não pode ser desativado por meio do MCP.

Destinos

list_event_destinations - leitura

Lista os destinos ativos em um evento.

check_event_channels_activation - leitura

Valida se o plano do usuário permite que os canais selecionados fiquem ativos simultaneamente e explica quaisquer limites do plano.

toggle_event_channel_on - gravação

Conecta um canal como destino do evento.

toggle_event_channel_off - gravação

Desconecta um destino de um evento. Afeta apenas a Restream; nada é alterado na plataforma.

edit_event_destination - gravação

Atualiza configurações específicas da plataforma em um destino existente.

Gravações e Armazenamento

list_user_recordings - leitura

Lista gravações agrupadas por gravação, com nomes de arquivos.

get_recording_download_url - leitura

Retorna um link de download temporário para um arquivo de gravação.

list_user_storage_files - leitura

Lista arquivos de armazenamento de vídeo.

Clipes

list_user_clips_projects - leitura

Lista projetos de clipes para a conta autenticada, com opções de paginação e classificação.

get_user_clips_project_details - leitura

Retorna clipes e informações de clipes publicados para um projeto de clipes.

create_user_clips_project - gravação

Cria um projeto de clipes a partir de uma fonte compatível. Atualmente, use fontes VideoStorageFile descobertas com list_user_storage_files.

create_user_clip_download - leitura

Cria uma URL de download temporária para um clipe. Descubra IDs de clipes com get_user_clips_project_details antes de solicitar um download.

Análises

get_event_analytics_viewers - leitura

Retorna análises de espectadores para um evento, com totais e valores por canal.

get_event_analytics_messages - leitura

Retorna análises de mensagens de chat para um evento, com totais e valores por canal.

Fluxos de Trabalho Comuns

Ir ao vivo para várias plataformas

Escolha destinos conectados, verifique os limites do plano e prepare um evento Restream para as plataformas selecionadas.

Agendar com transmissões externas

Crie ou atualize um evento agendado e sincronize os detalhes da transmissão com plataformas compatíveis.

Evento baseado em arquivo ou gravação

Crie um evento a partir de mídia armazenada ou uma gravação salva, com comportamento de repetição opcional.

Análises pós-transmissão

Revise a atividade de espectadores e chat após uma transmissão.

Baixar uma gravação

Encontre uma gravação e forneça acesso temporário de download.

Gerar e baixar clipes

Encontre um arquivo de armazenamento de vídeo, crie um projeto de clipes, revise os clipes gerados e o status de publicação e, em seguida, forneça uma URL de download temporária para o clipe selecionado.

Segurança

Conectar um LLM a uma conta que pode criar projetos de clipes, criar e remover eventos e atualizar destinos traz os riscos usuais de agentes. Práticas recomendadas:

  • Princípio de mesmo acesso: O servidor MCP opera como o usuário conectado. Conceda-o apenas a pessoas que já deveriam ter esse acesso.
  • Mantenha a confirmação humana ativada: A maioria dos clientes solicita confirmação antes de cada chamada de ferramenta. Deixe isso habilitado e revise as chamadas de ferramentas de gravação antes de aprová-las.
  • Injeção de prompt: Se um agente processar conteúdo não confiável, como uma página da web, mensagem de chat ou arquivo, e esse conteúdo contiver instruções, o agente pode tentar agir com base nelas. Revise as ações planejadas antes de aprovar e não aprove automaticamente ferramentas de gravação quando houver entrada não confiável no contexto.
  • Remover destinos não é destrutivo externamente: toggle_event_channel_off e remove_event apenas alteram o estado da Restream; eles nunca excluem ou modificam nada nas plataformas de destino.
  • Verifique o endpoint: Conecte-se apenas ao https://mcp.restream.io/mcp oficial.
  • Limite de credenciais: O servidor nunca aceita senhas ou credenciais RTMP/SRT e nunca retorna chaves de transmissão. Lide com isso no painel ou na API REST.

Limitações

  • Sem entrada de senha, credenciais RTMP/SRT ou recuperação de chave de transmissão.
  • Ainda não listado nos diretórios de conectores do Claude ou do ChatGPT. Adicione o servidor manualmente com o endpoint acima. As listagens de diretórios estão chegando em breve.