Qdrant·qdrant
Qdrant MCP — подключение и инструкция
Qdrant MCP предоставляет агенту сохранение и поиск информации в векторной коллекции Qdrant для сценариев памяти и RAG.
Что умеет этот сервер
Qdrant MCP предоставляет агенту сохранение и поиск информации в векторной коллекции Qdrant для сценариев памяти и RAG.
Сервер работает с выбранной collection и embedding-моделью.
Сохрани несколько тестовых фрагментов с понятными метаданными и найди их перефразированным вопросом.
Задача для знакомства
Через Qdrant MCP найди тестовый фрагмент в выбранной коллекции и покажи его метаданные. Другие коллекции и данные не меняй.
Уточнить результат
Сверь collection, embedding-модель и metadata результата. Похожесть векторов не подтверждает правильность ответа; проверь исходный текст найденного фрагмента.
Как подключить
Выберите подходящий способПодключить Qdrant MCP
Добавь uvx mcp-server-qdrant. В env задай QDRANT_URL, COLLECTION_NAME и выбранный EMBEDDING_MODEL по README. Проверь требуемую авторизацию и transport; не используй адрес localhost другого контейнера как адрес хоста без настройки сети.
Что понадобится
- uv/uvx, доступный Qdrant и нужная collection. Для защищённого экземпляра используй API key; модель embeddings требует совместимого окружения.
- 01
Подготовь окружение
uv/uvx, доступный Qdrant и нужная collection. Для защищённого экземпляра используй API key; модель embeddings требует совместимого окружения.
- 02
Установи и настрой
Добавь uvx mcp-server-qdrant. В env задай QDRANT_URL, COLLECTION_NAME и выбранный EMBEDDING_MODEL по README. Проверь требуемую авторизацию и transport; не используй адрес localhost другого контейнера как адрес хоста без настройки сети.
- 03
Открой новую сессию
Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.
Первый запрос — пример для чата агента
Через Qdrant MCP найди тестовый фрагмент в выбранной коллекции и покажи его метаданные. Другие коллекции и данные не меняй.Как проверить
Сверь collection, embedding-модель и metadata результата. Похожесть векторов не подтверждает правильность ответа; проверь исходный текст найденного фрагмента.
Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.
README и установка автораЧто умеет Qdrant
Qdrant MCP предоставляет агенту сохранение и поиск информации в векторной коллекции Qdrant для сценариев памяти и RAG.
Сервер работает с выбранной collection и embedding-моделью. Коллекция и параметры embeddings должны соответствовать друг другу; это не автоматическое подключение всех документов компьютера.
Что подготовить перед подключением
uv/uvx, доступный Qdrant и нужная collection. Для защищённого экземпляра используй API key; модель embeddings требует совместимого окружения.
Как установить и подключить
Добавь uvx mcp-server-qdrant. В env задай QDRANT_URL, COLLECTION_NAME и выбранный EMBEDDING_MODEL по README. Проверь требуемую авторизацию и transport; не используй адрес localhost другого контейнера как адрес хоста без настройки сети.
Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.
Как пользоваться: первый сценарий
Сохрани несколько тестовых фрагментов с понятными метаданными и найди их перефразированным вопросом. Затем проверь, откуда взят каждый результат, прежде чем подключать реальную базу знаний.
Как проверить результат и решить проблемы
Сверь collection, embedding-модель и metadata результата. Похожесть векторов не подтверждает правильность ответа; проверь исходный текст найденного фрагмента.
Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.
Ограничения
Смена embedding-модели может потребовать переиндексации. Доступ к Qdrant не заменяет сбор и очистку документов, а retrieval не гарантирует полноту RAG-ответа.
Исходники и документация
Репозиторий: qdrant/mcp-server-qdrant. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.
Другие подключения — в каталоге MCP-серверов Нейролюба.