Setup Guide

Claude + Seedance + Blender

How to wire Claude Code, Seedance 2.5 video generation, and Blender 3D into one pipeline on a Mac. Follow it top to bottom once. After that, every session is open Blender, start the bridge, and go.

Platform macOS (Apple Silicon)
Blender 4.4
Seedance 2.5 via Higgsfield / Arcads
Client Leo Marshall Creative

00How it fits together

Three tools, one operator. Claude Code is the control layer. Seedance makes the video. Blender makes the 3D. Frames move between them.

Control

Claude Code

Runs in the terminal. Talks to Seedance through cloud MCP servers and to Blender through a local bridge. You direct, it executes.

Video

Seedance 2.5

Cloud video model. Reached through Higgsfield or Arcads. Clips are chained from the last frame of the previous clip so characters stay consistent.

3D

Blender 4.4

Runs locally. Claude reads the scene, sets materials, lights, and cameras, and fires EEVEE previews. You press F12 for the final Cycles render.

The two directions that matter: a Seedance still becomes a Blender reference or backplate, and a Blender hero render becomes a Seedance start frame.

01Prerequisites

Check these before anything else. Most of them are already in place on the current machine.

Done
Blender 4.4Installed in /Applications.
Done
Homebrew tools: ffmpeg, uv, nodeffmpeg extracts frames. uv runs the Blender MCP server. node is used by other MCPs.
Done
Claude Code connected to Higgsfield and ArcadsBoth serve Seedance 2.5. No separate Seedance account or install is needed.
To do
Blender MCP bridgeThe one missing piece. Covered in section 04.

If you are setting up a fresh Mac

# Homebrew tools
brew install ffmpeg uv node

# Claude Code
npm install -g @anthropic-ai/claude-code
claude   # sign in on first run

# Blender: download 4.4 from blender.org and drag to /Applications

02Claude Code

Confirm the cloud connections that give Claude access to Seedance.

  1. Open a terminal and list the MCP servers.

    claude mcp list
  2. Look for claude.ai Higgsfield and arcads. Both should read Connected.

  3. If either says Needs authentication, start Claude Code, type /mcp, pick the server, and complete the browser login.

  4. Optional but recommended: install the two skills that encode the workflow, blender-motion and film-scrub-site. They live in ~/.claude/skills/ and load automatically when Blender or chained Seedance work comes up.

03Seedance

Seedance runs in the cloud, so setup is credits plus a working method. The method is what keeps a character from morphing between clips.

Credits

Check the balance before a batch. Ask Claude to run the Higgsfield balance tool or the Arcads credits tool.

ModelClipApprox. costTurnaround
Seedance 2.5, 720p5 seconds32.5 credits2 to 4 minutes

The chaining method

  1. Generate clip 1 from a text prompt, or from a start image if you have a hero frame from Blender.

  2. Download the clip and extract its true last frame. Frame 118 of 121 is used on purpose. The final frame is often partial.

    ffmpeg -i clip1.mp4 -vf "select=eq(n\,118)" -q:v 2 -frames:v 1 -update 1 END.jpg -y
  3. Host the frame where Higgsfield can fetch it. A GitHub push to a frames/ folder works immediately.

    git add frames/END.jpg && git commit -m "frame" && git push
    # then import from:
    # https://raw.githubusercontent.com/<user>/<repo>/main/frames/END.jpg
  4. Generate clip 2 with that frame as start_image and a prompt that begins "Continuing the same shot with the same person, same light…".

  5. Repeat for each clip. Four chained clips give you a 20 second film with no identity drift.

Preset interception. Higgsfield sometimes swaps your prompt for one of its presets. If the result looks like someone else's art direction, resubmit with the declined_preset_id from the notice.

04Blender bridge

This is the only real installation step. It lets Claude read and change the open Blender scene.

  1. Get the add-on. Download addon.py from the ahujasid/blender-mcp repository on GitHub.

  2. Install it in Blender. Edit → Preferences → Add-ons → the dropdown arrow at top right → Install from Disk. Choose addon.py, then tick the box to enable Blender MCP.

  3. Register the server with Claude Code. Run this once in the terminal.

    claude mcp add blender -- uvx blender-mcp
  4. Start the bridge. In Blender's 3D viewport press N to open the sidebar, click the BlenderMCP tab, and press Start MCP Server. The panel should read "MCP Server running on localhost:9876".

  5. Verify. Restart Claude Code and send this as the first prompt.

    Connect to Blender MCP and tell me what objects are in my current scene.

    A list of objects means it works. An error means the server is not running. Press Start MCP Server again, or restart Blender.

  6. Leave Blender open for the whole session. Closing it drops the bridge.

05Daily workflow

Once set up, a session looks like this.

Every session

  1. Open Blender with the project file. Start the MCP server from the N panel.

  2. Open Claude Code in the project folder. Verify the bridge with the "what objects are in my scene" prompt.

  3. Give direction as a creative director would. Drop a reference image rather than describing a look in words. Say what you see, not what to fix: "the purple reads flat and plastic" is better than "fix the material".

  4. Claude changes one thing at a time and returns an EEVEE preview. Respond, iterate.

  5. When it is right, you press F12 for the Cycles render. Claude never triggers the final render.

Blender to Seedance

Render a hero frame in EEVEE, push it to GitHub, import it into Higgsfield, and use it as the start_image for a Seedance clip. The 3D look becomes live footage.

Seedance to Blender

Extract a still from a Seedance clip. Claude reads roughness, light direction, and color temperature from the image and applies those values to your Blender materials and lights. It can also load the still as a camera background for matching a shot.

Rules Claude follows in Blender

06Troubleshooting

SymptomCauseFix
Claude cannot connect to BlenderMCP server not running or Blender closedOpen Blender, N panel, Start MCP Server. Restart Blender if it still fails.
uvx: command not founduv not installed or not on PATHbrew install uv, then open a new terminal.
Higgsfield shows "Needs authentication"Session expiredIn Claude Code type /mcp, select Higgsfield, sign in.
Seedance clip looks nothing like the promptPreset interceptionResubmit with the declined_preset_id from the notice.
Character changes between clipsClips generated independentlyChain them: start each clip from the previous clip's frame 118.
Job shows type: image while runningNormal. It flips to video on completion.Keep polling. Not a failure.
Start frame import failsHost not publicly reachablePush to GitHub and import from the raw.githubusercontent.com URL.