Quickstart: connect your agent

In five minutes you’ll connect an MCP-aware client to openIE CAD and have it build a real part you can open in the viewer.

1. Add the MCP server

openIE CAD speaks the Model Context Protocol over Streamable HTTP at:

https://cad.openie.dev/mcp

Authentication is OAuth 2.0 (dynamic client registration + PKCE) — most clients open a browser to authorize on first use.

claude.ai

Open Settings → Connectors → Add custom connector, then paste the URL https://cad.openie.dev/mcp and authorize when prompted. The tools appear in the tool list.

Claude Desktop / Cursor

Add the server to your MCP config (claude_desktop_config.json or your client’s mcp.json):

{
  "mcpServers": {
    "openie-cad": {
      "type": "streamable-http",
      "url": "https://cad.openie.dev/mcp"
    }
  }
}

Restart the client and approve the connection.

Custom SDK

Any MCP SDK works. Connect with the Streamable HTTP transport to https://cad.openie.dev/mcp, complete the OAuth flow, then call list_tools().

2. Ask it to build something

With the server connected, prompt your agent in plain language:

Create a 40 × 20 × 10 mm box, drill a 6 mm hole through the top, then export it as STL.

Behind the scenes the agent calls real tools — create_box, create_cylinder, boolean_subtract, export_stl — against the Truck B-Rep kernel. It gets back a real mesh, not a picture.

Tip

Prefer one shot? Ask the agent to use design_part_from_spec and describe the whole part in a sentence — the planner emits the op-list and the kernel executes it.

3. See it

Everything the agent does writes to a shared project. Open the viewer to watch it appear:

👉 cad.openie.dev/app

The viewer renders the 3D body, schematic, PCB, and any simulation overlays — five views on one document.

Next steps

• Learn: your first part — build something real, step by step.
• Learn: OCL basics — describe a whole product in one file.
• Reference: the MCP tools — everything your agent can call.
• Examples — complete designs to open and re-derive.