Setup Guide
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.
Three tools, one operator. Claude Code is the control layer. Seedance makes the video. Blender makes the 3D. Frames move between them.
Runs in the terminal. Talks to Seedance through cloud MCP servers and to Blender through a local bridge. You direct, it executes.
Cloud video model. Reached through Higgsfield or Arcads. Clips are chained from the last frame of the previous clip so characters stay consistent.
Runs locally. Claude reads the scene, sets materials, lights, and cameras, and fires EEVEE previews. You press F12 for the final Cycles render.
Check these before anything else. Most of them are already in place on the current machine.
# 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
Confirm the cloud connections that give Claude access to Seedance.
Open a terminal and list the MCP servers.
claude mcp listLook for claude.ai Higgsfield and arcads. Both should read Connected.
If either says Needs authentication, start Claude Code, type /mcp, pick the server, and complete the browser login.
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.
Seedance runs in the cloud, so setup is credits plus a working method. The method is what keeps a character from morphing between clips.
Check the balance before a batch. Ask Claude to run the Higgsfield balance tool or the Arcads credits tool.
| Model | Clip | Approx. cost | Turnaround |
|---|---|---|---|
| Seedance 2.5, 720p | 5 seconds | 32.5 credits | 2 to 4 minutes |
Generate clip 1 from a text prompt, or from a start image if you have a hero frame from Blender.
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 -yHost 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.jpgGenerate clip 2 with that frame as start_image and a prompt that begins "Continuing the same shot with the same person, same light…".
Repeat for each clip. Four chained clips give you a 20 second film with no identity drift.
declined_preset_id from the notice.This is the only real installation step. It lets Claude read and change the open Blender scene.
Get the add-on. Download addon.py from the ahujasid/blender-mcp repository on GitHub.
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.
Register the server with Claude Code. Run this once in the terminal.
claude mcp add blender -- uvx blender-mcpStart 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".
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.
Leave Blender open for the whole session. Closing it drops the bridge.
Once set up, a session looks like this.
Open Blender with the project file. Start the MCP server from the N panel.
Open Claude Code in the project folder. Verify the bridge with the "what objects are in my scene" prompt.
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".
Claude changes one thing at a time and returns an EEVEE preview. Respond, iterate.
When it is right, you press F12 for the Cycles render. Claude never triggers the final render.
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.
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.
| Symptom | Cause | Fix |
|---|---|---|
| Claude cannot connect to Blender | MCP server not running or Blender closed | Open Blender, N panel, Start MCP Server. Restart Blender if it still fails. |
uvx: command not found | uv not installed or not on PATH | brew install uv, then open a new terminal. |
| Higgsfield shows "Needs authentication" | Session expired | In Claude Code type /mcp, select Higgsfield, sign in. |
| Seedance clip looks nothing like the prompt | Preset interception | Resubmit with the declined_preset_id from the notice. |
| Character changes between clips | Clips generated independently | Chain them: start each clip from the previous clip's frame 118. |
Job shows type: image while running | Normal. It flips to video on completion. | Keep polling. Not a failure. |
| Start frame import fails | Host not publicly reachable | Push to GitHub and import from the raw.githubusercontent.com URL. |