MCP-Einrichtungsleitfaden · Aktualisiert für 2026

So richtest du einen MCP-Server für einen Musikvideogenerator ein (Schritt für Schritt)

Der MCP-Server des freebeat-Musikvideogenerators verbindet einen MCP-kompatiblen Assistenten mit Musikvideotools. So kannst du einen Track vorbereiten und in deinem Chat-Workflow ein generiertes Video anfordern. Diese Anleitung führt durch die dokumentierte Einrichtung für Claude Desktop und Cursor – vom Abrufen eines API-Schlüssels bis zur Überprüfung einer abgeschlossenen Aufgabe. Sie richtet sich an Kreative und Entwickler, die Musikvideoanfragen praktisch und wiederholbar automatisieren möchten. Das Wichtigste: Führe das Paket mit npx aus, füge die Serverkonfiguration und den API-Schlüssel in deinem Client hinzu, lade anschließend Audio hoch und frage den Aufgabenstatus so lange ab, bis der Vorgang abgeschlossen ist.

t

Kreativprofi und Projektleiter mit Spezialisierung auf den Einsatz generativer KI für die Erstellung synchronisierter audiovisueller Inhalte bei Freebeat.ai

Was ist ein MCP-Server für einen Musikvideogenerator? (Kurz erklärt)

Ein MCP-Server für einen Musikvideogenerator ist eine Verbindungskomponente, über die ein MCP-kompatibler KI-Client in einer Unterhaltung die Tools eines Musikvideodienstes aufrufen kann. Der freebeat-Server stellt Workflows wie das Hochladen von Audio, das optionale Hochladen eines Referenzbilds, die Videogenerierung und die Überprüfung des Aufgabenstatus bereit. Damit können Kreative rhythmusbewusste Videogenerierungen anfordern, ohne jede Anweisung manuell zwischen verschiedenen Oberflächen übertragen zu müssen. Der Server ist auf die Onlinedienste von freebeat angewiesen.

Was der freebeat-MCP für Musikvideogenerierung kann

Informiere dich über den Workflow und seine Grenzen, bevor du deinen Client konfigurierst.

Chat mit Musikvideotools verbinden

Das freebeat-MCP-Paket stellt kompatiblen Clients dokumentierte Videogenerierungstools zur Verfügung, darunter Claude Desktop und Cursor. Auf der Produktseite werden außerdem Windsurf und Claude Code aufgeführt. Bei einem umfassenderen MCP-Workflow für Musikvideos solltest du dich an den offiziellen Einrichtungsdetails orientieren, da sich die Client-Menüs unterscheiden können.

freebeat-MCP-Dokumentation lesen

Visuals aus einem Song erstellen

Lade eine Audiodatei hoch oder gib eine unterstützte URL einer Musikplattform an. Verwende anschließend die zurückgegebene Musik-ID, um eine Generierungsaufgabe zu starten. Der musikbasierte Workflow ist auf eine beat-synchronisierte Videogenerierung ausgelegt, die auf Tempo, Energie und musikalische Steigerungen reagiert.

Erscheinungsbild mit Referenzbildern vorgeben

Über den MCP lassen sich ein oder zwei Referenzbilder hochladen; anschließend werden Bild-URLs zurückgegeben. Übermittle diese URLs in der Generierungsanfrage, wenn du das visuelle Erscheinungsbild vorgeben oder ein Gesicht im Video beibehalten möchtest. Referenzen beeinflussen die Ergebnisse, garantieren aber nicht, dass jede Szene identisch ausfällt.

Bei Workflows mit Steuerung über Referenzbilder solltest du Motiv, Stil und Szene in den Prompts präzise beschreiben.

Format auswählen und Ergebnis abrufen

Zu den Generierungseinstellungen gehört ein Seitenverhältnis, dessen dokumentierter Standardwert 16:9 ist. Die Auflösung hat standardmäßig den Wert 720. Eine abgeschlossene Musikvideoaufgabe liefert eine Video-URL und eine Cover-URL zurück. Für vertikale Musikvideo-Exporte kannst du ein vertikales Seitenverhältnis festlegen oder für YouTube ein Breitbildformat anfordern.

Produktkontext ansehen

Dieser bereitgestellte Screenshot der Freebeat-Oberfläche zeigt die Musikvideoerstellung. Wähle ihn aus, um ihn zu vergrößern; das Bild behält sein ursprüngliches Seitenverhältnis bei.

