Entwickler

Der Modellierer ist eine API.

Die Oberfläche ist nur ein Client eines Katalogs von Aktionen — über 240 im Kern, mehr mit jedem Modul — jede mit einem JSON-Schema. Ihre Skripte, Ihre CI und Ihre Agenten rufen genau dieselben auf, mit denselben Berechtigungen, Revisionen und demselben Rückgängig-Machen.

RESTMCPPythonPluginsOpenAPI

REST

Ein Endpunkt pro Aktion.

Listen Sie den Katalog mit seinen Schemas auf und rufen Sie dann jede Aktion auf der Revision auf, die Sie halten. Optimistische Nebenläufigkeit bei jeder Änderung: Hat jemand zwischendurch bearbeitet, erfahren Sie es, statt überschrieben zu werden.

  • Token mit Geltungsbereich für Lesen, Schreiben, KI und Administration.
  • Batch: bis zu 100 Befehle als eine Revision und ein Rückgängig-Schritt — alles oder nichts.
  • Deltas: Ein Client, der ein Modell hält, erhält die Änderung, nicht die Datei.
  • Abbruch erreicht den Geometrie-Worker; für eine abgebrochene Anfrage wird nichts übernommen.

$KOZOROSA ist Ihre Foundry-Adresse oder die lokale Adresse, die Kozorosa für Mac unter Help → Connect an AI Agent angibt.

# Everything the modeler can do, with its schema
curl -H "Authorization: Bearer $TOKEN" \
     $KOZOROSA/api/studio/actions

# One edit, on the revision you hold
curl -X POST $KOZOROSA/api/studio/actions/push_pull \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model_id":"…","expected_revision":12,
       "args":{"target":"body1","face_id":"f7","distance":40}}'

# A hundred commands as one revision and one undo step
curl -X POST $KOZOROSA/api/studio/actions/batch …

MCP

Ihr Agent am Steuer.

Der MCP-Endpunkt stellt den Katalog als Werkzeuge bereit. Settings → API → Connect an AI agent liefert die fertige Konfiguration für Claude Code, Claude Desktop, Codex, Cursor, VS Code, Gemini und Windsurf.

  • Vorschläge: propose_changes zeigt die Änderung als Geisterbild im Ansichtsfenster; angewendet wird sie erst, wenn ein Mensch zustimmt.
  • Abfragen, die nichts kosten: describe_body, mass_properties, measure und die Modullisten.
  • Notizen: Ein Agent bewahrt sein Gedächtnis zu einem Modell in den Notizen des Modells auf.
Einen Agenten verbinden, Schritt für Schritt
POST /mcp
X-API-Key: ign_…          # scope: ai

{"jsonrpc": "2.0", "id": 1,
 "method": "tools/call",
 "params": {
   "name": "propose_changes",
   "arguments": {
     "model_id": "…",
     "title": "Lighten the web by 18%",
     "commands": [
       {"action": "shell",
        "args": {"target": "web", "thickness": 2.4}}
     ]
   }}}

Python

Schleifen, Arithmetik und das Modell zurückgelesen.

Die Python-Konsole bindet den gesamten Katalog an einen Namen, cad. Ein Skript läuft in einem eigenen, isolierten Prozess; es ist eine Bearbeitung und ein Rückgängig-Schritt, und ein fehlschlagendes Skript ändert nichts.

Ein Skript ausführen, Schritt für Schritt
n = params["cells"]
pitch = params["pitch"]
strut = params["strut"]

for i in range(n + 1):
    for j in range(n + 1):
        cad.create_box(width=strut, depth=strut,
                       height=n * pitch,
                       position=[i * pitch, j * pitch, 0])

print("struts:", len(cad.features))
result = {"struts": len(cad.features),
          "extent_mm": n * pitch}

Erweitern

Plugins und Module.

Teile

Parametrische Plugins

Ein Plugin ist ein deklaratives Rezept in einem signierten Manifest — es wird nie Plugin-Code ausgeführt. Beginnen Sie mit der Vorlage, laden Sie es für sich selbst hoch oder installieren Sie es für eine ganze Organisation.

Bibliothek

Geprüfte Teile

Stirn- und Kegelräder, ISO-Gewinde, Sechskantschrauben und -muttern, Unterlegscheiben, Schraubenfedern, Rohrflansche und Rändel, jeweils durch einen SHA-256 ihres Manifests fixiert.

Module

Ganze Gewerke

Module fügen Kernel-Aktionen, Abfragen, Exportformate, Werkzeuge und Seiten hinzu — die Baumodule sind auf diese Weise gebaut.

Bauen Sie auf einem Modellierer, der antwortet.

Importieren Sie eine STEP-Datei, ziehen Sie eine Fläche, setzen Sie ein Maß daran. 5 Tage, jedes Werkzeug, nichts zu bezahlen, bis Sie sich entscheiden.