QCAD gebruiken met Claude Desktop

Inleiding

QCAD bevat een MCP-server (Model Context Protocol). MCP is een open standaard waarmee AI-assistenten gereedschappen kunnen gebruiken die door andere toepassingen worden aangeboden. Met de QCAD MCP-server kan de Claude Desktop-app rechtstreeks werken met de tekening die op dat moment in QCAD is geopend. U kunt Claude bijvoorbeeld vragen om:

een onbekende tekening te beschrijven, met haar lagen, blokken, maatvoeringen en teksten
een tekening te controleren op problemen zoals niet-gesloten polylijnen, dubbele objecten of geometrie op laag 0
afstanden, lengtes en oppervlakten te meten
een stuklijst te maken op basis van blokreferenties
lagen, lijnen, bogen, cirkels, polylijnen, teksten, maatvoeringen en arceringen toe te voegen
bestaande objecten te verplaatsen, roteren, schalen, trimmen, afronden of er parallellen van te maken
de tekening te exporteren als PNG, PDF, SVG, DXF of DWG

In deze tutorial wordt uitgelegd hoe u QCAD onder Windows of macOS verbindt met Claude Desktop.

Vereisten

QCAD met de MCP-plugin, geïnstalleerd en actief op dezelfde computer als Claude Desktop
De Claude Desktop-app voor Windows of macOS

De QCAD-extensie voor Claude Desktop wordt met QCAD meegeleverd. Het is het bestand qcad.mcpb in de map mcp van uw QCAD-installatie, bijvoorbeeld:

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

Onder macOS bevindt de map zich in het programmapakket en wordt deze niet door de Finder getoond wanneer u de map Applications opent. Diverse > MCP > Installeren in Claude Desktop in QCAD opent of toont het bestand voor u (zie hieronder).

Node.js hoeft niet apart te worden geïnstalleerd. Claude Desktop bevat alles wat nodig is om de extensie uit te voeren.

De MCP-server in QCAD starten

De MCP-server in QCAD start niet vanzelf. Zolang de server niet is gestart, accepteert QCAD geen verbindingen.

Start QCAD.
Kies Diverse > MCP > Starten.

De opdrachtregel onderaan het QCAD-venster bevestigt dat de server actief is:

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

De server blijft actief totdat u Diverse > MCP > Stoppen kiest of QCAD afsluit. De server moet bij elke start van QCAD opnieuw worden gestart.

Het menu Diverse > MCP biedt ook:

Installeren in Claude Desktop: helpt u de QCAD-extensie in Claude Desktop te installeren (zie hieronder)
Status: toont op de opdrachtregel of de server actief is en op welke poort
Herstarten: stopt de server en start deze opnieuw, bijvoorbeeld na het wijzigen van de poort

De server accepteert alleen verbindingen vanaf dezelfde computer (adres 127.0.0.1). Hij is niet bereikbaar vanaf andere computers in uw netwerk.

De QCAD-extensie in Claude Desktop installeren

De extensie wordt slechts één keer geïnstalleerd. Zorg er voordat u begint voor dat Claude Desktop is geïnstalleerd en dat u bent aangemeld.

De QCAD-extensie is een lokale extensie: Claude Desktop voert deze uit op uw computer, waar de extensie verbinding maakt met de MCP-server in QCAD. Gebruik hiervoor niet Add custom connector in Claude. Aangepaste connectors accepteren alleen servers die via een https-adres vanaf het internet bereikbaar zijn, dus het adres http://127.0.0.1:3907/mcp van QCAD wordt daar niet geaccepteerd.

Windows

Kies in QCAD Diverse > MCP > Installeren in Claude Desktop. QCAD toont het bestand qcad.mcpb geselecteerd in de Verkenner. De opdrachtregel in QCAD toont ook de stappen om het te installeren.
Open in Claude Desktop het menu linksboven in het venster en kies File > Settings.
Ga naar Extensions, open Advanced settings en klik op Install Extension.
Kies het bestand qcad.mcpb, bijvoorbeeld C:\Program Files\QCAD\mcp\qcad.mcpb.

Dubbelklik onder Windows niet op het bestand qcad.mcpb en sleep het ook niet naar het venster van Claude Desktop. Geen van beide installeert de extensie: Claude Desktop registreert zich niet voor dit bestandstype, waardoor Windows bij een dubbelklik alleen vraagt met welke app het bestand moet worden geopend.

macOS

Kies in QCAD Diverse > MCP > Installeren in Claude Desktop. QCAD opent het bestand qcad.mcpb rechtstreeks in Claude Desktop.
Als Claude Desktop niet kan worden gevonden, toont QCAD het bestand in plaats daarvan in de Finder. Sleep het naar het venster van Claude Desktop, of kies Claude > Settings in de menubalk van Claude Desktop, ga naar Extensions, open Advanced settings, klik op Install Extension en kies het bestand.

De installatie voltooien

Claude Desktop toont de details van de QCAD-extensie. Klik op Install en bevestig.

Na de installatie verschijnt QCAD in de lijst met extensies onder Settings > Extensions. Zorg ervoor dat de extensie is ingeschakeld.

Instellingen van de extensie

De QCAD-extensie heeft drie instellingen, die in Claude Desktop kunnen worden gewijzigd onder Settings > Extensions > QCAD. Meestal hoeven de standaardwaarden niet te worden gewijzigd:

QCAD host: het adres van de QCAD MCP-server. Laat dit op 127.0.0.1 staan.
QCAD MCP port: de poort van de QCAD MCP-server, standaard 3907. Deze moet overeenkomen met de poort die in QCAD is ingesteld.
Reply timeout (ms): hoe lang Claude wacht op een antwoord van QCAD, standaard 60000 ms (één minuut). Verhoog deze waarde als u met zeer grote tekeningen werkt.

Werken met Claude en QCAD

Open een tekening in QCAD of begin met een nieuwe tekening.
Zorg ervoor dat de MCP-server actief is (Diverse > MCP > Status).
Open een nieuwe chat in Claude Desktop en vraag wat u nodig hebt, bijvoorbeeld:

Beschrijf de tekening die in QCAD is geopend.

Controleer de tekening in QCAD op problemen en geef een lijst van wat je vindt.

Maak een stuklijst op basis van de blokreferenties in de tekening.

Teken een rechthoek van 100 x 50 mm op een nieuwe laag "Omtrek" en rond alle hoeken af met een straal van 5 mm.

Claude bepaalt welke QCAD-gereedschappen worden gebruikt. De eerste keer dat een gereedschap wordt gebruikt, vraagt Claude Desktop om uw toestemming. U kunt het gereedschap eenmalig of altijd toestaan.

Claude werkt altijd met de tekening die op dat moment in QCAD actief is. Als er meerdere tekeningen geopend zijn, schakel dan in QCAD over naar de juiste tekening voordat u uw vraag stelt.

Wijzigingen die Claude aanbrengt, verschijnen direct in het QCAD-venster. Gereedschappen die bestaande objecten wijzigen of verwijderen, lagen hernoemen of ongebruikte lagen en blokken opschonen, melden alleen wat ze zouden wijzigen, tenzij Claude ze uitdrukkelijk vraagt de wijziging toe te passen. Als u een wijziging eerst wilt controleren, vraag Claude dan om u te laten zien wat het zou doen voordat de wijziging wordt toegepast. Elke wijziging kan in QCAD ongedaan worden gemaakt met Bewerken > Ongedaan maken of door Claude te vragen de wijziging ongedaan te maken.

Claude kan ook naar de tekening kijken: het geeft de tekening weer als afbeelding om te controleren wat erop staat of om het resultaat van een wijziging te verifiëren.

Spraakmodus

MCP is niet beschikbaar in de spraakmodus van Claude Desktop. De QCAD-gereedschappen kunnen alleen in tekstchats worden gebruikt. Om met QCAD te werken, typt u uw verzoeken in plaats van ze uit te spreken.

Privacy

De QCAD MCP-server en de extensie communiceren alleen op uw eigen computer met elkaar. Alles wat Claude uit uw tekening leest, bijvoorbeeld laagnamen, teksten, maatvoeringen en coördinaten, wordt echter als onderdeel van het gesprek naar Claude verzonden, net als alle andere inhoud die u in een chat deelt. Gebruik de MCP-server niet met tekeningen die uw computer niet mogen verlaten.

Probleemoplossing

Windows vraagt met welke app qcad.mcpb moet worden geopend

Claude Desktop voor Windows kan .mcpb-bestanden niet openen door erop te dubbelklikken. Sluit het dialoogvenster en installeer het bestand in plaats daarvan in Claude Desktop via File > Settings > Extensions > Advanced settings > Install Extension, zoals hierboven beschreven.

Claude accepteert het adres van QCAD niet als connector

Add custom connector in Claude werkt alleen met servers die vanaf het internet bereikbaar zijn. QCAD wordt in plaats daarvan via de QCAD-extensie verbonden, zoals hierboven beschreven.

Claude meldt “Cannot reach QCAD”

De extensie kan geen verbinding maken met QCAD. Controleer of:

QCAD actief is
de MCP-server is gestart met Diverse > MCP > Starten
de poort die door Diverse > MCP > Status wordt getoond, overeenkomt met de poort in de instellingen van de extensie in Claude Desktop

QCAD hoeft niet vóór Claude Desktop te worden gestart en Claude Desktop hoeft niet opnieuw te worden gestart na het starten van de MCP-server. Als Claude de QCAD-gereedschappen echter niet lijkt te kennen, start dan eerst QCAD en de MCP-server en open daarna een nieuwe chat in Claude Desktop.

De server kan niet worden gestart

Als Diverse > MCP > Starten meldt dat het adres al in gebruik is, gebruikt een ander programma of een ander QCAD-venster poort 3907 al. Slechts één QCAD-venster kan de MCP-server op een bepaalde poort uitvoeren. Stop de server in het andere QCAD-venster met Diverse > MCP > Stoppen en start hem in het venster waarin u wilt werken.

Claude werkt aan de verkeerde tekening

Claude werkt altijd met de actieve tekening van de QCAD-instantie waarin de MCP-server actief is. Klik in QCAD op het tabblad of het venster van de tekening waarmee Claude moet werken. Als er meerdere QCAD-instanties actief zijn, zorg er dan voor dat de MCP-server actief is in de instantie die u voor u hebt.

Een verzoek duurt lang of mislukt door een time-out

QCAD kan niet antwoorden zolang er in QCAD een dialoogvenster geopend is. Sluit alle geopende dialoogvensters in QCAD en vraag het opnieuw. Verhoog voor zeer grote tekeningen de Reply timeout in de instellingen van de extensie.