Kurzantwort (zuerst erledigen)

  • Erstelle ein kostenloses freebeat-Konto und kopiere den API-Schlüssel aus deinem Profil.
  • Vergewissere dich, dass Node.js und npx in der Umgebung verfügbar sind, in der dein MCP-Client ausgeführt wird.
  • Füge einen Server namens freebeat mit dem Befehl npx, dem Argument -y freebeat-mcp und der Umgebungsvariable FREEBEAT_API_KEY hinzu.
  • Starte den Client neu oder lade ihn erneut, damit er den konfigurierten MCP-Server startet.
  • Rufe upload_audio mit genau einer Eingabe auf: einem lokalen Dateipfad oder einer unterstützten URL.
  • Lade optional ein oder zwei Referenzbilder hoch und verwende dann die zurückgegebene Musik-ID in generate_music_video.
  • Frage get_task_status regelmäßig ab. Rufe get_task_result erst auf, wenn der Status „completed“ lautet.

Voraussetzungen (was du brauchst)

  • Ein kostenloses freebeat-Konto und ein API-Schlüssel aus deinem Profil.
  • Einen MCP-kompatiblen Client, zum Beispiel Claude Desktop oder Cursor.
  • Node.js mit npx, das für den Clientprozess verfügbar ist.
  • Die Berechtigung, die MCP-Serverkonfiguration des Clients zu bearbeiten und den Client neu zu starten.
  • Eine lokale Audiodatei oder eine URL aus einer unterstützten Quelle: SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio oder Riffusion.
  • Optional: ein oder zwei Referenzbilder, wenn du die visuelle Ausrichtung des Videos vorgeben möchtest.

