Ragora

Ragora MCP 服务

通过 Model Context Protocol，在任何 AI 助手中搜索你的知识库。

Ragora 的 MCP 服务是一项托管云服务，无需本地安装。只需使用服务 URL 和 API 密钥配置你的 AI 工具即可。

服务 URL： https://mcp.ragora.app/mcp

快速开始

1. 获取 API 密钥

在 ragora.app 注册，并在 设置 > API 密钥 中创建 API 密钥。

2. 连接你的 AI 工具

Claude Desktop

选项 1：命令行（推荐）

claude mcp add --transport http ragora https://mcp.ragora.app/mcp \
  --header "Authorization: Bearer sk_live_your_key_here"

选项 2：配置文件

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（Mac）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "ragora": {
      "type": "http",
      "url": "https://mcp.ragora.app/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add --transport http ragora https://mcp.ragora.app/mcp \
  --header "Authorization: Bearer sk_live_your_key_here"

Cursor

将以下内容添加到项目根目录下的 .cursor/mcp.json：

{
  "mcpServers": {
    "ragora": {
      "type": "http",
      "url": "https://mcp.ragora.app/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

VS Code / GitHub Copilot

将以下内容添加到项目根目录下的 .vscode/mcp.json：

{
  "mcpServers": {
    "ragora": {
      "type": "http",
      "url": "https://mcp.ragora.app/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

Windsurf

将以下内容添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "ragora": {
      "serverUrl": "https://mcp.ragora.app/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

任何 MCP 客户端

Ragora 使用 Streamable HTTP 传输方式。将任何兼容 MCP 的客户端指向：

• URL： https://mcp.ragora.app/mcp
• 方法： POST
• 标头： Authorization: Bearer sk_live_your_key_here

可用工具

工具	描述
discover_collections	列出你有权访问的所有知识库，并提供描述、统计信息和用法示例
search	一次性搜索你的所有知识库
search_collection	按名称搜索指定集合，可选使用标签/元数据筛选

工具参数

search(query, top_k?)

• query（必填）：自然语言搜索查询
• top_k（可选）：返回结果数量（默认值：5）

search_collection(collection_name, query, top_k?, custom_tags?, filters?)

• collection_name（必填）：集合名称或 slug（使用 discover_collections 查找名称）
• query（必填）：自然语言搜索查询
• top_k（可选）：结果数量（默认值：5）
• custom_tags（可选）：用于限定检索范围的标签
• filters（可选）：元数据筛选条件

动态集合工具

对于你有权访问的每个集合，系统都会使用该集合的 slug 生成专用工具：

• search_{slug} — 语义搜索，可选指定版本、标签和筛选条件
• get_topic_{slug} — 获取特定主题的信息
• list_versions_{slug} — 列出可用的文档版本

例如，名为 "Employee Handbook" 的集合会生成：

• search_employee_handbook
• get_topic_employee_handbook
• list_versions_employee_handbook

在 Ragora 控制面板的 集合 > MCP 设置 中配置工具名称和描述。

使用示例

搜索所有集合：

“搜索我的文档，查找 webhook 事件处理相关内容”

搜索指定集合：

“查找员工手册中的退款政策”

了解可用内容：

“我有哪些工作区，里面都有什么？”

工作原理

Your AI Tool                        Ragora Cloud
┌──────────────────┐               ┌──────────────────┐
│ Claude / Cursor  │   HTTP POST   │  MCP Server      │
│ / VS Code / etc  │──────────────>│  (Streamable HTTP)│
└──────────────────┘    /mcp       └────────┬─────────┘
                                            │
                                   ┌────────▼─────────┐
                                   │  Gateway API      │
                                   │  (Auth + Search)  │
                                   └────────┬─────────┘
                                       ┌────┴────┐
                                       ▼         ▼
                                   Postgres    Qdrant
                                   (metadata)  (vectors)

• 无需本地安装 — 通过 HTTP 直接连接
• 多租户 — API 密钥决定你可以访问哪些集合
• 动态工具 — 根据你有权访问的集合生成工具
• 混合搜索 — 密集检索（E5-Large）+ 稀疏检索（BM25），并结合倒数排名融合

安全

• 所有请求都通过 Authorization: Bearer 标头使用 API 密钥进行身份验证
• 每个 API 密钥仅限访问用户拥有和购买的集合
• 无法跨租户访问数据 — 所有查询都会按可访问的集合 ID 进行筛选
• 切勿将 API 密钥提交到版本控制系统

故障排除

问题	解决方案
“找不到工具”	更改配置后，重启 AI 应用。确认 API 密钥以 sk_live_ 开头
“未授权”	检查 Authorization: Bearer 标头格式。确认密钥尚未过期
没有结果	确保文档已上传且处理完毕。尝试使用更宽泛的查询
连接超时	检查互联网连接。前往 https://mcp.ragora.app/health 确认服务状态

链接

• Ragora — 注册并管理你的知识库
• MCP 集成指南 — 完整文档
• API 密钥 — 创建 API 密钥
• Model Context Protocol — MCP 规范

许可证

MIT