KwaFlux in Cursor nutzen: MCP einrichten, erste Anfragen und Lösungen bei Problemen

Das Wichtigste in Kürze

• Der Agent in Cursor kann KwaFlux über den lokalen MCP-Server steuern, den die App mitbringt. Zur Einrichtung genügt eine Schaltfläche in KwaFlux oder ein Eintrag in der mcp.json.
• Lassen Sie KwaFlux geöffnet und Node.js installiert. Der Server ist ein lokales Programm auf Ihrem Computer, deshalb erreichen ihn die Cloud Agents von Cursor nicht.
• Cursor fragt standardmäßig nach, bevor MCP-Tools laufen. Geben Sie zuerst die reinen Lese-Tools frei, um die Verbindung zu prüfen.
• Die meisten Fehler bei der Einrichtung haben drei Ursachen: ein nicht maskierter Windows-Pfad im JSON, Änderungen an der falschen mcp.json und fehlendes Neuladen.

Der Agent in Cursor kann KwaFlux auf Ihrem Computer steuern, und zwar über den lokalen MCP-Server, der mit der App installiert wird. Öffnen Sie in KwaFlux Einstellungen › Agent (MCP), wählen Sie Cursor und klicken Sie auf In Cursor installieren, oder fügen Sie einen Eintrag in die mcp.json von Cursor ein. Danach bitten Sie den Agenten, ein Video zu diagnostizieren, zu reparieren, zu konvertieren oder zu verbessern.

Die Einrichtung dauert etwa fünf Minuten. Cursor startet den Server, KwaFlux übernimmt die Verarbeitung.

In diesem Leitfaden erfahren Sie, auf welchen zwei Wegen Sie KwaFlux zu Cursor hinzufügen, wie Sie die Verbindung prüfen, womit Sie anfangen und wie Sie die üblichen Probleme lösen.

Inhalt

1. Was macht Cursor mit einem MCP-Server?
2. Bevor Sie beginnen
3. Methode 1: Mit einer Schaltfläche aus KwaFlux installieren
4. Methode 2: Die mcp.json selbst bearbeiten
5. Prüfen, ob die Verbindung steht
6. Ihre ersten Anfragen
7. Freigaben und automatische Ausführung
8. Fehlerbehebung
9. Häufige Fragen

Was macht Cursor mit einem MCP-Server?

Ein MCP-Server gibt dem Agenten in Cursor zusätzliche Tools. Einen lokalen Server (stdio) startet Cursor beim Laden als Programm auf Ihrem Computer, und der Agent ruft dessen Tools auf, wenn eine Anfrage sie braucht.

Der Server von KwaFlux ist ein Node.js-Skript, das mit der App geliefert wird. Seine Tools prüfen den Status der App, stellen Aufträge wie Konvertierung, Reparatur und Verbesserung in die Warteschlange und warten, bis sie fertig sind. Was ein Agent ist und wie diese Schleife funktioniert, lesen Sie unter was ist ein KI-Agent.

Bevor Sie beginnen

Randnotiz: Auf dem Mac verweist der Schnipsel von KwaFlux statt auf einen Skriptpfad auf ein Hilfsprogramm in der App (<KwaFlux.app>/Contents/Helpers/kwaflux-mcp-run). Kopieren Sie ihn aus der App, dann steht dort der tatsächliche Speicherort.

Methode 1: Mit einer Schaltfläche aus KwaFlux installieren

1. Öffnen Sie in KwaFlux die Einstellungen und gehen Sie zu Agent (MCP).
2. Wählen Sie unter MCP-Host den Eintrag Cursor.
3. Klicken Sie auf In Cursor installieren. KwaFlux kopiert die Konfiguration und öffnet Cursor mit einem Installationslink.
4. Bestätigen Sie die Installation in Cursor.
5. Wie der Hinweis in KwaFlux sagt: „Nach der Installation MCP in Cursor neu laden.“

Nach dem Klick kopiert KwaFlux die Konfiguration und zeigt „Konfiguration kopiert, Cursor wird geöffnet – bei Bedarf manuell einfügen“. Öffnet sich Cursor nicht, nutzen Sie Methode 2; die Konfiguration liegt bereits in der Zwischenablage.

Die Schaltfläche öffnet einen Link dieser Form, an dessen Ende die Konfiguration kodiert steht:

