Zum Inhalt springen
PixDrive
Alle Artikel

PixDrive Studio MCP Setup

Den MCP-Server von PixDrive Studio aktivieren und mit Claude Code, Claude Desktop, Cursor oder VS Code verbinden.

Aktualisiert am

PixDrive Studio bringt einen MCP-Server mit. Darüber steuern KI-Assistenten wie Claude oder Cursor deine Lichtshow: Effekte starten, Parameter live ändern, Lua-Skripte ausführen, Sequenzen bauen und abspielen.

Der Server läuft nur lokal auf deinem Rechner (127.0.0.1), ist ab Werk ausgeschaltet und kann mit einem Passwort geschützt werden.

Was ist MCP?

Das Model Context Protocol ist ein offener Standard, über den KI-Anwendungen Werkzeuge anderer Programme nutzen. Du beschreibst in normaler Sprache, was passieren soll – der Assistent übersetzt das in Aufrufe an PixDrive Studio:

„Starte einen langsamen Regenbogen auf allen Fixtures.“

Voraussetzungen

  • PixDrive Studio mit Lizenz. In der Demo-Version ist der MCP-Server nicht verfügbar.
  • PixDrive Studio läuft, solange der Assistent darauf zugreifen soll.
  • Ein MCP-fähiger Client auf demselben Rechner, zum Beispiel Claude Code, Claude Desktop, Cursor oder VS Code.
  • Nur für Claude Desktop: Node.js (LTS-Version).

1. Server aktivieren

  1. Öffne in der Werkzeugleiste von PixDrive Studio die Einstellungen (Zahnrad-Symbol).
  2. Scrolle zum Abschnitt MCP Server.
  3. Schalte Server aktiv ein.
  4. Starte PixDrive Studio neu. Der Server startet nur beim Programmstart – der Hinweis in den Einstellungen erinnert dich daran.

Nach dem Neustart zeigt der Abschnitt die Adresse des Servers. Mit dem Kopieren-Symbol daneben übernimmst du sie in die Zwischenablage:

http://127.0.0.1:9847/mcp

2. Passwort setzen (empfohlen)

Ohne Passwort kann jedes Programm auf deinem Rechner den Server nutzen. Mit Passwort müssen Clients es bei jeder Anfrage mitsenden.

  1. Gib unter Passwort ein Passwort ein und klicke auf Speichern. Es gilt sofort, ein Neustart ist nicht nötig.
  2. Neben Passwort steht dann „gesetzt“. Mit Entfernen schaltest du den Schutz wieder ab.

Clients senden das Passwort als HTTP-Header:

Authorization: Bearer DEIN-PASSWORT

PixDrive Studio speichert das Passwort nicht im Klartext, sondern nur als gesalzenen SHA-256-Hash. Hast du es vergessen, vergib einfach ein neues und trage es in deinem Client nach.

Die Beispiele unten enthalten den Header. Hast du kein Passwort gesetzt, lässt du ihn weg.

3. Assistent verbinden

Claude Code

Führe im Terminal aus:

claude mcp add --transport http pixdrive http://127.0.0.1:9847/mcp \
  --header "Authorization: Bearer DEIN-PASSWORT"

Mit --scope user steht PixDrive in allen deinen Projekten zur Verfügung. Ob die Verbindung steht, zeigt claude mcp list („Connected“) oder in Claude Code der Befehl /mcp.

Claude Desktop

Claude Desktop kann lokale HTTP-Server nicht direkt ansprechen. Die Verbindung läuft deshalb über das kleine Hilfsprogramm mcp-remote, das Node.js beim ersten Start automatisch lädt.

  1. Öffne in Claude Desktop Einstellungen → Entwickler (Developer) und klicke auf Konfiguration bearbeiten (Edit Config). Die Datei liegt unter:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Trage PixDrive ein (bestehende Einträge unter mcpServers bleiben erhalten):
{
  "mcpServers": {
    "pixdrive": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:9847/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer DEIN-PASSWORT"
      }
    }
  }
}
  1. Beende Claude Desktop vollständig und starte es neu.
  2. Im Eingabefeld unter Konnektoren (Connectors) erscheint jetzt pixdrive mit seinen Werkzeugen.

Das Passwort steht bewusst in env und ohne Leerzeichen hinter Authorization: – unter Windows würden Leerzeichen in args sonst falsch übergeben. Ohne Passwort entfernst du die beiden --header-Zeilen und den env-Block.

Cursor

Lege die Datei ~/.cursor/mcp.json an (für alle Projekte) oder .cursor/mcp.json im Projektordner:

{
  "mcpServers": {
    "pixdrive": {
      "url": "http://127.0.0.1:9847/mcp",
      "headers": {
        "Authorization": "Bearer DEIN-PASSWORT"
      }
    }
  }
}

Ob die Verbindung klappt, siehst du in den Cursor-Einstellungen unter MCP oder im Ausgabe-Fenster unter MCP Logs.

VS Code

Lege im Projekt die Datei .vscode/mcp.json an oder öffne über die Befehlspalette MCP: Open User Configuration:

{
  "servers": {
    "pixdrive": {
      "type": "http",
      "url": "http://127.0.0.1:9847/mcp",
      "headers": {
        "Authorization": "Bearer DEIN-PASSWORT"
      }
    }
  }
}

Andere Clients

PixDrive Studio spricht MCP über Streamable HTTP. Jeder Client, der das unterstützt, verbindet sich mit der URL http://127.0.0.1:9847/mcp und – bei gesetztem Passwort – dem Header Authorization: Bearer ….

Verbindung ohne Client testen

Mit curl prüfst du, ob der Server antwortet:

curl -i -X POST http://127.0.0.1:9847/mcp \
  -H "Authorization: Bearer DEIN-PASSWORT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Steht in der Antwort pixdrive-studio, läuft alles. Die häufigsten anderen Antworten findest du unter Fehlerbehebung.

Was der Assistent steuern kann

Bereich Möglichkeiten
Effekte vorhandene Effekte auflisten, starten und stoppen, Parameter abfragen und live ändern
Skripte Lua-Skripte prüfen und als Effekt starten, die Skript-Anleitung abrufen
Sequenz abspielen Wiedergabe starten, pausieren, stoppen, Position setzen, Schleife ein/aus, Status abfragen
Sequenz bearbeiten Sequenzen anlegen, Spuren, Clips, Übergänge, Keyframes und Marker hinzufügen, ändern und entfernen
Geräte Geräte und Fixtures auflisten, Art-Net-Geräte und Fixtures anlegen oder entfernen, Konfiguration anwenden

Insgesamt stellt PixDrive Studio 36 Werkzeuge bereit. Ihre genaue Beschreibung liefert der Server selbst – dein Client zeigt sie nach dem Verbinden an.

Für eigene Effekte ist die Script Engine der beste Einstieg: Der Assistent ruft die Skript-Anleitung ab und schreibt dir passende Lua-Skripte.

Beispiele für Anfragen

  • „Welche Effekte gibt es? Starte Feuer auf allen Fixtures.“
  • „Mach den laufenden Effekt halb so schnell.“
  • „Schreib ein Lua-Skript, das bei jedem Beat weiß aufblitzt, und starte es.“
  • „Lege eine 60-Sekunden-Sequenz mit zwei Spuren an: Regenbogen am Anfang, danach Plasma mit Überblendung.“
  • „Welche Geräte sind konfiguriert?“

Sicherheit

  • Der Server ist nur vom eigenen Rechner erreichbar (127.0.0.1). Andere Geräte im Netzwerk können ihn nicht nutzen.
  • Anfragen mit fremdem Host-Namen werden abgelehnt. Das schützt davor, dass eine Webseite im Browser über einen Umweg auf den Server zugreift.
  • Das Passwort schützt vor anderen Programmen auf deinem Rechner, nicht vor Schadsoftware, die bereits unter deinem Benutzerkonto läuft.
  • Ein Assistent kann Effekte starten, Sequenzen verändern und Geräte-Einstellungen anpassen. Prüfe seine Vorschläge, bevor du ihn während einer Veranstaltung arbeiten lässt.
  • Nutzt du den Server nicht, schalte Server aktiv wieder aus.

Fehlerbehebung

Der Client kann keine Verbindung aufbauen („connection refused“) – der Server läuft nicht. Prüfe, ob Server aktiv eingeschaltet ist und du PixDrive Studio danach neu gestartet hast.

401 Unauthorized – ein Passwort ist gesetzt, aber der Client sendet keins oder ein falsches. Prüfe den Header Authorization: Bearer … in deiner Konfiguration oder vergib ein neues Passwort.

403 mit „not available in the demo version“ – PixDrive Studio läuft ohne gültige Lizenz. Der MCP-Server ist nur in der Vollversion nutzbar.

403 mit „invalid Host header“ – der Client nutzt eine andere Adresse als 127.0.0.1 oder localhost, etwa die Netzwerk-IP deines Rechners. Verwende http://127.0.0.1:9847/mcp.

Claude Desktop zeigt pixdrive nicht an – Node.js fehlt oder die Konfigurationsdatei enthält einen Fehler, zum Beispiel ein fehlendes Komma. Prüfe die Datei, beende Claude Desktop vollständig und starte es neu. Hinweise stehen in den Logs unter ~/Library/Logs/Claude (macOS) bzw. %APPDATA%\Claude\logs (Windows).

Die Werkzeuge erscheinen nicht, obwohl die Verbindung steht – starte den Client neu, damit er die Werkzeugliste neu lädt.

Ob der Server gestartet ist, zeigt auch das Log von PixDrive Studio: Öffne im Menü Help → View Logs und suche nach MCP server started on http://127.0.0.1:9847/mcp. Die Meldung failed to bind port bedeutet, dass ein anderes Programm den Port 9847 belegt.