MCP-Server für CAD — Model Context Protocol

Achtundzwanzig MCP-Tools, mit denen Claude Code, Claude Desktop oder Cursor druckfertige 3D-Modelle bauen, prüfen und exportieren. Streamable HTTP, Bearer-Token.

Der OwlCAD-MCP-Server

Ein MCP-Endpunkt, der einem Agenten einen echten CAD-Kern gibt: einen parametrischen Baum verfassen, auswerten, rendern, auf Druckbarkeit prüfen, exportieren und als Projekt speichern. Zustandsloses Streamable HTTP – jeder Aufruf ist ein eigenständiger POST.

https://mcp.owlcad.com · Pro-Plan erforderlich · Keine KI-Credits

Verbinden

Jeder MCP-Client, der HTTP spricht, funktioniert. Getestet werden Claude Code, Claude Desktop und Cursor. Claude Desktop braucht einen anderen Block als die beiden anderen, deshalb hat das Konfigurationsfeld für jeden einen eigenen Tab.

Öffne in OwlCAD Konto → Zugriffstoken und erstelle eines. Vergib nur die nötigen Berechtigungen; Lesen allein ist die Voreinstellung. Kopiere es sofort; gespeichert wird nur ein Hash.

Trage den Server in die Konfiguration deines MCP-Clients ein. Claude Code und Cursor nehmen die URL direkt entgegen, mit dem Token in einem Authorization-Header. Die Konfigurationsdatei von Claude Desktop kann gar keinen entfernten Server aufnehmen, deshalb startet ihr Block die Brücke mcp-remote — oder überspring die Datei ganz und nimm den Desktop-Connector weiter unten.

Starte den Client neu und lass den Agenten owlcad://schema/primitives lesen, bevor er irgendetwas baut.

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_…" } } } }

Du nutzt Claude Desktop? Der Abschnitt „Desktop-Connector“ weiter unten ist einfacher: keine Datei, kein Token. Dieser Block ist für alle, die eine Zugangsdatei bevorzugen. Die Konfigurationsdatei von Claude Desktop kennt nur lokal gestartete Server, also trägt mcp-remote die Verbindung zu uns hinaus. Kopiere diesen Block exakt: Nach dem Doppelpunkt in „Authorization:“ steht kein Leerzeichen, und das Token gehört in env statt in die Zeile, weil Claude Desktop unter Windows die Maskierung von Leerzeichen innerhalb von args verliert und den Header zerstört. Node muss installiert sein, und beim ersten Start wird die Brücke heruntergeladen.

Desktop-Connector

Claude Desktop erreicht den Server über seinen eigenen Connectors-Bereich, ganz ohne Konfigurationsdatei. Nichts zu bearbeiten, kein Token zu kopieren, kein Node zu installieren — du meldest dich im Browser bei OwlCAD an und genehmigst, was die Anwendung tun darf.

Öffne in Claude Desktop Einstellungen → Connectors → Eigenen Connector hinzufügen.

Füge die Server-URL ein und fahre fort.

Ein Browser öffnet sich. Melde dich bei OwlCAD an, lies, worum die Anwendung bittet, und genehmige es.

URL

https://mcp.owlcad.com

Der mcp-remote-Block oben funktioniert weiterhin und wird weiterhin unterstützt. Nimm ihn, wenn du ein Token lieber in einer Konfigurationsdatei behältst oder dein Client keinen Connectors-Bereich hat — Claude Code und Cursor nehmen die URL direkt und sind so oder so nicht betroffen.

Verbundene Anwendungen stehen unter Konto → Zugriffstokens, neben deinen persönlichen Tokens, aber in einer eigenen Karte. Trennen stoppt eine Anwendung bei ihrer nächsten Anfrage.

Konventionen

Stehen in den initialize-Anweisungen und in owlcad://schema/conventions – denn hier falsch zu liegen scheitert lautlos, nicht mit einem Fehler.

Millimeter für jede Abmessung und Koordinate.

Z nach oben – das Druckbett ist die XY-Ebene.

Drehungen in GRAD, nicht in Radiant. Ein in Radiant verfasster Baum wirkt fast ungedreht.

Genau eine Geometrie-Eingabe pro Aufruf: nodes, scad oder projectId.

Werkzeuge

Achtundzwanzig, die den ganzen Weg vom Verfassen bis zur druckfertigen Datei abdecken. Jedes braucht die angegebene Berechtigung; ein Token ohne sie bekommt einen lesbaren Fehler, der die fehlende Berechtigung nennt.

