Serveur MCP CAO — modélisation 3D pour Claude et Cursor

Vingt-neuf outils MCP qui permettent à Claude Code, Claude Desktop ou Cursor de créer, vérifier et exporter des modèles 3D prêts à imprimer. Streamable HTTP.

Le serveur MCP d’OwlCAD

Un point d’accès MCP qui donne à un agent un vrai noyau CAO : rédiger un arbre paramétrique, l’évaluer, en faire le rendu, vérifier qu’il s’imprime, l’exporter et l’enregistrer comme projet. Streamable HTTP sans état — chaque appel est un POST autonome.

https://mcp.owlcad.com · Offre Pro requise · Aucun crédit IA

Regardez un agent construire une pièce

Une vraie session MCP de notre banc d’essai d’agents, abrégée pour la lecture : la tâche confiée, chaque outil appelé avec ce qu’il a mesuré, et la pièce obtenue. Ouvrez la pièce dans l’éditeur, sans compte.

Plaque de montage construite par un agent

“Build an 80 × 60 × 5 mm mounting plate with four 4 mm holes, one near each corner, 8 mm in from both edges. The holes must go all the way through.”

  • Modèle: Gemini 3.6 Flash
  • Taille: 80 × 60 × 5 mm

Connexion

Tout client MCP qui parle HTTP fonctionne. Nous testons Claude Code, Claude Desktop et Cursor. Claude Desktop demande un bloc différent des deux autres : le panneau de configuration a donc un onglet pour chacun.

Dans OwlCAD, ouvrez Compte → Jetons d’accès et créez-en un. N’accordez que les autorisations nécessaires ; la lecture seule est la valeur par défaut. Copiez-le immédiatement ; seul un hachage est conservé.

Ajoutez le serveur à la configuration de votre client MCP. Claude Code et Cursor acceptent l’URL directement, avec le jeton dans un en-tête Authorization. Le fichier de configuration de Claude Desktop ne peut tout simplement pas contenir de serveur distant : son bloc lance donc la passerelle mcp-remote — ou sautez le fichier et connectez-vous depuis l’annuaire de Claude, plus bas.

Redémarrez le client, puis faites lire owlcad://schema/primitives à l’agent avant qu’il ne construise quoi que ce soit.

Claude Code · Cursor — .mcp.json

{ "mcpServers": { "owlcad": { "url": "https://mcp.owlcad.com", "headers": { "Authorization": "Bearer owlcad_pat_…" } } } }

Claude Desktop — claude_desktop_config.json

{ "mcpServers": { "owlcad": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.owlcad.com", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer owlcad_pat_…" } } } }

Vous utilisez Claude Desktop ? La section « Connecteur Claude » plus bas est plus simple : aucun fichier, aucun jeton. Ce bloc s’adresse à qui préfère garder un identifiant dans un fichier de configuration. Le fichier de configuration de Claude Desktop ne connaît que les serveurs lancés en local ; c’est donc mcp-remote qui porte la connexion jusqu’à nous. Copiez ce bloc tel quel : les deux-points d’« Authorization: » ne sont suivis d’aucune espace, et le jeton va dans env plutôt que sur la ligne, car Claude Desktop sous Windows perd l’échappement des espaces à l’intérieur d’args et abîme l’en-tête. Node doit être installé, et le premier lancement télécharge la passerelle.

Connecteur Claude

OwlCAD figure dans l’annuaire de connecteurs de Claude : Claude sur le web et Claude Desktop s’y connectent en quelques clics. Aucun fichier de configuration, aucun jeton à copier, aucun Node à installer : vous vous connectez à OwlCAD dans un navigateur et approuvez ce que Claude pourra faire.

Ouvrir OwlCAD dans l’annuaire de Claude

Ouvrez la fiche d’OwlCAD dans l’annuaire de Claude, ou trouvez-la dans Claude sous Paramètres → Connecteurs → Parcourir les connecteurs.

Sélectionnez Connecter sur la fiche d’OwlCAD.

Un navigateur s’ouvre. Connectez-vous à OwlCAD, lisez ce que demande Claude, puis approuvez.

Pour ajouter le serveur par son URL, par exemple si l’administrateur de votre espace de travail a désactivé l’annuaire, choisissez Paramètres → Connecteurs → Ajouter un connecteur personnalisé et collez :

