Qdrant MCP einrichten: Collection, Suche und Read-only

Wählen Sie eine vorhandene Test-Collection mit einem unkritischen Referenztext. Halten Sie dessen Kennung und erwarteten Inhalt außerhalb des Suchwerkzeugs bereit. Ein plausibler Suchtreffer allein belegt noch nicht, dass die vorgesehene Quelle gefunden wurde.

Collection und Suchmodell festlegen

Der offizielle Qdrant-MCP-Server bietet qdrant-find und qdrant-store. QDRANT_READ_ONLY=true deaktiviert das Speicherwerkzeug. COLLECTION_NAME wählt eine Standard-Collection. Verwenden Sie ein mit dieser Collection kompatibles Embedding-Modell; der Wert unten ist ein dokumentiertes Beispiel, keine allgemeingültige Wahl.

VS-Code-Konfiguration für eine entfernte Datenbank

Installieren Sie uv, passen Sie Host, Collection und Modell an und speichern Sie das Beispiel als .vscode/mcp.json. VS Code fragt den API-Schlüssel ab. Die Datenbankverbindung verwendet HTTPS, während der MCP-Prozess lokal über stdio läuft.

{
  "servers": {
    "qdrant": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-qdrant"
      ],
      "env": {
        "QDRANT_URL": "https://YOUR_QDRANT_HOST:6333",
        "QDRANT_API_KEY": "${input:qdrant-key}",
        "COLLECTION_NAME": "YOUR_EXISTING_TEST_COLLECTION",
        "EMBEDDING_MODEL": "sentence-transformers/all-MiniLM-L6-v2",
        "QDRANT_READ_ONLY": "true",
        "QDRANT_SEARCH_LIMIT": "5"
      }
    }
  },
  "inputs": [
    {
      "id": "qdrant-key",
      "type": "promptString",
      "description": "Qdrant API key",
      "password": true
    }
  ]
}

Verwenden Sie einen auf die benötigten Daten und Operationen begrenzten Schlüssel. Das Abschalten eines Werkzeugs entzieht dem Schlüssel keine Rechte. Prüfen Sie vor einer Erweiterung den Read-only-Leitfaden.

Eine bekannte Referenz testen

1. Prüfen Sie nach dem Start die angebotenen Werkzeuge. Bestätigen Sie im Lesemodus, dass qdrant-store fehlt.

2. Suchen Sie mit qdrant-find nach einer charakteristischen Formulierung aus dem Referenztext. Beschränken Sie den Test auf die vorbereitete Collection.

3. Vergleichen Sie zurückgegebenen Text und Metadaten mit Ihrer Originalreferenz. Halten Sie fehlende oder falsche Kennungen getrennt von Rangunterschieden fest.

4. Wiederholen Sie die Suche mit einem unpassenden Begriff. Prüfen Sie, warum trotzdem ein Treffer erscheint; semantische Ähnlichkeit garantiert keinen exakten Treffer.

Für lokalen Speicher dokumentiert das Projekt QDRANT_LOCAL_PATH als Alternative zu QDRANT_URL; setzen Sie nicht beide. Die Qdrant-Registersuche verlinkt deklarierte Servereinträge. Wählen Sie den ersten Zugriff mit dem Datenbank-Assistenten.

Suchqualität getrennt von Erreichbarkeit prüfen

Legen Sie vor dem Test drei kleine Suchfälle fest: einen bekannten Text, eine sinngleiche Formulierung und einen unpassenden Begriff. Notieren Sie für jeden Fall, welche Referenz Sie erwarten und welche Ergebnisse tatsächlich zurückkommen. Vergleichen Sie dabei Kennung und Inhalt, nicht nur den Rang des ersten Treffers. Eine erreichbare Datenbank kann unpassende Suchergebnisse liefern, wenn die Collection oder ihre Aufbereitung nicht zum Test passt. Ändern Sie deshalb nicht gleichzeitig Suchtext, Modell und Datenbestand. Bewahren Sie die ursprünglichen Testfälle auf und wiederholen Sie sie nach einer Änderung. So wird erkennbar, ob sich ein bestimmter Suchweg verbessert hat.

Warum fehlt qdrant-store?

Das Beispiel schaltet es mit QDRANT_READ_ONLY=true bewusst aus.

Funktioniert jede vorhandene Collection mit dem Beispielmodell?

Nein. Prüfen Sie die Kompatibilität mit Modell und Vektorkonfiguration Ihrer gespeicherten Daten.

Belegt ein passender Treffer die Vollständigkeit?

Nein. Vergleichen Sie mit einer bekannten Referenz und dokumentieren Sie, welche erwarteten Inhalte gefunden wurden.

Kann ich URL und lokalen Pfad gemeinsam setzen?

Das Projekt dokumentiert sie als Alternativen. Wählen Sie die Speicherart, die Sie prüfen möchten.

Herstellerdokumentation am 2. Oktober 2026 geprüft. Kein angemeldeter Kontotest.

1. Qdrant: MCP server
   Abrufbefehl anzeigen

   curl -s https://github.com/qdrant/mcp-server-qdrant
2. Qdrant: Security
   Abrufbefehl anzeigen

   curl -s https://qdrant.tech/documentation/operations/security/
3. VS Code: MCP configuration
   Abrufbefehl anzeigen

   curl -s https://code.visualstudio.com/docs/agent-customization/mcp-servers

Alle Beiträge