KwaFlux mit Claude Code und Claude Desktop nutzen (MCP-Einrichtung)

Das Wichtigste in Kürze

• Claude Code verbindet sich mit KwaFlux über einen einzigen claude mcp add-Befehl, den KwaFlux für Sie erzeugt; Claude Desktop über einen Eintrag in der claude_desktop_config.json.
• Nutzen Sie in Claude Code den User-Scope, damit KwaFlux in jedem Projekt verfügbar ist und nicht nur in einem Ordner.
• Beenden Sie Claude Desktop nach dem Bearbeiten der Konfiguration ganz, auch über das Symbol im Infobereich, sonst lädt es den Server nicht.
• Beide Clients fragen nach, bevor sie MCP-Tools ausführen, und /mcp zeigt in Claude Code, ob KwaFlux verbunden ist und wie viele Tools es anbietet.

Claude kann KwaFlux auf Ihrem Computer über den lokalen MCP-Server steuern, der mit der App installiert wird. Für Claude Code liefert Ihnen KwaFlux einen fertigen claude mcp add-Befehl, für Claude Desktop einen JSON-Eintrag, den Sie in die claude_desktop_config.json übernehmen. In beiden Fällen muss KwaFlux geöffnet bleiben, solange Claude arbeitet.

In diesem Leitfaden erfahren Sie, wie Sie beide Claude-Clients verbinden, wo deren Konfiguration liegt, wie Sie die Verbindung prüfen, womit Sie anfangen und wie Sie die üblichen Probleme lösen.

Inhalt

1. Claude Code oder Claude Desktop?
2. Bevor Sie beginnen
3. Claude Code: ein Befehl
4. Claude Code: mit einem Projekt teilen
5. Claude Desktop: die Konfiguration bearbeiten
6. Ihre ersten Anfragen
7. Lange Aufträge und Timeouts
8. Fehlerbehebung
9. Häufige Fragen

Claude Code oder Claude Desktop?

Claude Code ist der Coding-Agent von Anthropic für Terminal und IDEs; Claude Desktop ist die Claude-Chat-App für Windows und macOS. Beide können lokale MCP-Server ausführen, und beide können KwaFlux nutzen.

Wenn Sie mit Claude vor allem über Ihre Videos sprechen wollen, ist Claude Desktop der einfachere Einstieg. Arbeiten Sie ohnehin im Terminal oder in einer IDE, fügt sich Claude Code dort ein. Zu den anderen Assistenten siehe unseren Vergleich.

Bevor Sie beginnen

• KwaFlux 1.0.14 oder neuer, geöffnet. Der MCP-Server spricht mit der laufenden App.
• Node.js 18 oder neuer, im PATH. Die Karte in den KwaFlux-Einstellungen sagt: „Der Host startet den Server über Node.js 18 oder neuer — Node muss installiert und im PATH sein.“ Schlägt node --version fehl, installieren Sie die aktuelle LTS-Version von nodejs.org. Die Karte sucht außerdem nach Node.js und schreibt den vollen Pfad in die Konfiguration, wie in den Beispielen unten; findet sie Node.js nicht, sagt sie das und schreibt stattdessen node.
• In KwaFlux: Öffnen Sie Einstellungen › Agent (MCP), wählen Sie unter MCP-Host den Eintrag Claude und dann Claude Code oder Claude Desktop.

Claude Code: ein Befehl

1. Klicken Sie bei ausgewähltem Claude Code auf Installationsbefehl kopieren.
2. Fügen Sie ihn in ein Terminal ein und führen Sie ihn aus. Bei einer Windows-Standardinstallation lautet er:

claude mcp add --scope user kwaflux -- "C:\Program Files\nodejs\node.exe" "C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs"

3. Starten Sie eine neue Claude-Code-Sitzung und führen Sie /mcp aus. Dort sollte kwaflux als verbunden erscheinen, mit der Zahl seiner Tools.

Zwei Teile dieses Befehls sind wichtig:

• **--scope user** legt den Server in ~/.claude.json für alle Ihre Projekte ab. Mit dem Standard von Claude Code, dem Local-Scope, würde KwaFlux nur in dem Ordner auftauchen, in dem Sie den Befehl ausgeführt haben.
• **--** trennt die Optionen von Claude vom Befehl, der den Server startet. Die Dokumentation von Claude Code erklärt: „Alles nach -- wird unverändert an den Server übergeben.“

Claude Code: mit einem Projekt teilen

Der Hinweis in KwaFlux nennt auch eine Projektdatei: „In die .mcp.json im Projektstamm einfügen oder die CLI ausführen.“ Eine .mcp.json im Projekt dient dazu, Server per Versionsverwaltung mit allen zu teilen, die in diesem Ordner arbeiten. Sie bietet sich an, wenn ein Team ein Videoprojekt in einem Repository pflegt und alle KwaFlux am selben Ort installiert haben.

Klicken Sie bei ausgewähltem Claude Code auf Konfig kopieren und speichern Sie das Ergebnis als .mcp.json im Projektstamm:

{
  "mcpServers": {
    "kwaflux": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Program Files\\KwaFlux\\Tools\\kwaflux-mcp\\kwaflux_mcp.mjs"
      ]
    }
  }
}

Bevor Claude Code in einer interaktiven Sitzung Server aus der .mcp.json eines Projekts nutzt, fragt es nach einer Freigabe. Bis Sie zustimmen, zeigt /mcp den Server als ausstehend an.

Claude Desktop: die Konfiguration bearbeiten

1. Wählen Sie in KwaFlux Claude › Claude Desktop und klicken Sie auf Konfig kopieren.
2. Öffnen Sie in Claude Desktop über das Claude-Menü die Settings (Einstellungen), gehen Sie zu Developer und klicken Sie auf Edit Config. Damit öffnen oder erstellen Sie: - Windows: %APPDATA%\Claude\claude_desktop_config.json - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Übernehmen Sie den Eintrag kwaflux in mcpServers. Löschen Sie keine Server, die schon darin stehen.
4. Beenden Sie Claude Desktop ganz, auch über das Symbol im Infobereich der Taskleiste bzw. in der Menüleiste, und öffnen Sie es wieder. Der Hinweis in KwaFlux sagt das unmissverständlich: Nach dem Bearbeiten Claude Desktop ganz beenden.
5. Öffnen Sie in einer Unterhaltung das Menü unten links im Eingabefeld, gehen Sie zu Connectors und prüfen Sie, ob kwaflux mit seinen Tools aufgeführt ist.

Claude Desktop fragt vor jedem Tool nach Ihrer Freigabe, außer Sie erlauben ein Tool für die Unterhaltung.

Ihre ersten Anfragen

Beginnen Sie mit einer Prüfung, die nur liest:

Prüf mit den KwaFlux-Tools, ob KwaFlux läuft und ob ich angemeldet bin.

Probieren Sie dann echte Aufträge, mit vollen lokalen Pfaden:

Die Bildinterpolation sowie die Tools zum Freistellen und Ersetzen bleiben in der App; der Assistent ist angewiesen, Sie dafür dorthin zu schicken. Downloads durch Agenten bleiben aus, solange Sie unter Agent-Freigabe die Option Downloads durch Agenten zulassen nicht auf Jedes Mal fragen stellen. KwaFlux zeigt dann für jeden Download ein Popup, und der Assistent bittet Sie zusätzlich im Chat zu bestätigen, dass Sie diesen Inhalt herunterladen dürfen.

Tipp: In Claude Code erscheinen die Tools von KwaFlux als mcp__kwaflux__<tool>, zum Beispiel mcp__kwaflux__kwaflux_get_app_status. Mit diesen Namen erlauben Sie die reinen Lese-Tools in Ihren Berechtigungsregeln, damit Claude nicht jedes Mal nachfragt, wenn es die Aufgabenliste prüft.

Lange Aufträge und Timeouts

Videoaufträge können Minuten dauern. Das Warte-Tool von KwaFlux wartet pro Aufruf bis zu 300 Sekunden, standardmäßig 60, und meldet dann, ob die Aufgabe fertig ist. Wenn nicht, kann Claude einfach erneut warten.

Startet der Server selbst auf einem langsamen Rechner nur zögerlich, beschreibt die Dokumentation von Claude Code für den Start die Umgebungsvariable MCP_TIMEOUT, zum Beispiel MCP_TIMEOUT=10000 claude. Für Tool-Aufrufe kann ein Eintrag in der .mcp.json eines Projekts ein Feld timeout in Millisekunden enthalten. Setzen Sie es über 300.000, wenn Sie um lange Wartezeiten bitten.

Fehlerbehebung

Bei Problemen, die bei jedem Host auftreten können, hilft die Anleitung zur Fehlerbehebung bei KwaFlux MCP.

Fazit

Führen Sie in Claude Code den Befehl aus, den KwaFlux für Sie kopiert, mit User-Scope, und prüfen Sie /mcp. In Claude Desktop übernehmen Sie den Eintrag in die claude_desktop_config.json und beenden die App ganz, bevor Sie sie wieder öffnen. Lassen Sie dann KwaFlux geöffnet und beginnen Sie mit einer Statusabfrage.

KwaFlux aus Claude steuern

KwaFlux bringt einen lokalen MCP-Server für Claude Code, Claude Desktop und andere MCP-Apps mit. Die KI-Verarbeitung läuft auf Ihrer eigenen GPU, und Ihre Mediendateien werden für die Verarbeitung nicht hochgeladen. KwaFlux läuft unter Windows 10 (64-Bit, Version 1809 oder neuer), Windows 11 und macOS 12 oder neuer auf Apple Silicon. Dateien importieren und die App erkunden geht ohne Konto. Anmeldung und ein bezahlter Plan sind nur für Export, Konvertierung, Dateireparatur und Datei-Download aus einem Link nötig.

KwaFlux laden · Pläne ansehen