Zur Dokumentation springen

API und MCP

Von einer Unterhaltung zu einer Zeichnung

Verbinden Sie Claude, ChatGPT oder ein anderes KI-Werkzeug mit dem MCP-Server von Occlusia, bestätigen Sie es und bringen Sie ein Modell vom Upload bis zum Export, indem Sie darum bitten.

Verbinden und bestätigen

  1. 01

    Die Adresse hinzufügen

    Fügen Sie in Ihrem KI-Werkzeug einen Remote-MCP-Server mit der Adresse https://api.occlusia.app/v1/mcp hinzu — in Claude unter Settings, Connectors, Add custom connector.

  2. 02

    Auf occlusia.app anmelden

    Beim ersten Aufruf von Occlusia öffnet das Werkzeug occlusia.app: Melden Sie sich bei Bedarf an. Das ist OAuth: Das Werkzeug sieht nie Ihr Passwort, und es gibt keinen Schlüssel zu kopieren.

  3. 03

    Die App bestätigen

    Die Seite sagt, welche App anfragt — mit ihrer bestätigten Identität, wenn sie eine hat —, wohin sie Sie zurückschickt und was sie tun darf. Lassen Sie sie nur zu, wenn Sie sie gerade selbst verbunden haben.

  4. 04

    Zurück in der Unterhaltung

    Das Werkzeug ist verbunden. Es erscheint in Ihrem Konto unter Verbundene Apps, wo Sie es jederzeit trennen können.

Ein Modell, vom Upload bis zum Export

Was Sie fragen und was die KI mit den Werkzeugen von Occlusia tut. Fragen Sie in Ihren eigenen Worten: Die KI liest die Anleitung und die Referenz von Occlusia von selbst.

  1. 01

    „Öffne mein Modell“

    Die KI gibt Ihnen einen Link zu einer Seite, auf die Sie Ihr .skp-, .ifc-, .fbx- oder .occs-Modell oder ein .occp-Projekt ziehen — oder holt es von einem öffentlichen Link, den Sie angeben. Das Öffnen kostet einen Credit.

  2. 02

    „Was enthält es?“

    Sie listet die Darstellungen des Modells auf, seine Objekte nach Gruppen, seine Beschriftungen und Höhenkoten. Auflisten ist kostenlos.

  3. 03

    „Schraffiere den Beton mit AR-CONC, mit einer BOLD-Schnittlinie“

    Sie ändert die Einstellungen der Objekte, die Sie nennen — oder wendet Ihre Konfiguration ganz an, wenn Sie ihr Ihre .occc-Datei geben.

  4. 04

    „Zeig mir Section A-A“

    Sie zeichnet die Darstellung und sieht das Bild, sodass sie ihre eigene Arbeit prüfen und Ihnen zeigen kann. Jede neue Zeichnung kostet einen Credit; dieselbe Zeichnung erneut ist kostenlos.

  5. 05

    „Exportiere Section A-A und den Grundriss als ein A3-PDF im Maßstab 1:50“

    Sie exportiert und gibt Ihnen für jede Datei einen Download-Link. Ein PDF kostet einen Credit pro Blatt.

Der Arbeitsbereich

  • Was die KI öffnet, einstellt und exportiert, bleibt in Ihrem Arbeitsbereich von einer Anfrage zur nächsten und von einer Unterhaltung zur nächsten erhalten, solange er genutzt wird. Er endet nach 15 Minuten ohne Nutzung, und seine Dateien mit ihm.
  • workspace_status sagt, was er enthält; bitten Sie die KI, den Arbeitsbereich zurückzusetzen, um neu zu beginnen.
  • Bewahren Sie auf, was wichtig ist: Bitten Sie um das Projekt (.occp) oder die Konfiguration (.occc) als Download.

Was das KI-Werkzeug sieht

Ihr KI-Werkzeug erhält, was die Werkzeuge von Occlusia antworten — die Namen der Objekte und Darstellungen Ihres Modells, die Vorschauen, die sie zeichnen, die Download-Links — und sein Anbieter bewahrt sie nach seinen eigenen Bedingungen auf. Occlusia bewahrt Ihre Dateien nur in Ihrem Arbeitsbereich auf und löscht sie, wenn er endet.

Stattdessen mit einem API-Schlüssel

Ein Werkzeug, das einen Header sendet, kann anstelle von OAuth einen API-Schlüssel verwenden. Der Server spricht MCP 2026-07-28 sowie 2025-11-25 zurück bis 2025-03-26.

claude mcp add --transport http occlusia https://api.occlusia.app/v1/mcp \
  --header "Authorization: Bearer occ_sk_…"
Mit Claude Code oder in den MCP-Einstellungen eines anderen KI-Werkzeugs.