docs: fix /health → /health/live, refresh stale mode-detection log examples (#766)

Issue #766 reported that the running.md quick-start tells users to
`curl http://localhost:8000/health`, which returns 404 — the server
only registers `/health/live` and `/health/ready` (K8s-style probes).
The same section also listed BasicAuth and OAuth startup log lines
(`BasicAuth mode detected …`, `OAuth mode detected …`) that no longer
exist anywhere in the codebase.

Update running.md and troubleshooting.md to point at the real
endpoints, explain liveness vs readiness, and replace the fictional
log examples with messages the server actually emits today. Also
clarify that the per-session BasicAuth messages only appear after the
first MCP client connects, which is the second symptom the reporter
hit.

Docs-only change; code paths and endpoint surface unchanged.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Chris Coutinho
2026-05-12 07:35:49 +02:00
co-authored by Claude Opus 4.7
parent f8e48f1c53
commit e78e191818
2 changed files with 37 additions and 16 deletions
+2 -2
View File
@@ -290,10 +290,10 @@ kill <pid>
2. **Test connectivity:**
```bash
# Test from same machine
curl http://localhost:8000/health
curl http://localhost:8000/health/live
# Test from network (if using --host 0.0.0.0)
curl http://<server-ip>:8000/health
curl http://<server-ip>:8000/health/live
```
3. **Check firewall:**