MCP Directory

How to add Qdrant MCP Server to Windsurf

Official Qdrant server using a vector collection as semantic memory: store and find embeddings. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 1.1k★ · stdio · apikey · official

Windsurf config for Qdrant MCP Server

uvx mcp-server-qdrant
{
  "mcpServers": {
    "qdrant-mcp-server": {
      "command": "uvx",
      "args": [
        "mcp-server-qdrant"
      ],
      "env": {
        "QDRANT_URL": "https://<your-cluster>.cloud.qdrant.io:6333",
        "QDRANT_API_KEY": "<your-api-key>",
        "COLLECTION_NAME": "<your-collection-name>",
        "EMBEDDING_MODEL": "sentence-transformers/all-MiniLM-L6-v2"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Qdrant MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Qdrant MCP Server's tools become available to Cascade.

Before you start

  • Python with the `uv`/`uvx` package manager (or Docker as an alternative)
  • A Qdrant instance: a Qdrant Cloud cluster, a self-hosted server URL, or a local on-disk path via `QDRANT_LOCAL_PATH`
  • For remote Qdrant: a `QDRANT_API_KEY` (from your Qdrant Cloud dashboard at cloud.qdrant.io)
  • No separate embedding API key needed — embeddings default to the local FastEmbed model `sentence-transformers/all-MiniLM-L6-v2`

What Qdrant MCP Server can do in Windsurf

qdrant-store

Store a piece of information (with optional JSON metadata) into the Qdrant collection as an embedding

qdrant-find

Retrieve the most relevant stored entries for a natural-language query via semantic search

Security

For Qdrant Cloud the QDRANT_API_KEY grants full collection access, so keep it in env vars. The default embedding model downloads and runs locally on first use, which has compute and disk implications.

Qdrant MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Qdrant MCP Server config there under the "mcpServers" key and restart the client.

Is Qdrant MCP Server safe to use with Windsurf?

For Qdrant Cloud the QDRANT_API_KEY grants full collection access, so keep it in env vars. The default embedding model downloads and runs locally on first use, which has compute and disk implications.

Do I need an OpenAI or other embedding API key?

No. Embeddings are generated locally with FastEmbed (`all-MiniLM-L6-v2` by default), so the only credential you may need is a Qdrant API key for a remote cluster.

Can I run it without a Qdrant server?

Yes. Set `QDRANT_LOCAL_PATH` to a directory and it uses a local on-disk Qdrant database instead of a remote URL — but don't set both `QDRANT_URL` and `QDRANT_LOCAL_PATH`.

How do I make it read-only?

Set `QDRANT_READ_ONLY=true`, which disables the `qdrant-store` tool and exposes only `qdrant-find`.

View repo Full Qdrant MCP Server page