MCP 集成

StoryLoom 内置 MCP（Model Context Protocol） 服务端，把你的作品、设定集和分镜暴露给外部 AI 客户端（Claude Code、Codex、Claude Desktop、Cursor 等）。让你习惯的 AI 工具直接读写 StoryLoom 里的创作数据，不用把设定来回复制粘贴。

这能干什么

MCP 是一套「让 AI 客户端调用本地工具」的标准协议。接入后，外部 AI 可以：

• 读取作品、章节正文、版本历史，组装与写作页同口径的创作上下文；
• 查询和维护设定集的角色卡、世界观、时间线；
• 读写分镜，调用出图、视频、配音、成片；
• 用你在 StoryLoom 里配置的供应商跑审校、一致性检查、大纲、分镜等 AI 功能（Key 不经 MCP 外传）。

形态：stdio sidecar + 主应用

StoryLoom 随应用打包了一个独立的 MCP 服务端可执行文件 storyloom-mcp（Tauri sidecar）。客户端以 stdio 方式启动它，它再通过本机端点把请求转给正在运行的 StoryLoom 主程序执行，所以使用 MCP 时 StoryLoom 需要开着。

┌─────────────────┐  stdio (MCP)  ┌──────────────────┐  本机端点 + 令牌  ┌──────────────┐
│  AI 客户端       │ ◄───────────► │  storyloom-mcp   │ ◄──────────────► │ StoryLoom    │
│ (Claude Code /  │   JSON-RPC    │  (sidecar)       │                  │ 主程序与数据  │
│  Cursor 等)     │               └──────────────────┘                  └──────────────┘
└─────────────────┘

接入方式

左侧导航进入 MCP 页：

1. 「本地服务与环境」卡片显示服务是否运行、sidecar 是否就绪；
2. 在「一键接入」里选择客户端——Claude Code、Codex、Claude Desktop、Cursor。确认目标配置文件与作用域后，StoryLoom 会把 storyloom-mcp 写进该客户端的配置并生成一个接入令牌；已有的其它 MCP 服务不受影响；
3. 重启该客户端后生效。

MCP 页：一键接入四种客户端，下方管理接入令牌

Claude Code 支持写入全局或某个项目目录（项目级 .mcp.json）；Codex 写 TOML 配置。不想用一键接入，也可以手动新建令牌后自行配置。「取消接入」只移除配置，令牌需要在下方列表里吊销。

工具覆盖

类别	能做什么
作品与章节	列出 / 读取 / 新建 / 修改作品与章节，读写正文，按大纲批量建章节，查看与回滚版本
设定集	查询与增删改角色卡、世界观、时间线，设置角色出图提示词、音色与演绎风格
AI 写作	审校、一致性检查、章节摘要、选题、大纲、作品简介、角色 / 世界观 / 时间线生成、设定提取
分镜与媒体	读写分镜、AI 拆分镜、出图（单镜 / 整章）、候选图管理、角色参考图、视频、配音、生成本章成片并导出
导入导出	解析分镜表、按草稿保存分镜、导入图片 / 视频 / 配音、导入小说与工程包、导出小说与工程包
商品与合规	商品读写、AI 提炼卖点草稿、合规体检、事实核对规则检查

v1.0.0 共 87 个工具。剪映草稿、批量变体、封面与发布清单导出、静图成片、多候选整章等目前只在界面里提供，MCP 未接。

令牌与安全边界

• 接入令牌可设为只读（只放行查询类工具），或限定只能访问指定作品；可随时吊销或删除。
• 调用 AI、生成媒体的工具需要可写令牌，并消耗你自己配置的供应商额度。
• MCP 页的「最近调用」列出每次调用记录，便于核对外部 AI 做了什么。
• MCP 只暴露创作相关的数据与操作，不返回 API Key 等凭据；令牌明文只写进你本机客户端的配置文件。
• 导出类工具默认不覆盖已有文件。

相关章节

• Story Bible →
• 路线图 →