evaluate

Führt den echten CSG-Kern aus: wasserdicht oder nicht, Dreieckszahl, Abmessungen, Druckbarkeitswarnung.

print_check

Überhangfläche, dünnste Wand und ob es in den Bauraum eines bestimmten Druckers passt.

measure

Volumen, Oberfläche, Schwerpunkt und Körperanzahl, dazu das Filament, das ein Druck verbrauchen würde, und die Kosten.

check_interference

Welche Teile der obersten Ebene sich physisch überschneiden und um welches Volumen. Die Baugruppenprüfung, die kein Render zeigt.

render

PNG-Bilder des Modells aus benannten Ansichten – das Werkzeug, mit dem ein Agent seine eigene Arbeit sehen kann.

export

Wertet aus und liefert ein STL, 3MF oder OBJ als Base64.

export_step

STEP-B-Rep für den CAD-Austausch, an einem gespeicherten Projekt. OCCT braucht Minuten, daher läuft es als Auftrag: Sie erhalten eine Kennung und fragen sie ab.

job_status

Meldet den Stand einer Auftragskennung. Eine langsame Analyse an einem gespeicherten Projekt wird im Hintergrund beendet statt abgelehnt und liefert eine.

export_2d

Flacht das Modell zu DXF oder SVG ab: als Standfläche oder als waagerechter Schnitt auf gewählter Höhe.

save_project

Speichert ein Modell als Projekt in deinem Konto und liefert Id und Editor-Link zurück.

list_projects

Deine Projekte, neueste zuerst. So findet ein Agent eine Id.

get_project

Lädt eines deiner Projekte und listet seine Knoten, samt der version, die zum Aktualisieren nötig ist.

create_upload

Liefert eine URL zum Hochladen einer lokalen Datei, damit import_model und import_2d sie übernehmen können, ohne dass die Bytes durch den Kontext des Modells laufen. Kann der Client nicht hochladen, kommt zusätzlich ein Link, über den die Person es im Browser erledigt.

import_model

Importiert eine STL-, OBJ- oder 3MF-Datei als neues Projekt, erkennt die Einheit und meldet, ob das Mesh wasserdicht ist.

import_2d

Importiert eine DXF als neues Projekt und macht aus jedem geschlossenen Umriss eine editierbare parametrische Extrusion.

list_parts

Die parametrischen, datenblattgenauen Teile, die OwlCAD mitbringt: Halter, Schrauben, Platinen- und Motorkörper.

update_project

Ersetzt die Geometrie eines bestehenden Projekts und behält Id und Link. Erfordert die gelesene version.

edit_nodes

Dieselben Änderungen an einem Baum, den du mitschickst, bearbeitet zurückgegeben, gespeichert wird nichts. Iteriere an einem Modell, ohne es erneut zu senden, und prüfe oder exportiere dann das Ergebnis.

edit_project

Eine gezielte Änderung: Parameter setzen, Knoten verschieben, hinzufügen oder löschen, in ein Boolean gruppieren, Variable setzen.

remix_project

Forkt ein öffentliches Projekt in ein eigenes und behält die Herkunftsverknüpfung zum Original.

organize_project

Legt ein Projekt in einen deiner Ordner – oder holt es wieder heraus.

list_folders

Ordner, die dir gehören oder in denen du Mitglied bist, wohin organize_project ein Projekt legen kann.

delete_project

Löscht ein Projekt und seine Geometrie endgültig.

repair_project

Schweißt Risse, schließt Löcher und korrigiert Flächenrichtungen bei jedem importierten Mesh, das nicht wasserdicht ist.

split_for_printing

Schneidet ein Teil, das nicht aufs Druckbett passt, an einer Ebene in zwei Hälften — mit Stiften, Passfedern, Dübeln oder verschraubt, damit sie wieder zusammenfinden. Beide Hälften bleiben parametrisch.

share_project

Schaltet die öffentliche Freigabe ein oder aus und liefert den schreibgeschützten Link, also das, was man weitergibt.

open_in_editor

Der Link, der ein Projekt im OwlCAD-Editor öffnet – meist das Beste, was man einem Menschen geben kann.

ask_help

Fragt die OwlCAD-Dokumentation in normaler Sprache, welches Werkzeug etwas tut, und liefert Fließtext plus die Ids der herangezogenen Anleitungen. Antwortet nur aus der Dokumentation und sagt es, wenn etwas nicht abgedeckt ist.

