Resolve the common connection and setup problems first.

Run the diagnostic command

uvx blendrelay-mcp doctor

Blender shows Disconnected

• Keep Blender open and choose Connect again.
• Confirm that the enabled extension is named BlendRelay MCP.
• Restart Blender after an extension update.
• Run uvx --refresh blendrelay-mcp setup after installing a new Blender version.

Codex cannot find the server

codex mcp list

Confirm that the server is registered as blendrelay. Register it again if necessary:

codex mcp add blendrelay -- uvx blendrelay-mcp mcp

Claude or Antigravity cannot change the scene

Confirm that the CLI is installed and signed in. For Claude, run claude doctor. For Antigravity, permit mcp(blendrelay/*) if its policy blocks MCP tools.

The agent completed without changing Blender

Inspect the task log shown in the panel. Common causes are a disconnected bridge, an MCP permission denial, an incorrect MCP server name, or a prompt that did not establish the desired scope. Select the relevant objects or geometry before retrying a local change.

Still stuck?

Open an issue with the Blender version, BlendRelay version, selected agent, error text, and a minimal reproduction. Do not include credentials, access tokens or private project files.

Open a GitHub issue