Restream

Conecta Restream MCP con Claude o ChatGPT para crear, programar, gestionar y analizar transmisiones en vivo en más de 30 plataformas.

Documentación

Servidor MCP

Conecta asistentes y agentes de IA a una cuenta de Restream a través del Model Context Protocol. El servidor MCP de Restream es un servidor remoto protegido con OAuth que expone las capacidades de canales, eventos, destinos, grabaciones, almacenamiento, clips y analíticas de Restream como herramientas MCP, de modo que un cliente MCP pueda leer y operar la cuenta de un usuario en su nombre.

https://mcp.restream.io/mcp

Cómo Funciona

  • Transporte: Servidor remoto sobre HTTP Streamable. No se instala nada localmente; los clientes se conectan al endpoint alojado indicado arriba.
  • Autenticación: OAuth 2.1. En el primer uso, el cliente abre una ventana del navegador para que el usuario inicie sesión en Restream y autorice el acceso. El cliente almacena y renueva el token, por lo que no hay claves API de larga duración que gestionar en la configuración.
  • Alcance: El servidor actúa estrictamente dentro de la cuenta y el plan del usuario autenticado. Solo puede hacer lo que ese usuario ya podría hacer en el panel de control.
  • Relación con la API REST: Las herramientas MCP son una superficie seleccionada y orientada a acciones sobre las capacidades de Restream. Para endpoints HTTP sin procesar, registro de aplicaciones OAuth, alcances y webhooks, consulta la documentación de la API de Restream. El servidor MCP es para flujos de trabajo de agentes; la API REST es para integraciones de aplicaciones.

Información

La instalación con un solo clic desde los directorios de conectores de Claude y ChatGPT aún no está disponible. Hasta entonces, añade el servidor manualmente con el endpoint indicado arriba. La configuración es idéntica por lo demás.

Requisitos Previos

  • Una cuenta de Restream. Las cuentas gratuitas pueden conectar canales y crear eventos; algunos destinos y límites dependen del plan.
  • Un cliente compatible con MCP que admita un servidor remoto.

Conexión

Paso 1: Revisa el Modelo de Seguridad

Advertencia

El servidor MCP puede crear proyectos de clips, crear y reprogramar eventos, eliminar eventos y alternar destinos. Mantén la confirmación humana habilitada en tu cliente y revisa las llamadas a herramientas de escritura antes de aprobarlas.

Paso 2: Configura tu Cliente

Todos los clientes apuntan al mismo endpoint: https://mcp.restream.io/mcp. La primera llamada a una herramienta activa el inicio de sesión OAuth en el navegador.

Claude Code

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

Claude.ai / Claude Desktop

Configuración -> Conectores -> Añadir conector personalizado:

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

ChatGPT

Habilita el modo Desarrollador en Configuración -> Seguridad e inicio de sesión -> Modo Desarrollador. Luego ve a Configuración -> Plugins -> Explorar plugins y haz clic en el icono + junto a la barra de búsqueda para crear un conector:

  • Nombre: Restream
  • URL del servidor MCP: https://mcp.restream.io/mcp
  • Autenticación: OAuth

Cursor

Añade el servidor a ~/.cursor/mcp.json para uso global o a .cursor/mcp.json para un proyecto:

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

VS Code con GitHub Copilot

Añade el servidor a .vscode/mcp.json:

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

Codex

En Configuración -> Servidores MCP, añade un servidor HTTP Streamable llamado restream con la URL https://mcp.restream.io/mcp.

Clientes solo stdio

Conecta con el shim mcp-remote, que gestiona el protocolo de enlace OAuth:

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

Información

Las interfaces de usuario de los clientes cambian con frecuencia. Si una etiqueta de menú difiere de los pasos anteriores, consulta la documentación MCP de tu cliente.

Paso 3: Verifica

Pregunta al asistente: "Lista mis canales de Restream conectados". Debería solicitar permiso para llamar a las herramientas de Restream y devolver tus canales por platform y displayName. Si los ves, estás conectado.

Autenticación y Autorización

  • El servidor implementa OAuth 2.1; tu cliente MCP realiza el flujo de código de autorización en el navegador y gestiona la renovación del token.
  • El acceso está vinculado al usuario que ha iniciado sesión. No hay una ruta separada de clave API o token de portador para el servidor MCP. La autenticación es solo OAuth.
  • Por seguridad, el servidor MCP deliberadamente no:
    • acepta contraseñas, incluidos inicios de sesión de cuentas o canales;
    • acepta credenciales RTMP/SRT para añadir canales personalizados;
    • devuelve claves de transmisión u otros ID internos.

Realiza esas acciones en el panel de control o mediante la API REST.

Referencia de Herramientas

El servidor expone 26 herramientas en seis áreas. Las herramientas están etiquetadas como lectura si no tienen efectos secundarios o escritura si son acciones que modifican el estado de la cuenta. Tu cliente debe confirmar antes de ejecutar herramientas de escritura.

Cuenta y Canales

get_current_user - lectura

Devuelve el perfil del usuario autenticado y el contexto del espacio de trabajo.

list_channels - lectura

Lista los canales conectados a la cuenta.

check_channel_api_access - lectura

Comprueba cada canal conectado en busca de problemas de acceso a la API de la plataforma y devuelve pasos de corrección orientados al usuario para los que necesiten atención.

Eventos

list_user_events - lectura