URL

https://mcp.owlcad.com

Le bloc mcp-remote ci-dessus fonctionne toujours et reste pris en charge. Utilisez-le si vous préférez garder un jeton dans un fichier de configuration, ou si votre client n’a pas d’écran de connecteurs — Claude Code et Cursor acceptent l’URL directement et ne sont concernés dans aucun cas.

Les applications connectées figurent dans Compte → Jetons d’accès, à côté de vos jetons personnels mais dans leur propre carte. En déconnecter une l’arrête dès sa requête suivante.

ChatGPT

ChatGPT atteint le serveur par le mode développeur, qui ajoute un serveur MCP distant à partir de son URL dans ChatGPT sur le web. Comme avec Claude, vous vous connectez à OwlCAD dans un navigateur au lieu de copier un jeton.

Dans ChatGPT sur le web, ouvrez Paramètres → Sécurité et connexion et activez le mode développeur. Sa disponibilité dépend de votre offre ChatGPT et, dans un espace de travail, de votre administrateur.

Allez sur chatgpt.com/plugins, sélectionnez le bouton plus et nommez la connexion OwlCAD.

Sous Connexion, saisissez l’URL du serveur et créez la connexion. ChatGPT affiche les outils qu’il a trouvés.

La première fois que ChatGPT utilise OwlCAD, une fenêtre de navigateur s’ouvre. Connectez-vous à OwlCAD, lisez ce que demande ChatGPT, puis approuvez.

URL

https://mcp.owlcad.com

Par défaut, ChatGPT vous demande de confirmer avant qu’un outil qui modifie vos projets ne s’exécute. La connexion figure dans Compte → Jetons d’accès comme toute autre application connectée, et la déconnecter là l’arrête dès sa requête suivante.

Gemini CLI

Gemini CLI installe OwlCAD comme extension depuis notre dépôt public, qui fournit aussi à Gemini un court guide des outils. Vous vous connectez à OwlCAD dans un navigateur, il n’y a donc aucun jeton à copier.

Dans un terminal, lancez la commande d’installation ci-dessous.

Démarrez Gemini CLI. La première fois qu’il utilise OwlCAD, un navigateur s’ouvre : connectez-vous à OwlCAD et approuvez. S’il ne s’ouvre pas, lancez /mcp auth owlcad.

Lancez /mcp pour vérifier qu’OwlCAD et ses outils sont listés.

gemini extensions install https://github.com/Spare-Matter/owlcad-plugin

Sur un compte gratuit ou Google One, Google a remplacé Gemini CLI par Antigravity CLI. Ajoutez-y OwlCAD dans ~/.gemini/config/mcp_config.json, et Antigravity vous connecte de la même façon :

{ "mcpServers": { "owlcad": { "serverUrl": "https://mcp.owlcad.com/" } } }

La connexion nécessite un navigateur sur le même ordinateur que Gemini CLI, elle ne fonctionne donc pas en SSH. Elle apparaît dans Compte → Jetons d’accès comme toute autre application connectée.

Conventions

Indiquées dans les instructions d’initialize et dans owlcad://schema/conventions, car se tromper ici échoue en silence plutôt qu’avec une erreur.

Millimètres pour chaque dimension et coordonnée.

Z vers le haut — le plateau est le plan XY.

Rotations en DEGRÉS, pas en radians. Un arbre rédigé en radians semble presque sans rotation.

Exactement une entrée de géométrie par appel : nodes, scad ou projectId.

Outils

Vingt-neuf, couvrant toute la boucle, de la rédaction au fichier prêt à imprimer. Chacun exige l’autorisation indiquée ; un jeton qui ne l’a pas reçoit une erreur lisible nommant l’autorisation manquante.

evaluate

Exécute le vrai noyau CSG : étanche ou non, nombre de triangles, encombrement, avertissement d’imprimabilité.

print_check

Surface en surplomb, paroi la plus fine, et compatibilité avec le volume d’une imprimante donnée.

measure

Volume, aire, centre de masse et nombre de corps, plus le filament que l’impression consommerait et son coût.

check_interference

Quelles pièces de premier niveau se chevauchent physiquement, et de quel volume. Le contrôle d’assemblage qu’aucun rendu ne montre.

