⚠️ 失望-集体MCP
> 🚨 重要提示:此实验性MCP服务器现已停用,将很快关闭。
>
> 如需更新,请访问 kollektiv.sh
>
> 请不要将此服务器用于新项目。
~~🧠 您的个人法学硕士知识库~~(已停用)
[原始描述-不再保留] Kollektiv MCP使您能够在几秒钟内建立个人法学硕士知识库,并从您的
最喜欢的编辑/客户。无需更多的基础设施设置、分块、同步-只需上传您的
数据并开始聊天。支持所有主要的MCP客户端-Cursor、Windsurf、,
克劳德桌面等。
⚠️ 弃用通知
这个实验性的MCP服务器是 已弃用 并将 很快关闭。服务端点可能随时停止工作,恕不另行通知。
请勿将其用于新项目或生产用途。
💿 连接(已停用-可能无法工作)
连接到Kollektiv MCP的最简单方法是复制并粘贴以下内容
配置到编辑器中 mcp.json 文件。所有客户端(Cursor、Windsurf、Claude Desktop、,
VSCode、PyCharm)支持此功能 json 格式```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` 应该看起来像这样:```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:```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` 配置
1. 重新启动应用程序
1. 如果尚未进行身份验证,请进行身份验证
1. 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` 用于从连接到远程服务器的库
不支持远程连接的客户端
- 怎样:
- 在终端中运行以下命令```bash
# MacOS
rm -rf ~/.mcp-auth
# Windows
Remove-Item -Recurse -Force "$env:USERPROFILE\.mcp-auth"
- 清除浏览器数据和Cookie:
- 这有什么作用:
- 删除登录时用于存储身份验证信息的浏览器Cookie
进入集体。
- 怎样:
- 打开浏览器设置,删除过去几个小时的浏览数据
> ⚠️ 注意:这将使您退出所有活动会话,包括Kollektiv。只有在以下情况下才能这样做
> 您陷入了登录流程中断的困境。
- 重新启动MCP客户端并尝试重新连接到MCP服务器:
- 这有什么作用:
- MCP客户端(Cursor、Windsurf等)通常缓存来自以下位置的连接/配置设置
之前的运行可能会干扰身份验证。
- 怎样:
- 重新启动编辑器/客户端
- 尝试重新连接到MCP服务器
使用MCP检查器
出于调试目的,您可以使用MCP检查器连接到Kollektiv MCP服务器。bash
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,SecureCookie被存储起来——任何密码都不会接触到这台服务器。 -
所有交通都得到了服务 通过Cloudflare的边缘仅通过HTTPS,每一个敏感
POST请求携带一次性CSRF/交易令牌。 -
后端在内部运行 Cloudflare Workers沙盒 (无本地文件系统,无长时间运行
过程),大大减少了攻击面。
有关详细的披露指南,请参阅 安全.md.
🪪 许可证
根据Apache License 2.0发布——商业支持或替代许可:
azuev@outlook.com
