Troubleshooting
Common issues and recovery paths for certificates, proxy setup, CLI, and MCP integration.
Use this page as the first stop when HTTPeep behavior is not as expected.
Quick checks
- Confirm proxy runtime is running and listening on the expected port
- Verify root certificate is installed and trusted
- Validate app or system proxy settings are pointing to HTTPeep
- Confirm your active rules are enabled and matched
Common issue categories
Certificate issues
HTTPS interception failures, trust status, and installation troubleshooting.
External proxy chain
Problems with upstream corporate proxies or proxy chaining.
CLI issues
Command not found, runtime not reachable, and CI usage pitfalls.
MCP integration
Agent connection problems, tool errors, and setup mismatches.