KnearMe MCP Worker Operations Runbook
Incident triage
Section titled “Incident triage”- Confirm worker deployment health and latest SHA.
- Validate OAuth issuer/resource metadata endpoint responses.
- Test a known-safe
tools/listrequest. - Verify portfolio API upstream availability.
Auth-related incident handling
Section titled “Auth-related incident handling”- If all requests fail auth, validate
JWT_PUBLIC_KEYand issuer/resource values first. - Ensure OAuth metadata URL resolves and serves expected data.
Upstream incident handling
Section titled “Upstream incident handling”- If tool calls fail but auth passes, test portfolio API directly.
- Coordinate with portfolio app owners for upstream outages.
Rollback
Section titled “Rollback”Re-deploy last known-good worker build with known-good env values.