Ressourcen

Nur lesbar, zur Laufzeit aus derselben Registry erzeugt, die der Validator durchsetzt – was ein Agent liest und was angewendet wird, können also nicht auseinanderlaufen.

owlcad://schema/primitives

Jede Form, jeder Modifikator und Generator, mit dem gültigen Bereich jedes Parameters. Zuerst lesen.

owlcad://schema/conventions

Einheiten, Achsen, Drehungseinheiten, Glättungsstufen und die Limits unten.

owlcad://schema/fasteners

Maße von Schrauben, Muttern und Gewindeeinsätzen, damit ein Loch zur tatsächlich vorhandenen Hardware passt.

owlcad://printers

Druckerprofile und Bauräume, für das printerId-Argument von print_check.

owlcad://materials

Filament-Materialien mit Dichte und Preis – die Grundlage für Gewicht und Kosten in measure.

owlcad://project/{projectId}

Eine URI-Vorlage: liest eines deiner Projekte als Ressource, mit demselben Inhalt, den get_project liefert.

Limits

Schranken, keine Produktkontingente – eine interaktive Sitzung sind Dutzende Aufrufe. Jedes wird pro Anfrage durchgesetzt.

Aufrufe pro Token und Tag

2.000 (ein Batch zählt pro Nachricht)

Projekte pro Konto und Tag

100

Nachrichten pro JSON-RPC-Batch

32

Anfrage-Budget

45 Sekunden

Inline-Exportgröße

8 MB · 200.000 Dreiecke

Importierte Mesh-Datei

6 MB

Token pro Konto

10

Richte deinen Agenten darauf.

Token erstellen, Server im Client eintragen, um ein Teil bitten. Pro-Plan erforderlich; keine KI-Credits.

Frequently asked questions

Was ist der OwlCAD-MCP-Server?

Ein MCP-Endpunkt (Model Context Protocol) unter https://mcp.owlcad.com, der einem KI-Agenten achtundzwanzig Werkzeuge zum Bauen, Prüfen und Exportieren druckfertiger 3D-Modelle gibt. Der Transport ist Streamable HTTP und zustandslos – jeder Aufruf ist ein eigenständiger POST, authentifiziert mit einem persönlichen Zugriffstoken.

Welche MCP-Clients funktionieren damit?

Jeder Client, der MCP über HTTP spricht – getestet werden Claude Code, Claude Desktop und Cursor. Richte den Client auf https://mcp.owlcad.com und übergib dein Token in einem Authorization-Header als Bearer-Credential.

Welche Einheiten und Konventionen gelten?

Millimeter, Z nach oben und Drehungen in GRAD. Das steht in den initialize-Anweisungen und in owlcad://schema/conventions, denn hier falsch zu liegen ist der klassische stille Fehler – ein in Radiant verfasster Baum wirkt fast ungedreht.

Woher weiß ich, welche Formen und Parameter gültig sind?

Lies zuerst owlcad://schema/primitives. Es wird zur Laufzeit aus derselben Registry erzeugt, die der Validator durchsetzt – die veröffentlichten Bereiche sind also genau die, die angewendet werden. Ein Agent muss nie einen Parameternamen oder eine Grenze raten.

Welche Limits gibt es?

2.000 Aufrufe pro Token und Tag, 100 erstellte Projekte pro Konto und Tag, bis zu 32 Nachrichten in einem JSON-RPC-Batch und 45 Sekunden Budget pro Anfrage. Token sind Pro-exklusiv und werden bei jeder Anfrage erneut geprüft, ein ausgelaufenes Abo stoppt eines also sofort.

OwlCAD · Funktionen · Preise · Galerie · Für Schulen · KI-Agenten · MCP-Server · STL-Editor · STL-Betrachter · 3MF-Editor · 3MF-Betrachter · OBJ-Editor · DXF-Editor · STEP-Viewer · OBJ-Viewer · GLB-Viewer · KI-3D-Generator · Modell-Konfigurator · Konfiguratoren-Galerie · Alle vergleichen · vs. TinkerCAD · vs. Onshape · vs. Fusion 360 · vs. FreeCAD · vs. SelfCAD · vs. OpenSCAD · Alle Ressourcen · Erste Schritte · Video-Tutorials · Hilfe-Center · Spendier mir einen Kaffee ☕ · Kontakt · Editor öffnen · Credits · Datenschutz · AGB