rikkahub 中文文档 下载 App

添加 SSE 与 Streamable HTTP 服务器 · 双传输类型配置

添加 MCP 服务器的步骤

  1. 打开 设置 → MCP
  2. 点击右上角 + 按钮
  3. 选择与你的服务器匹配的传输类型（SSE 或 Streamable HTTP）
  4. 填写服务器详情（见下文）
  5. 保存
  6. 等待连接——RikkaHub 会自动连接并同步服务器暴露的工具列表
  7. 绿色的已连接指示器确认握手成功

通用服务器选项

每个 MCP 服务器都有一组通用选项：

选项必填说明
name✅可读显示名称，出现在 MCP 列表和助手选择器中
enable默认 true不删除服务器的情况下开启或关闭
url✅MCP 端点完整 URL
headers❌随每个请求发送的自定义 HTTP 头（身份验证、API 密钥等）

headers 的典型用法

添加键值对，比如：

Header 名值用途
AuthorizationBearer <token>API 密钥 / 身份验证
X-Api-Keyxxxxxxxxxx自定义服务商 API Key
Content-Typeapplication/json某些服务器要求

SSE 传输的 URL 格式

SSE（Server-Sent Events）是最初的 MCP 传输方式。端点 URL 通常以 /sse 结尾，例如：

https://mcp.example.com/sse

客户端打开一个持久 HTTP 连接，服务器通过这个连接推送事件。

Streamable HTTP 传输的 URL 格式

MCP 规范中较新的推荐传输方式。提供服务器的基础 URL（不需要 /sse 后缀），例如：

https://mcp.example.com/mcp

Streamable HTTP 更现代、更灵活，是未来方向。如果服务器同时支持两种传输，优先选择 Streamable HTTP。

连接失败时怎么办

如果添加后状态变成"错误"：

  1. 检查 URL 是否正确（末尾多了或少了字符都不行）
  2. 检查 headers 里的认证信息
  3. 检查服务器是否真的在运行、网络可达
  4. 指数退避重试中，等一等看会不会自己连上
  5. 确认设备网络权限是否允许（Android 15+ 需要本地网络权限）

服务器 vs 助手的关系

重要：在 MCP 设置页添加服务器并不会自动让助手能调用它。你还需要：

  1. 打开某个助手 → 工具与集成标签页
  2. 在 MCP 服务器 部分切换你要启用的服务器

这个设计是有意的——让每个助手能独立选择挂载哪些 MCP 服务器。这样你可以：

助手选择器只显示 已启用 的 MCP 服务器（全局启用开关 + headers 配置好）。如果服务器被禁用了，助手的选择器里也不会出现。

服务器的 JSON 导入

如果某个 MCP 服务提供了现成的 JSON 配置，你可以直接导入，不需要手动输入。

详见「JSON 导入服务器配置」一节。