把你的 AI 连接到 Scene24
Scene24 连接器让你已经在用的 AI 用 Scene24 制作影片。它读取产品网站和品牌,按参考广告的语法构建影片,查看预览静帧,修正不够好的地方,然后在 Scene24 编辑器中把影片交给你。
思考在你的 AI 中进行,用的是你在那边的方案;Scene24 负责捕获、构建、检查和渲染。支持 Claude Code、Codex CLI、ChatGPT,以及 claude.ai 和 Claude Desktop。
设置
所有应用都连接到同一个地址:
https://api.scene24.so/mcp
Claude Code
在 你的 AI 中选择 Claude Code 并创建连接。把显示的命令粘贴到终端,即可为所有项目添加 Scene24。在 Claude Code 中运行 /mcp 可以看到已连接。Claude Code 也可以不用密钥登录:只添加地址,然后运行 /mcp 进行认证。
Codex CLI
在 你的 AI 中选择 Codex CLI 并创建连接。把显示的密钥以 SCENE24_TOKEN 保存在 shell 配置文件中,然后把 Scene24 添加到 ~/.codex/config.toml:
[mcp_servers.scene24] url = "https://api.scene24.so/mcp" bearer_token_env_var = "SCENE24_TOKEN" tool_timeout_sec = 300
Codex 默认给每个工具 60 秒。一次构建可能接近一分钟,所以配置把 tool_timeout_sec 提高到 300。启动 Codex 并运行 /mcp 可以看到 Scene24 已连接。
ChatGPT
在 ChatGPT 中打开 Plugins,选择 +,然后选择 Add custom MCP server。将其命名为 Scene24,把地址粘贴为 URL 并选择 OAuth。确认提示并选择 Create as a plugin。ChatGPT 会把你带到 Scene24 进行授权;允许后它会自动登录。
并非每个 ChatGPT 方案都提供自定义 MCP 服务器;在工作或学校的工作区中,可能需要管理员先允许。
claude.ai 和 Claude Desktop
依次打开 Customize、Connectors。选择 +,然后选择 Add custom connector,命名为 Scene24 并粘贴地址。保留 Claude 建议的登录方式并选择 Add。Claude 会把你带到 Scene24 进行授权。
所有 Claude 方案都能使用自定义连接器,免费方案可以添加一个。在 Team 或 Enterprise 方案中,所有者先为组织添加连接器,然后每位成员连接自己的账号。
检查连接
让你的 AI 检查 Scene24 连接。它会调用 check_connection,返回它代表的 Scene24 账号(部分隐藏)、连接名称、本月剩余的影片数,以及一张测试卡:写着一个单词的图片。
你的 AI 会显示同一个单词。如果你的 AI 说出了这个单词,说明图片能送达,它也就能查看影片的预览静帧。连接 ChatGPT 或 Claude 时,页面会跟进每一步:应用找到 Scene24、你允许、它登录、它首次调用、它读取卡片。
工具
每个工具都会说明自己是只读还是会改动内容,这样应用就知道何时需要先问你。
只读
这些只查看。应用可以不必每次询问就运行它们。
- check_connection
- Scene24 以哪个账号连接、本月剩余的影片数,以及一张测试卡。
- get_film_kit_guide
- film_kit 手册和一个示例构建器。你的 AI 在编写影片前会先读它。
- get_film_kit_api
- film_kit 的每个函数及其签名。
- list_references
- 参考广告列表,包括你自己上传的,可按名称或风格搜索。
- get_reference
- 逐节拍查看一个参考广告,附整支广告的联系表。
- list_films
- 你的影片(最新的在前),以及本月剩余的影片数。
- get_film
- 影片当前的状态,以及它的品牌、画面和最后的构建器。
- show_panels
- 把影片的画面和标志拼成一张图。
- get_build
- 最后一次构建的结果,或运行中的阶段。
- wait_for_film
- 等待捕获、构建或预览完成。
- get_preview
- 影片最后的预览静帧。
- get_aspects
- 影片可以展示和导出的画幅,以及每个版本的检查结果。
- get_export
- 影片 MP4 导出的进度,完成后附下载链接。
修改你的影片
这些会在你的工作区中创建或修改影片。它们不会删除任何东西,除非你同意,构建也不会覆盖你在编辑器中做的修改。
- start_film
- 用产品 URL 打开一部影片:捕获网站并读取品牌。
- set_brand
- 修正 Scene24 读到的品牌:颜色、字体、文字标志和标志。
- request_screens
- 向你要登录后的画面,在一个只需粘贴或上传的页面里收取。
- cancel_screens
- 撤回已经不需要的画面请求。
- request_upload
- 为影片上传产品截图的链接。
- add_panel
- 把上传的截图加入影片的画面。
- build_film
- 运行影片的构建器,检查结果并保存为影片。
- edit_film
- 修改构建器的一部分并重新构建。
- render_preview
- 渲染已保存影片的预览静帧。
- restore_pass
- 把影片退回到之前的某一稿,作为新的一稿重新构建。
- export_film
- 把影片渲染成 MP4,用它本身的画幅或你要的版本。
- share_film
- 生成一个公开链接,任何拿到链接的人都能播放这部影片,并附嵌入代码。只在你需要时生成。
删除
这些会永久删除某样东西:一部影片,或影片的公开分享链接。你的 AI 会先说出是哪部影片并征求你的同意,再调用它们。
- delete_film
- 确认后永久删除影片及其版本和导出文件。
- unshare_film
- 结束影片的公开分享链接。影片和 MP4 都会保留。
使用的数据
- 你指定的网站:Scene24 像访客一样打开它,并为影片保存它的画面、标志、颜色和字体。
- 你为影片提供给 AI 的截图,与该影片一起保存。
- 你的影片、它们的版本和预览静帧,和你在 Home 中制作的影片一样保存在 Scene24 工作区中。
- 从不接收你的对话:Scene24 只接收你的 AI 发出的工具调用,不接收你对它说的话,也看不到你在那个应用中的账号。
- 连接密钥只保存其指纹,从不保存密钥本身。为了在你的 AI 中显示,Scene24 还会把每个连接的最后一次调用(哪个工具、是否成功、用时多久)保留一天。
限制
- 无论你的 AI 构建多少次,一部影片在本月只计一次。同一部影片的其他画幅(9:16、1:1、4:5)不算额外的影片。
- 网站无法读取、或从未完成构建的影片会退回到本月额度中,每月最多三部。
- 每次调用都会在约 50 秒内回复。更长的工作会继续进行,回复会说明下一步调用什么,所以不会重复运行。
- 每部影片最多构建 60 次、渲染预览 30 次。
- 同时最多十个连接。已过期的应用连接不计入。
断开连接
在 你的 AI 中撤销连接,该应用会立即失去访问权限。你也可以在应用中移除 Scene24。
打开你的 AI