Home > Tutorials > Quick Start
Get KnowStack running locally and make your first query via MCP.
- Node.js 20+
- pnpm (
npm install -g pnpm) - Docker & Docker Compose
git clone <repository-url>
cd knowstack
pnpm installcp .env.example .envThe default .env works for local development. See .env.example for all available options.
# Start PostgreSQL and Redis
docker compose up -d db redispnpm prisma generate
pnpm prisma migrate devpnpm start:devThe server runs at http://localhost:3100.
With the server running, use the SDK CLI to create your organization, project, ingest documentation, and seed instructions:
npx @knowstack/sdk --initFollow the interactive prompts. The CLI prints MCP connection config at the end. See SDK Setup Guide for full options.
Use the config printed by the SDK to connect any MCP-compatible tool. Example for a CLI tool:
# Example: Claude Code (adapt for your MCP client)
claude mcp add knowstack \
--transport http http://localhost:3100/api/v1/mcp \
-H "x-ks-org: your-org-slug" \
-H "x-ks-project: your-project-slug"For IDE-based clients, see MCP Reference — Client Configuration.
| Script | Description |
|---|---|
npx @knowstack/sdk --init |
Setup org, project, docs |
pnpm start:dev |
Start with hot reload |
pnpm build |
Build for production |
pnpm prisma studio |
Open database GUI |
pnpm test |
Run unit tests |
- MCP Reference - Full MCP tool documentation
- cURL Examples - Command-line examples
- Backfill Embeddings - Add semantic search to your documents