第 2 课
用 MCP 工具做片：从项目到配音再导出
对照官方 Tools 与端到端示例，用自然语言触发 create_project / voiceover_batch / export_project 等工具链，并记录对照结果。
学习位置仅保存在当前浏览器，有效期 180 天。
图文讲义
来源：Clueso · Set up Clueso MCP · Tools available / Combine tools、create_project 等工具说明（工具名与官方 Setup 表一致）。以自然语言驱动；不必背工具名。
你将得到什么
- 一次完整的「描述目标 → 多工具串联 → 可在 Clueso 编辑器继续改」的跟做
- 对官方工具表中 项目 / 片段 / 配音 / 导出 的对照理解
- 一份可复用的提示词模板（PPT→讲解视频、Changelog→发布视频）
开始前
第 1 讲 MCP 已连通；浏览器可打开 Clueso 工作区对照 UI。导出与高级品牌能力可能需付费计划——以官网为准。
步骤 1：先浏览工作区（只读）
提示词（官方 Verify / What you can do）：
Show me all projects in my Clueso workspace.
或：
Show me my most recently updated Clueso project.
对照结果：出现 find（或等价）工具调用；返回项目名/ID。记下一个 projectId（若有）供后文引用。
步骤 2：创建空白项目
提示词：
Create a new Clueso project titled "KUN MCP Demo - Password Reset".
After creation, summarize the projectId and the initial clip.
官方行为摘要（Setup · create_project）：新建项目会带 一个空白 clip（index 0），并返回 projectId 与 initialClipId。
对照结果：工具成功；回复中含项目 ID；打开 web.clueso.io 能看到同名项目。
步骤 3：加片段与文案元素
提示词示例：
In project "KUN MCP Demo - Password Reset":
1) Ensure clip 0 lasts about 6 seconds and is titled "Problem".
2) Add a second blank clip titled "Steps" lasting 8 seconds.
3) On clip 0, add a large title text: "Forgot password?"
4) On clip 1, add three short bullet callouts: Open settings → Reset → Confirm email.
Use Clueso design guidance if available.
官方相关工具：update_clips、add_clips、add_elements、get_design_guide（Setup 工具表）。助手会自行挑选。
对照结果：编辑器时间线上出现 ≥2 个 clip，画面有标题/标注；元素可继续手改。
步骤 4：批量配音
提示词：
Set an English AI voice for the whole project, then voiceover_batch:
- Clip "Problem": "Forgot your password? Reset it in under a minute."
- Clip "Steps": "Open settings, choose reset password, then confirm the email link."
Estimate durations if needed so timings match the speech.
官方要点（Setup · Voiceover）：voiceover_batch / set_voice；生成语音会 按口播重定时长；可先 estimate_duration。
对照结果：各 clip 有口播；时长与脚本匹配；可在编辑器试听。
步骤 5：导出视频
提示词（官方 Export 示例口径）：
Export project "KUN MCP Demo - Password Reset" as a video at 1080p 30fps.
Tell me when the export job is queued and where to find the file in the Exports tab.
官方：export_project 后台渲染；助手很快返回；成品出现在编辑器 Exports 标签（Setup · Export）。
对照结果：导出任务已排队/完成；Exports 中可下载。若提示需升级计划，记录官网文案即可，不算本课失败——连通与创建/配音已覆盖核心 MCP 路径。
官方端到端配方（可直接改素材重跑）
以下意图来自 Setup「Combine tools for end-to-end workflows」，请整段粘贴后替换附件：
A. PPT → 讲解视频
Turn this slide deck into a narrated explainer video.
Upload the PPTX, create a project, import each slide as a clip, generate AI narration per slide, then export the video.
（对应官方链：upload_file → create_project → add_clips(kind=pptx) → voiceover_batch → export_project）
B. Changelog → 发布视频
Build a product release video from this changelog.
Create a project, add blank clips, add headlines and AI illustrations, generate voiceover from the script, and export.
C. 录屏 → 精修指南
Convert this screen recording into a polished Clueso guide.
Upload the recording, add it as a video clip, auto_sync steps, add titles and zooms, regenerate narration, then export.
常用工具速查（不必背，供核对）
| 工具 | 作用（官方表意译） |
|---|---|
find | 按类型搜索项目/文件夹/素材/音色等 |
create_project / get_project / update_project | 创建与读写项目 |
add_clips / update_clips | 管理片段 |
add_elements / generate_media | 往片段加文案、标注、AI 图/动画 |
voiceover_batch / set_voice / add_audio | 口播与配乐 |
export_project | 导出视频 |
run_script | 在服务端用同步 JS 批量调用上述工具（高级） |
完整列表以 help.clueso.io/mcp-setup 为准。
排错（官方 Troubleshooting 摘要）
- 工具不出现：重启客户端；Cursor 须 Agent 模式；检查 Node ≥ 22.16。
- 授权反复失败：先登录 web.clueso.io；清 Cookie 后重授。
- 调用超时：确认账号/工作区可用；检查是否拦截
connect.clueso.io；移除后重加 MCP。
本讲验收清单
- 能创建（或打开）一个演示项目并在网页编辑器看到
- 至少完成「加片段/元素」或「配音」之一并有 UI 对照
- 发起过一次
export_project（成功或明确的计划限制提示均可记录）
