MCP 与连接器

内置能力、系统连接器与自定义 MCP 服务器的三种作用域,以及「装了但工具不出现」的排查顺序。

MCP 页管理 Klaus 可调用的外部与系统能力。

  • 内置能力:电脑操控(让 Klaus 像人一样点击、输入操作桌面应用)以原生能力卡片形式出现,点卡片进入开关与配置。(浏览器操控曾也是这里的一张原生能力卡,它现已归为内置插件,开关与配置面搬到了插件页。)
  • 系统连接器:接入 macOS 本机数据与应用,如信息(Messages)、Safari 书签与历史、照片、App UI 等。部分连接器需要先完成系统授权(见下文「系统授权」),授权前保持关闭。
  • 市场与自定义:可从市场安装 MCP 服务器,也可手动添加自定义 MCP 服务器。连接器目录现在完全由服务端托管,客户端不再随包编译一份种子——好处是服务端上新后所有客户端不用发版就能看到,代价是服务端不可达时连接器市场会是空的(和技能广场同一个取舍)。

MCP 服务器有三个作用域:全局(所有会话可用)、项目(写在 <项目>/.klaus/mcp.json,随仓库提交、团队共享)、本地(写在引擎配置 ~/.klaus/config.toml 里这个项目路径名下,仅本机私有、不进仓库)。「已安装」档顶部是一排平铺的标签:「全局」加上每个已登记项目各一个;在项目标签里,每行用「项目」或「本地」标出它属于哪种。项目作用域的配置在会话启动时读取,改完要开新会话才生效。另外,由插件带来的 MCP 服务器会在行上打一个「插件」来源标记——它是一个来源标签,不是你能选的作用域。「服务器装了但工具不出现」的原因按常见程度排:需要授权的服务器(OAuth)在完成授权前一直不可用,MCP 页会把这类服务器单独标出来、可以就地补授权;其次是启动命令依赖的运行时不在(npx/uv 这类,MCP 页有检测入口);再次是服务器本身或那个工具被单独关了——单个工具可以单独关掉,不必禁掉整个服务器。

(历史上还有一道「项目信任」闸门,现在已经取消了:不会再因为没确认信任而拿不到工具。)