From a conversation to a drawing

1. 01

   Add the address

   In your AI tool, add a remote MCP server with the address https://api.occlusia.app/v1/mcp — in Claude, under Settings, Connectors, Add custom connector.

2. 02

   Sign in on occlusia.app

   The first time the tool calls Occlusia, it opens occlusia.app: sign in if needed. This is OAuth: the tool never sees your password, and there is no key to copy.

3. 03

   Approve the app

   The page says which app asks — its verified identity when it has one —, where it will send you back, and what it will be able to do. Allow it only if you have just connected it yourself.

4. 04

   Back in the conversation

   The tool is connected. It appears under Connected apps in your account, where you can disconnect it at any time.

1. 01

   “Open my model”

   The AI gives you a link to a page where you drop your .skp, .ifc, .fbx or .occs model, or an .occp project — or fetches it from a public link you give. Opening it costs one credit.

2. 02

   “What does it contain?”

   It lists the model's views, its objects by group, its notes and spot elevations. Listing is free.

3. 03

   “Hatch the concrete with AR-CONC, with a BOLD cut line”

   It changes the settings of the objects you name — or applies your configuration whole, if you give it your .occc file.

4. 04

   “Show me Section A-A”

   It draws the view and sees the image, so it can check its own work and show it to you. Each new drawing costs one credit; the same drawing again is free.

5. 05

   “Export Section A-A and the plan as one A3 PDF at 1:50”

   It exports and hands you a download link for each file. A PDF costs one credit per sheet.

• What the AI opens, sets and exports stays in your workspace from one request to the next, and from one conversation to the next, while it is used. It ends after 15 minutes unused, and its files with it.
• workspace_status says what it holds; ask the AI to reset the workspace to start again.
• Keep what matters: ask for the project (.occp) or the configuration (.occc) as a download.

Your AI tool receives what Occlusia's tools answer — the names of your model's objects and views, the previews it draws, the download links — and its provider keeps them under its own terms. Occlusia keeps your files only in your workspace, and deletes them when it ends.

A tool that sends a header can use an API key in place of OAuth. The server speaks MCP 2026-07-28, and 2025-11-25 back to 2025-03-26.

claude mcp add --transport http occlusia https://api.occlusia.app/v1/mcp \
  --header "Authorization: Bearer occ_sk_…"