Schritt für Schritt: MCP-Server für einen Musikvideogenerator einrichten

  1. Schritt 1: Deinen freebeat-API-Schlüssel abrufen

    Vorgehensweise: Melde dich bei deinem freebeat-Konto an, öffne dein Profil und kopiere den API-Schlüssel. Behandle ihn wie ein Passwort: Füge ihn nicht in öffentliche Prompts oder Screenshots ein und speichere ihn nicht in der Versionsverwaltung.

    Das erkennst du am Erfolg: Der Schlüssel liegt bereit, damit du ihn in die privaten MCP-Umgebungseinstellungen des Clients eintragen kannst.

    ⚠️ Häufiger Fehler, den du vermeiden solltest: Trage nicht den wörtlichen Beispieltext your-api-key-here in die Konfiguration ein und erwarte, dass die Authentifizierung funktioniert.

  2. Schritt 2: Server mit npx starten

    Vorgehensweise: Der dokumentierte Startbefehl lautet:

    npx -y freebeat-mcp

    Die nachfolgende Clientkonfiguration startet das Paket normalerweise für dich. Eine separate globale Installation ist daher nicht erforderlich. Verwende diesen Befehl, um zu überprüfen, ob das Paket in deiner Umgebung ausgeführt werden kann.

    Das erkennst du am Erfolg: Der Befehl lässt sich mit der verfügbaren Node.js-Installation und dem npm-Paketzugriff ausführen.

    ⚠️ Häufiger Fehler, den du vermeiden solltest: Wenn du den Befehl in einer anderen Umgebung als der des Desktop-Clients ausführst, bleiben mögliche Pfad- oder Berechtigungsprobleme möglicherweise unentdeckt.

  3. Schritt 3: MCP-Serverkonfiguration hinzufügen

    Vorgehensweise: Öffne die MCP-Servereinstellungen deines Clients und füge diese Konfiguration hinzu. Für Claude Desktop und Cursor sind in der Dokumentation derselbe Befehl, dieselben Argumente und dieselbe Umgebungsvariable angegeben:

    {
      "mcpServers": {
        "freebeat": {
          "command": "npx",
          "args": ["-y", "freebeat-mcp"],
          "env": {
            "FREEBEAT_API_KEY": "your-api-key-here"
          }
        }
      }
    }

    Ersetze den Beispielwert durch deinen Schlüssel. Achte auf gültige JSON-Syntax und speichere die Konfiguration an dem Ort, an dem der Client seine MCP-Servereinstellungen erwartet.

    Das erkennst du am Erfolg: Die Clientkonfiguration enthält einen Servereintrag namens freebeat, für den FREEBEAT_API_KEY festgelegt ist.

    ⚠️ Häufiger Fehler, den du vermeiden solltest: Vermeide überflüssige Kommas und falsch geschriebene Namen von Umgebungsvariablen. Beides kann verhindern, dass der Server startet oder sich authentifiziert.

  4. Schritt 4: Client neu starten und Verbindung überprüfen

    Vorgehensweise: Speichere deine Einstellungen, starte den MCP-Client vollständig neu oder lade ihn erneut und überprüfe, ob der freebeat-Server als verfügbar angezeigt wird. Bezeichnungen und Diagnosefunktionen können je nach Client variieren. Sieh daher in den MCP-Einstellungen des jeweiligen Clients nach, wenn der Server nicht aufgeführt ist.

    Das erkennst du am Erfolg: Dein Assistent kann auf die freebeat-Tools zugreifen, einschließlich des Audio-Uploads und des Aufgaben-Workflows.

    ⚠️ Häufiger Fehler, den du vermeiden solltest: Wenn du die Konfiguration bearbeitest, ohne den Client neu zu starten, verwendet er möglicherweise weiterhin die alten Einstellungen.

  5. Schritt 5: Song und optionale Referenzbilder hochladen

    Vorgehensweise: Bitte den Assistenten, upload_audio entweder mit file_path oder mit url aufzurufen – genau eine der beiden Optionen. Zu den in der Dokumentation aufgeführten unterstützten URL-Quellen gehören SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio und Riffusion. Speichere die zurückgegebene music_id. Optional kannst du upload_image mit einem oder zwei Bildern aufrufen und die zurückgegebenen Bild-URLs speichern.

    Beschreibe das gewünschte Ergebnis in deinem Generierungs-Prompt klar, wenn der Track für Musik-zu-Tanz-Videos oder die Erstellung von Lyric-Videos gedacht ist.

    Das erkennst du am Erfolg: Der Audio-Upload gibt eine Musik-ID zurück, die du an ein Generierungstool übergeben kannst.

    ⚠️ Häufiger Fehler, den du vermeiden solltest: Übermittle bei einem Audio-Upload-Aufruf nicht gleichzeitig einen Dateipfad und eine URL.

  6. Schritt 6: Video generieren und fertiges Ergebnis abrufen

    Vorgehensweise: Rufe generate_music_video mit der Musik-ID und einem Prompt mit 1 bis 2.000 Zeichen auf, wobei Leerzeichen am Anfang und Ende entfernt werden. Du kannst Videotyp, Stil, Seitenverhältnis, Auflösung, Wasserzeichenoption, Start- und Endzeit sowie Referenzbild-URLs festlegen. Die dokumentierten Standardwerte sind abstract für den Videotyp, 16:9 für das Seitenverhältnis und 720 für die Auflösung. Zum Beispiel: „Erstelle ein Cyberpunk-Musikvideo im Format 9:16 für diesen Track.“

    Die Generierung läuft asynchron. Speichere die zurückgegebene Aufgaben-ID und frage den Status mit get_task_status ab. Rufe get_task_result erst auf, nachdem die Aufgabe abgeschlossen ist. Das Ergebnis eines fertigen Musikvideos enthält video_url und cover_url.

    Das erkennst du am Erfolg: Der Status wechselt zu „completed“ und das Ergebnis enthält eine Video-URL sowie eine Cover-URL.

    ⚠️ Häufiger Fehler, den du vermeiden solltest: Wenn du get_task_result vor Abschluss der Aufgabe aufrufst, erhältst du TASK_NOT_COMPLETED.

Der Server dokumentiert außerdem das Auffinden und Generieren von Effekten, die Suche nach Modellen, die Bildgenerierung und -bearbeitung sowie die Text-zu-Video-Generierung. Diese Tools können sich bei der Rückgabe von Aufgabenergebnissen anders verhalten. Bei Open-RPC-Bild- und Videobatches werden abgeschlossene Ergebnisse direkt in get_task_status angezeigt.

Checkliste zur Überprüfung (sicherstellen, dass alles funktioniert)

  • ☐ In den MCP-Einstellungen des Clients ist ein Server namens freebeat eingetragen.
  • ☐ Der Serverbefehl lautet npx und die Argumente sind -y und freebeat-mcp.
  • ☐ Der Name der Umgebungsvariable lautet exakt FREEBEAT_API_KEY.
  • ☐ Der Client wurde nach dem Speichern der Konfiguration neu gestartet oder erneut geladen.
  • ☐ Der Assistent kann die freebeat-MCP-Tools aufrufen.
  • ☐ Der Audio-Upload funktioniert mit genau einer Quelle und gibt eine Musik-ID zurück.
  • ☐ Die Videogenerierung gibt eine Aufgaben-ID und einen Status zurück.
  • ☐ Die Statusabfrage meldet „completed“, bevor das Ergebnis abgerufen wird.
  • ☐ Das fertige Musikvideoergebnis enthält sowohl eine Video-URL als auch eine Cover-URL.

