name: mcp-troubleshooting description: Diagnose and fix MCP configuration/runtime issues across supported integrations using agents CLI checks.
When MCP servers are failing or not visible:
- Run
agents status --fastto inspect configured vs enabled integrations. - Run
agents mcp testfor schema/config validation. - Run
agents mcp test --runtimeto check integration CLI/runtime connectivity. - Run
agents doctorfor environment and binary diagnostics. - Apply the smallest safe fix, then run
agents syncand verify withagents sync --check.
Troubleshooting priorities:
- Missing binaries or PATH issues.
- Invalid server names/transport fields.
- Missing required environment variables or secrets.
- Target mismatch (server not routed to expected integration).