cyberneticlibrary

Diagnose MCP Connection Issues

mcp-diagnoserskillsetup L20
morinap/dot-morinap
What it does

Diagnose and fix MCP server connectivity issues

Best for

When MCP servers fail to connect or authenticate unexpectedly

Inputs
  • · failing MCP server name
Outputs
  • · root cause classification
  • · minimal fix
  • · hardening suggestions
Requires
  • · MCP client tools
Preconditions

OpenCode environment with MCP servers configured

Failure modes
  • · Incorrect root cause diagnosis
  • · Fixing wrong server
Trust signals
  • · 5-step diagnostic workflow
  • · Auth flow taxonomy
  • · Guardrails against secret leaks