render

Images PNG du modèle depuis des vues nommées — l’outil qui permet à un agent de voir son propre travail.

export

Évalue et renvoie un STL, 3MF ou OBJ en base64.

export_step

STEP B-rep pour l’échange CAO, sur un projet enregistré. OCCT prend des minutes : cela s’exécute comme une tâche, qui renvoie un identifiant à interroger.

job_status

Rapporte l’état d’un identifiant de tâche. Une analyse lente sur un projet enregistré se termine en arrière-plan au lieu d’être refusée, et en renvoie un.

export_2d

Aplatit le modèle en DXF ou SVG : son emprise, ou une coupe horizontale à la hauteur voulue.

save_project

Enregistre un modèle comme projet sur votre compte et renvoie son id et le lien de l’éditeur.

list_projects

Vos projets, du plus récent au plus ancien. C’est ainsi qu’un agent trouve un id.

get_project

Charge un de vos projets et liste ses nœuds, avec la version nécessaire pour le mettre à jour.

create_upload

Renvoie une URL où envoyer un fichier local, afin qu’import_model et import_2d puissent le prendre sans que les octets passent par le contexte du modèle. Si le client ne peut pas envoyer de fichier, un lien est aussi fourni pour que la personne le fasse dans son navigateur.

import_model

Importe un fichier STL, OBJ ou 3MF comme nouveau projet, en détectant l’unité et en indiquant si le maillage est étanche.

import_2d

Importe un DXF comme nouveau projet, chaque contour fermé devenant une extrusion paramétrique modifiable.

list_parts

Les pièces paramétriques et cotées d’après catalogue fournies par OwlCAD : équerres, visserie, cartes et moteurs.

read_resource

Les schémas et références des ressources ci-dessous, renvoyés comme résultat d’outil — pour les clients qui ne laissent pas le modèle lire les ressources lui-même.

update_project

Remplace la géométrie d’un projet existant en conservant son id et son lien. Exige la version que vous avez lue.

edit_nodes

Les mêmes modifications sur un arbre que vous transmettez, renvoyé modifié, et rien n’est enregistré. Itérez sur un modèle sans le renvoyer, puis évaluez ou exportez le résultat.

edit_project

Une modification ciblée : régler un paramètre, déplacer, ajouter ou retirer un nœud, grouper en booléen, définir une variable.

remix_project

Duplique un projet public en un projet à vous, en conservant le lien de filiation vers l’original.

organize_project

Classe un projet dans un de vos dossiers, ou l’en retire.

list_folders

Les dossiers que vous possédez ou dont vous êtes membre, là où organize_project peut classer un projet.

delete_project

Supprime définitivement un projet et sa géométrie.

repair_project

Soude les fissures, bouche les trous et corrige l’orientation des faces de tout maillage importé non étanche.

split_for_printing

Coupe en deux moitiés, selon un plan, une pièce trop grande pour le plateau, avec des connecteurs — goupilles, clavettes, goujons ou boulons — pour les réassembler. Les deux moitiés restent paramétriques.

share_project

Active ou désactive le partage public et renvoie le lien en lecture seule, ce que l’on remet à quelqu’un d’autre.

open_in_editor

Le lien qui ouvre un projet dans l’éditeur OwlCAD — généralement ce qu’il y a de mieux à remettre à une personne.

ask_help

Interroge la documentation OwlCAD, en langage courant, sur l’outil qui fait telle chose, et renvoie du texte et les ids des guides utilisés. Répond uniquement à partir de la documentation et le dit lorsqu’un sujet n’est pas couvert.

Ressources

En lecture seule, générées à l’exécution depuis le registre même qu’applique le validateur — ce que lit un agent et ce qui est appliqué ne peuvent donc pas diverger. Les clients qui ne laissent pas le modèle lire les ressources obtiennent le même contenu avec l’outil read_resource.

owlcad://schema/primitives

Chaque forme, modificateur et générateur, avec la plage valide de chaque paramètre. À lire en premier.

owlcad://schema/conventions

Unités, axes, unités de rotation, niveaux de finesse et les limites ci-dessous.

owlcad://schema/fasteners

