·troubleshoot-mcp-connection
</>

troubleshoot-mcp-connection

✓
pjt222/development-guidesGitHub: pjt222/development-guidesSource: pjt222/development-guides

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.

pjt222·troubleshoot·mcp·connection
10Installs·1Trend·@pjt222

Installation

GitHub: pjt222/development-guides
$npx skills add https://github.com/pjt222/development-guides --skill troubleshoot-mcp-connection

How to Install troubleshoot-mcp-connection

Quickly install troubleshoot-mcp-connection AI skill to your development environment via command line

  1. Open Terminal: Open your terminal or command line tool (Terminal, iTerm, Windows Terminal, etc.)
  2. Run Installation Command: Copy and run this command: npx skills add https://github.com/pjt222/development-guides --skill troubleshoot-mcp-connection
  3. Verify Installation: Once installed, the skill will be automatically configured in your AI coding environment and ready to use in Claude Code, Cursor, or OpenClaw

Source: pjt222/development-guides.

SKILL.md

View raw

Expected: Configuration file is located and readable, showing the MCP server entries with command, args, and env fields.

On failure: If the config file does not exist or is empty, the server was never configured. Follow the configure-mcp-server skill to set it up from scratch.

Expected: The server process starts and produces initialization output (JSON-RPC handshake or "listening" message) without errors.

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. Source: pjt222/development-guides.

Facts (cite-ready)

Stable fields and commands for AI/search citations.

Install command
npx skills add https://github.com/pjt222/development-guides --skill troubleshoot-mcp-connection
Source
pjt222/development-guides
Category
</>Dev Tools
Verified
✓
First Seen
2026-03-10
Updated
2026-03-10
URL
https://www.learn-skills.dev/en/skills/pjt222/development-guides/troubleshoot-mcp-connection

Browse more skills from pjt222/development-guides

Quick answers

What is troubleshoot-mcp-connection?

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. Source: pjt222/development-guides.

How do I install troubleshoot-mcp-connection?

Open your terminal or command line tool (Terminal, iTerm, Windows Terminal, etc.) Copy and run this command: npx skills add https://github.com/pjt222/development-guides --skill troubleshoot-mcp-connection Once installed, the skill will be automatically configured in your AI coding environment and ready to use in Claude Code, Cursor, or OpenClaw

Where is the source repository?

https://github.com/pjt222/development-guides

Details

Category
</>Dev Tools
Source
skills.sh
First Seen
2026-03-10

Related Skills

review-ux-ui
13 Installs
awareness
11 Installs
gratitude
11 Installs
create-work-breakdown-structure
11 Installs
repair-broken-references
11 Installs
repair-damage
11 Installs