第三方应用挂载（逐类实操）

本文是 00-接入指南.md 的操作细化：按客户端类型告诉你"去哪填、填什么、怎么确认成功"。

快照 2026-10-12。⚠ 具体菜单名各客户端版本会变 ⇒ 认语义（下表），不要死记路径 ✓

0. 不管什么客户端，都是这三格

⛔ 前提：第三方应用与 UnlimitCanvas 在同一台电脑（服务仅回环）＋ 应用正在运行 ＋ 已在设置里启用。

1. 类型 A：IDE / 编辑器里的 AI 插件

多数 IDE 的 AI 插件已经能"图形化添加 MCP 服务器"：

IDE 设置 → 找 AI / MCP / Tools 相关分组 → Add MCP Server / 新增服务器
  ├─ 类型：HTTP
  ├─ URL：http://127.0.0.1:38770/mcp
  └─ Headers：Authorization = Bearer <token>
保存 → 重启 IDE（或让插件重载 MCP）→ 在插件的工具列表里看到 uc_do_* ✓

• 有的 IDE 是工作区级配置、有的是用户级：建议放用户级（换项目不用重配）
• ⚠ 别把带 token 的配置提交到项目仓库

2. 类型 B：桌面 AI 客户端（配置文件式）

这类客户端通常有一个 MCP 配置文件（JSON / TOML），里面是 mcpServers 一类的条目：

{
  "mcpServers": {
    "unlimit-canvas": {
      "type": "http",
      "url": "http://127.0.0.1:38770/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

步骤：找到配置文件 → 加这段（合并进已有内容，别覆盖 ⋯）→ 完全退出并重启客户端 → 在客户端里确认出现 unlimit-canvas 与其工具。

• 客户端可能要求重启两次（第一次写配置、第二次生效）
• 字段名差异：type 也可能叫 transport；headers 也可能叫 auth/env ⇒ 以客户端文档为准，语义不变

3. 类型 C：自动化 / 后端平台

如果平台支持"自定义 MCP / HTTP 工具"，一般会让你填：

⚠ 这类平台常常跑在另一台机器或容器里 ⇒ 那种情况下连不上（回环限制）⇒ 必须让平台进程与 UnlimitCanvas 同机运行。

4. 类型 D：只支持 stdio 的客户端

• 症状：它只让你填"命令 + 参数"，没有 URL/Header 的填法
• 结论：本产品不提供 stdio 服务 ⇒ 换用支持 HTTP 的客户端最稳
• 兜底（自行评估、不在产品支持范围）：用通用的"HTTP ↔ stdio 桥"把本服务包一层再给客户端；桥的稳定性与安全由你自行负责

5. 挂载后自检（三步确认，逐级排除）

uc_do_gain_agent_overview 是"系统级指南"（必学技巧 / 核心概念 / 模板生态）⇒ 让 AI 先读它，后面干活会顺很多 ✓

6. 上线前的小清单（避免"能demo不能干活"）

• [ ] 用的是当前 token（不是上一次的）
• [ ] 端点端口＝设置页端口；改过端口已重启应用
• [ ] 第三方应用已重启（多数只启动时读配置）
• [ ] 账号已激活（否则调用 403）
• [ ] 要在画布上干活 ⇒ 画布顶栏「AI 编辑授权」已开
• [ ] 要用云端 API 节点 ⇒ 设置页「允许 Agent 调用 API 节点」开着