Kollektiv MCP

⚠️ 失望-集体MCP

🚨 重要提示：此实验性MCP服务器现已停用，将很快关闭。 如需更新，请访问 kollektiv.sh 请不要将此服务器用于新项目。

______________________________________________________________________

[![TypeScript]()](https://www.typescriptlang.org)     

~~🧠 您的个人法学硕士知识库~~（已停用）

\[原始描述-不再保留\] Kollektiv MCP使您能够在几秒钟内建立个人法学硕士知识库，并从您的 最喜欢的编辑/客户。无需更多的基础设施设置、分块、同步-只需上传您的 数据并开始聊天。支持所有主要的MCP客户端-Cursor、Windsurf、， 克劳德桌面等。

⚠️ 弃用通知

这个实验性的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

• args：

- -y -这使您的shell能够安装 mcp-remote 当前需要连接 到远程服务器 - mcp-remote -这使您的客户端能够连接到远程MCP服务器（在本例中 集体） - https://mcp.thekollektiv.ai/mcp -是您要连接的端点

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

光标

打开光标并转到 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桌面版

打开克劳德桌面并转到 Settings -> Developer > Edit config.打开 json 文件在任何 文本/代码编辑器，粘贴上面的配置并保存（ctrl/cmd+s）。

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

💡Claude for Desktop需要重新启动应用程序才能正确连接。如果服务器不运行 “绿色”过了一段时间，试着过一遍 故障排除 步骤如下。

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

VS Code

打开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服务器

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

• 记得添加 "chat.mcp.enabled": true, 在你的 settings.json
• 切换到 代理 模式

💡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中启用了Kollektiv MCP。

其他（PyCharm、克劳德密码）

大多数MCP客户端都遵循相同的规则 .json 格式，并应与类似的配置步骤配合使用 正如前面提到的客户：

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

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

• 特定客户端的强大开发人员希望支持MCP连接的程度
• 客户端是否支持

最新的 MCP规范 支持Oauth

如果您遇到问题，请通过以下步骤 简单 故障排除步骤 可能会有所帮助。

支持的客户

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

• 光标✅
• 帆板运动✅
• 克劳德桌面版✅
• VS Code✅
• 克莱恩✅

其他MCP客户端 _应该_ 理论上是支持的，但在实践中可能会有点支持 不同。如果你有一个你真的想联系的客户，请告诉我！

🎮 用法

可用工具

• /query_documents --向您上传到Kollektiv的文件提交问题

根据您的文档来源收到答案。

• /list_documents --返回已同步文档的列表以及基本元数据。
• 专业提示： 包含短语 集体 MCP 因此客户端知道调用这些工具。

使用技巧

• 始终添加“使用Kollektiv MCP” -这个命令会告诉客户端要使用哪个MCP服务器。
• 等待文档可用 --上传后，文件需要1-2分钟才能上传

被质疑。

• 必要时重新表述查询 --如果客户端生成的查询质量不佳，请对其进行编辑或重写

你自己。

❓ 故障排除和支持

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

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

如果您遇到连接问题，请执行以下故障排除步骤 这应该有助于您连接到MCP服务器。

支持

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

连接故障排除

如果你得到 授权请求无效 错误如下或无法连接 另一个原因是，请尝试执行以下步骤，这些步骤应该可以解决问题。

1. 确保连接到正确的端点:

- 使用 https://mcp.thekollektiv.ai/mcp 作为MCP终点。

1. 清理mcp远程缓存:

- 这有什么作用： - 删除缓存 mcp-remote 用于从连接到远程服务器的库 不支持远程连接的客户端 - 怎样： - 在终端中运行以下命令

# MacOS
rm -rf ~/.mcp-auth  

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

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

- 这有什么作用： - 删除登录时用于存储身份验证信息的浏览器Cookie 进入集体。 - 怎样： - 打开浏览器设置，删除过去几个小时的浏览数据

⚠️ 注意：这将使您退出所有活动会话，包括Kollektiv。只有在以下情况下才能这样做 您陷入了登录流程中断的困境。

1. 重新启动MCP客户端并尝试重新连接到MCP服务器：

- 这有什么作用： - MCP客户端（Cursor、Windsurf等）通常缓存来自以下位置的连接/配置设置 之前的运行可能会干扰身份验证。 - 怎样： - 重新启动编辑器/客户端 - 尝试重新连接到MCP服务器

使用MCP检查器

出于调试目的，您可以使用MCP检查器连接到Kollektiv MCP服务器。

npx @modelcontextprotocol/inspector

选择SSE或流式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实施了多种安全措施：

• 通过标准登录 OAuth 2.1“授权码”流程 由Supabase提供动力；仅

短暂的， HttpOnly, Secure Cookie被存储起来——任何密码都不会接触到这台服务器。

• 所有交通都得到了服务 通过Cloudflare的边缘仅通过HTTPS，每一个敏感

POST请求携带一次性CSRF/交易令牌。

• 后端在内部运行 Cloudflare Workers沙盒 （无本地文件系统，无长时间运行

过程），大大减少了攻击面。

有关详细的披露指南，请参阅 安全.md.

🪪 许可证

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