为助手挂载 MCP 服务器 · 助手级工具权限选择

为什么助手需要单独挂载

你可能有 5 个 MCP 服务器，但不想每个助手都调用所有 5 个。助手级挂载是 RikkaHub 精细权限的关键一环：

• 编程助手：挂载代码搜索、文件读取、数据库查询
• 写作助手：挂载网页搜索、知识库查询、文本分析
• 角色扮演助手：可能一个 MCP 服务器都不需要（用预设消息和记忆就够了）

全局添加 + 助手勾选 = 灵活而精确的控制。

挂载步骤

1. 打开 设置 → 助手 → 某个助手 → 工具与集成 标签页
2. 滚动到 MCP 服务器 区域
3. 切换要挂载的服务器开关（显示为全局已启用的服务器）
4. 保存

这里只显示全局已启用的 MCP 服务器。如果某个 MCP 服务器在全局被禁用了，它不会出现在任何助手的挂载选项里。

挂载后会发生什么

• ✅ AI 可以在对话中调用该服务器暴露的工具
• ✅ 受工具级 enable / needsApproval 设置约束
• ✅ 如果多个助手挂载了同一个服务器，它们共享同一个服务器连接（RikkaHub 会复用连接）
• ❌ 助手的工具列表不会自动刷新——可能需要切换一次对话或重启 RikkaHub

一个助手挂载多个服务器

一个助手可以挂载多个 MCP 服务器。在对话中 AI 能同时调用所有已挂载服务器的所有已启用工具。

推荐实践

• 不要挂载太多：每个挂载的服务器都会消耗连接资源
• 按需挂载：一个助手挂 2-5 个服务器比较合理
• 助手职责单一：一个助手专注一个场景（编程 / 写作 / 翻译），挂载对应的工具

三层权限模型回顾

服务器 enable（全局） → 工具 enable（工具级） → 助手挂载（助手级）

只有三层都通过，AI 才能调用。举例：

• 服务器 A 全局启用 ✅
• 服务器 A 的"写入"工具被禁用 ❌
• → 即使助手挂载了服务器 A，"写入"工具也不可用
• 服务器 B 全局启用 ✅
• 服务器 B 的所有工具启用 ✅
• 助手 X 没有挂载服务器 B ❌
• → 助手 X 不能调用服务器 B 的任何工具

助手间共享服务器

如果你有 3 个助手都需要"网页搜索" MCP 服务器：

• 全局只添加一次服务器 ✅
• 分别在 3 个助手上勾选挂载 ✅
• 共享同一个服务器连接（节省资源）

常见问题

助手说"我没有这个工具"

排查顺序：

1. 检查服务器是否全局启用（设置 → MCP → 服务器 enable 开关）
2. 检查助手是否挂载了这个服务器
3. 检查具体工具是否被禁用
4. 检查连接状态是否为"已连接"
5. 重启 RikkaHub（极少数情况下挂载后没立即生效）

挂载后助手选择器里找不到服务器

只能勾选全局已启用的服务器。如果全局禁用了，这里就看不到。先在全局开启，再到助手这里勾选。