文档

MCP

MCP 扩展让 Nora 可以连接实现了 Model Context Protocol 的外部工具和服务。

配置 MCP 服务器

打开设置 > 扩展 > MCP,并填写 JSON 配置。保存时 Sliprail 会验证配置格式。

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--isolated"]
    }
  }
}

Sliprail 会加载每个已配置服务器提供的工具。如果配置或启动失败,扩展状态中会显示错误,并提供重试入口。

创建角色

角色会成为启动器中的一条指令,用于按照指定的 MCP 配置打开 Nora。每个角色支持:

  • 角色名字 - 启动器中显示的指令名称
  • 消息模板 - 将 %s 替换为启动器参数后发送给 Nora
  • 读取剪贴板作为输入 - 将剪贴板文本追加到角色输入
  • 模型 - 覆盖全局 MCP 模型,或继续使用 MCP 默认模型
  • 动态工具搜索 - 默认开启,Nora 会按需搜索已配置工具
  • 可使用的工具 - 关闭动态工具搜索后使用的手动工具列表

角色必须至少有一个可用工具。开启动态工具搜索时,已配置 MCP 服务器中的全部工具都可用于按需搜索。

使用角色

  1. 保存有效的服务器配置
  2. 添加角色并配置它可以使用的工具
  3. 在桌面启动器中输入角色名称
  4. 可以按空格后继续输入参数
  5. 按 Enter 使用该角色打开 Nora

全局设置

  • 执行工具调用需要确认 - 默认开启,建议保持开启。Nora 会在执行工具前请求确认
  • 模型 - 未单独选择时使用 Nora 默认模型
  • 使用全局共享 MCP 服务器实例 - 默认开启。只有服务器支持多个独立实例时才建议关闭

关闭共享实例后,每个聊天窗口都会启动独立 MCP 服务器。部分服务器需要添加 --isolated 等隔离参数才能正常工作。

安全与同步

MCP 工具可能读取文件、发起网络请求或修改数据。除非完全信任服务器和角色配置,否则请保持工具调用确认开启。

MCP 云同步默认关闭。只有确实需要同步服务器和角色设置时,才在云同步中开启 MCP。