Serveur MCP pour la CAO — Model Context Protocol

Vingt-huit 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, le rendre, 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 · Forfait Pro requis · Aucun crédit IA

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 utilisez le connecteur Desktop 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 Desktop » 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 Desktop

Claude Desktop peut atteindre le serveur depuis son propre écran de connecteurs, sans aucun fichier de configuration. Rien à modifier, aucun jeton à copier, aucun Node à installer : vous vous connectez à OwlCAD dans un navigateur et approuvez ce que l’application pourra faire.

Dans Claude Desktop, ouvrez Paramètres → Connecteurs → Ajouter un connecteur personnalisé.

Collez l’URL du serveur et continuez.

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

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.

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-huit, 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 porte-à-faux, 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 le tirage 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 pour téléverser 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 téléverser, 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.

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 un assemblage — goupilles, clavettes, goujons ou boulonné — 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.

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 lissage 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://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. Forfait Pro requis ; aucun crédit IA n’est dépensé.

Frequently asked questions

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-huit 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 fonctionnent avec ?

Tout client qui parle MCP sur HTTP — nous testons Claude Code, Claude Desktop et Cursor. Pointez le client vers https://mcp.owlcad.com et passez votre jeton dans un en-tête Authorization comme identifiant bearer.

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 à 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 · Éditeur STL · Visionneuse STL · Éditeur 3MF · Visionneuse 3MF · Éditeur OBJ · Éditeur DXF · Visionneuse STEP · Visionneuse OBJ · Visionneuse GLB · Générateur 3D par IA · Personnaliseur 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 · Ouvrir l'éditeur · Crédits · Confidentialité · Conditions