科勒克蒂夫

集体 MCP

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

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

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

💿 连接

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

{
  "mcpServers": {
    "kollektiv": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.thekollektiv.ai/mcp"
      ]
    }
  }
}

姓名：
- 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应该类似于此：

{
  "chat.mcp.discovery.enabled": true,
  "chat.mcp.enabled": true,
  "mcp": {
    "servers": {
      "kollektiv": {
        "type": "stdio",
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://mcp.thekollektiv.ai/mcp"
        ]
      }
    }
  }
}

后续步骤：

点击**“开始”**连接到 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 ：

{
  "mcpServers": {
    "kollektiv": {
      "timeout": 60,
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.thekollektiv.ai/mcp"
      ],
      "transportType": "stdio",
      "disabled": false
    }
  }
}

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

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

其他（PyCharm、Claude Code）

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

将配置复制并粘贴到客户端的json配置中
重启应用程序
如果尚未验证，请进行验证
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

连接故障排除

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

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

# MacOS
rm -rf ~/.mcp-auth  

# Windows
Remove-Item -Recurse -Force "$env:USERPROFILE\.mcp-auth"

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

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

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

使用 MCP 检查器

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

npx @modelcontextprotocol/inspector

选择 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

Kollektiv | Your private LLM knowledgebase

Integrations

集体 MCP

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

💿 连接

光标

风帆冲浪

克劳德桌面版

VS 代码

克莱恩

其他（PyCharm、Claude Code）

支持的客户端

🎮 使用方法

可用工具

使用技巧

❓ 故障排除和支持

支持

连接故障排除

使用 MCP 检查器

🛠️ 实施细节（针对🤓）

🔐 安全

🪪 许可证

Related MCP Servers

mcp-server-rag-web-browserofficial

kjlahsdjkashdjhkasdkajshd

guxi

Jotdown

New MCP Servers