Quick start with Docker Compose

Prerequisites: Docker and Docker Compose installed, plus Git and Make. Clone the server repository: git clone https://github.com/synamcps/synamcps-server && cd synamcps-server.

Copy the environment template: cp .env.example .env. Review secrets, ports, and vector backend settings (pgvector by default; Qdrant is supported). Keep the defaults for a local trial.

Start the stack: make compose-up. Compose brings up Postgres, Redis, S3/MinIO, and Synamcps together. Wait until the containers are healthy.

Open the Admin UI at http://localhost:8080/login. Sign in with the credentials from your .env, create a storage, ingest a sample document or link, and issue a scoped token for MCP clients.

Verify the MCP endpoint at /mcp with your bearer token, then connect Cursor or Claude using the MCP Connect wizard. When finished, tear down with make compose-down.