MCP 接入指南（第三方应用挂载）

本文面向正式使用：怎么把 UnlimitCanvas 的 MCP 服务挂进第三方 AI 应用（IDE 插件、AI 客户端、自动化平台等）。

✅ 只讲产品里可操作的正规途径（设置页 ＋ 应用内帮助）—— 跟着点就能接上。

⛔ 不含开发/调试内容（仓库路径、脚本、测试台等一律不写）。

快照：2026-10-12；⚠ 具体界面文案/默认端口可能随版本微调 ⇒ 以你应用里的设置页为准。

一、三步挂载（先看这个，绝大多数人只需要这三步）

① 在**本机**的 UnlimitCanvas 里：设置 → MCP Agent → 打开「启用 MCP 服务」
      ↓ 推荐点「**复制客户端配置**」⇒ 一段**可直接粘贴**的 JSON（已含端点与 Token）
        （也可以分别复制「MCP 端点」与「鉴权 Token」，到外部应用里手工填 ✓）
② 在**同一台机器**的第三方 AI 应用里：新增一个 MCP 服务器（HTTP 类型）
      ↓ 填端点 ＋ 认证头：Authorization: Bearer <token>
③ 回到应用确认：账号已激活；要在**画布上干活**时，再打开画布顶栏的「AI 编辑授权」
      ↓ 让 AI 调一次 `uc_do_gain_agent_overview` ⇒ 看见工具结果 ＝ 接好了 ✓

二、前提与边界（先读，省一半时间）

⚠ 不要尝试用端口转发/隧道把本服务暴露到公网：产品不支持这种做法，安全风险自负 ✗

三、在应用里取凭据（唯一正规途径）

位置：设置 → MCP Agent

同一页还有一条安全提示（务必看）：token 等同于完全权限 ⇒ 只填进你信任的客户端。

四、在第三方应用里挂载（核心）

4.1 通用填法：三格就够了

第三方应用里新增 MCP 服务器时，找 「添加 MCP 服务器 / Add MCP Server」，然后：

保存后重启该第三方应用（多数客户端只在启动时读取 MCP 配置）。

4.2 如果你的客户端用配置文件（很常见）

⭐ 最省事：直接用设置页的「复制客户端配置」—— 复制出来的内容就是下面这段（端点与 Token 都已填好）✓

在它的 MCP 配置里加一条（字段名以客户端文档为准，语义就是上面那三格）：

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

• ⚠ 把 <粘贴你的 token> 换成真实 token；不要把带 token 的文件提交进代码库/发给别人
• ⚠ url 的端口与你设置页一致；改了端口 ⇒ 这里也要改，并重启两边

4.3 只支持「命令式（stdio）」的客户端怎么办

有些客户端只接受 stdio（让你填一条命令）的 MCP。本产品提供的是 HTTP 服务，不是命令 ⇒

最稳的做法是换用支持 HTTP/Streamable HTTP 的客户端。

（若你确实要用 stdio-only 的客户端，需要自行找"HTTP→stdio 桥"，⛔ 那不属于产品支持范围。）

4.4 挂载成功的标志

• 客户端里能看到工具列表 —— 本产品的工具都以 uc_do_ 开头 ✓
• 让 AI 调用 uc_do_gain_agent_overview（系统级指南）⇒ 能返回内容即为成功 ✓
• 之后可以照 04-标准作业流程（SOP）.md 里的流程干活

五、不动第三方应用也能验证（推荐先做这步）

六、连上了却用不了？对号入座

七、FAQ（用户最常问的）

• 可以挂几个第三方应用？ 一个 token 通用，可以多个同时挂 —— 都受同一份授权与开关约束 ✓
• token 会过期吗？ 不会自动过期；只有你点「重新生成」才会变（变了旧挂载立刻失效）。
• 别人能远程控制我的电脑吗？ 服务只在本机回环、且要 token ⇒ 不暴露在网络上。不用时建议在设置里关掉「启用 MCP 服务」更稳妥 ✓
• 要开防火墙 / 开放端口吗？ 不需要（不出回环）。
• 应用关掉还能用吗？ 不能 —— 服务随应用进程。
• 能指定只让某个客户端用吗？ 当前是单一全局 token，做不到"按客户端授权"（要作废全部，就重置 token）。

八、安全要点（务必读）

1. token ＝ 完全权限：能操作你的画布 ⇒ ⛔ 别贴进聊天/工单/截图/公开仓库
2. 只填进你信任的客户端；换人用电脑、怀疑泄露 ⇒ 设置页「重新生成」并更新所有客户端
3. 不用就关：设置 → MCP Agent 关掉「启用 MCP 服务」
4. ⛔ 别用隧道/端口转发把它暴露到公网（产品不支持）

九、本专题导航