Tutorials ModelCraft help Walkthroughs
Use ModelCraft with an AI assistant
Let your own AI assistant or script look at the model and build simple solids: permissions, connecting through CadCraft Studio, and the activity log.
Written for ModelCraft 0.4. The same help is inside the app: press F1.
What you will learn
How to let an AI assistant (or a script you wrote) work with ModelCraft, and how to decide what it is allowed to touch.
ModelCraft has no AI of its own and sends nothing anywhere. You bring the assistant: Claude Desktop, Claude Code or any program that speaks the Model Context Protocol (MCP). ModelCraft only gives it tools, and you choose which.
Turn it on
- Open Settings (the gear in the app bar, or ⌘,Ctrl+,) and go to the ModelCraft tab.
- Under Assistants, tick Let AI assistants and scripts use ModelCraft. It is off until you do.
- Choose what it may do: Read is ticked to start with; tick Edit, Save or Export only when you need them.
Tools outside the permissions you ticked are not offered to the assistant, and if it asks for one anyway, ModelCraft refuses and writes it in the activity log. Turning the switch off ends every connection at once; Reset ModelCraft settings turns it off too.
Connect your assistant
Assistants connect through CadCraft Studio on your computer: Studio runs a small server only this computer can reach, protected by a token it makes each time it starts. In Studio, choose Connect an assistant and copy the address and the token into your assistant (Studio shows the exact settings for Claude Code, Claude Desktop and other MCP clients). Never share the token.
You stay in charge
- Every change is one undo step, labelled with the assistant's name for it (for example "Assistant: box"). ⌘ZCtrl+Z takes back the assistant's last change as a whole.
- You know when one is connected. A button in the app bar names the assistant while it is connected; click it to see what it may do, or to Disconnect it.
- Activity. Settings › ModelCraft › Assistants › Activity lists every call: when, which tool, done or refused. Save the log keeps a copy.
What an assistant can ask for
| Tool | Permission | What it does |
|---|---|---|
app_info, model_describe | Read | The model's unit, size, and every group and component with where it is, whether it is a closed solid and its volume |
view_screenshot | Read | A picture of the 3D view as shown |
box_add, cylinder_add | Edit | A box or a cylinder as a new group, at a place and size you or it give ("3m", "10'" or a number in the model's unit) |
instance_move, instances_erase | Edit | Moves or erases groups and components |
undo | Edit | Takes back its own steps |
Solids an assistant makes come in as groups, so they never merge with what you drew. Saving and exporting stay with you.
If something doesn't work
- The assistant sees no ModelCraft tools: check that the switch is on in this window, and that the window is open in Studio.
- "needs the edit permission": tick Edit under Assistants, then ask again.
- "401" or "token" errors: the token changed (Studio restarted, or New token). Copy the new one into the assistant's settings.