How to Connect Claude to SolidCraft: MCP Setup and What Runs Where
▶ Watch on YouTube & subscribe to The Stack Underflow
Claude can’t click around in your CAD program on its own. It needs a plug: a small program that sits between a Claude app and SolidCraft and turns Claude’s requests into real SolidCraft actions. This lesson sets that plug up and then proves it works with a part you can measure yourself.
The one-line version: install SolidCraft, click Connect AI assistants, restart Claude. Then ask for a 20 mm cube and check that SolidCraft measures 8,000 mm³.
Last verified in our lab: 27 October 2026 (SolidCraft 0.24.1, Linux x86_64 in Docker; Claude Code 2.1.311 with Claude Sonnet 5.5). Lesson 2 onwards uses newer SolidCraft versions, so update when the lesson says so.
The idea first: what runs where
Three pieces are involved, and only one of them is in the cloud:
| Piece | Where it runs | What it does |
|---|---|---|
| Claude (the model) | Anthropic’s cloud | Reads your request and decides which tool to call |
| The Claude app (Claude Desktop or Claude Code) | Your computer | Sends your messages to Claude and runs the tool calls Claude asks for |
| SolidCraft and its plug | Your computer | The plug offers SolidCraft’s actions as tools; SolidCraft does the actual modelling |
MCP (the Model Context Protocol) is the standard way a Claude app talks to such a plug. An MCP server is the plug itself; a tool is one action it offers, such as “inspect the design” or “measure”. SolidCraft’s plug offers 19 tools (we read its own tool list).
Without the plug, Claude can only describe what to do. In our test with no setup, and Claude allowed to run nothing, it only typed out commands; nothing ran.
Before you start
Install a Claude app (Claude Desktop from claude.com/download, or Claude Code), open it once and sign in. Which plans include which app is in the FAQ on that download page.
The setup, step by step
- Install SolidCraft’s desktop app, the newest version, from solidcraft.io/download. The in-browser version has no plug for the Claude app. Windows may warn that the download isn’t signed yet: SolidCraft’s instructions say More info, then Run anyway. On a Mac, the first time, right-click SolidCraft in Applications and choose Open.
- Open SolidCraft. If you had an older copy and the title bar shows Update, take it first. Click the round ? button at the top right (just left of Report a bug) and choose Connect AI assistants near the bottom of the list. Look for “added solidcraft”.
- Restart Claude completely. Claude Desktop: on Windows quit it from its icon near the clock, not just the close button; on a Mac, Command Q. Then open it again. Claude Code: start a new session.
Check it worked. In Claude Desktop: the + button under the chat box, then Connectors: solidcraft should be listed. In Claude Code: type /mcp.
If the entry is missing in Claude Code, add it by hand:
claude mcp add --scope user solidcraft -- solidcraft-cli mcp
On older Windows installers the full path is needed:
claude mcp add --scope user solidcraft -- "C:\Program Files\SolidCraft\solidcraft-cli.exe" mcp
Why the menu click matters
SolidCraft’s docs say the app adds itself to installed Claude apps when it starts. In our test of 0.24.1 (and 0.23.1) it did not: no entry after 60 seconds with a design open. So click Connect AI assistants. Clicking it twice changed nothing. With no Claude app installed it says “no supported client found”.
Prove it: a cube you can measure
Work the answer out first: a 20 mm cube is 20 x 20 x 20 = 8,000 mm³. Then ask Claude, one message at a time:
- “What’s in my SolidCraft design?” Claude made one
inspect_designcall (the design was empty). - “Make a 20 mm cube in SolidCraft.” One tool call built a 20 x 20 x 20 box.
- “Measure it.” SolidCraft answered 8000.0 cubic millimetres.
You can check the same thing without trusting Claude’s words: the number comes from SolidCraft’s own measure, and you can read the cube’s size in SolidCraft yourself.
Our proof with no AI: we replayed the same three tool calls in a fresh copy of SolidCraft and got 8000.0 again. Our own STL checker agreed: closed, 20 x 20 x 20, 8000.0 mm³.
Not working?
- Did you click Connect AI assistants?
- “no supported client found”: install Claude, open it and sign in once, click again, restart Claude.
- Claude not fully quit: quit it completely and reopen it.
- SolidCraft closed mid-chat: open it again; the next request reconnects.
- Keep SolidCraft open: without its window, the plug builds in a hidden session you can’t see.
Lesson 7 of this course covers these errors word for word.
What we didn’t film
Claude Desktop isn’t filmed; its steps are quoted from Anthropic’s and SolidCraft’s pages. Our test ran in Claude Code with tool approvals given in advance. A Claude app can ask you before each tool call.
The course
- Next: Lesson 2: sketch a 3D part by hand vs Claude
- The whole course in order: YouTube playlist
- The lab for this lesson (scripts, logs, tests): solidcraft-course-lab/out/l1
Sources
- SolidCraft download page: read 27 Oct 2026; it offered 0.24.1, the newest release on GitHub that day
- Claude download page and FAQ: the Claude apps
- The lab: every number on this page, with logs and tests
Change notes
- 16 Nov 2026: first published, from the lesson’s lab results of 27 Oct 2026.
Not affiliated with or endorsed by SolidCraft (Tangency Labs) or Anthropic. Found a mistake? Tell us in the video’s comments and we’ll correct this page.
Found this useful? The deep version lives on YouTube — new breakdowns of how AI dev tools actually work, weekly.
Subscribe on YouTube →Prefer email? Get the free newsletter: one failure, traced step by step, about once a week.