Servidor MCP de Ssemble

Servidor MCP para Ssemble AI Clipping: crea vídeos cortos virales desde cualquier asistente de IA.

Funciona con Claude Desktop, Claude Code, Cursor, VS Code, Windsurf y cualquier cliente compatible con MCP.

Qué hace

Este servidor MCP permite a los asistentes de IA crear clips de vídeo cortos a partir de vídeos de YouTube utilizando el motor de clipping de IA de Ssemble. La IA puede:

• Crear shorts a partir de URLs de YouTube o archivos subidos

• Callbacks de Webhook — recibe notificaciones cuando se completa el procesamiento (funciona con n8n, Zapier, Make)

• Explorar recursos — plantillas de subtítulos, música de fondo, superposiciones de gameplay, ganchos de memes

• Seguir el procesamiento — comprueba el progreso y recupera los clips completados

• Gestionar solicitudes — listar historial, obtener resultados, eliminar solicitudes antiguas

Related MCP server: clipwise-mcp

Requisitos previos

• Cuenta de Ssemble con una suscripción activa

• Clave de API (obtenla en Settings → API Keys en el panel de Ssemble)

• Node.js >= 18

Inicio rápido

Claude Desktop

Edita tu archivo de configuración:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ssemble": {
      "command": "npx",
      "args": ["@ssemble/mcp-server"],
      "env": {
        "SSEMBLE_API_KEY": "sk_ssemble_your_key_here"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar.

Claude Code

claude mcp add ssemble -- npx @ssemble/mcp-server

Luego establece la variable de entorno:

export SSEMBLE_API_KEY="sk_ssemble_your_key_here"

Cursor / VS Code / Windsurf

Añade a tus ajustes de MCP:

{
  "mcpServers": {
    "ssemble": {
      "command": "npx",
      "args": ["@ssemble/mcp-server"],
      "env": {
        "SSEMBLE_API_KEY": "sk_ssemble_your_key_here"
      }
    }
  }
}

Herramientas disponibles

Cómo funciona el procesamiento

El procesamiento de vídeo tarda entre 5 y 30 minutos. Hay dos flujos de trabajo disponibles:

Opción A: Polling (comprobación manual)

1. create_short — envía el trabajo y devuelve al instante un ID de solicitud

2. get_status — comprueba el progreso en cualquier momento (queued → processing → completed)

3. get_shorts — recupera los clips generados cuando termine

Opción B: Webhook (automatizado)

1. create_short con webhookUrl — envía el trabajo con una URL de callback

2. Cuando el procesamiento se completa o falla, la API envía un HTTP POST a tu URL con los resultados

3. No se necesita polling — ideal para n8n, Zapier, Make e integraciones de backend personalizadas

Ejemplo de payload de Webhook:

{
  "event": "shorts.completed",
  "requestId": "507f1f77bcf86cd799439011",
  "status": "completed",
  "timestamp": "2026-03-30T12:00:00.000Z",
  "data": {
    "shorts": [
      {
        "id": "...",
        "title": "AI-Generated Title",
        "video_url": "https://...",
        "duration": 45,
        "viral_score": 8.5
      }
    ]
  }
}

Ejemplos de uso

Crear shorts a partir de un vídeo de YouTube:

"Crea shorts a partir de https://youtube.com/watch?v=abc123, usa los primeros 10 minutos con música de fondo relajante"

Explorar recursos disponibles:

"Muéstrame todas las plantillas de subtítulos" / "¿Qué música de fondo hay disponible?"

Comprobar el progreso:

"¿Cuál es el estado de mi solicitud de vídeo?"

Obtener resultados:

"Muéstrame los clips de la solicitud 507f1f77bcf86cd799439011, ordenados por puntuación viral"

Variables de entorno

Desarrollo

git clone https://gitlab.com/vlogr/ssemble-mcp-server.git
cd ssemble-mcp-server
npm install
SSEMBLE_API_KEY=sk_ssemble_your_key npm start

Licencia

MIT