cursor://anysphere.cursor-deeplink/mcp/install?name=kwaflux&config=eyJjb21tYW5kIjoiQzpcXFByb2dyYW0gRmlsZXNcXG5vZGVqc1xcbm9kZS5leGUiLCJhcmdzIjpbIkM6XFxQcm9ncmFtIEZpbGVzXFxLd2FGbHV4XFxUb29sc1xca3dhZmx1eC1tY3BcXGt3YWZsdXhfbWNwLm1qcyJdfQ

Das ist der Link für eine Windows-Standardinstallation. Haben Sie KwaFlux an einem anderen Ort installiert, sieht Ihrer anders aus.

Methode 2: Die mcp.json selbst bearbeiten

Cursor liest MCP-Server aus zwei Dateien:

KwaFlux ist eine Desktop-App und kein Teil eines Projekts. Nehmen Sie deshalb die globale Datei.

1. Wählen Sie in KwaFlux unter MCP-Host den Eintrag Cursor und klicken Sie auf Konfig kopieren.
2. Öffnen Sie ~/.cursor/mcp.json oder legen Sie die Datei an.
3. Ist die Datei neu, fügen Sie den ganzen Schnipsel ein. Enthält sie schon Server, ergänzen Sie nur den Eintrag kwaflux innerhalb des vorhandenen mcpServers.

Bei einer Windows-Standardinstallation sieht der Schnipsel so aus:

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

4. Speichern Sie und starten Sie Cursor neu, oder schalten Sie den Server unter Customize aus und wieder ein.

Tipp: Behalten Sie die doppelten Backslashes bei. In JSON leitet ein einzelnes \ eine Escape-Sequenz ein. C:\Program Files macht deshalb die ganze Datei ungültig, und Cursor verwirft jeden Server darin, nicht nur KwaFlux.

Prüfen, ob die Verbindung steht

1. Öffnen Sie in der Seitenleiste von Cursor Customize und suchen Sie kwaflux. Der Server sollte aktiviert sein und seine Tools auflisten.
2. Fragen Sie im Agent-Chat:

Läuft KwaFlux? Prüf das mit den KwaFlux-Tools.

Der Agent ruft kwaflux_get_app_status auf. Ist KwaFlux geöffnet, steht in der Antwort auch, ob Sie angemeldet sind. Ist die App geschlossen, liefert das Tool einen Fehler, der mit app_not_running beginnt. Öffnen Sie KwaFlux und fragen Sie erneut.

3. Lassen Sie sich Ihre Aufgabenliste zeigen. Eine leere Liste ist in Ordnung; sie bedeutet, dass die ganze Kette funktioniert.

Ihre ersten Anfragen

Nennen Sie volle lokale Pfade und sagen Sie, wofür Sie das Ergebnis brauchen:

Jede Aufgabe erscheint in der Aufgabenliste von KwaFlux, wo Sie sie beobachten, pausieren oder abbrechen können. Einzelheiten zur Konvertierung finden Sie beim Konverter.

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.

Freigaben und automatische Ausführung

Laut der Dokumentation von Cursor „fragt Cursor standardmäßig nach einer Freigabe, bevor MCP-Tools genutzt werden“, und für MCP-Tools gelten dieselben Run Modes wie für Terminalbefehle. Für KwaFlux ist das eine vernünftige Voreinstellung:

• Reine Lese-Tools wie App-Status, Aufgabenliste, Aufgabendetails und die Liste der Exportformate können Sie bedenkenlos auf die Positivliste setzen.
• Tools, die Aufträge einreihen, schreiben neue Dateien neben Ihre Quelle. Geben Sie diese selbst frei, bis Sie Ihren Anfragen vertrauen.

Fehlerbehebung

Bei Problemen, die nicht speziell mit Cursor zu tun haben, hilft die Anleitung zur Fehlerbehebung bei KwaFlux MCP.

Fazit

Klicken Sie auf In Cursor installieren oder fügen Sie einen Eintrag in ~/.cursor/mcp.json ein. Laden Sie dann neu, lassen Sie KwaFlux geöffnet und bitten Sie den Agenten, vor dem ersten echten Auftrag den Status der App zu prüfen. Danach lassen sich Konvertierungen, Reparaturen und Verbesserungen aus dem Chat von Cursor starten und erscheinen in der Aufgabenliste von KwaFlux.

KwaFlux aus Cursor steuern

KwaFlux bringt einen lokalen MCP-Server für Cursor 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