QCAD mit Claude Desktop verwenden

Einführung

QCAD enthält einen MCP-Server (Model Context Protocol). MCP ist ein offener Standard, mit dem KI-Assistenten Werkzeuge verwenden können, die von anderen Anwendungen bereitgestellt werden. Mit dem QCAD MCP-Server kann die Claude Desktop App direkt mit der Zeichnung arbeiten, die gerade in QCAD geöffnet ist. Sie können Claude zum Beispiel bitten:

• eine unbekannte Zeichnung, ihre Layer, Blöcke, Bemaßungen und Texte zu beschreiben
• eine Zeichnung auf Probleme wie nicht geschlossene Polylinien, doppelte Objekte oder Geometrie auf Layer 0 zu prüfen
• Abstände, Längen und Flächen zu messen
• eine Stückliste aus Blockreferenzen zu erstellen
• Layer, Linien, Bögen, Kreise, Polylinien, Texte, Bemaßungen und Schraffuren hinzuzufügen
• bestehende Objekte zu verschieben, zu drehen, zu skalieren, zu trimmen, zu runden oder Äquidistanten davon zu erstellen
• die Zeichnung als PNG, PDF, SVG, DXF oder DWG zu exportieren

In diesem Tutorial wird erklärt, wie Sie QCAD unter Windows oder macOS mit Claude Desktop verbinden.

Voraussetzungen

• QCAD mit dem MCP-Plugin, installiert und ausgeführt auf demselben Computer wie Claude Desktop
• Die Claude Desktop App für Windows oder macOS

Die QCAD-Erweiterung für Claude Desktop wird mit QCAD mitgeliefert. Es handelt sich um die Datei qcad.mcpb im Ordner mcp Ihrer QCAD-Installation, zum Beispiel:

• Windows: C:\Program Files\QCAD\mcp\qcad.mcpb
• macOS: /Applications/QCAD-Pro.app/Contents/Resources/mcp/qcad.mcpb

Unter macOS befindet sich der Ordner innerhalb des Programmpakets und wird vom Finder nicht angezeigt, wenn Sie den Ordner Applications öffnen. Diverses > MCP > In Claude Desktop installieren in QCAD öffnet die Datei oder zeigt sie für Sie an (siehe unten).

Node.js muss nicht separat installiert werden. Claude Desktop bringt alles mit, was zum Ausführen der Erweiterung benötigt wird.

Den MCP-Server in QCAD starten

Der MCP-Server in QCAD startet nicht von selbst. Solange er nicht gestartet ist, nimmt QCAD keine Verbindungen an.

• Starten Sie QCAD.
• Wählen Sie Diverses > MCP > Starten.

Die Befehlszeile am unteren Rand des QCAD-Fensters bestätigt, dass der Server läuft:

MCP: MCP server running on port 3907 (http://127.0.0.1:3907/mcp)

Der Server läuft, bis Sie Diverses > MCP > Stoppen wählen oder QCAD beenden. Er muss bei jedem Start von QCAD erneut gestartet werden.

Das Menü Diverses > MCP bietet außerdem:

• In Claude Desktop installieren: hilft Ihnen, die QCAD-Erweiterung in Claude Desktop zu installieren (siehe unten)
• Status: zeigt in der Befehlszeile an, ob der Server läuft und auf welchem Port
• Neu starten: stoppt den Server und startet ihn erneut, zum Beispiel nach dem Ändern seines Ports

Der Server nimmt nur Verbindungen vom selben Computer an (Adresse 127.0.0.1). Er ist von anderen Computern in Ihrem Netzwerk aus nicht erreichbar.

Die QCAD-Erweiterung in Claude Desktop installieren

Die Erweiterung wird nur einmal installiert. Stellen Sie vorher sicher, dass Claude Desktop installiert ist und Sie angemeldet sind.

Die QCAD-Erweiterung ist eine lokale Erweiterung: Claude Desktop führt sie auf Ihrem Computer aus, wo sie sich mit dem MCP-Server in QCAD verbindet. Verwenden Sie dafür nicht Add custom connector in Claude. Benutzerdefinierte Connectors akzeptieren nur Server, die über eine https-Adresse aus dem Internet erreichbar sind. Die Adresse http://127.0.0.1:3907/mcp von QCAD wird dort daher nicht akzeptiert.

Windows

• Wählen Sie in QCAD Diverses > MCP > In Claude Desktop installieren. QCAD zeigt die Datei qcad.mcpb markiert im Datei-Explorer an. Die Befehlszeile in QCAD zeigt zudem die Schritte zur Installation an.
• Öffnen Sie in Claude Desktop das Menü oben links im Fenster und wählen Sie File > Settings.
• Gehen Sie zu Extensions, öffnen Sie Advanced settings und klicken Sie auf Install Extension.
• Wählen Sie die Datei qcad.mcpb, zum Beispiel C:\Program Files\QCAD\mcp\qcad.mcpb.

Doppelklicken Sie unter Windows nicht auf die Datei qcad.mcpb und ziehen Sie sie nicht in das Fenster von Claude Desktop. Beides installiert die Erweiterung nicht: Claude Desktop registriert sich nicht für diesen Dateityp, daher fragt Windows bei einem Doppelklick nur, mit welcher App die Datei geöffnet werden soll.

macOS

• Wählen Sie in QCAD Diverses > MCP > In Claude Desktop installieren. QCAD öffnet die Datei qcad.mcpb direkt in Claude Desktop.
• Falls Claude Desktop nicht gefunden wird, zeigt QCAD die Datei stattdessen im Finder an. Ziehen Sie sie in das Fenster von Claude Desktop, oder wählen Sie in Claude Desktop Claude > Settings in der Menüleiste, gehen Sie zu Extensions, öffnen Sie Advanced settings, klicken Sie auf Install Extension und wählen Sie die Datei.

Installation abschließen

Claude Desktop zeigt die Details der QCAD-Erweiterung an. Klicken Sie auf Install und bestätigen Sie.

Nach der Installation erscheint QCAD in der Liste der Erweiterungen unter Settings > Extensions. Stellen Sie sicher, dass die Erweiterung aktiviert ist.

Einstellungen der Erweiterung

Die QCAD-Erweiterung hat drei Einstellungen, die in Claude Desktop unter Settings > Extensions > QCAD geändert werden können. Normalerweise müssen die Standardwerte nicht geändert werden:

• QCAD host: die Adresse des QCAD MCP-Servers. Belassen Sie diese bei 127.0.0.1.
• QCAD MCP port: der Port des QCAD MCP-Servers, standardmäßig 3907. Dieser muss mit dem in QCAD konfigurierten Port übereinstimmen.
• Reply timeout (ms): wie lange Claude auf eine Antwort von QCAD wartet, standardmäßig 60000 ms (eine Minute). Erhöhen Sie diesen Wert, wenn Sie mit sehr großen Zeichnungen arbeiten.

Mit Claude und QCAD arbeiten

• Öffnen Sie eine Zeichnung in QCAD oder beginnen Sie mit einer neuen Zeichnung.
• Stellen Sie sicher, dass der MCP-Server läuft (Diverses > MCP > Status).
• Öffnen Sie einen neuen Chat in Claude Desktop und fragen Sie nach dem, was Sie benötigen, zum Beispiel:

Beschreibe die Zeichnung, die in QCAD geöffnet ist.

Prüfe die Zeichnung in QCAD auf Probleme und liste auf, was du findest.

Erstelle eine Stückliste aus den Blockreferenzen in der Zeichnung.

Zeichne ein Rechteck von 100 x 50 mm auf einem neuen Layer "Umriss" und runde alle Ecken mit einem Radius von 5 mm.

Claude entscheidet, welche QCAD-Werkzeuge verwendet werden. Wenn ein Werkzeug zum ersten Mal verwendet wird, bittet Claude Desktop um Ihre Erlaubnis. Sie können das Werkzeug einmalig oder immer zulassen.

Claude arbeitet immer mit der Zeichnung, die gerade in QCAD aktiv ist. Wenn mehrere Zeichnungen geöffnet sind, wechseln Sie in QCAD zur richtigen Zeichnung, bevor Sie Ihre Anfrage stellen.

Änderungen, die Claude vornimmt, erscheinen sofort im QCAD-Fenster. Werkzeuge, die bestehende Objekte ändern oder löschen, Layer umbenennen oder unbenutzte Layer und Blöcke bereinigen, melden nur, was sie ändern würden, es sei denn, Claude fordert sie ausdrücklich auf, die Änderung anzuwenden. Wenn Sie eine Änderung zuerst überprüfen möchten, bitten Sie Claude, Ihnen zu zeigen, was es tun würde, bevor die Änderung angewendet wird. Jede Änderung kann in QCAD mit Bearbeiten > Rückgängig rückgängig gemacht werden oder indem Sie Claude bitten, sie rückgängig zu machen.

Claude kann sich die Zeichnung auch ansehen: Es stellt die Zeichnung als Bild dar, um zu prüfen, was sie zeigt, oder um das Ergebnis einer Änderung zu überprüfen.

Sprachmodus

MCP ist im Sprachmodus von Claude Desktop nicht verfügbar. Die QCAD-Werkzeuge können nur in Text-Chats verwendet werden. Um mit QCAD zu arbeiten, tippen Sie Ihre Anfragen, anstatt sie zu sprechen.

Datenschutz

Der QCAD MCP-Server und die Erweiterung kommunizieren nur auf Ihrem eigenen Computer miteinander. Alles, was Claude aus Ihrer Zeichnung liest, zum Beispiel Layernamen, Texte, Bemaßungen und Koordinaten, wird jedoch als Teil der Unterhaltung an Claude gesendet, wie jeder andere Inhalt, den Sie in einem Chat teilen. Verwenden Sie den MCP-Server nicht mit Zeichnungen, die Ihren Computer nicht verlassen dürfen.

Fehlerbehebung

Windows fragt, mit welcher App qcad.mcpb geöffnet werden soll

Claude Desktop für Windows kann .mcpb-Dateien nicht per Doppelklick öffnen. Schließen Sie den Dialog und installieren Sie die Datei stattdessen in Claude Desktop unter File > Settings > Extensions > Advanced settings > Install Extension, wie oben beschrieben.

Claude akzeptiert die Adresse von QCAD nicht als Connector

Add custom connector in Claude funktioniert nur mit Servern, die aus dem Internet erreichbar sind. QCAD wird stattdessen über die QCAD-Erweiterung verbunden, wie oben beschrieben.

Claude meldet „Cannot reach QCAD”

Die Erweiterung kann keine Verbindung zu QCAD herstellen. Prüfen Sie, ob:

• QCAD läuft
• der MCP-Server mit Diverses > MCP > Starten gestartet wurde
• der von Diverses > MCP > Status angezeigte Port mit dem Port in den Einstellungen der Erweiterung in Claude Desktop übereinstimmt

QCAD muss nicht vor Claude Desktop gestartet werden, und Claude Desktop muss nach dem Starten des MCP-Servers nicht neu gestartet werden. Wenn Claude die QCAD-Werkzeuge jedoch nicht zu kennen scheint, starten Sie zuerst QCAD und dessen MCP-Server und öffnen Sie dann einen neuen Chat in Claude Desktop.

Der Server kann nicht gestartet werden

Wenn Diverses > MCP > Starten meldet, dass die Adresse bereits verwendet wird, verwendet ein anderes Programm oder ein anderes QCAD-Fenster bereits den Port 3907. Nur ein QCAD-Fenster kann den MCP-Server auf einem bestimmten Port ausführen. Stoppen Sie den Server im anderen QCAD-Fenster mit Diverses > MCP > Stoppen und starten Sie ihn in dem Fenster, in dem Sie arbeiten möchten.

Claude arbeitet an der falschen Zeichnung

Claude arbeitet immer mit der aktiven Zeichnung der QCAD-Instanz, in der der MCP-Server läuft. Klicken Sie in QCAD auf den Tab oder das Fenster der Zeichnung, mit der Claude arbeiten soll. Wenn mehrere QCAD-Instanzen laufen, stellen Sie sicher, dass der MCP-Server in der Instanz läuft, die Sie gerade vor sich haben.

Eine Anfrage dauert lange oder schlägt mit einer Zeitüberschreitung fehl

QCAD kann nicht antworten, solange in QCAD ein Dialog geöffnet ist. Schließen Sie alle offenen Dialoge in QCAD und fragen Sie erneut. Erhöhen Sie bei sehr großen Zeichnungen den Reply timeout in den Einstellungen der Erweiterung.