Utiliser QCAD avec Claude Desktop

Introduction

QCAD contient un serveur MCP (Model Context Protocol). MCP est un standard ouvert qui permet aux assistants d’IA d’utiliser des outils fournis par d’autres applications. Grâce au serveur MCP de QCAD, l’application Claude Desktop peut travailler directement avec le dessin actuellement ouvert dans QCAD. Vous pouvez par exemple demander à Claude de :

décrire un dessin inconnu, ses calques, ses blocs, ses cotes et ses textes
rechercher dans un dessin des problèmes tels que des polylignes non fermées, des entités en double ou de la géométrie sur le calque 0
mesurer des distances, des longueurs et des aires
créer une nomenclature à partir des références de blocs
ajouter des calques, des lignes, des arcs, des cercles, des polylignes, des textes, des cotes et des hachures
déplacer, faire pivoter, mettre à l’échelle, ajuster, arrondir ou décaler des entités existantes
exporter le dessin au format PNG, PDF, SVG, DXF ou DWG

Ce tutoriel explique comment connecter QCAD à Claude Desktop sous Windows ou macOS.

Prérequis

QCAD avec le plugin MCP, installé et en cours d’exécution sur le même ordinateur que Claude Desktop
L’application Claude Desktop pour Windows ou macOS

L’extension QCAD pour Claude Desktop est fournie avec QCAD. Il s’agit du fichier qcad.mcpb dans le dossier mcp de votre installation de QCAD, par exemple :

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

Sous macOS, le dossier se trouve à l’intérieur du paquet de l’application et n’est pas affiché par le Finder lorsque vous ouvrez le dossier Applications. Dans QCAD, Divers > MCP > Installer dans Claude Desktop ouvre ou affiche le fichier pour vous (voir ci-dessous).

Il n’est pas nécessaire d’installer Node.js séparément. Claude Desktop fournit tout ce qui est nécessaire pour exécuter l’extension.

Démarrer le serveur MCP dans QCAD

Le serveur MCP de QCAD ne démarre pas de lui-même. Tant qu’il n’est pas démarré, QCAD n’accepte aucune connexion.

Démarrez QCAD.
Choisissez Divers > MCP > Démarrer.

La ligne de commande en bas de la fenêtre de QCAD confirme que le serveur est en cours d’exécution :

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

Le serveur reste actif jusqu’à ce que vous choisissiez Divers > MCP > Arrêter ou que vous quittiez QCAD. Il doit être redémarré à chaque démarrage de QCAD.

Le menu Divers > MCP propose également :

Installer dans Claude Desktop : vous aide à installer l’extension QCAD dans Claude Desktop (voir ci-dessous)
État : indique dans la ligne de commande si le serveur est en cours d’exécution et sur quel port
Redémarrer : arrête puis redémarre le serveur, par exemple après la modification de son port

Le serveur n’accepte que les connexions provenant du même ordinateur (adresse 127.0.0.1). Il n’est pas accessible depuis d’autres ordinateurs de votre réseau.

Installer l’extension QCAD dans Claude Desktop

L’extension ne doit être installée qu’une seule fois. Avant de commencer, assurez-vous que Claude Desktop est installé et que vous êtes connecté.

L’extension QCAD est une extension locale : Claude Desktop l’exécute sur votre ordinateur, où elle se connecte au serveur MCP de QCAD. N’utilisez pas Add custom connector dans Claude pour cela. Les connecteurs personnalisés n’acceptent que des serveurs accessibles depuis Internet via une adresse https ; l’adresse http://127.0.0.1:3907/mcp de QCAD n’y est donc pas acceptée.

Windows

Dans QCAD, choisissez Divers > MCP > Installer dans Claude Desktop. QCAD affiche le fichier qcad.mcpb sélectionné dans l’Explorateur de fichiers. La ligne de commande de QCAD indique également les étapes de l’installation.
Dans Claude Desktop, ouvrez le menu en haut à gauche de la fenêtre et choisissez File > Settings.
Allez dans Extensions, ouvrez Advanced settings et cliquez sur Install Extension.
Choisissez le fichier qcad.mcpb, par exemple C:\Program Files\QCAD\mcp\qcad.mcpb.

Sous Windows, ne double-cliquez pas sur le fichier qcad.mcpb et ne le faites pas glisser dans la fenêtre de Claude Desktop. Aucune de ces deux actions n’installe l’extension : Claude Desktop ne s’enregistre pas pour ce type de fichier, et un double-clic amène donc seulement Windows à demander avec quelle application ouvrir le fichier.

macOS

Dans QCAD, choisissez Divers > MCP > Installer dans Claude Desktop. QCAD ouvre directement le fichier qcad.mcpb dans Claude Desktop.
Si Claude Desktop est introuvable, QCAD affiche plutôt le fichier dans le Finder. Faites-le glisser dans la fenêtre de Claude Desktop, ou choisissez Claude > Settings dans la barre de menus de Claude Desktop, allez dans Extensions, ouvrez Advanced settings, cliquez sur Install Extension et choisissez le fichier.

Finaliser l’installation

Claude Desktop affiche les détails de l’extension QCAD. Cliquez sur Install et confirmez.

Après l’installation, QCAD apparaît dans la liste des extensions sous Settings > Extensions. Assurez-vous qu’elle est activée.

Paramètres de l’extension

L’extension QCAD possède trois paramètres, qui peuvent être modifiés dans Claude Desktop sous Settings > Extensions > QCAD. En général, il n’est pas nécessaire de modifier les valeurs par défaut :

