Back to guide/Developer Tools

MCP Integration Debugging

Walks through the MCP debugging checklist systematically, covers the most common failure modes, and asks for exact commands rather than vague suggestions.

claude-code-tipsserver_namesymptoms
Edit View
Prompt
My MCP server {{server_name}} isn't working in Claude Code.

Symptoms: {{symptoms}}

Help me debug:
1. Check if the server is registered in ~/.claude.json under this project
2. Verify the command and args are correct
3. Check if environment variables are set (list which ones are needed)
4. Test if the server binary/script exists at the configured path
5. Look for common issues: wrong Node version, missing build step, port conflicts

Show me the exact commands to run for each diagnostic step.

Variables to customize

{{server_name}}{{symptoms}}

Why this prompt works

Walks through the MCP debugging checklist systematically, covers the most common failure modes, and asks for exact commands rather than vague suggestions.

Save this prompt to your library

Organize, version, and access your best prompts across ChatGPT, Claude, and Cursor.

Related prompts

Code Review Assistant

Get thorough code reviews with actionable feedback tailored to your language, framework, and standards.

Context-Aware Code Completion

Providing the surrounding code and project context lets the model match existing patterns exactly. The constraint against modifying existing code prevents unwanted side effects.

Inline Code Suggestion

Constraining suggestions to match existing style and scope produces insertions that feel native to the codebase. The 'no explanation' rule mimics real inline completion behavior.

Code Explanation

The audience level parameter adjusts complexity automatically. Requiring a usage example ensures the explanation is practical, not just theoretical.