a03fd3de4f
- Replace all unicode (emojis, checkmarks, arrows, em-dashes) with ASCII in .claude/ docs - Comment out OperatingSystemsList route in core.js - breaks lean builds without computers plugin - Comment out Operating Systems tab in ModelCatalogHub - TODO: Plugins should dynamically register their settings routes Fixes #2 CI check failures on wj branch Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
156 lines
4.1 KiB
Markdown
156 lines
4.1 KiB
Markdown
# Flask-ShopDB Dev Environment Startup Checklist
|
|
|
|
Quick reference for starting the complete development environment with all MCP servers and multi-agent collaboration.
|
|
|
|
---
|
|
|
|
## Pre-Launch (First Time Only)
|
|
|
|
These items are already configured and will persist:
|
|
|
|
- [X] `.mcp.json` - MCP server configurations (gortex, mysql, browser, vm, coordinator)
|
|
- [X] `.claude/settings.json` - Auto-enables project MCP servers + SessionEnd hook
|
|
- [X] `start-dev.cmd` - Updated with `NODE_TLS_REJECT_UNAUTHORIZED=0` for Vite
|
|
- [X] `stop-dev.cmd` - Auto-runs when Claude Code session closes
|
|
|
|
---
|
|
|
|
## Launch Sequence
|
|
|
|
### Step 1: Start Development Environment
|
|
|
|
```bash
|
|
./start-dev.cmd
|
|
```
|
|
|
|
**What this does:**
|
|
1. **Checks MCP Coordinator daemon** - starts it if not running (for multi-agent collaboration)
|
|
2. Starts Flask API (Docker) - https://192.168.100.1:5001
|
|
3. Starts MySQL DB (Docker) - healthy check
|
|
4. Starts Vite dev server - http://192.168.100.1:5173
|
|
- **Note:** Vite window will pop up (this is normal)
|
|
- Vite now has `NODE_TLS_REJECT_UNAUTHORIZED=0` to connect to Flask's HTTPS
|
|
|
|
**Verify it's running:**
|
|
- Frontend: http://192.168.100.1:5173
|
|
- Backend: https://192.168.100.1:5001
|
|
|
|
---
|
|
|
|
### Step 3: Open Claude Code Session
|
|
|
|
```bash
|
|
# In project directory
|
|
claude
|
|
```
|
|
|
|
**On first launch after MCP config changes, you'll be prompted to approve:**
|
|
- [X] gortex (C:\Users\270015376\Documents\gortex.exe)
|
|
- [X] mysql (database access)
|
|
- [X] browser (browser automation)
|
|
- [X] vm / vm-shopfloor (SSH to test VM)
|
|
- [X] coordinator (multi-agent collaboration)
|
|
|
|
**Auto-loaded MCP servers:**
|
|
- github, shopdb, amber (from user config)
|
|
- Plus all project servers from `.mcp.json`
|
|
|
|
---
|
|
|
|
## What's Automated
|
|
|
|
### On Dev Environment Start (`./start-dev.cmd`):
|
|
- [X] MCP Coordinator daemon auto-starts (if not already running)
|
|
- [X] Flask API (Docker)
|
|
- [X] MySQL DB (Docker)
|
|
- [X] Vite dev server (with TLS fix)
|
|
|
|
### On Claude Code Session Start:
|
|
- [X] All approved MCP servers auto-connect
|
|
- [X] `enableAllProjectMcpServers: true` loads project servers
|
|
|
|
### On Session Close:
|
|
- [X] `./stop-dev.cmd` runs automatically (SessionEnd hook)
|
|
- [X] MCP Coordinator daemon stops
|
|
- [X] Docker containers stop
|
|
- [X] Vite dev server stops
|
|
- [X] No manual cleanup needed
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### Vite Proxy Errors (TLS)
|
|
If you see `http proxy error: /api/...` in Vite window:
|
|
- Check Vite was started with `NODE_TLS_REJECT_UNAUTHORIZED=0`
|
|
- Restart Vite: Kill the window, run `./start-dev.cmd` again
|
|
|
|
### MCP Servers Not Loading
|
|
- Restart Claude Code session
|
|
- Check `.mcp.json` exists in project root (not `.claude/mcp-servers.json`)
|
|
- Verify `enableAllProjectMcpServers: true` in `.claude/settings.json`
|
|
|
|
### Coordinator Not Working
|
|
```bash
|
|
# Check daemon status
|
|
npx mcp-coordinator server status
|
|
|
|
# Restart if needed
|
|
npx mcp-coordinator server stop
|
|
npx mcp-coordinator server start --daemon
|
|
```
|
|
|
|
### Flask Not Responding
|
|
```bash
|
|
# Check Docker containers
|
|
docker ps --filter "name=flask-shopdb"
|
|
|
|
# Restart if needed
|
|
./stop-dev.cmd
|
|
./start-dev.cmd
|
|
```
|
|
|
|
---
|
|
|
|
## Quick Status Check
|
|
|
|
```bash
|
|
# Check all services at once
|
|
docker ps --filter "name=flask-shopdb" && \
|
|
curl -s http://localhost:5173 > /dev/null && echo "[X] Vite OK" && \
|
|
curl -sk https://localhost:5001/api/auth/me 2>&1 | grep -q "Authorization" && echo "[X] Flask OK" && \
|
|
curl -s http://localhost:3100/health > /dev/null && echo "[X] Coordinator OK"
|
|
```
|
|
|
|
---
|
|
|
|
## Login Credentials
|
|
|
|
**ShopDB App:**
|
|
- Username: `270015376` or `testadmin`
|
|
- Password: `admin123`
|
|
|
|
**Test VM (192.168.100.10):**
|
|
- SupportUser: `vos313`
|
|
- shopfloor: `vos313`
|
|
|
|
---
|
|
|
|
## Current MCP Servers
|
|
|
|
| Server | Purpose | Status |
|
|
|--------|---------|--------|
|
|
| github | GitHub API access | Auto-loaded |
|
|
| shopdb | ShopDB-specific tools | Auto-loaded |
|
|
| amber | GE internal tools | Auto-loaded |
|
|
| gortex | Custom Gortex tool | Needs approval |
|
|
| mysql | Direct DB access | Needs approval |
|
|
| browser | Browser automation | Needs approval |
|
|
| vm | SSH to test VM (SupportUser) | Needs approval |
|
|
| vm-shopfloor | SSH to test VM (shopfloor) | Needs approval |
|
|
| coordinator | Multi-agent collaboration | Needs approval |
|
|
|
|
---
|
|
|
|
Last updated: 2026-09-10
|