At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key from
QDRANT_API_KEYis sent as theapi-keyheader. - Docs: https://qdrant.tech/documentation/cloud/authentication/
Credentials
Set these per environment. See Connect an integration.| Variable | Required | Description |
|---|---|---|
QDRANT_API_KEY | Yes | Qdrant database API key for your cluster Docs. |
Setup
- Create a Qdrant Cloud account: Sign up at https://cloud.qdrant.io - the free tier includes a 1GB cluster, enough for testing. Self-hosted Qdrant works too (run it with an api-key configured).
- Create a cluster and API key: Create a cluster, then open its API Keys tab and create a database API key. Copy it immediately - it is only shown once.
- Store the key and note your endpoint: Add QDRANT_API_KEY=… to your .env file. Copy the cluster endpoint hostname from Cluster details - tools take it as the clusterHost parameter without scheme or port (e.g. xyz-example.eu-central-1-0.aws.cloud.qdrant.io); requests go to port 6333.
- Verify access: Run the List Collections tool with your clusterHost.
- The API key is sent in the api-key header; Qdrant Cloud also accepts Authorization: Bearer
- Every tool needs the clusterHost parameter (hostname only; requests target HTTPS port 6333) - there is no global Qdrant API host
- Vectors must match the collection’s configured vector size; generate embeddings separately (e.g. with OpenAI or Mistral)
Tools
| Tool | Access | Description |
|---|---|---|
| List Collections | Read | List all collections in the Qdrant cluster |
| Get Collection Info | Read | Get a collection’s configuration, vector parameters, and point count |
| Search Points | Read | Search a collection for the points nearest to a query vector |
| Upsert Points | Write | Insert or update points (vectors with payloads) in a collection |
Example prompts
- List the collections in my Qdrant cluster and show each one’s vector size and point count.
- Search my Qdrant collection with an embedding vector and show the top matches with their payloads.