Naar de documentatie

API en MCP

Van een gesprek naar een tekening

Koppel Claude, ChatGPT of een andere AI-tool aan de MCP-server van Occlusia, keur haar goed en breng een model van upload tot export door erom te vragen.

Koppelen en goedkeuren

  1. 01

    Het adres toevoegen

    Voeg in uw AI-tool een externe MCP-server toe met het adres https://api.occlusia.app/v1/mcp — in Claude onder Settings, Connectors, Add custom connector.

  2. 02

    Aanmelden op occlusia.app

    De eerste keer dat de tool Occlusia aanroept, opent ze occlusia.app: meld u zo nodig aan. Dit is OAuth: de tool ziet nooit uw wachtwoord, en er is geen sleutel om te kopiëren.

  3. 03

    De app goedkeuren

    De pagina zegt welke app het vraagt — met haar geverifieerde identiteit als ze er een heeft —, waarheen ze u terugstuurt en wat ze zal kunnen doen. Sta haar alleen toe als u haar zojuist zelf hebt gekoppeld.

  4. 04

    Terug in het gesprek

    De tool is gekoppeld. Ze verschijnt onder Gekoppelde apps in uw account, waar u haar op elk moment kunt ontkoppelen.

Een model, van upload tot export

Wat u vraagt, en wat de AI doet met de tools van Occlusia. Vraag in uw eigen woorden: de AI leest de gids en het naslagwerk van Occlusia zelf.

  1. 01

    “Open mijn model”

    De AI geeft u een link naar een pagina waarop u uw .skp-, .ifc-, .fbx- of .occs-model neerzet, of een .occp-project — of haalt het op via een openbare link die u geeft. Het openen kost één credit.

  2. 02

    “Wat bevat het?”

    Ze somt de weergaven van het model op, zijn objecten per groep, zijn notities en peilmaten. Opsommen is gratis.

  3. 03

    “Arceer het beton met AR-CONC, met een BOLD snijlijn”

    Ze wijzigt de instellingen van de objecten die u noemt — of past uw configuratie in zijn geheel toe, als u uw .occc-bestand geeft.

  4. 04

    “Toon me Section A-A”

    Ze tekent de weergave en ziet de afbeelding, zodat ze haar eigen werk kan controleren en aan u kan tonen. Elke nieuwe tekening kost één credit; dezelfde tekening opnieuw is gratis.

  5. 05

    “Exporteer Section A-A en de plattegrond als één A3-pdf op 1:50”

    Ze exporteert en geeft u een downloadlink voor elk bestand. Een pdf kost één credit per blad.

De werkruimte

  • Wat de AI opent, instelt en exporteert, blijft in uw werkruimte bewaard van het ene verzoek naar het volgende, en van het ene gesprek naar het volgende, zolang ze wordt gebruikt. Ze eindigt na 15 minuten zonder gebruik, en haar bestanden met haar.
  • workspace_status zegt wat ze bevat; vraag de AI om de werkruimte te resetten om opnieuw te beginnen.
  • Bewaar wat telt: vraag het project (.occp) of de configuratie (.occc) als download.

Wat de AI-tool ziet

Uw AI-tool ontvangt wat de tools van Occlusia antwoorden — de namen van de objecten en weergaven van uw model, de voorbeelden die ze tekent, de downloadlinks — en haar aanbieder bewaart ze onder zijn eigen voorwaarden. Occlusia bewaart uw bestanden alleen in uw werkruimte, en verwijdert ze wanneer die eindigt.

Met een API-sleutel in plaats daarvan

Een tool die een header meestuurt, kan een API-sleutel gebruiken in plaats van OAuth. De server spreekt MCP 2026-07-28, en 2025-11-25 terug tot 2025-03-26.

claude mcp add --transport http occlusia https://api.occlusia.app/v1/mcp \
  --header "Authorization: Bearer occ_sk_…"
Met Claude Code, of in de MCP-instellingen van een andere AI-tool.