rikkahub 中文文档 下载 App

JSON 导入 MCP 服务器配置 · 现成配置一键导入

什么时候用 JSON 导入

如果某个 MCP 服务提供了现成的 JSON 配置文件（官方网站文档、GitHub README、社区分享），直接导入比手动逐项填写高效得多。这在：

这三种场景下特别有用。

导入步骤

  1. 打开 设置 → MCP
  2. 点击右上角 + 按钮
  3. 选择 导入（或类似的图标，取决于版本）
  4. 粘贴 JSON 内容或选择 JSON 文件
  5. RikkaHub 会验证配置、合并到现有列表
  6. 点击保存完成导入

JSON 格式要求

配置应该是一个 JSON 对象，按 RikkaHub 的配置模式描述服务器。最简单服务器 SSE 示例：

{
  "type": "sse",
  "commonOptions": {
    "name": "My MCP Server",
    "enable": true,
    "headers": [
      ["Authorization", "Bearer my-secret-token"]
    ]
  },
  "url": "https://mcp.example.com/sse"
}

最简单服务器 Streamable HTTP 示例：

{
  "type": "streamableHttp",
  "commonOptions": {
    "name": "My MCP Server",
    "enable": true,
    "headers": [
      ["Authorization", "Bearer my-secret-token"]
    ]
  },
  "url": "https://mcp.example.com/mcp"
}

各字段说明

字段必填说明
type✅"sse" 或 "streamableHttp"
commonOptions.name✅服务器显示名称
commonOptions.enable✅是否全局启用
commonOptions.headers❌键值对数组，每对是 [name, value]
url✅端点 URL（SSE 通常以 /sse 结尾）

多服务器 JSON

理论上可以一次导入多个服务器。JSON 结构需要是一个数组或包含多个服务器配置的对象——取决于你获取的具体格式。

导入时 RikkaHub 会合并到现有列表。如果有同名服务器，通常会提示覆盖或跳过。

导入后的验证

导入完成后：

  1. 回到 MCP 列表
  2. 检查新服务器的连接状态是否为"已连接"
  3. 点击进入服务器详情，确认工具列表正常显示
  4. 到某个助手上挂载这个服务器
  5. 在对话里让 AI 调用一个工具测试一下

如果连接失败：

关于 JSON 来源的提醒