Skip to main content

Connect to an Agent

# Local setup — Qdrant starts automatically (embedded), Ollama on localhost
claude mcp add tea-rags -s user -- node /path/to/tea-rags/build/index.js
tip

QDRANT_URL is autodetected: probes localhost:6333 for external Qdrant, falls back to embedded. No configuration needed for local setups.

Remote Server Setup​

# External Qdrant + Ollama on separate host
claude mcp add tea-rags -s user -- node /path/to/tea-rags/build/index.js \
  -e QDRANT_URL=http://192.168.1.100:6333 \
  -e EMBEDDING_BASE_URL=http://192.168.1.100:11434

Qdrant Cloud​

claude mcp add tea-rags -s user -- node /path/to/tea-rags/build/index.js \
  -e QDRANT_URL=https://your-cluster.qdrant.io:6333 \
  -e QDRANT_API_KEY=your-api-key-here

HTTP Transport (Remote)​

Security

When deploying HTTP transport in production:

  • Always run behind a reverse proxy (nginx, Caddy) with HTTPS
  • Implement authentication/authorization at the proxy level
  • Use firewalls to restrict access to trusted networks
  • Never expose directly to the public internet without protection

Start the server:

TRANSPORT_MODE=http HTTP_PORT=3000 node build/index.js

Configure client:

{
  "mcpServers": {
    "qdrant": {
      "url": "http://your-server:3000/mcp"
    }
  }
}

Using a Different Provider​

"env": {
  "EMBEDDING_PROVIDER": "openai",
  "OPENAI_API_KEY": "sk-..."
}

See Configuration for all options.