---
name: blender-mcp-setup
description: "Set up or diagnose the SHA-pinned PartMe Blender MCP connection used by the Codex Blender plugin."
---

# Blender MCP Setup

Use this for first use and connection failures. Call `blender_connection_status` before asking the
user to repeat setup. If it is not connected, call `blender_getting_started` and present its actual
Blender discovery result, official download URL, Add-on name, steps, and bundled screenshots.
The Codex plugin already bundles the SHA-pinned PartMe runtime and Add-on artifact. Never ask an
ordinary user to pip-install a platform archive. When an Add-on ZIP is needed, run the bundled
`scripts/package_connector.py` helper and present the resulting file; do not recreate or rewrite
the upstream Add-on.

Use this user-facing summary:

> 还没有 Blender？下载安装包
>
> 打开 Blender，在 偏好设置 > 插件 中启用 MCP 插件，然后在 N 面板中点击 Start MCP Server。

Clarify that the trusted Add-on name is **PartMe Blender MCP** and its N-panel category is
**PartMe MCP**. A separately installed community Add-on named **MCP for Blender** is not the endpoint for
this plugin and must not be treated as proof that the guarded Blender Harness is connected.

For illustrated steps, read [the Chinese setup guide](../../docs/getting-started.zh-CN.md) or
[the English setup guide](../../docs/getting-started.md). Do not install Blender, enable Add-ons, or
change MCP configuration without the user's authorization. Never request or display the private
Harness descriptor token.

For error-specific recovery, supported/unsupported boundaries, common misrouting patterns, and
first-use examples, read [setup troubleshooting](references/setup-troubleshooting.md).