Get started
Work through this in order
- 1
Check the Blender server is running
In Blender press N, open the MCP for Blender tab and make sure the server is started. Use Start MCP Server if it is not.
- 2
Check the MCP server is set up in your AI client
Claude Code, Claude Desktop or Cursor must have the blender entry from the setup steps.
- 3
Do not start the server yourself in a terminal
The README says not to run uvx in the terminal by hand. The AI client starts it.
- 4
Try the request again
The README says the first command may fail and later ones often work.
- 5
Restart both sides
Restart your AI client and the Blender server. The README lists this as the fix for connection errors that stay.
- 6
Run one MCP server only
Do not have Cursor and Claude Desktop both running the server at the same time.
Before you retry
The README warns that the execute_blender_code tool can run arbitrary Python in Blender and says to always save your work first. Save before every retry, especially after a freeze.
Still stuck?
If none of this helps, the project's GitHub page is the place for version-specific problems. Nothing here is a guarantee: these are the documented fixes only, read 16 Nov 2026. Blender and Claude are trademarks of their owners. KreatorFlow is not affiliated with either, and Blender MCP is a third-party project.
Skip MCP: build the scene in your browser
If you only wanted a 3D scene or a short 3D video, you can skip the add-on, the server and the client. Open Stage, tell Kiryu what you want and change it by chat. Nothing to install, and you can start without an account.
Stage has limits: scenes come from menus of sets, props, characters, creatures and moves, there is no free modelling or sculpting, and it renders in real time. For custom models and final renders, keep Blender.
Specific problems the README names
Source: the project README, read 16 Nov 2026. Projects change, so check the README for your version.
Timeout errors
Simplify the request or split it into smaller steps.
Blender freezes during a Poly Haven download
Poly Haven downloads run on Blender's main thread, so the window can freeze until they finish. Ask for lower resolutions, such as 1k or 2k, when you can.
A Poly Pizza download fails with a Cloudflare challenge
The README says the CDN blocks datacenter, VPN and cloud addresses. Retry from a normal connection, or import the .glb file by hand.
Hunyuan3D works for some accounts and fails for others
The README says mainland Tencent Cloud accounts use the default endpoint, while international accounts need the International (Pro) account toggle. International credentials sent to the mainland endpoint fail.
On Windows with Cursor, the server will not start
The README uses the command cmd with the arguments /c, uvx and mcp-for-blender for Cursor on Windows.
My old blender-mcp setup stopped matching the docs
The README says the project was renamed and the package is now mcp-for-blender. It also says existing uvx blender-mcp setups still work.


