Connecter un agent IA à OwlCAD

Pointez Claude Code, Claude Desktop ou Cursor vers OwlCAD pour qu’il construise et vérifie des modèles pour vous.

OwlCAD parle MCP, le protocole que Claude Code, Claude Desktop et Cursor utilisent pour atteindre des outils externes : un agent peut donc construire des modèles prêts à imprimer sans navigateur. C’est une fonction Pro et cela ne consomme aucun crédit : l’agent à qui vous parlez déjà rédige le modèle lui-même, et OwlCAD fait la géométrie. Les outils couvrent toute la boucle : evaluate exécute le vrai noyau CAO et indique si la forme est solide, combien de triangles elle compte et quelle taille elle fait ; render renvoie des images que l’agent peut réellement regarder, seul moyen de distinguer une forme qui calcule d’une forme juste ; print_check signale les porte-à-faux, les parois fines et si cela tient sur votre imprimante ; export renvoie un STL, 3MF ou OBJ. Enregistrer donne un projet OwlCAD ordinaire : il apparaît dans votre tableau de bord avec un aperçu, et vous pouvez l’ouvrir et le modifier comme n’importe quel autre. Tout est en millimètres, Z vers le haut, rotations en degrés. Les trois clients ne se configurent pas de la même façon : Claude Code et Cursor acceptent directement l’adresse d’un serveur distant, mais le fichier de configuration de Claude Desktop ne sait que lancer un programme sur votre propre machine — il exécute donc une petite passerelle nommée mcp-remote qui porte la connexion jusqu’à nous. C’est pourquoi son bloc ne ressemble en rien à l’autre, et pourquoi y coller la version courte échoue sans jamais dire pourquoi. Si vous demandez des modifications sur plusieurs tours, dites à l’agent d’utiliser update_project plutôt que save_project : vous gardez un seul projet et un seul lien au lieu d’un nouveau à chaque fois. Il existe une seconde voie, pour un agent qui travaille dans un NAVIGATEUR plutôt qu’en mode headless : Claude dans Chrome, ou toute boucle d’utilisation de l’ordinateur qui pilote une vraie page. Contrairement à la voie MCP, elle est gratuite et ne demande aucun jeton — elle s’exécute dans votre propre navigateur. Ouvrez l’éditeur avec /app?agent=1 et la page reçoit une passerelle de script : l’agent appelle l’éditeur directement au lieu de deviner des coordonnées en pixels sur un canevas 3D dépourvu d’arbre d’accessibilité, et il peut prendre une capture d’écran pour voir ce qu’il a réellement fait. La lecture est toujours disponible, un agent peut donc inspecter n’importe quelle session de l’éditeur ; le paramètre est ce qui lui permet de MODIFIER, il ne vaut que pour cet onglet, et /app?agent=0 désactive de nouveau la modification. Tout ce qu’elle fait est une modification annulable ordinaire : Ctrl+Z revient sur ce que vous ne vouliez pas.

1. Créez un jeton d’accès avec les autorisations dont l’agent a besoin — la lecture seule suffit pour consulter votre travail.
2. Claude Code et Cursor atteignent le serveur directement : l’URL est https://mcp.owlcad.com et le jeton va dans un en-tête Authorization sous la forme « Bearer … ».
3. Claude Desktop ne le peut pas — son fichier de configuration ne lance que des serveurs locaux —, il exécute donc la passerelle mcp-remote : la commande est npx, les arguments sont -y mcp-remote https://mcp.owlcad.com --header Authorization:${AUTH_HEADER}, et le jeton va dans env sous la forme « Bearer … ». Copiez le bloc exact depuis owlcad.com/mcp-server : l’espace manquant après les deux-points est volontaire, car Claude Desktop sous Windows abîme un argument d’en-tête qui en contient une.
4. Redémarrez le client. Demandez-lui de lire d’abord owlcad://schema/primitives : on y trouve toutes les formes et la plage valide de chaque réglage.
5. Demandez un modèle. Une bonne boucle : le construire, lancer evaluate pour vérifier qu’il est solide, le rendre pour le regarder, puis save_project.
6. Demandez le lien de l’éditeur quand vous voulez reprendre la main — open_in_editor renvoie une URL qui ouvre le modèle dans OwlCAD.