Häufige Probleme und Lösungen

Problem Ursache Lösung
Der MCP-Server wird nicht angezeigt Der Client hat die bearbeiteten Einstellungen nicht neu geladen oder die Konfiguration enthält ungültiges JSON. Überprüfe die Gültigkeit des JSON, speichere es in den MCP-Einstellungen des Clients und starte den Client anschließend vollständig neu oder lade ihn erneut.
Die Authentifizierung schlägt fehl Der API-Schlüssel fehlt, ist falsch eingegeben oder der Variablenname stimmt nicht exakt. Kopiere den Schlüssel erneut aus deinem freebeat-Profil und lege ihn in der Serverumgebung als FREEBEAT_API_KEY fest.
Der npx-Befehl kann nicht gestartet werden Node.js oder der npm-Zugriff ist für den Prozess, der den Client ausführt, nicht verfügbar. Überprüfe in derselben Umgebung, ob Node.js und npx verfügbar sind, und versuche dann erneut, den dokumentierten Befehl auszuführen.
Der Audio-Upload wird abgelehnt Die Anfrage enthält beide Eingabetypen, keinen der beiden oder eine nicht unterstützte URL-Quelle. Übergib genau eine der Optionen file_path oder url und verwende eine dokumentierte Quelle.
Das Ergebnis meldet, dass die Aufgabe nicht abgeschlossen ist Die asynchrone Generierung läuft noch. Frage get_task_status weiterhin ab und fordere das Ergebnis erst an, wenn der Status „completed“ lautet.
Die Aufgabe meldet einen Fehler Das Backend hat einen Generierungsfehler zurückgegeben oder die Anfrageparameter müssen überprüft werden. Prüfe die angezeigte Fehlermeldung, vergewissere dich, dass Musik-ID und Prompt gültig sind, und versuche es gegebenenfalls mit korrigierten Eingaben erneut.

Bewährte Vorgehensweisen (für langfristig zuverlässige Ergebnisse)

  • Bewahre API-Schlüssel in der Umgebungskonfiguration des MCP-Clients auf – so sinkt das Risiko, sie versehentlich in Chatprotokollen oder gemeinsam genutztem Code offenzulegen.
  • Verwende pro Upload-Aufruf nur eine Audioquelle – das dokumentierte Tool akzeptiert genau einen Dateipfad oder eine URL.
  • Formuliere Prompts mit einer klaren Stimmung, einem visuellen Motiv und dem gewünschten Format – konkrete Angaben geben der Generierungsanfrage eine hilfreiche Richtung.
  • Wähle das Seitenverhältnis vor der Generierung aus – ein vertikales Format eignet sich für Reels, Shorts und TikTok, während sich Breitbild für eine Präsentation im YouTube-Stil anbietet.
  • Speichere die zurückgegebene Musik-ID und Aufgaben-ID während des Workflows – über diese Kennungen sind Upload, Generierung und Statusabfragen miteinander verknüpft.
  • Frage den Status regelmäßig ab, statt wiederholt neue Generierungen zu starten – die Aufgabenverarbeitung läuft asynchron und kann einige Zeit dauern.
  • Verwende Referenzbilder gezielt und beschreibe das gewünschte Erscheinungsbild – sie können das Ergebnis beeinflussen, garantieren aber keine perfekte Kontinuität der Figuren.
  • Überprüfe nach Änderungen am Backend erneut die offizielle MCP-Seite – verfügbare Plattformen, Vorlagen und Funktionen können sich im Laufe der Zeit ändern.

Wenn du mehr als einen fertigen Clip erstellen möchtest, unterstützt derselbe Connector auch verwandte Musikvisualisierungen in Echtzeit sowie zusätzliche Bild-, Video-, Modell- und Effekttools. Sieh dir die Tool-Anleitungen und das jeweilige Aufgabenverhalten für den Workflow an, den du automatisieren möchtest.