Encuentra eventos en todos sus estados de ciclo de vida.

get_event - lectura

Devuelve un evento, incluidos sus destinos activos.

create_event - escritura

Crea un evento de Restream a partir de la fuente elegida por el usuario, como Studio, codificador, video subido o grabación guardada.

edit_event - escritura

Actualiza detalles del evento, como título y descripción.

reschedule_event - escritura

Programa un evento en borrador o mueve uno ya programado.

unschedule_event - escritura

Elimina la hora de inicio, convirtiendo el evento de nuevo en borrador. La eliminación en plataformas externas permanece deshabilitada.

remove_event - escritura

Elimina el evento de la cuenta de Restream. Solo afecta al estado de Restream; nunca elimina ni modifica transmisiones o publicaciones en plataformas externas.

set_event_loop_count - escritura

Establece cuántas veces un evento respaldado por archivo o grabación repite la reproducción.

enable_event_external_scheduled_broadcasts - escritura

Habilita la creación y sincronización de transmisiones programadas en plataformas externas compatibles para un evento ya programado. Esto no se puede deshabilitar a través de MCP.

Destinos

list_event_destinations - lectura

Lista los destinos activos en un evento.

check_event_channels_activation - lectura

Valida que el plan del usuario permita que los canales seleccionados estén activos simultáneamente y explica cualquier límite del plan.

toggle_event_channel_on - escritura

Conecta un canal como destino del evento.

toggle_event_channel_off - escritura

Desconecta un destino de un evento. Solo afecta a Restream; no se cambia nada en la plataforma.

edit_event_destination - escritura

Actualiza la configuración específica de la plataforma en un destino existente.

Grabaciones y Almacenamiento

list_user_recordings - lectura

Lista grabaciones agrupadas por grabación, con nombres de archivo.

get_recording_download_url - lectura

Devuelve un enlace de descarga temporal para un archivo de grabación.

list_user_storage_files - lectura

Lista archivos de almacenamiento de video.

Clips

list_user_clips_projects - lectura

Lista proyectos de clips para la cuenta autenticada, con opciones de paginación y ordenación.

get_user_clips_project_details - lectura

Devuelve clips e información de clips publicados para un proyecto de clips.

create_user_clips_project - escritura

Crea un proyecto de clips a partir de una fuente compatible. Actualmente, usa fuentes VideoStorageFile descubiertas con list_user_storage_files.

create_user_clip_download - lectura

Crea una URL de descarga temporal para un clip. Descubre los ID de clips con get_user_clips_project_details antes de solicitar una descarga.

Analíticas

get_event_analytics_viewers - lectura

Devuelve analíticas de espectadores para un evento, con totales y valores por canal.

get_event_analytics_messages - lectura

Devuelve analíticas de mensajes de chat para un evento, con totales y valores por canal.

Flujos de Trabajo Comunes

Transmitir en vivo a múltiples plataformas

Elige destinos conectados, verifica los límites del plan y prepara un evento de Restream para las plataformas seleccionadas.

Programar con transmisiones externas

Crea o actualiza un evento programado y sincroniza los detalles de transmisión con las plataformas compatibles.

Evento respaldado por archivo o grabación

Crea un evento desde medios almacenados o una grabación guardada, con comportamiento de repetición opcional.

Analíticas posteriores a la transmisión

Revisa la actividad de espectadores y chat después de una transmisión.

Descargar una grabación

Encuentra una grabación y proporciona acceso de descarga temporal.

Generar y descargar clips

Encuentra un archivo de almacenamiento de video, crea un proyecto de clips, revisa los clips generados y su estado de publicación, y luego proporciona una URL de descarga temporal para el clip seleccionado.

Seguridad

Conectar un LLM a una cuenta que puede crear proyectos de clips, crear y eliminar eventos, y actualizar destinos conlleva los riesgos habituales de los agentes. Prácticas recomendadas:

  • Principio de mismo acceso: El servidor MCP opera como el usuario que ha iniciado sesión. Concédelo solo a personas que ya deberían tener ese acceso.
  • Mantén la confirmación humana activada: La mayoría de los clientes solicitan confirmación antes de cada llamada a una herramienta. Déjala habilitada y revisa las llamadas a herramientas de escritura antes de aprobarlas.
  • Inyección de prompts: Si un agente procesa contenido no confiable, como una página web, un mensaje de chat o un archivo, y ese contenido contiene instrucciones, el agente podría intentar actuar sobre ellas. Revisa las acciones planificadas antes de aprobar y no apruebes automáticamente herramientas de escritura cuando haya entrada no confiable en contexto.
  • Eliminar destinos no es destructivo externamente: toggle_event_channel_off y remove_event solo cambian el estado de Restream; nunca eliminan ni modifican nada en las plataformas de destino.
  • Verifica el endpoint: Solo conéctate al https://mcp.restream.io/mcp oficial.
  • Límite de credenciales: El servidor nunca acepta contraseñas ni credenciales RTMP/SRT y nunca devuelve claves de transmisión. Gestiona esas en el panel de control o en la API REST.

Limitaciones

  • Sin entrada de contraseñas, credenciales RTMP/SRT ni recuperación de claves de transmisión.
  • Aún no aparece en los directorios de conectores de Claude o ChatGPT. Añade el servidor manualmente con el endpoint indicado arriba. Los listados en directorios llegarán pronto.