用 Claude、Codex 与 Cursor 通过 MCP 制作分镜和视频

先让 Agent 整理镜头，再交给模型生成

Claude Code、Codex 或 Cursor 可以通过 Say Action MCP 操作你自己的项目和画布，并提交图像与视频任务。外部 Agent 负责理解你的要求；MCP 工具负责读取、写入和调用生成任务。模型能力与参考素材仍会影响结果。

先做一集、几个镜头，检查分镜后再生成。本文讲连接与运行边界；已有英文 MCP 教程提供逐步示例，不在这里重复整段对话。

在 MCP 页创建密钥并连接客户端

打开 /mcp，选择 Claude Code、Codex 或 Cursor 的接入卡片，点击获取密钥并登录。在一次性密钥弹窗中保存消费上限，再复制连接配置。以后到 /access-keys 管理权限、修改上限或撤销密钥。把 yc_live_ 密钥保存在本机 ISAYACTION_API_KEY 环境变量中，不要发给 Agent 当作提示词。

端点：https://isayaction.com/api/mcp；使用 Streamable HTTP，认证头为 Authorization: Bearer yc_live_...。浏览器 Cookie 不能替代密钥。

Claude Code（Unix shell）：claude mcp add --transport http isayaction https://isayaction.com/api/mcp --header "Authorization: Bearer $ISAYACTION_API_KEY"

Codex：codex mcp add isayaction --url https://isayaction.com/api/mcp --bearer-token-env-var ISAYACTION_API_KEY

Cursor 的 MCP 配置：{ "mcpServers": { "isayaction": { "url": "https://isayaction.com/api/mcp", "headers": { "Authorization": "Bearer ${env:ISAYACTION_API_KEY}" } } } }

无人值守 codex exec 需要在 ~/.codex/config.toml 的 [mcp_servers.isayaction] 中设置 default_tools_approval_mode = "approve"。这会允许工具自动执行；设置密钥上限后再运行。客户端审批设置与服务端扣费是两回事。

按实际工具推进项目、剧本与画布

先用 get_account 和 list_models 查看余额与模型能力，再用 list_projects / create_project、list_canvases / create_canvas 选择工作位置。让 Agent 先把原剧本拆成集，再调用 import_script：它只导入调用方已经准备好的集，不调用模型拆集。list_units 和 get_unit_workspace 用于查询剧本单元；set_unit_shots、create_shot、revise_shot 用于整理镜头。

画布编辑前读取 canvas_list_node_types 与 canvas_get_state；用 canvas_create_storyboard 创建表格，canvas_read_storyboard 读取行，canvas_edit_storyboard 修改镜头，canvas_apply_ops 可添加节点、更新允许的字段和建立连线，不支持删除或移动已有节点。需要快照的写入使用当前 snapshotHash，完成后用 get_canvas_link 返回可打开的画布。

确认镜头与模型后，用 generate_media 提交任务，再用 get_generation 或 wait_generations 查询结果；list_recent_generations 查近期任务。retry_generation 是新的生成尝试，可能再次计费。示例要求：“先把这场戏拆成三个镜头，保留台词，返回画布链接；我检查后再生成视频。”

直接扣积分，密钥默认不限额

MCP 收费调用直接扣积分，服务端不会逐次等待你确认。新密钥默认不限额；Agent 循环、误操作或密钥泄露都可能持续产生费用。外部客户端的订阅或模型费用另计。内置 Agent 的任务预算与访问密钥的累计上限也不是同一个设置。

在密钥弹窗点击“保存消费上限”，或到 /access-keys 点击“修改上限”并保存。上限按此密钥累计，不按月重置，退款与密钥轮换不重置用量；密钥页在 80% 与 100% 显示用量警告。开启“API 额度提醒”后，服务还会创建对应通知；邮件送达取决于邮件配置。达到上限会拒绝新的收费调用。设为 0 可阻止收费调用，但不会取消已经提交的任务。

积分按渠道定价预估；实际扣除以后台配置的价格档为准。 视频按秒计费为按请求秒数预授权；若上游实际产出时长超出请求，可能产生少量让利差额。

上游明确返回失败时会退回预留积分；网络状态不明确的任务先保留待核对状态，避免重复结算。

网络重试与重新生成要分开处理

所有写入工具（包括收费生成工具）要求 8–128 字符的 idempotencyKey。相同操作遇到网络错误时，重用原来的键与完全相同的参数；不要换键盲目重交。改变参数是另一项操作，需要新的键。

遇到 idempotency_key_pending 先等待并查询；outcome_unknown 表示结果未知，先检查任务或对象现状，不能自动重做。已经保存的结果会返回原结果；idempotency_key_conflict 表示同一键被用于不同参数。把任务 ID 留在记录里，便于用 get_generation 查清状态。

密钥只交给受信任的客户端

密钥代表你的权限，按需要选择 scope。密钥只在创建或轮换时显示；不要放进公开仓库、共享配置、截图、画布或聊天记录。环境变量用于本机配置，不代表可以把终端截图公开。

不再使用时到 /access-keys 撤销密钥；怀疑泄露时立即撤销或轮换，并查看用量和任务。客户端可以提交提示词与参考素材，运行前先检查它将使用哪个项目、模型和密钥。

连接自带模型与第三方中转站

在模型渠道设置中填写 Base URL 和 API Key，按供应商文档选择协议、模型 ID 与所需 Header。先确认所需的文生图、图生视频等能力，再开始生成；接口路径、分辨率和首尾帧参数以实际渠道为准。不支持的渠道可以提交适配申请，申请不代表已兼容。

BYOK 支持配置自有 API 地址、模型密钥和自定义 Header。使用 OneAPI、NewAPI 等中转站时，需要选择与其实际接口匹配的 OpenAI、Gemini 或 Claude 协议，并核对模型 ID 及图像、视频接口支持情况；不是所有中转站和私有协议都能直接使用。BYOK 模型调用不加收平台模型费用、不扣平台生成积分，但工作空间服务和上游模型费用仍分别收取。

仅连接你信任的渠道，生产连接使用 HTTPS。自定义请求经登录态后端转发；必要的提示词、参考素材和凭证会参与请求。不要把 API Key、密码或含密钥的 Header 放进公开画布、截图或客服申请。