← All skills

troubleshoot-mcp-connection

79 / 100 · Review before installing

Check before installing. Some of what it can do is expected: a coding skill usually runs build and test commands.

By roohe/agentic-super-skills (GitHub) · coding · 10 stars · scanned at commit f483e54

Diagnose and fix MCP server connection issues between Claude Code, Claude Desktop, and MCP servers. Covers Windows argument parsing, authentication failures, transport issues, and platform-specific debugging. Use when Claude Code or Claude Desktop fails to connect to an MCP server, when MCP tools don't appear in sessions, on "cannot attach the server" errors, when a working connection has stopped, or when setting up MCP on a new machine.

Works with any agent that supports SKILL.md skills.

What this skill can do

Safer alternatives

Low-risk skills in the same category (coding) that look related. Check that one does what you need.

• 100 Low risktroubleshoot-binlog-mcpmicrosoft/testfx · 1,059 stars
• 100 Low risktroubleshootBrainBlend-AI/atomic-agents · 6,329 stars
• 85 Low riskdiagnosing-mcpasgeirtj/system_prompts_leaks · 71,387 stars

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'troubleshoot-mcp-connection' ] || [ -L ~/.agents/skills/'troubleshoot-mcp-connection' ]; then echo 'A skill folder named troubleshoot-mcp-connection already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/roohe/agentic-super-skills' "$d" && git -C "$d" checkout --quiet 'f483e54f3ad5f202a77d45f2e57f8d970b71195f' -- 'skills_library/troubleshoot-mcp-connection' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills_library/troubleshoot-mcp-connection' ~/.agents/skills/'troubleshoot-mcp-connection' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'troubleshoot-mcp-connection' ~/.claude/skills/'troubleshoot-mcp-connection' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for roohe/agentic-super-skills shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/roohe/agentic-super-skills.svg)](https://zalavijaysinh.github.io/skilltrust/repos/roohe/agentic-super-skills/)

Score history