v2.6.0 Beta 新增：MCP 本地服务从 2.6.0-beta.1 开始提供，目前在 Beta 通道；正式版发布后所有用户都可以使用。
- 阅读和编写剧本，调整章节、片段与剧情路线，修改变量；
- 编辑角色、表情、皮肤与立绘布局，整理场景、镜头与演出；
- 导入和整理素材，编辑语音，读写多语言译文；
- 查找引用、做工程体检，在预览里试跑剧情并截取画面；
- 打开相应的工具组后，还能编辑游戏界面与主题、数据表，以及构建游戏。
AI 助手的每一次修改都通过 Studio 本身完成：和你亲手编辑一样会自动保存、立刻显示在界面上；修改前还会自动保存项目历史快照，随时可以回退。
开始之前
- 在同一台电脑上打开 Studio 和工程。MCP 只接受本机连接。
- 准备一个支持 MCP 的 AI 编程助手，例如 Claude Code、Cursor 或 Codex。
- 在“设置 → 系统”中开启项目历史。项目历史关闭时，AI 助手只能读取，不能修改工程。
开启服务
打开 MCP 页
点击顶部的「扩展工坊」，在左侧选择「MCP」。
启用服务
点击页面左上角的电源按钮。状态变成「运行中」后，旁边会显示本机地址，默认是 http://127.0.0.1:39251/mcp。
接入 AI 助手
最简单的方式是把“接入提示词”交给 AI 助手，让它自己完成配置：
复制接入提示词
在「接入客户端」中选择提示词语言（简体中文、繁體中文、日本語或 English），点击「复制接入提示词」。
发给 AI 助手
把提示词粘贴到 AI 助手的对话框里发送。它会按提示把 Studio 添加到自己的 MCP 配置中，需要重启或重新加载时会提醒你。
在 Studio 中批准
AI 助手第一次调用需要授权的工具时，Studio 会弹出连接请求。确认是你刚刚接入的助手后，选择「只读」或「允许修改」。如果「新连接批准」设为自动，则不会弹出，见下文。
手动配置
也可以展开「手动配置」，按客户端复制现成的配置：
| 客户端 | 配置方式 |
|---|
| Claude Code | 在终端执行 claude mcp add --scope user --transport http letsgal-studio http://127.0.0.1:39251/mcp |
| Cursor | 把 letsgal-studio 的连接地址合并进 ~/.cursor/mcp.json 的 mcpServers |
| Codex | 在 ~/.codex/config.toml 末尾追加 [mcp_servers.letsgal_studio]，url 填本机地址 |
批准连接
AI 助手第一次调用需要授权的工具时，Studio 会弹出批准窗口，显示客户端自报的名称、版本和请求时间：
| 选择 | 效果 |
|---|
| 只读 | 可以读取当前工程的内容，不能修改 |
| 允许修改 | 还可以修改工程，写入前会自动保存历史快照 |
| 拒绝 | 这次连接的所有请求都会被拒绝 |
本机的任何程序都能发起连接，客户端的名称和版本也是它自己声明的，Studio 无法核实。只在你刚刚亲自接入了这个客户端时才批准。
新连接批准
「权限与确认」中的「新连接批准」决定新的连接要不要你批准：
| 选项 | 效果 |
|---|
| 每次询问（默认） | 每个新的连接都要你在 Studio 中批准 |
| 自动只读 | 新的连接自动以只读方式接入，不再弹出批准窗口 |
| 自动允许修改 | 新的连接自动获得修改权限，不再弹出批准窗口；选择时 Studio 会再确认一次 |
自动批准后，本机任何程序都能直接连接 Studio；选择「自动允许修改」时，它们还能直接修改工程。只在需要时开启，用完建议改回「每次询问」。
已连接的会话
「已连接的会话」列出所有连接，可以看到权限、最近活动和调用次数，也可以单独「断开」或「全部断开」。每个连接右侧的标签表示它现在的状态：
| 标签 | 含义 |
|---|
| 可修改 | 已获准修改工程 |
| 只读 | 已获准读取工程，不能修改 |
| 待批准 | 正在等你在批准窗口中做出选择 |
| 未授权 | 已经连上，但还没有调用需要授权的工具；第一次调用时按「新连接批准」的设置处理 |
Codex 等客户端会为每个对话各开一个连接，有时还会为后台任务（例如自动给对话起标题）多开连接，所以列表里同一个客户端可能出现好几行。这些连接只要没有调用需要授权的工具，就只显示「未授权」，不会弹出批准窗口。
选择开放的工具
「工具组」决定 AI 助手能使用哪些功能，展开工具组可以看到其中每个工具的用途。修改后，AI 助手需要重新连接才会生效。
| 工具组 | 默认 | 包含的功能 |
|---|
| 核心 | 始终开启 | 工程状态、角色与场景名册、查找引用、工程体检、项目历史、撤销自己的修改、删除内容、发送通知 |
| 剧本 | 开启 | 阅读与编写剧本、调整章节与片段、剧情路线、变量 |
| 角色与演出 | 开启 | 角色、表情、皮肤与立绘布局、立绘烘焙、场景、镜头、粒子与演出片段 |
| 素材与语音 | 开启 | 导入与整理素材、语音编辑与识别 |
| 本地化 | 开启 | 读取与修改译文 |
| 预览验证 | 开启 | 查看预览状态、试跑剧情、截取画面 |
| 界面与主题 | 关闭 | 游戏界面文档、主题与对白样式 |
| 数据表与扩展 | 关闭 | 数据表与已启用扩展的设置 |
| 高级 | 关闭 | 外部批量编辑文件、检查点与整体回退、发行设置、调试运行 |
| 构建与扩展开发 | 关闭 | 构建游戏、开发扩展、浏览扩展工坊 |
Cursor 等客户端最多只能加载约 40 个工具，默认开启的几组正好 40 个。打开更多工具组前，先确认你的 AI 助手能加载更多工具。
权限与确认
「权限与确认」决定哪些操作需要你在 Studio 里确认：
| 模式 | 效果 |
|---|
| 标准（默认） | 删除内容、写入外部链接、启用扩展代码等操作，每次都要你确认 |
| 自定义 | 逐项选择哪些操作需要确认，其余操作直接执行 |
| 全部放行 | 所有操作直接执行，不再弹出确认；新的连接也一律自动允许修改 |
全部放行只适合你全程盯着 AI 助手工作的时候。开启后，本机任何程序都能直接连接 Studio 并修改工程，包括启用扩展代码在 Studio 里运行；如果 AI 助手读到了恶意内容，也可能在你不知情时做出这些修改。有新的连接被自动批准时会弹出提示（同一客户端 10 分钟内只提示一次），用完建议切回「标准」。
确认窗口
需要确认时，Studio 会弹出窗口，列出 AI 助手要做什么、涉及哪些内容，以及它给出的理由。理由由 AI 助手自己填写，仅供参考。
拒绝后，同一个连接 1 分钟内不能再请求确认；连续拒绝 3 次，这个连接会自动降为只读。
看清 AI 助手在做什么
| 位置 | 显示内容 |
|---|
| 窗口光圈 | 服务运行时窗口四周显示淡蓝色光圈；AI 助手调用工具时光圈变亮。可以在「服务设置」中关闭 |
| 状态栏 | 用一句话说明当前步骤，例如「claude-code 正在阅读剧本 · 第三章 · main」；修改完成后显示改了什么，失败时说明原因，等你确认时会醒目提示 |
| 全局通知 | AI 助手完成阶段性任务时会发通知；它在后台开始构建游戏、生成 ZIP 交付包，或有新的连接被自动批准时，也会弹出提示 |
| 活动日志 | MCP 页右侧记录服务启停、连接与批准、每次工具调用和修改内容，可以筛选、搜索、展开详情和复制 |
撤销与回退
- AI 助手修改工程前，Studio 会自动保存项目历史快照；同一个连接 5 分钟内的连续修改合并为一次快照，删除内容前一定会保存快照。
- AI 助手可以撤销自己做过的修改，不会撤销你的修改。
- 删除的内容不能由 AI 助手撤销，需要在项目历史中回退。
- 你正在输入的片段，AI 助手会等你停下来再改，不会打断你。
可以这样请 AI 助手帮忙
连接后，直接用自然语言描述需求即可，例如：
- 「读一下第二章，检查有没有前后矛盾的地方，先只告诉我，不要修改。」
- 「把第三章开头的对白改得更口语化，保持角色语气，改完通知我。」
- 「检查整个工程有没有引用了不存在的角色、表情或素材。」
- 「给“雨夜”场景加一段下雨的粒子效果，再截取预览画面检查效果。」
- 「为工程添加英文，把第一章的对白翻译成英文，角色名保持不变。」
大改之前，让 AI 助手先说明计划，完成后用通知告诉你；只想让它看不想让它改时，批准连接时选择「只读」。
服务设置与布局
「服务设置」中可以修改端口（1024–65535，默认 39251）。应用后服务会重新启动，已接入的 AI 助手需要改用新地址。同一处还可以关闭「窗口光圈」。
MCP 页左侧设置栏与右侧会话、日志之间的分隔线可以拖动调整宽度，双击恢复默认。
安全说明
- 服务只监听本机，浏览器里的网页无法连接。
- AI 助手拿不到账号密码、许可证和登录凭证，返回给它的内容会隐藏这类信息。
- AI 助手不能修改 Studio 设置、账号与付款，也不能读写工程以外的文件。
- AI 助手读到的剧本、名称和注释都只是工程数据。工程里有来路不明的内容时，建议保持「标准」模式。
- 开启运营统计时，AI 助手发起的构建与你点击「构建」一样，会上传剧情大纲用于统计。
常见问题
状态显示「端口被占用」
端口被其他程序占用了，可能是另一个打开的 Studio。点击「更换端口」改用其他端口，再更新 AI 助手里的地址。
只用了一个 AI 助手，列表里却有好几个连接
Codex 等客户端会为每个对话各开一个连接，有时还会为后台任务多开连接。没有调用需要授权的工具的连接显示「未授权」，不会打扰你；不需要的可以点「断开」，客户端下次用到时会自动重新连接。
AI 助手说在等待批准
回到 Studio，在弹出的连接请求中选择「只读」或「允许修改」。如果请求窗口已经关闭，让 AI 助手再调用一次工具即可重新发起请求。
AI 助手说项目历史没有开启，不能修改
在“设置 → 系统”中开启项目历史，再让它重试。
截取画面或试跑预览失败
预览相关的功能需要 Studio 窗口可见：不要最小化窗口，也不要把预览拆成独立窗口；在调试模块中暂时不能使用。
Cursor 提示工具太多
关闭一些不需要的工具组，让工具总数保持在 40 个以内，然后让 Cursor 重新连接。
AI 助手直接改了磁盘上的工程文件，改动又消失了
Studio 打开工程时以内存中的内容为准，会自动保存并覆盖外部修改。请让 AI 助手通过 MCP 修改；需要大批量直接改文件时，打开「高级」工具组，让它先开启“外部批量编辑”。