Dimensions des vis, écrous et inserts thermiques, pour qu’un trou corresponde à la visserie dont vous disposez.

owlcad://schema/edit-ops

Chaque opération qu’acceptent edit_project et edit_nodes, avec les champs requis par chacune et la borne de chaque champ.

owlcad://printers

Profils d’imprimante et volumes d’impression, pour l’argument printerId de print_check.

owlcad://materials

Matériaux de filament avec densité et prix — la base de l’estimation de poids et de coût de measure.

owlcad://project/{projectId}

Un modèle d’URI : lit un de vos projets comme ressource, avec le contenu que renvoie get_project.

Limites

Des bornes, pas des quotas produit — une session interactive représente quelques dizaines d’appels. Chacune s’applique par requête.

Appels par jeton et par jour

2 000 (un lot compte une fois par message)

Projets créés par compte et par jour

100

Messages par lot JSON-RPC

32

Budget par requête

45 secondes

Taille d’export en ligne

8 Mo · 200 000 triangles

Fichier de maillage importé

6 Mo

Jetons par compte

10

Pointez votre agent dessus.

Créez un jeton, ajoutez le serveur à votre client et demandez une pièce. Offre Pro requise ; aucun crédit IA n’est dépensé.

Questions fréquentes

Qu’est-ce que le serveur MCP d’OwlCAD ?

Un point d’accès MCP (Model Context Protocol) à l’adresse https://mcp.owlcad.com qui donne à un agent IA vingt-neuf outils pour créer, vérifier et exporter des modèles 3D prêts à imprimer. Le transport est Streamable HTTP et sans état — chaque appel est un POST autonome authentifié par un jeton d’accès personnel.

Quels clients MCP sont compatibles ?

Tout client qui parle MCP sur HTTP — nous testons Claude Code, Claude Desktop et Cursor. Claude Code et Cursor acceptent https://mcp.owlcad.com directement, avec votre jeton dans un en-tête Authorization comme identifiant bearer. Claude Desktop est différent : claude_desktop_config.json n’accepte que les serveurs lancés sur votre propre machine, il atteint donc le point d’accès via la passerelle mcp-remote, configurée comme une commande avec des arguments plutôt que comme une URL. Copiez ce bloc depuis la page du serveur MCP au lieu de le saisir, car deux détails qui ressemblent à des erreurs sont indispensables : aucune espace après les deux-points dans l’argument Authorization, et le jeton dans env.

Quelles sont les unités et conventions ?

Millimètres, Z vers le haut et rotations en DEGRÉS. C’est indiqué dans les instructions d’initialize et dans la ressource owlcad://schema/conventions, car se tromper ici est l’erreur silencieuse classique — un arbre rédigé en radians semble presque sans rotation.

Comment savoir quelles formes et quels paramètres sont valides ?

Lisez d’abord la ressource owlcad://schema/primitives. Elle est générée à l’exécution depuis le registre même qu’applique le validateur : les plages publiées sont donc celles qui seront réellement appliquées — un agent n’a jamais à deviner un nom de paramètre ni une borne.

Quelles sont les limites ?

2 000 appels par jeton et par jour, 100 projets créés par compte et par jour, jusqu’à 32 messages dans un lot JSON-RPC, et un budget de 45 secondes par requête. Les jetons sont réservés à l’offre Pro et revérifiés à chaque requête : un abonnement expiré en arrête un immédiatement.

OwlCAD · Fonctionnalités · Tarifs · Galerie · Pour les écoles · Agents IA · Serveur MCP · Tous les formats de fichier · Éditeur STL · Visionneuse STL · Éditeur 3MF · Visionneuse 3MF · Éditeur OBJ · Éditeur DXF · Visionneuse STEP · Visionneuse OBJ · Visionneuse GLB · Générateur 3D par IA · Texte vers CAO · Configurateur de modèles · Galerie de configurateurs · Tout comparer · vs TinkerCAD · vs Onshape · vs Fusion 360 · vs FreeCAD · vs SelfCAD · face à OpenSCAD · Toutes les ressources · Prise en main · Tutoriels vidéo · Centre d’aide · Offrez-moi un café ☕ · Contact · Nouveautés · Ouvrir l’éditeur · Crédits · Confidentialité (en anglais) · Conditions (en anglais)