Kollektiv | Your private LLM knowledgebase

集体 MCP

🧠 您的个人法学硕士知识库

Kollektiv MCP 让您能够在几秒钟内构建个人 LLM 知识库，并在您常用的编辑器/客户端中使用它。无需任何基础架构设置、分块和同步——只需上传数据即可开始聊天。它开箱即用，支持所有主流 MCP 客户端 - Cursor、Windsurf、Claude Desktop 等。

🧪 Kollektiv 处于早期测试阶段。如果您在连接 MCP 客户端时遇到任何问题，请先尝试以下步骤。如果仍然无法解决，请在此处提交问题

为什么选择 Kollektiv？

• 聊天会话之间无需重新上传数据
• 从任何客户端访问- Cursor、Windsurf、Claude Desktop、VSCode、PyCharm 等。
• 无需设置基础设施- 只需上传数据即可开始聊天

💿 连接

连接到 Kollektiv MCP 最简单的方法是将以下配置复制并粘贴到编辑器的mcp.json文件中。所有客户端（Cursor、Windsurf、Claude Desktop、VSCode、PyCharm）都支持此json格式。

• 姓名：
  • kollektiv - 你可以给服务器任何描述性名称
• 命令：
  • npx - 确保在运行此命令之前已安装 node.js
• 参数：
  • -y - 这使你的 shell 能够安装mcp-remote这是当前连接到远程服务器所必需的
  • mcp-remote - 这使您的客户端能够连接到远程 MCP 服务器（在本例中为 Kollektiv）
  • https://mcp.thekollektiv.ai/mcp - 是您要连接的端点

查看下面的简短演示或阅读有关如何连接的客户端特定说明。

光标

打开 Cursor，前往Cursor Settings > MCP > Add new global MCP Server 。粘贴上述配置并保存（ctrl/cmd+s）。

如果配置成功并且您之前未进行过身份验证，则会打开一个浏览器窗口，引导您进入登录页面。

💡保存json后，Cursor 可能需要一段时间才能连接到 MCP。您可能需要重新启动 Cursor 或等待一段时间。如果您看到“客户端已关闭”或其他错误，请按照以下故障排除步骤操作。

如果连接成功，您应该会在设置页面中看到 Kollektiv MCP 变为绿色：

风帆冲浪

打开 Windsurf，前往Settings -> Windsurf Settings > MCP Servers > View raw config 。粘贴上述配置并保存（ctrl/cmd+s）。

如果配置成功并且您之前未进行过身份验证，则会打开一个浏览器窗口，引导您进入登录页面。

💡与其他客户端不同，根据我的经验，Windsurf 需要重启应用才能正常连接。如果服务器一段时间后仍未恢复正常，请尝试以下故障排除步骤。

如果连接成功，您应该会看到 Kollektiv MCP 在设置页面变为绿色：

克劳德桌面版

打开 Claude Desktop，然后转到Settings -> Developer > Edit config 。在任何文本/代码编辑器中打开json文件，粘贴上述配置并保存（ctrl/cmd+s）。

如果配置成功并且您之前未进行过身份验证，则会打开一个浏览器窗口，引导您进入登录页面。

💡Claude 桌面版需要重启应用才能正常连接。如果服务器一段时间后仍未恢复正常，请尝试以下故障排除步骤。

如果连接成功，您应该会看到 Kollektiv MCP 在设置页面变为绿色：

VS 代码

打开 VS Code 并转到Settings -> MCP: Add server > Command (stdio) ：

• 命令：
  • npx -y mcp-remote https://mcp.thekollektiv.ai/mcp
• 姓名：
  • 给你的服务器起一个描述性的名字，比如kollektiv

您的配置settings.json应该类似于此：

后续步骤：

• 点击**“开始”**连接到 MCP 服务器
  • 如果您未通过身份验证 - 您将被带到身份验证页面
• 请记住在您的settings.json中添加"chat.mcp.enabled": true,
• 切换到代理模式

💡VS Code 要求您手动启动服务器，添加chat.mcp.enabled并切换到代理模式才能使用 MCP。如果您在代理模式下没有看到 MCP 工具，请尝试以下故障排除步骤。

如果连接成功，您应该会看到 Kollektiv MCP 公开的工具。

克莱恩

打开 Cline，点击MCP Servers > Edit Configuration ，然后将以下配置添加到您的cline_mcp_settings.json ：

注意：Cline 尚不支持与支持授权的远程服务器的直接连接。

如果连接成功，您将进入身份验证流程。登录后，您将看到 Cline 中已启用 Kollektiv MCP。

其他（PyCharm、Claude Code）

大多数 MCP 客户端遵循相同的.json格式，并且应采用与前面提到的客户端类似的配置步骤：

1. 将配置复制并粘贴到客户端的json配置中
2. 重启应用程序
3. 如果尚未验证，请进行验证
4. Kollektiv MCP 应该变为绿色，并在聊天/代理模式下可用

