ZH
动态0.5.0 新功能:评论小说和镜头、版本历史、撤销,以及关闭 AI 的开关。
Docs

文档 › 把 Scenaloom 接入 AI 应用:剧本 MCP 服务器

把 Scenaloom 接入 AI 应用:剧本 MCP 服务器

Scenaloom 的剧本 MCP 服务器把你的项目接入你已经在用的 AI 应用。在 Claude、ChatGPT、Cursor 或 VS Code 里添加 https://scenaloom.com/mcp,登录一次 Scenaloom,再批准这个应用可以做哪些事。之后它就能读取你的电影剧本、剧集和小说,提出修改建议并等你审阅后才改到稿子上,还能留下评论,你不用再把剧本复制粘贴到对话框里。

https://scenaloom.com/mcp

剧本 MCP 服务器能做什么

  • 读取:列出你的项目,按块或一场一场地读取某一集的剧本,读取小说章节,查看角色、地点、道具、节拍、大纲和评论。
  • 编辑:对剧本或小说章节提出修改,逐条给你看修改前后的对比,你同意后才应用。应用后的修改会和同时在写的其他人合并,记入版本历史,也可以撤销。
  • 评论:在某一行上留下评论,并标明是哪个应用写的;也可以把评论标为已解决。
  • 生成:为角色肖像、分镜画面等生成任务报价,你确认要花的积分后才开始。

因为 AI 应用直接在真实的项目上工作,而不是在一份粘贴过去的副本上,这种 AI 编剧集成能让场次、角色和历史记录都留在同一个地方。工具参考列出了所有工具。想让 Claude 剧本协作更稳妥,可以再装上 Scenaloom Agent Skill,它会教模型按“先读、再提议、后应用”的顺序改稿。

Claude(claude.ai、桌面版和手机 App)

  1. 在 claude.ai 打开“Customize”,再进入“Connectors”。
  2. 选择“Add”,再选“Add custom connector”。名称填 Scenaloom,URL 粘贴 https://scenaloom.com/mcp。
  3. 选择“Continue”,登录 Scenaloom,在授权页面上批准所需的权限。
  4. 在对话中打开 + 菜单,选择“Connectors”,把 Scenaloom 打开。这个连接器在 Claude 桌面版和手机 App 里同样可用。

在 Team 和 Enterprise 方案中,由所有者在“Organization settings”的“Connectors”里添加一次连接器,之后每位成员用自己的 Scenaloom 账户连接。Claude 免费方案只能添加一个自定义连接器。

Claude Code

先在终端里添加服务器,再到 Claude Code 里登录:

claude mcp add --transport http scenaloom https://scenaloom.com/mcp

在会话中运行 /mcp,选中 scenaloom,再选“Authenticate”,浏览器会打开 Scenaloom 的授权页面。想在所有项目里都用 Scenaloom,就在上面的命令后加上 --scope user。Agent Skill 插件可以把剧本 MCP 服务器和技能一起装好。

ChatGPT

  1. 在 ChatGPT 打开“Settings”,依次进入“Apps”和“Advanced settings”,打开“Developer mode”。
  2. 选择“Create app”,名称填 Scenaloom,MCP 服务器 URL 粘贴 https://scenaloom.com/mcp,认证方式选 OAuth。
  3. 登录 Scenaloom 并批准权限。在对话中打开 + 菜单,选择“Developer mode”,再选中 Scenaloom。

开发者模式只在 ChatGPT 付费方案中提供,菜单位置也可能调整,最新路径以 ChatGPT 帮助中心为准。

Cursor

把 Scenaloom 加到 ~/.cursor/mcp.json(对所有项目生效)或 .cursor/mcp.json(只对当前项目生效),然后打开“Cursor Settings”里的“MCP”,点 scenaloom 旁边的“Connect”登录:

{
  "mcpServers": {
    "scenaloom": {
      "url": "https://scenaloom.com/mcp"
    }
  }
}

VS Code

在命令面板运行“MCP: Add Server”,选择 HTTP 并粘贴 URL;也可以把下面的配置写进 .vscode/mcp.json。Copilot 第一次调用 Scenaloom 的工具时,VS Code 会打开浏览器让你登录:

{
  "servers": {
    "scenaloom": {
      "type": "http",
      "url": "https://scenaloom.com/mcp"
    }
  }
}

其他支持 OAuth 远程 MCP 服务器的应用,接入方式都一样:填入这个 URL,按提示登录即可。

你要批准的权限

AI 应用连接时,Scenaloom 会显示一个授权页面,写明应用的名称、网址以及它申请的权限。不想给的权限,取消勾选就行。

权限允许做什么
读取项目列出并读取你的项目、剧本、小说、角色、节拍、大纲和评论。始终包含。
编辑剧本和小说提出并应用修改,更新角色和地点的资料,新建项目和剧集。
评论添加评论,并把评论标为已解决。
使用积分为图片、视频和音频生成报价并启动生成。默认不勾选,应用必须单独申请。

AI 应用可以连接你能打开的所有项目,但权限永远不会超过你在项目里的角色:在你只是“查看者”的项目上,即使授予了编辑权限,它也只能读、不能改。读取和编辑在所有方案中都能用,免费方案也一样。会调用 Scenaloom AI 的工具,和你在 Scenaloom 里直接使用时一样,计入你方案的对话和写作额度。

每一处修改都由你把关

  • 所有改动都先以提议的形式出现。AI 应用会给你看修改前后的对比,在它应用你接受的提议之前,稿子一个字都不会变。
  • 提议也会出现在编辑器的 AI 面板里,你可以自己一键应用。
  • 应用后的修改会和正在同一场戏里打字的协作者合并,保存在版本历史中,也可以撤销。
  • 如果提议之后剧本又被改过,Scenaloom 会拒绝应用这条提议,AI 应用必须重新读取、重新提议。
  • AI 应用写的评论会标上它的名字;你 @提及的协作者,要等你确认后才会收到通知。

积分与消费

未经你允许,已连接的 AI 应用不能使用积分。每次生成之前,它会先向 Scenaloom 询价,告诉你确切的费用和当前余额,得到你的同意后才开始。无法显示确认步骤的应用,只能在你设定的每日上限内消费;上限可以在授权页面或“已连接的应用”里设置,范围从 0(默认值,即不允许消费)到每 24 小时 500 积分。退款按积分政策处理。

查看活动记录、断开应用

打开账户设置,找到“已连接的应用”。每个应用都会显示连接时间、最近一次使用时间、权限、每日积分上限,以及它做过的操作记录。选择“断开连接”就能立刻切断,它的下一次请求就会失败;“全部断开”对所有应用一次生效。找回账户、更改邮箱地址或退出所有设备,也会断开全部应用。应用的登录授权最长有效 90 天,到期后需要你重新批准。

剧本 MCP 服务器常见问题排查

  • 应用提示未授权:从应用里重新登录(例如在 Claude Code 中运行 /mcp)。已断开的应用,以及登录已超过 90 天的应用,都需要重新批准。
  • 修改因剧本已变更而被拒绝:AI 应用读取之后,有人改过这段剧本。请让它重新读取这场戏,再提一次修改。
  • 应用能读不能改:你没有授予“编辑剧本和小说”权限,或者你在该项目里的角色是“查看者”或“可评论者”。要更改权限,先在“已连接的应用”里断开这个应用,再重新连接。
  • 生成被拒绝:应用没有“使用积分”权限、你的余额不足,或者当天的上限已经用完。
  • 请求过于频繁:按应用提示等待几秒后再试。