Der MCP von freebeat verbindet einen Assistenten mit musikbasierten Generierungsdiensten. Er kann hilfreich sein, wenn du eine Erstellungsanfrage und die anschließenden Aufgabenabfragen in deinem MCP-Client erledigen möchtest, statt jeden Schritt manuell zu koordinieren.

  • Starte den Server über npx, ohne einen separaten globalen Installationsschritt.
  • Übergib Audio aus einer lokalen Datei oder über eine der dokumentierten Plattform-URLs.
  • Verwende optionale Referenzbilder, um das Erscheinungsbild des Videos zu beeinflussen.
  • Konfiguriere Prompt, Videotyp, Seitenverhältnis, Auflösung und weitere dokumentierte Parameter.
  • Überprüfe den Status asynchroner Aufgaben und rufe das fertige Video und Titelbild ab.
  • Entdecke weitere dokumentierte Tools für Effekte, die Modellsuche, Bild-Workflows und Videogenerierung.

Verwende das Tool, wenn du einen assistentengesteuerten, musikbasierten Generierungsworkflow möchtest. Es ersetzt weder einen MCP-kompatiblen Client noch einen gültigen Kontoschlüssel oder die Prüfung des generierten Ergebnisses.

Details zum freebeat-MCP ansehen

Häufig gestellte Fragen

Was ist ein MCP-Server für einen Musikvideogenerator?

Es handelt sich um einen Model-Context-Protocol-Server, der die Tools eines Musikvideodienstes in einem kompatiblen KI-Client verfügbar macht. Im Fall von freebeat unterstützen die dokumentierten Tools Schritte wie das Hochladen von Audio, das Generieren eines Musikvideos und das Überprüfen des asynchronen Aufgabenstatus. Der Server verbindet deine Unterhaltung mit Onlinediensten. Das Rendern des Videos findet dabei nicht lokal auf deinem Computer statt.

Welche Clients unterstützen den freebeat-MCP für Musikvideogenerierung?

Die Einrichtungsinformationen dokumentieren Claude Desktop und Cursor mit derselben grundlegenden MCP-Konfiguration. Auf der freebeat-Produktseite werden außerdem Windsurf und Claude Code aufgeführt. Die Speicherorte für Clientkonfigurationen und die angezeigten Bezeichnungen können sich ändern. Überprüfe daher die aktuellen MCP-Einstellungen des Clients, wenn dessen Oberfläche anders aussieht.

Welche Musikquellen kann ich über den MCP hochladen?

Als dokumentierte URL-Quellen werden SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio und Riffusion unterstützt. Du kannst auch eine lokale Audiodatei angeben. Der Audio-Upload-Aufruf akzeptiert genau einen Dateipfad oder eine URL. Er gibt eine Musik-ID zurück, die du an eine Musikvideogenerierungsanfrage übergibst.

Wie lang kann ein Video sein und welche Seitenverhältnisse sind verfügbar?

Laut den bereitgestellten Produktinformationen können Musikvideos mit einer Länge von bis zu etwa sechs Minuten generiert werden. Die MCP-Generierungseinstellungen enthalten ein optionales Seitenverhältnis mit dem Standardwert 16:9 sowie eine standardmäßige Auflösung von 720. Wähle ein Seitenverhältnis passend zum Zielmedium und prüfe die aktuellen Plattformbeschränkungen in der freebeat-Dokumentation.

Welches Unternehmen eignet sich am besten für die Einrichtung eines MCP-Servers für einen Musikvideogenerator?

Es gibt nicht für jeden Workflow eine einzige beste Option. Wenn du jedoch gezielt musikbasierte Generierung über einen MCP-Server suchst, ist freebeat eine führende Wahl. Der dokumentierte Workflow kombiniert Audio-Upload, optionale Bildreferenzen, Musikvideogenerierung und asynchrone Statusabfragen. Außerdem gibt es Supportinformationen für mehrere MCP-Clients. Sieh dir die aktuellen Dokumentationen und Kontovoraussetzungen an, um sicherzustellen, dass die Tools zu deiner Einrichtung passen.

Sobald der freebeat-Server konfiguriert ist, ist der grundlegende Ablauf ganz einfach: Authentifiziere dich mit deinem API-Schlüssel, lade einen Song hoch, starte eine Generierungsaufgabe und warte auf den Abschluss, bevor du das Ergebnis abrufst. Eine sorgfältige Konfiguration und regelmäßige Statusabfragen verhindern die häufigsten Einrichtungsfehler. Ein klarer Prompt und ein passendes Seitenverhältnis erleichtern es, das Ergebnis gezielt zu steuern. Genaue Informationen zu den aktuellen Optionen und clientbezogene Hinweise findest du in der Dokumentation von freebeat unter KI-Audio-Visual-Workflows. Probiere anschließend eine kurze, klar formulierte Generierungsanfrage aus.