MCP Health Repair
Purpose
Stabilize MCP servers and remove recurring /status failures.
Workflow
- Capture baseline: run
opencode mcp list2-3 times for intermittent failures. - Classify failure type:
Connection closed: usually bad args/env/credentials.- timeout: startup/download/port bind issues.
- schema invalid: bad config key shape (
envvsenvironment).
- Validate command paths in
opencode.jsonagainst installed package entry points. - Apply surgical fixes:
- correct command args
- set safe port env when needed
- disable unresolved servers to stop noisy failures
- Re-verify with
opencode mcp listand keep evidence logs.
Guardrails
- Never keep an enabled server that is known broken.
- Prefer env vars for secrets.
- Add validator checks for repeated regressions.