Skip to main content
Glama
deenesjakoruzh
alexander-zuev

Kollektiv | Your private LLM knowledgebase

by alexander-zuev
OverviewSchemaRelated ServersScoreDiscussions
TypeScript

集体 MCP

TypeScript 运行时 授权 Supabase 建造 代码验证 执照

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

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

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

Related MCP server: Claude-LMStudio Bridge

为什么选择 Kollektiv？

  • 聊天会话之间无需重新上传数据

  • 从任何客户端访问- Cursor、Windsurf、Claude Desktop、VSCode、PyCharm 等。

  • 无需设置基础设施- 只需上传数据即可开始聊天

💿 连接

连接到 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 MCP 配置

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

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

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

Windsurf 配置成功

克劳德桌面版

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

Claude桌面配置

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

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

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

成功的 Claude 桌面

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" ] } } } }

VS Code 配置

后续步骤：

  • 点击**“开始”**连接到 MCP 服务器

    • 如果您未通过身份验证 - 您将被带到身份验证页面

  • 请记住在您的settings.json中添加"chat.mcp.enabled": true,

  • 切换到代理模式

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

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

VS Code 连接成功

克莱恩

打开 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格式，并且应采用与前面提到的客户端类似的配置步骤：

  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库的缓存

    • 如何：

      • 在终端中运行以下命令

# MacOS rm -rf ~/.mcp-auth # Windows Remove-Item -Recurse -Force "$env:USERPROFILE\.mcp-auth"

  1. 清除浏览器数据和 Cookie ：

    • 其作用：

      • 删除登录 Kollektiv 时用于存储身份验证信息的浏览器 cookie。

    • 如何：

      • 打开浏览器设置并删除过去几个小时的浏览数据

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

  1. 重新启动 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——而无需管理基础设施、管道或模型配置。

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

🔐 安全

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

  • 登录通过由 Supabase 提供支持的标准OAuth 2.1“授权码”流程进行；仅存储短暂的、 HttpOnly的Secure cookie——无需任何密码即可接触此服务器。

  • 所有流量均通过 Cloudflare 的边缘通过 HTTPS 专门提供服务，并且每个敏感的 POST 请求都携带一次性 CSRF/交易令牌。

  • 后端在Cloudflare Workers 沙箱内运行（没有本地文件系统，没有长时间运行的进程），大大减少了攻击面。

    有关详细的披露指南，请参阅SECURITY.md 。

🪪 许可证

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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/alexander-zuev/kollektiv-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server