Qdrant MCP Server 是什么？
Qdrant MCP Server 是连接 Qdrant 向量数据库的语义检索工具。Codex 可以把允许保存的文本写入指定集合，并按含义召回相关片段和来源元数据。
一句话理解把文档或代码片段写入 Qdrant 并进行语义检索，适合受控知识库与代码搜索。
为什么需要它？
让助手从指定向量集合检索相关片段，而不是把整个知识库一次性塞入上下文。
接入前，AI 只能依赖你粘贴的材料、截图或旧上下文；接入后，它可以在你授权的范围内调用真实工具，并把结果、来源和状态带回当前任务。
核心能力
向指定集合写入带元数据的条目
把真实信息带回当前任务，减少反复复制和手动核对。
执行语义相似度检索
在明确授权范围内调用工具，并保留执行过程和结果。
连接本地或 Qdrant Cloud 实例
回读来源、状态与限制，方便继续处理和人工验收。
适合谁？怎么用？
- 在指定向量集合中检索知识片段
- 已经使用 Qdrant，希望为项目资料或代码建立可限定集合的语义检索。
- 集合、召回数量和来源字段可回读，测试数据可以删除并确认生命周期。
- 不适合把客户隐私或未授权文档批量写入长期知识库。
- 向量库可能长期保存内部文本与代码
- 检索结果可能跨用户或项目泄露
怎么接入？
- 1准备
创建测试集合并准备受限 Qdrant 凭证。
- 2授权
运行
uvx mcp-server-qdrant，通过环境变量提供 QDRANT_URL 和 API Key。 - 3连接
在客户端登记 stdio 服务并固定 COLLECTION_NAME。
- 4开始使用
写入一条测试内容后执行语义查询。
安装命令
添加 Qdrant MCP Server
codex mcp add qdrant -- uvx mcp-server-qdrant运行前按官方 README 通过环境变量配置测试集合、Qdrant 地址和受限 API Key。
检查命令
确认 MCP 已经登记
codex mcp list不想自己操作终端时，把下面整段发给 Codex。它会先核对官方说明和前置条件，遇到凭证或占位符会停下来询问。
发给 Codex
自助接入 Qdrant MCP Server
请帮我在当前电脑上接入并验证 Qdrant MCP Server。
官方来源：https://github.com/qdrant/mcp-server-qdrant
目标接入命令：codex mcp add qdrant -- uvx mcp-server-qdrant
请按以下步骤执行：
1. 先阅读官方 README，核对当前推荐接入方式与上述命令。如果官方说明已经变化，先告诉我差异，不要盲目执行旧命令。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证，也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符，先列出需要我提供的值并停下来，不要自行猜测。
4. 条件满足后执行接入命令，再运行 codex mcp list，确认 Qdrant MCP Server 已登记，并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接：请用 Qdrant MCP 在 docs-test 集合中检索 5 个与登录排错相关的片段，并返回每条的来源元数据。
6. 不要创建、修改、删除、发送内容，也不要连接生产环境；需要写权限或更高权限时先征求我确认。- 复制完整指令，发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境；遇到 Token、项目 ID、路径或其他占位符时，应停下来向你确认。
- 接入后运行
codex mcp list，再用 Qdrant MCP Server 的只读首测任务回读结果。
第一次调用示例
登记完成后，新开一个任务，先用下面这句做只读验证，把目标、范围和停止条件一次说清楚。
发给 Codex
第一次只读任务
请用 Qdrant MCP 在 docs-test 集合中检索 5 个与登录排错相关的片段，并返回每条的来源元数据。怎样算成功
集合、召回数量和来源字段可回读，测试数据可以删除并确认生命周期。
- 先定义集合用途和元数据字段。
- 只写入允许长期保存的内容。
- 用已知问题测试召回并检查来源元数据。
- 删除测试条目，确认数据生命周期可控。
权限与安全
凭证与连接方式
本地 stdio 或 HTTP；固定集合、地址和受限 API Key，先用测试数据。
- 向量库可能长期保存内部文本与代码
- 检索结果可能跨用户或项目泄露
- 需要集合隔离、最小 Key、删除机制和嵌入数据审查
