MCP 服务器选项详解 · headers、启用开关与工具列表
服务器级通用选项
每个 MCP 服务器都有以下配置项（在设置 → MCP → 点击服务器进入详情）：
name（必填）
可读的显示名称。这个名字会出现在：
- MCP 服务器列表
- 助手设置中的选择器
- 连接状态显示
命名建议：简短、能说明用途。比如 "Code Search"、"Web Scraper"、"Internal API"。
enable（默认 true）
不删除服务器的情况下开启或关闭。关闭后：
- RikkaHub 关闭与该服务器的连接
- 工具列表从助手的可用 MCP 服务器中隐藏
- 配置保留，随时可以重新开启
url（必填）
MCP 端点的完整 URL。格式取决于传输类型：
- SSE：通常以
/sse结尾（如https://mcp.example.com/sse） - Streamable HTTP：基础路径（如
https://mcp.example.com/mcp）
URL 错误会导致连接失败，检查：
- 末尾是否多了或少了字符
- 协议是 https 还是 http
- 端口号是否正确（有的服务器用非 80/443 端口）
headers（键值对列表）
随每个请求发送到该服务器的自定义 HTTP 头。最常见用途：
| Header | 示例值 | 场景 |
|---|---|---|
Authorization | Bearer sk-xxxx | API Key 或 token 身份验证 |
X-Custom-Token | mytoken123 | 自定义服务商的认证方式 |
User-Agent | RikkaHub/2.5.6 | 标识请求来源 |
Accept | application/json | 指定响应格式 |
点击 + 添加新 Header，填写名称和值即可。支持任意数量。
工具级选项
连接成功后，RikkaHub 会自动拉取服务器暴露的所有工具。每个工具可以单独控制——这是 RikkaHub 比很多 AI app 更精细的地方。
工具列表
服务器详情页下方显示它暴露的所有工具。每个工具一行，显示：
- 工具名称
- 简短描述
- 启用状态
enable（默认 true）
启用或禁用这个特定工具。被禁用的工具从助手的工具列表中隐藏，即使服务器已连接也不会被调用。
典型场景
- 服务器暴露了 10 个工具，但你只需要其中 3 个
- 某个工具不稳定或会导致问题
- 想精确控制助手能调用哪些能力
needsApproval（默认 false）
开启后，RikkaHub 会在执行该工具前显示确认对话框。AI 尝试调用时，你需要手动点击确认才能继续。
对任何会修改数据或触发外部副作用的工具开启"需要审批"——文件写入、发送邮件、购买、数据库删除操作等。
这是防止 AI 自主执行不可逆操作的最后一道防线。速度慢一些，但安全。
助手级挂载（补充）
服务器添加完成、工具选项配置好后，最后一步：
- 打开 设置 → 助手 → 某个助手 → 工具与集成
- 在 MCP 服务器部分切换你要挂载的服务器
助手能调用的 MCP 服务器 = 全局已启用的服务器 ∩ 助手已勾选的服务器。
三层筛选（服务器启用 → 工具启用 → 助手挂载）确保了精确的权限控制。
配置修改后立即生效
修改服务器的任何选项（URL、headers、工具启用状态、需要审批等）后，RikkaHub 会自动：
- 断开现有连接
- 用新配置重新连接
- 同步更新工具列表
不需要重启 app。