QCAD host : l’adresse du serveur MCP de QCAD. Laissez-la à 127.0.0.1.
QCAD MCP port : le port du serveur MCP de QCAD, par défaut 3907. Il doit correspondre au port configuré dans QCAD.
Reply timeout (ms) : la durée pendant laquelle Claude attend une réponse de QCAD, par défaut 60000 ms (une minute). Augmentez cette valeur si vous travaillez avec de très grands dessins.

Travailler avec Claude et QCAD

Ouvrez un dessin dans QCAD ou commencez avec un nouveau dessin.
Assurez-vous que le serveur MCP est en cours d’exécution (Divers > MCP > État).
Ouvrez une nouvelle conversation dans Claude Desktop et demandez ce dont vous avez besoin, par exemple :

Décris le dessin qui est ouvert dans QCAD.

Recherche les problèmes dans le dessin ouvert dans QCAD et liste ce que tu trouves.

Crée une nomenclature à partir des références de blocs du dessin.

Dessine un rectangle de 100 x 50 mm sur un nouveau calque "Contour" et arrondis tous les coins avec un rayon de 5 mm.

Claude décide quels outils de QCAD utiliser. La première fois qu’un outil est utilisé, Claude Desktop vous demande votre autorisation. Vous pouvez autoriser l’outil une seule fois ou toujours.

Claude travaille toujours avec le dessin actuellement actif dans QCAD. Si plusieurs dessins sont ouverts, passez au bon dessin dans QCAD avant de poser votre question.

Les modifications effectuées par Claude apparaissent immédiatement dans la fenêtre de QCAD. Les outils qui modifient ou suppriment des entités existantes, renomment des calques ou purgent les calques et blocs inutilisés indiquent seulement ce qu’ils modifieraient, sauf si Claude leur demande explicitement d’appliquer la modification. Si vous souhaitez d’abord vérifier une modification, demandez à Claude de vous montrer ce qu’il ferait avant de l’appliquer. Chaque modification peut être annulée dans QCAD avec Édition > Annuler ou en demandant à Claude de l’annuler.

Claude peut également regarder le dessin : il effectue un rendu du dessin sous forme d’image pour vérifier ce qu’il montre ou pour contrôler le résultat d’une modification.

Mode vocal

MCP n’est pas disponible dans le mode vocal de Claude Desktop. Les outils de QCAD ne peuvent être utilisés que dans les conversations textuelles. Pour travailler avec QCAD, tapez vos demandes au lieu de les dicter.

Confidentialité

Le serveur MCP de QCAD et l’extension communiquent uniquement entre eux sur votre propre ordinateur. Cependant, tout ce que Claude lit dans votre dessin, par exemple les noms de calques, les textes, les cotes et les coordonnées, est envoyé à Claude dans le cadre de la conversation, comme tout autre contenu que vous partagez dans une conversation. N’utilisez pas le serveur MCP avec des dessins qui ne doivent pas quitter votre ordinateur.

Dépannage

Windows demande avec quelle application ouvrir qcad.mcpb

Claude Desktop pour Windows ne peut pas ouvrir les fichiers .mcpb par double-clic. Fermez la boîte de dialogue et installez plutôt le fichier dans Claude Desktop sous File > Settings > Extensions > Advanced settings > Install Extension, comme décrit ci-dessus.

Claude n’accepte pas l’adresse de QCAD comme connecteur

Add custom connector dans Claude ne fonctionne qu’avec des serveurs accessibles depuis Internet. QCAD est connecté par l’intermédiaire de l’extension QCAD, comme décrit ci-dessus.

Claude signale « Cannot reach QCAD »

L’extension ne peut pas se connecter à QCAD. Vérifiez que :

QCAD est en cours d’exécution
le serveur MCP a été démarré avec Divers > MCP > Démarrer
le port affiché par Divers > MCP > État correspond au port indiqué dans les paramètres de l’extension dans Claude Desktop

Il n’est pas nécessaire de démarrer QCAD avant Claude Desktop, ni de redémarrer Claude Desktop après avoir démarré le serveur MCP. Toutefois, si Claude ne semble pas connaître les outils de QCAD, démarrez d’abord QCAD et son serveur MCP, puis ouvrez une nouvelle conversation dans Claude Desktop.

Le serveur ne peut pas être démarré

Si Divers > MCP > Démarrer signale que l’adresse est déjà utilisée, un autre programme ou une autre fenêtre de QCAD utilise déjà le port 3907. Une seule fenêtre de QCAD peut exécuter le serveur MCP sur un port donné. Arrêtez le serveur dans l’autre fenêtre de QCAD avec Divers > MCP > Arrêter et démarrez-le dans la fenêtre dans laquelle vous souhaitez travailler.

Claude travaille sur le mauvais dessin

Claude travaille toujours avec le dessin actif de l’instance de QCAD qui exécute le serveur MCP. Dans QCAD, cliquez sur l’onglet ou la fenêtre du dessin avec lequel Claude doit travailler. Si plusieurs instances de QCAD sont en cours d’exécution, assurez-vous que le serveur MCP est en cours d’exécution dans l’instance que vous avez sous les yeux.

Une requête prend beaucoup de temps ou échoue avec un dépassement de délai

QCAD ne peut pas répondre tant qu’une boîte de dialogue est ouverte dans QCAD. Fermez toutes les boîtes de dialogue ouvertes dans QCAD et posez à nouveau votre question. Pour les très grands dessins, augmentez le Reply timeout dans les paramètres de l’extension.