Qdrant MCP — Сценарии использования, Установка & Живое демо

Name: Qdrant MCP Server
Author: qdrant

Зачем использовать

Ключевые функции

Two-tool minimal surface — store text, find text; no schema gymnastics
Embedding model runs locally via fastembed by default (no extra API key)
Works with Qdrant Cloud or any self-hosted instance via QDRANT_URL
Metadata stored alongside each entry for filterable recall
Ideal building block for agent memory and lightweight RAG

Живое демо

Как выглядит на практике

qdrant.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "qdrant": {
      "command": "uvx",
      "args": [
        "mcp-server-qdrant"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "qdrant": {
      "command": "uvx",
      "args": [
        "mcp-server-qdrant"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "qdrant": {
      "command": "uvx",
      "args": [
        "mcp-server-qdrant"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "qdrant": {
      "command": "uvx",
      "args": [
        "mcp-server-qdrant"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "qdrant",
      "command": "uvx",
      "args": [
        "mcp-server-qdrant"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "qdrant": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-server-qdrant"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add qdrant -- uvx mcp-server-qdrant

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Qdrant

Give a Claude agent persistent memory across sessions

👤 Builders making personal assistants or internal copilots ⏱ ~15 min beginner

Когда использовать: You want Claude to remember user preferences, past decisions, or ongoing projects even after the chat ends.

Предварительные требования

Running Qdrant (local Docker or cloud) — docker run -p 6333:6333 qdrant/qdrant OR a Qdrant Cloud cluster URL + API key
COLLECTION_NAME env var set — Any string, e.g. claude_memory

Поток

Teach it to store important facts

Whenever I tell you something important about a project (deadlines, stakeholders, decisions), store it with qdrant-store, metadata {project, category}.✓ Скопировано

→ Claude starts echoing 'stored' for durable facts
Verify recall works

What do you remember about project 'atlas'? Use qdrant-find with a query like 'project atlas decisions'.✓ Скопировано

→ Relevant prior messages returned with scores
Curate and forget

Search for anything about project 'atlas' that's more than 90 days old or marked obsolete, and delete those entries.✓ Скопировано

→ List of pruned items with confirmation

Итог: An assistant that actually remembers what you told it last week — scoped per-project, prunable.

Подводные камни

Storing every message bloats the collection and degrades recall quality — Only store explicit facts/decisions, not chit-chat. Make the 'store or not' decision part of the system prompt.
Collection created with wrong vector size after switching embedding models — Qdrant rejects mismatched vectors — drop and recreate the collection when you change EMBEDDING_MODEL

Сочетать с: filesystem · notion

Build a lightweight RAG over a docs folder

👤 Devs who want RAG without a framework ⏱ ~30 min intermediate

Когда использовать: You have 50–5000 Markdown files and want Claude to answer questions against them, with citations.

Предварительные требования

Docs on disk as Markdown — Any folder of .md files

Поток

Chunk and store the docs

Read every .md under /docs. Split into ~500-token chunks on heading boundaries. For each chunk, call qdrant-store with the text and metadata {source_path, heading}.✓ Скопировано

→ N chunks stored, one per section
Query with a user question

User asks: 'How do I rotate API keys?' Use qdrant-find to pull the top 5 most relevant chunks. Cite source_path in your answer.✓ Скопировано

→ Answer with inline [source_path] citations
Measure retrieval quality

For these 10 eval questions [list], which of the expected source paths appear in the top-5 retrieval? Report recall@5.✓ Скопировано

→ A retrieval-quality score you can improve iteratively

Итог: A working RAG loop you can tune chunk size and k until quality is acceptable.

Подводные камни

Too-large chunks dilute the embedding and kill recall — Keep chunks under ~1000 tokens; split by headings first, then by token count as a fallback
Updating a doc doesn't remove old chunks — answers become stale — Use a deterministic point id (hash of source_path+heading) so upserts replace rather than duplicate

Сочетать с: filesystem · firecrawl

Deduplicate a messy list of tickets, leads, or FAQs semantically

👤 Ops teams with a CSV of near-duplicates ⏱ ~25 min intermediate

Когда использовать: Exact-match dedup misses things like 'reset password' vs 'how do I change my password' — you need semantic similarity.

Поток

Store each item with its row id as metadata

Read rows.csv. For each row, qdrant-store with information=<text> and metadata={row_id: <id>}.✓ Скопировано

→ N points stored
Cluster by similarity

For each row, query qdrant-find for its top-5 neighbors with score > 0.85. Output groups of row_ids that are mutually near.✓ Скопировано

→ Duplicate groups printed
Pick canonical + mark rest as duplicates

For each group, pick the longest/most-informative row as canonical. Output a CSV {row_id, canonical_id}.✓ Скопировано

→ Dedup map ready for the source system

Итог: A dedup mapping CSV with confidence scores, reviewable by a human before applying.

Подводные камни

Similarity threshold is domain-specific — 0.85 may be too lenient or too strict — Hand-label 20 pairs first, then pick the threshold that best separates dup from non-dup

Сочетать с: postgres · filesystem

Searchable meeting-notes memory

👤 Managers / ICs drowning in Notion/Obsidian notes ⏱ ~20 min beginner

Когда использовать: You take weekly notes but can never find the one where a specific decision was made.

Предварительные требования

Folder of meeting notes — Any text or markdown files

Поток

Index existing notes

Walk /meetings/**/*.md. For each, qdrant-store the body with metadata {date, attendees, project}.✓ Скопировано

→ All notes indexed with dates
Recall decisions

Find every note where we discussed 'pricing for enterprise tier'. Show me the date and a 2-line summary of each.✓ Скопировано

→ Ranked list of matching meetings
Keep it fresh

Add today's note <paste>, then tell me which past notes most likely contradict or update decisions in today's.✓ Скопировано

→ Contradiction check via semantic neighbors

Итог: A semantic index over your notes you can keep updating weekly.

Подводные камни

Mixing personal + work notes in one collection leaks scope — Use separate collections or enforce a scope metadata filter on every find

Сочетать с: filesystem · notion

Комбинации

Сочетайте с другими MCP — эффект x10

qdrant + filesystem

Index a local docs folder then answer questions with citations

Index every .md under /docs into Qdrant, then answer: 'how does our auth flow work?' with citations to the original file paths.✓ Скопировано

qdrant + firecrawl

Crawl a site and build a searchable knowledge base

Crawl docs.mycompany.com with Firecrawl, store each page in Qdrant collection company_docs.✓ Скопировано

qdrant + postgres

Semantic search over unstructured columns in a relational DB

SELECT id, body FROM support_tickets created in the last 30 days, embed each body into Qdrant with metadata {ticket_id}, then let me search them by meaning.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
qdrant-store	information: str, metadata?: object	Persist a fact, chunk, or note for later semantic recall	free (local embedding)
qdrant-find	query: str, limit?: int	Retrieve semantically similar entries to answer a question or deduplicate	free

Стоимость и лимиты

Во что обходится

Квота API: Self-hosted: unlimited. Qdrant Cloud: depends on cluster size.
Токенов на вызов: Store: ~100 tokens overhead per call. Find: ~200 tokens + result payload.
Деньги: Free if self-hosted. Qdrant Cloud free tier: 1GB cluster. Paid from ~$25/mo.
Совет: Start with local Docker for dev; upgrade to Cloud only when you need persistence and multi-device access.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: QDRANT_URL and optional QDRANT_API_KEY in env vars

Исходящий трафик: If self-hosted: none. If Qdrant Cloud: all vectors and metadata sent to your cluster region.

Embeddings can be reversed enough to recover approximate text — treat the collection as sensitive as the source data.
Set COLLECTION_NAME per tenant if hosting a multi-user agent.

Устранение неполадок

Частые ошибки и исправления

Collection does not exist / Not found

The server creates the collection on first store only if COLLECTION_NAME is set. Verify the env var and restart the MCP.

Проверить: curl $QDRANT_URL/collections

Vector dimension mismatch

You changed EMBEDDING_MODEL without dropping the old collection. Drop it and start fresh (or use a new COLLECTION_NAME).

Проверить: curl $QDRANT_URL/collections/<name>

Connection refused on localhost:6333

Qdrant container isn't running. docker run -p 6333:6333 qdrant/qdrant and retry.

Проверить: curl localhost:6333/healthz

Searches return irrelevant results

Chunks may be too big or the embedding model too weak. Try FastEmbed's bge-small-en-v1.5 and chunks ≤500 tokens.

Альтернативы

Qdrant в сравнении

Альтернатива	Когда использовать	Компромисс
Chroma MCP	You prefer an embedded vector DB with zero infra	Less production-grade than Qdrant for heavy loads
Pinecone MCP	You're already on Pinecone and want hosted-only	Paid from day one; more opinionated
Memory MCP	You want ultra-simple key-value memory, not semantic	No embeddings — exact recall only

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills