Startup Procedures

Services Overview

Service	Script	Port	Runtime
Astro dev server	scripts/start-web.sh	4321	Node/npm
API server (Hono)	scripts/start-api.sh	2077	Bun
MCP gateway	scripts/start-mcp-gateway.sh	8710	Python/uvicorn
Qdrant	Docker / qdrant binary	6333	Rust

Starting Everything

The typical startup sequence:

1. Qdrant — must be running before the MCP gateway (vector search dependency)
2. MCP gateway — Python process, serves all MCP tools via Cloudflare Tunnel at akita-mcp.candide.me
3. API server — Hono on Bun, handles dev tools and API routes
4. Astro dev server — frontend, binds to --host 0.0.0.0 for Tailscale access

# Start Qdrant (if not already running)
qdrant

# Start MCP gateway
scripts/start-mcp-gateway.sh

# Start API server
scripts/start-api.sh

# Start web dev server
scripts/start-web.sh

Stopping Services

Each service runs in its own terminal or background process. Use Ctrl+C to stop individual services, or find processes by port:

lsof -i :4321  # Astro
lsof -i :2077  # API
lsof -i :8710  # MCP gateway
lsof -i :6333  # Qdrant

Publishing

The site is deployed to Cloudflare Pages (no CI/CD):

scripts/publish-web.sh  # wrangler pages deploy