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_offeremove_eventapenas 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/mcpoficial. - 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.