Claude Code 对接 Sora MCP

📘 Overview：Claude Code MCP Overview →

你可能在社交媒体上看过 Sora 生成的视频——水花四溅的慢动作、城市街头的延时摄影——每一帧都像实拍。Sora 最牛的地方在于它理解物理规律：重力、光影、流体、碰撞。接到 Claude Code 后，一行命令就能在终端里用上 Sora 的视频生成能力。

获取 API Token

使用 Sora MCP Server 之前，需要先准备一个 Ace Data Cloud API Token。获取方式和 Claude Code VS Code 配置教程保持一致：

打开 Ace Data Cloud 控制台 - 应用列表，获取您的 API Token，留作备用。
如果你尚未登录或注册，会自动跳转到登录页面；登录注册之后会自动返回当前页面。
首次申请时会有免费额度赠送，可以先免费体验 Claude Code MCP 服务。

一个 Token 可以使用 AceData Cloud 提供的全部 MCP Server，无需为 Sora 单独申请。文档和截图里建议只展示脱敏形式，例如 3b78cc40dd3b43db806a4300....，不要把完整 Token 贴到公开仓库、Issue、截图或聊天记录里。

用 claude.ai 网页版或 Claude Desktop？它们支持 OAuth 一键授权，无需手动填 Token，详见 Sora MCP 的 Claude.ai / Desktop 教程。

配置 Claude Code

下面三组选一种即可。-H 必须大写，小写 -h 是 --help；Authorization 后面的 Token 请替换成你在控制台复制到的真实值。

只给当前项目用：local

适合先试用，配置只绑定你运行命令时所在的项目目录。Claude Code 会把记录写进本机 ~/.claude.json，并带上当前项目路径。

1
2
3

claude mcp add sora --transport http https://sora.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer 3b78cc40dd3b43db806a4300...." \
  -s local

所有项目都能用：user

适合你经常在多个项目里使用 Sora MCP。配置写进本机 ~/.claude.json 的用户级配置，之后任何项目打开 Claude Code 都能看到。

1
2
3

claude mcp add sora --transport http https://sora.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer 3b78cc40dd3b43db806a4300...." \
  -s user

随项目共享：project

适合团队项目。配置写进当前项目根目录的 .mcp.json，可以提交到私有仓库让队友复用；公开仓库不要提交真实 Token，建议改成环境变量占位符或让每个人本地自行添加。

1
2
3

claude mcp add sora --transport http https://sora.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer 3b78cc40dd3b43db806a4300...." \
  -s project

项目级配置第一次被 Claude Code 读取时，可能会显示 Pending approval，需要在 Claude Code 会话里确认信任这个项目配置，这是正常的安全提示。

真实运行结果

下面是在 Claude Code 2.1.158 中用隔离临时目录实际执行后的脱敏输出。命令使用真实 AceData Cloud Token，输出中的 Token 已替换成 3b78cc40dd3b43db806a4300....，临时配置已删除。

1 2	Added HTTP MCP server sora with URL: https://sora.mcp.acedata.cloud/mcp to local config sora: https://sora.mcp.acedata.cloud/mcp (HTTP) - ✓ Connected

三种 scope 的行为也做过实测：

1
2
3

luma-local: https://luma.mcp.acedata.cloud/mcp (HTTP) - ✓ Connected
luma-user: https://luma.mcp.acedata.cloud/mcp (HTTP) - ✓ Connected
luma-project: https://luma.mcp.acedata.cloud/mcp (HTTP) - ⏸ Pending approval (run `claude` to approve)

确认本机配置时可以运行：

1	claude mcp list

看到 sora: https://sora.mcp.acedata.cloud/mcp (HTTP) - ✓ Connected 就说明 Sora MCP 已经接入成功。

试几个效果

配置完成后，回到 Claude Code 会话直接用自然语言即可调用 Sora：

延时摄影

这类有物理光影变化的场景是 Sora 的绝对强项：

1	生成一段城市延时摄影视频，黄昏到夜晚的过渡，车灯拉出光轨，天空从橙色变成深蓝

图片转视频

给 Sora 一张静态图，它能让画面动起来：

1	把这张产品截图转成一段动态展示视频，镜头缓慢推进，画面有电影感

高清横屏 / 竖屏

Sora-2 支持 HD 横屏和竖屏，竖屏直接适配短视频：

1	生成一段 HD 横屏的海浪拍岸慢动作视频

工具列表

工具	说明
sora_generate_video	文本生成视频
sora_generate_video_from_image	图片生成视频

静觅崔庆才的个人站点 - Python爬虫教程