Ssemble MCP Server

MCP-Server für Ssemble AI Clipping — erstellen Sie virale Kurzvideos mit jedem KI-Assistenten.

Funktioniert mit Claude Desktop, Claude Code, Cursor, VS Code, Windsurf und jedem MCP-kompatiblen Client.

Was er kann

Dieser MCP-Server ermöglicht es KI-Assistenten, mithilfe der KI-Clipping-Engine von Ssemble Kurzvideos aus YouTube-Videos zu erstellen. Die KI kann:

• Shorts erstellen aus YouTube-URLs oder hochgeladenen Dateien

• Webhook-Callbacks — Benachrichtigungen erhalten, wenn die Verarbeitung abgeschlossen ist (funktioniert mit n8n, Zapier, Make)

• Assets durchsuchen — Untertitelvorlagen, Hintergrundmusik, Gameplay-Overlays, Meme-Hooks

• Verarbeitung verfolgen — Fortschritt prüfen und fertige Clips abrufen

• Anfragen verwalten — Verlauf auflisten, Ergebnisse abrufen, alte Anfragen löschen

Related MCP server: clipwise-mcp

Voraussetzungen

• Ssemble-Konto mit einem aktiven Abonnement

• API-Schlüssel (erhältlich unter Einstellungen → API-Schlüssel im Ssemble-Dashboard)

• Node.js >= 18

Schnellstart

Claude Desktop

Bearbeiten Sie Ihre Konfigurationsdatei:

• 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"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern neu.

Claude Code

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

Setzen Sie dann die Umgebungsvariable:

export SSEMBLE_API_KEY="sk_ssemble_your_key_here"

Cursor / VS Code / Windsurf

Fügen Sie dies zu Ihren MCP-Einstellungen hinzu:

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

Verfügbare Tools

Funktionsweise der Verarbeitung

Die Videoverarbeitung dauert 5-30 Minuten. Es stehen zwei Workflows zur Verfügung:

Option A: Polling (manuelle Überprüfung)

1. create_short — übermittelt den Auftrag und gibt sofort eine Anfragen-ID zurück

2. get_status — jederzeit den Fortschritt prüfen (in der Warteschlange → in Bearbeitung → abgeschlossen)

3. get_shorts — die generierten Clips abrufen, wenn sie fertig sind

Option B: Webhook (automatisiert)

1. create_short mit webhookUrl — übermittelt den Auftrag mit einer Callback-URL

2. Wenn die Verarbeitung abgeschlossen ist oder fehlschlägt, sendet die API einen HTTP-POST mit den Ergebnissen an Ihre URL

3. Kein Polling erforderlich — ideal für n8n, Zapier, Make und benutzerdefinierte Backend-Integrationen

Beispiel für Webhook-Payload:

{
  "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
      }
    ]
  }
}

Anwendungsbeispiele

Shorts aus einem YouTube-Video erstellen:

"Erstelle Shorts aus https://youtube.com/watch?v=abc123, verwende die ersten 10 Minuten mit chilliger Hintergrundmusik"

Verfügbare Assets durchsuchen:

"Zeige mir alle Untertitelvorlagen" / "Welche Hintergrundmusik ist verfügbar?"

Fortschritt prüfen:

"Was ist der Status meiner Videoanfrage?"

Ergebnisse abrufen:

"Zeige mir die Clips für die Anfrage 507f1f77bcf86cd799439011, sortiert nach Viralitäts-Score"

Umgebungsvariablen

Entwicklung

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

Lizenz

MIT