claude-code-mcp-troubleshooting

Community

Diagnose and fix Claude Code MCP issues quickly.

Authorphotonics-dhl
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This skill helps Hermes users identify and resolve Claude Code MCP connectivity and configuration issues that prevent MCP-based assistants from communicating or performing tasks.

Core Features & Use Cases

  • Diagnostics: detect MCP server visibility gaps between Hermes and Claude Code.
  • Environment checks: identify Node.js fetch restrictions, Python version compatibility, and network policies.
  • Guided remediation: provide concrete steps to adjust mcp.yaml, configure Claude MCP, and apply safe workarounds when outbound access is blocked.
  • Use Case: when Hermes cannot reach Claude Code MCP due to isolation, apply the guidance to restore MCP functionality without altering core system files.

Quick Start

Follow the recommended checks to verify Hermes and Claude Code MCP configurations and apply safe workarounds if outbound access is restricted.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: claude-code-mcp-troubleshooting
Download link: https://github.com/photonics-dhl/Hermes/archive/main.zip#claude-code-mcp-troubleshooting

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.