接入 Clueso MCP：Claude Code / Cursor / Codex

你将得到什么

• 一条可用的 Clueso 远程 MCP 连接（OAuth，无需自管 API Key）
• 在 Claude Code / Cursor / Codex 之一看到 Clueso 工具，并能通过官方验收提示列出项目
• 清楚 Streamable HTTP 端点与各客户端配置差异

开始前准备

1. 打开浏览器登录 web.clueso.io（官方排错说明：授权前先登录 Clueso）。
2. 选定一个 MCP 客户端（本课主路径三选一；其余见文末扩展）。
3. Cursor / VS Code：官方要求 Node.js 22.16+。先核对：

node --version

对照结果：版本号应 ≥ v22.16.0。若更低，请先升级再继续 Cursor/VS Code 配置。

Clueso MCP 所有计划均可接入；视频导出、高级品牌等工具可能需付费计划——以 Setup · Before you start 为准。

核心事实（先记住）

路径 A：Claude Code（推荐，一条命令）

官方命令：

claude mcp add --transport http Clueso https://connect.clueso.io/mcp

终端会提示在浏览器授权：登录 Clueso → 点击 Allow。

可选：在项目目录内加 --scope project，只对当前项目生效（官方同页说明）。

验证：

claude mcp list

对照结果：列表中应有 Clueso，状态类似 ✓ connected。

再开会话：

claude

在对话里粘贴官方测试句（下一节）。

路径 B：Cursor（Agent 模式）

官方强调：MCP 工具仅在 Agent 模式可用。

方式 1 — 手动 .cursor/mcp.json（官方 Option 2）

mkdir -p .cursor && touch .cursor/mcp.json

写入（与 Setup · Cursor 一致）：

{
  "mcpServers": {
    "Clueso": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://connect.clueso.io/mcp"
      ]
    }
  }
}

重启 Cursor → 浏览器弹出 OAuth → 登录并 Allow。

方式 2 — 官方 deeplink（Option 1）

官方提供 Cursor deeplink 自动安装（见 Setup 页 “Automatic setup”）。能打开则更省事；失败时退回手动 mcp.json。

对照结果：Agent 聊天中应能选到 Clueso 相关工具；首次调用会要求批准工具调用。

路径 C：Codex CLI

先确认 CLI 较新（官方：远程 MCP 需要较新 Codex）：

codex --version
# 需要时：
npm i -g @openai/codex

在 ~/.codex/config.toml 增加（官方原文）：

[mcp_servers.clueso]
url = "https://connect.clueso.io/mcp"

授权：

codex mcp login clueso

浏览器登录 → Allow。启动 Codex 后执行 /mcp，应能看到 clueso。

官方验收提示（三路径通用）

在已连接的客户端里发送（官方 Verify the connection）：

Show me my most recently updated Clueso project.

或中文等价意图：

列出我 Clueso 工作区里最近更新的项目。

对照结果：

1. 助手提出 工具调用审批 → 你点 Allow / Approve。
2. 返回项目列表或「最近更新」项目信息（空工作区则可能是空列表，但仍说明工具通了）。
3. 若超时/失败：重启客户端、重新授权，并确认已登录 web.clueso.io（官方 Troubleshooting）。

另一条官方示例测试句（Setup 各客户端小节）：

Create a Clueso guide from this PPT, add a voiceover to each slide explaining the key point, and export it as a video.

本课第 2 讲再展开工具链；第 1 讲以 列表/连通 为硬验收。

扩展：ChatGPT / Claude / Gemini CLI / VS Code

按需对照官方同页，勿混用字段名：

• ChatGPT（付费 + Developer Mode）：Apps → Add → URL https://connect.clueso.io/mcp → 命名 Clueso → OAuth；聊天里开启 Developer mode。
• Claude（付费）：Settings → Connectors → Add custom connector → 同一 URL。
• Gemini CLI（≥ 0.1.7）：gemini mcp add clueso https://connect.clueso.io/mcp，或手写 ~/.gemini/settings.json 的 httpUrl。
• VS Code：.vscode/mcp.json 使用 servers.Clueso + mcp-remote（字段与 Cursor 略有不同，以官方为准）。

本讲验收清单

• connect.clueso.io/mcp 已写入所选客户端配置
• OAuth 完成且客户端显示 Clueso / clueso
• 官方验收提示能触发工具调用并返回（或明确空列表）

下一讲：用自然语言串联 create_project、配音与 export_project。