连接成功取决于许多因素，包括但不限于：

• 特定客户端的强大开发人员希望支持 MCP 连接的情况
• 客户端是否支持最新的MCP 规范和 Oauth 支持

如果您遇到问题，执行这些简单的故障排除步骤可能会有所帮助。

支持的客户端

我已经验证了与以下 MCP 客户端的连接正常：

• 光标✅
• 风帆冲浪✅
• 克劳德桌面✅
• VS 代码✅
• 克莱恩✅

理论上其他 MCP 客户端应该会受支持，但实际操作起来可能会有所不同。如果您有非常想连接的客户端，请告诉我！

🎮 使用方法

可用工具

• /query_documents — 向您上传到 Kollektiv 的文档提交问题，并根据文档来源获得答案。
• /list_documents — 返回同步文档列表以及基本元数据。
• **专业提示：包含短语“使用 Kollektiv MCP”，**以便客户知道调用这些工具。

使用技巧

• 始终添加“使用 Kollektiv MCP” ——这会告诉客户端使用哪个 MCP 服务器。
• 等待文档可用— 上传后，需要 1-2 分钟才能查询文档。
• 在需要时重新措辞查询- 如果客户端生成了错误的查询，请自行编辑或重写。

❓ 故障排除和支持

此 MCP 服务器使用 Cloudflare Agents SDK 以及其他库，为用户提供最现代化的连接和使用 MCP 服务器的方式。另一方面，MCP 客户端尚未实现对以下两个关键部分的支持：

• 远程 MCP 服务器
• MCP 服务器授权

如果您遇到连接问题，请按照以下故障排除步骤操作，这将有助于您连接到 MCP 服务器。

支持

如果您需要其他支持，请打开 GitHub 问题或联系support@thekollektiv.ai

连接故障排除

如果您收到如下所示的无效授权请求错误或由于其他原因无法连接，请尝试执行以下步骤以解决问题。

1. 确保您连接到正确的端点：
   • 使用https://mcp.thekollektiv.ai/mcp作为 MCP 端点。
2. 清理 mcp-remote 缓存：
   • 其作用：
     • 删除用于从不支持远程连接的客户端连接到远程服务器的mcp-remote库的缓存
   • 如何：
     • 在终端中运行以下命令

3. 清除浏览器数据和 Cookie ：
   • 其作用：
     • 删除登录 Kollektiv 时用于存储身份验证信息的浏览器 cookie。
   • 如何：
     • 打开浏览器设置并删除过去几个小时的浏览数据

⚠️ 注意：此操作将退出所有活动会话，包括 Kollektiv。仅当您遇到登录流程中断的情况时才执行此操作。

4. 重新启动 MCP 客户端并尝试重新连接到 MCP 服务器：
   • 其作用：
     • MCP 客户端（Cursor、Windsurf 等）通常会缓存以前运行的连接/配置设置，这可能会干扰身份验证。
   • 如何：
     • 重新启动编辑器/客户端
     • 尝试重新连接到 MCP 服务器

使用 MCP 检查器

为了调试目的，您可以使用 MCP Inspector 连接到 Kollektiv MCP 服务器。

选择 SSE 或 Streamable HTTP 传输

• SSE：连接到服务器https://mcp.thekollektiv.ai/sse
• 可流式传输的 HTTP：连接到https://mcp.thekollektiv.ai/mcp上的服务器

🛠️ 实施细节（针对🤓）

如果您只是为了 Kollektiv 而来，请跳过此部分。本节面向对其工作原理感兴趣的开发者和构建者。

Kollektiv MCP 是模块化系统的一部分，使用户能够在几秒钟内在其数据上设置 RAG——而无需管理基础设施、管道或模型配置。

它由三个独立部署的服务组成：

• MCP 服务器 (Cloudflare Worker)
  https://mcp.thekollektiv.ai
  充当客户端通过模型上下文协议与索引数据交互的安全网关。支持 OAuth。
• 前端（React + Vite Worker）
  https://thekollektiv.ai
  一个简洁、简约的用户界面，用于上传和管理其内容。
• 后端（FastAPI）
  https://api.thekollektiv.ai
  处理 RAG 管道的源提取、验证和编排。

🔐 安全

Kollektiv MCP 实施了多项安全措施：

• 登录通过由 Supabase 提供支持的标准OAuth 2.1“授权码”流程进行；仅存储短暂的、 HttpOnly的Secure cookie——无需任何密码即可接触此服务器。
• 所有流量均通过 Cloudflare 的边缘通过 HTTPS 专门提供服务，并且每个敏感的 POST 请求都携带一次性 CSRF/交易令牌。
• 后端在Cloudflare Workers 沙箱内运行（没有本地文件系统，没有长时间运行的进程），大大减少了攻击面。有关详细的披露指南，请参阅SECURITY.md 。

🪪 许可证

根据 Apache License 2.0 发布 - 商业支持或替代许可： azuev@outlook.com