Qdrant·qdrant

Qdrant MCP — подключение и инструкция

Qdrant MCP предоставляет агенту сохранение и поиск информации в векторной коллекции Qdrant для сценариев памяти и RAG.

ПамятьЛокальноAPI-ключ

Что умеет этот сервер

01

Qdrant MCP предоставляет агенту сохранение и поиск информации в векторной коллекции Qdrant для сценариев памяти и RAG.

02

Сервер работает с выбранной collection и embedding-моделью.

03

Сохрани несколько тестовых фрагментов с понятными метаданными и найди их перефразированным вопросом.

Задача для знакомства

Через 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 требует совместимого окружения.
  1. 01

    Подготовь окружение

    uv/uvx, доступный Qdrant и нужная collection. Для защищённого экземпляра используй API key; модель embeddings требует совместимого окружения.

  2. 02

    Установи и настрой

    Добавь uvx mcp-server-qdrant. В env задай QDRANT_URL, COLLECTION_NAME и выбранный EMBEDDING_MODEL по README. Проверь требуемую авторизацию и transport; не используй адрес localhost другого контейнера как адрес хоста без настройки сети.

  3. 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-серверов Нейролюба.

Вопросы о Qdrant

Qdrant MCP предоставляет агенту сохранение и поиск информации в векторной коллекции Qdrant для сценариев памяти и RAG.
Вернуться в библиотеку