> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-for-blender.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Client Setup: Claude, Cursor, VS Code, and More

> Configure Blender MCP with Claude Desktop, Claude Code, Cursor, VS Code, OpenCode, and Antigravity. Includes per-client JSON configs and troubleshooting notes.

Blender MCP works with any MCP-compatible client. Below are step-by-step configurations for every supported client. Only run one client instance at a time, because multiple clients trying to connect to the same server will conflict.

<Warning>
  Only run ONE instance of the MCP server at a time. Do not connect both Claude Desktop and Cursor to Blender MCP simultaneously.
</Warning>

<Tabs>
  <Tab title="Claude Desktop">
    Claude Desktop uses a JSON config file to register MCP servers. Watch the setup video or follow the steps below.

    <Frame>
      <iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/neoK_WMq92g" title="Claude Desktop setup for Blender MCP" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
    </Frame>

    <Steps>
      <Step title="Open the config file">
        In Claude Desktop, go to **Settings → Developer → Edit Config** to open `claude_desktop_config.json`.
      </Step>

      <Step title="Add the Blender MCP entry">
        Paste this JSON inside the `mcpServers` object:

        ```json theme={null}
        {
          "mcpServers": {
            "blender": {
              "command": "uvx",
              "args": ["blender-mcp"]
            }
          }
        }
        ```
      </Step>

      <Step title="Fully quit and relaunch Claude Desktop">
        On macOS, press **Cmd+Q** to fully quit. On Windows, quit from the system tray icon. Reopen Claude Desktop so it reloads the config.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code">
    Claude Code is a terminal-based client. Add Blender MCP with a single command:

    ```bash theme={null}
    claude mcp add blender uvx blender-mcp
    ```

    This registers the server automatically. Restart Claude Code if it was already running.
  </Tab>

  <Tab title="Cursor">
    Cursor registers MCP servers through its settings UI. Watch the setup video or follow the steps below.

    <Frame>
      <iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/wgWsJshecac" title="Cursor setup for Blender MCP" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
    </Frame>

    <Steps>
      <Step title="Open MCP settings">
        Go to **Settings → MCP**.
      </Step>

      <Step title="Paste the config JSON">
        On macOS, paste this JSON directly:

        ```json theme={null}
        {
          "command": "uvx",
          "args": ["blender-mcp"]
        }
        ```
      </Step>

      <Step title="Windows users: use cmd wrapper">
        On Windows, use this instead so Cursor can resolve `uvx`:

        ```json theme={null}
        {
          "command": "cmd",
          "args": ["/c", "uvx", "blender-mcp"]
        }
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="VS Code">
    VS Code supports MCP servers through its agent and copilot features.

    Add this to your VS Code MCP configuration:

    ```json theme={null}
    {
      "servers": {
        "blender": {
          "type": "stdio",
          "command": "uvx",
          "args": ["blender-mcp"]
        }
      }
    }
    ```

    Restart VS Code after saving the config.
  </Tab>

  <Tab title="OpenCode">
    OpenCode uses a local server type with a command array.

    ```json theme={null}
    {
      "mcpServers": {
        "blender": {
          "type": "local",
          "command": ["uvx", "blender-mcp"]
        }
      }
    }
    ```

    Save the config and restart OpenCode to apply changes.
  </Tab>

  <Tab title="Antigravity">
    Antigravity supports environment variables alongside the command config.

    ```json theme={null}
    {
      "mcpServers": {
        "blender": {
          "command": "uvx",
          "args": ["blender-mcp"],
          "env": {
            "BLENDER_HOST": "localhost",
            "BLENDER_PORT": "9876"
          }
        }
      }
    }
    ```

    Restart Antigravity after updating the configuration.
  </Tab>
</Tabs>

<Tip>
  If your client cannot find `uvx`, use the full path from `which uvx` (macOS/Linux) or `where uvx` (Windows) as the `"command"` value. See the [Installation](/installation) page for detailed PATH troubleshooting.
</Tip>