Claude Code Integration with Seedance MCP

📘 OverviewClaude Code MCP Overview →

Seedance is an AI video generation model launched by ByteDance, which understands Chinese descriptions very accurately and generates videos that are dynamic and natural. After receiving Claude Code, you can directly generate videos in natural language in the terminal—describe a scene, and you can get the final product in a few minutes.

Obtain API Token

Before using the Seedance MCP Server, you need to prepare an Ace Data Cloud API Token. The method to obtain it is consistent with the Claude Code VS Code configuration tutorial:

  1. Open the Ace Data Cloud Console - Application List to get your API Token for backup.
  2. If you are not logged in or registered, you will be automatically redirected to the login page; after logging in or registering, you will automatically return to the current page.
  3. The first application will have a free quota gift, allowing you to experience the Claude Code MCP service for free.

Get Ace Data Cloud API Key

One Token can be used for all MCP Servers provided by Ace Data Cloud, and there is no need to apply separately for Seedance. The documentation and screenshots suggest displaying only the desensitized form, such as YOUR_ACEDATACLOUD_API_KEY, and do not paste the complete Token into public repositories, Issues, screenshots, or chat records.

Using the web version of claude.ai or Claude Desktop? They support OAuth one-click authorization, eliminating the need to manually fill in the Token. For details, see the Claude.ai / Desktop tutorial for Seedance MCP.

Configure Claude Code

Choose one from the following three options. -H must be uppercase; lowercase -h is --help; please replace the Token after Authorization with the actual value you copied from the console.

For current project only: local

Suitable for trial use, the configuration is only bound to the project directory where you run the command. Claude Code will write the records into the local ~/.claude.json, along with the current project path.

claude mcp add seedance --transport http https://seedance.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY" \
  -s local

Usable for all projects: user

Suitable for frequent use of Seedance MCP across multiple projects. The configuration is written into the local ~/.claude.json user-level configuration, and any project that opens Claude Code afterward will be able to see it.

claude mcp add seedance --transport http https://seedance.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY" \
  -s user

Shared with the project: project

Suitable for team projects. The configuration is written into the .mcp.json in the current project root directory, which can be submitted to a private repository for teammates to reuse; do not submit the real Token to public repositories, and it is recommended to change it to an environment variable placeholder or let each person add it locally.

claude mcp add seedance --transport http https://seedance.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY" \
  -s project

When the project-level configuration is read by Claude Code for the first time, it may display Pending approval, and you need to confirm trust in this project configuration in the Claude Code session, which is a normal security prompt.

Verify Connection

After configuration, run:

claude mcp list

Seeing seedance display ✓ Connected indicates a successful handshake. If it fails, check the Token, service URL, and configuration scope; do not judge the current status based on historical client versions or fixed tool counts.

Actual Usage

After configuration is complete, return to the Claude Code session and directly use natural language to call Seedance:

Product Demo Video

Generate video material directly when writing documents or making presentations:

Generate a video: a dashboard on an operations monitoring screen is refreshing in real-time, curves are fluctuating, numbers are jumping, dark theme

Make Images Move

Use this product image to generate a video, letting the product slowly rotate for display

Generate Video Intro

The generated video can be directly embedded into HTML / Markdown files:

Generate a 3-second video intro: a glowing code symbol </> transitions from blurry to clear, with particle effects in the background, in a tech blue tone

Tool List

Tool Description
seedance_generate_video Text to video generation
seedance_generate_video_from_image Image to video generation