返回 StudioMCP 1.18

画布 MCP 使用指南

mcp.md 是写给 Claude Code / Codex / Cursor 读的操作手册（流程、费用规则、何时停下问人）。点按钮复制全文，粘贴给助手即可。

让你自己的 AI 助手（Claude Code、Codex、Cursor、Hermes）直接操作 SKYHORSE 画布。

这是什么

助手通过 MCP 读画布、加节点、连线、生成图片 / 视频 / 音频、取用素材库和资产库，并直接拿到成品文件。地址 https://api.skyhorse.ai/mcp，用你自己的令牌登录。

它做的每一步都和你在画布上亲手操作一样：同事实时看到节点出现，费用记在你的令牌上。助手可以像你一样删除节点（画布历史版本可找回）；不能删除画布或素材。

准备：令牌

登录 https://api.skyhorse.ai，进入「令牌」页。
新建一个令牌，名称写清用途（如「我的 Claude Code」），额度按需设置。
复制以 sk- 开头的令牌。和 Studio 里用的是同一种，可直接复用。

令牌就是你的身份：助手只能看到你能看到的画布，花的是你的额度。不要把令牌发给别人或贴进聊天；泄露了在后台删掉重建。

接入

两样东西：地址 https://api.skyhorse.ai/mcp 和你的令牌。把 sk-你的令牌 换成自己的。

Claude Code（终端执行一次）

claude mcp add --transport http skyhorse-canvas https://api.skyhorse.ai/mcp --header "Authorization: Bearer sk-你的令牌"

Codex（`~/.codex/config.toml` 末尾）

[mcp_servers.skyhorse-canvas]
url = "https://api.skyhorse.ai/mcp"
http_headers = { Authorization = "Bearer sk-你的令牌" }

Cursor / Windsurf / 其他（MCP 设置里粘贴）

{"mcpServers":{"skyhorse-canvas":{"url":"https://api.skyhorse.ai/mcp","headers":{"Authorization":"Bearer sk-你的令牌"}}}}

Hermes（`~/.hermes/config.yaml`）

mcp_servers:
  skyhorse-canvas:
    url: https://api.skyhorse.ai/mcp
    headers: { Authorization: "Bearer sk-你的令牌" }
    timeout: 300

验证：对助手说「列出我的画布」，返回列表即接通。

能做什么

助手会自己选工具，你只需要用人话描述目标。42 个工具按用途分组：

用途	能做的事	付费
画布	列出、新建、读取、改名；查看历史版本并恢复；找回最近删除的画布；一键整理布局、不满意还原	否
文件夹	一个剧本一个文件夹：新建、改名、设封面、把画布放进去；删除进最近删除（30 天可恢复，删除前必须经你确认）	否
节点与连线	加节点、删节点，改提示词和参数，一次按序设定全部参考，多版结果选用哪版；一屏概览画布结构	否
旧分镜表	脚本节点已停用：助手只能读画布上已有的旧镜头表，不能新建或修改	否
生成	让图片 / 视频 / 音频节点开始生成；hy 通道 480p 是草稿，满意后一键出 1080p 正片（画面一致）；查进度	是
处理	图片放大 / 抠图 / 降噪；从视频截首帧 / 尾帧 / 某一秒做接戏参考；拼成片（顺序、起止、音轨、字幕）；抽帧看结果	否
素材与资产	素材库（你整理好的人物 / 场景 / 道具 / 音频）取用与存回；资产库搜索、归类、导入画布；上传本地文件	否

生成和在画布里手动点「生成」完全一样：同样的模型、同样的价格，结果同样进入资产库。

可以这样说

「列出我的画布，打开『总画布』，告诉我有哪些视频节点还没生成」
「新建『第二集』文件夹和画布，按这份剧本拆 12 个镜头，每镜建好图片和视频节点，先不要生成」
「把素材库里『秦回』的定妆图放到画布，连到所有视频节点做参考」
「把第 3 镜的提示词改成夜景，换成 9:16，然后生成，生成完告诉我」
「这 8 个镜头的 480p 草稿我看过了，全部出 1080p 正片」
「截『视频 4』的尾帧，连到『视频 5』做参考，重新生成视频 5」
「这个画布太乱了，整理一下」
「『视频 12』用第 2 版」

涉及花钱的步骤，建议先让助手把节点和提示词搭好，你在画布里看一眼再说「生成」。

规则

费用：只有生成和出正片花钱，记在你的令牌上，与手动生成同价；上传、下载免费。给助手的令牌设个额度上限，它就不可能超支。
权限：助手只能打开你自己能打开的画布。
删除：助手能删节点（和你在画布里删一样，历史版本 7 天内可找回）；不能删画布和素材；文件夹删除必须先经你确认，30 天可恢复。
协作：和同事同时编辑是同一机制，只改被操作的节点。在多人共用的画布上动手前先说一声。
日志：每次调用都记录账号、令牌、时间、做了什么，管理员可查。

常见问题

「令牌无效」：检查是否以 sk- 开头、有无多余空格、后台是否被禁用或过期。

「没有这个画布的权限」：画布属于别的账号。让主人操作，或自己新建。

生成了但画布上没看到：刷新画布。视频要几分钟，节点会先显示「生成中」。

参考图被拒（疑似真人）：Seedance 会拒绝疑似真人的图，写实的 AI 人物也可能被拒。在画布里右键那张图点「合规检验」，几秒后图片尺寸右边出现绿色盾牌，之后用 Seedance 2.5 · hy 生成就不会被拒。这一步要你本人点，助手不能代做；只检验 AI 生成或原创的虚拟形象，真人照片不能通过。

任务一直排队：并发上限每令牌图 4 / 视频 6 / 音频 4，排队自动开始，不用重复提交。

参数「无效」并列出一串可选值：按列出的值改即可；不同模型可选值不同，让助手先查。

能上传文件吗：能，助手直传 ≤ 32 MB；更大的先在 Studio 上传到资产库，再让助手导入画布。

多个助手能同时用吗：能，各用自己的令牌；同一画布上多个助手和多个人可以一起工作。