MCP接続エラーを解決したい

コマンド / 機能

claude mcp list で状態確認

概要

MCP（Model Context Protocol）サーバーとの接続問題を診断・解決します。設定ミス、サーバー起動エラー、認証問題などを特定できます。

設定例

# MCP サーバーの状態を確認
claude mcp list

# 出力例
MCP Servers:
  github: ✓ Connected (5 tools)
  filesystem: ✓ Connected (3 tools)
  postgres: ✗ Error: Connection refused

# 詳細なエラー情報を確認
/mcp

# よくあるエラーと対処法

# 1. "Command not found"
# → npx/node/python のパスを確認
{
  "command": "/usr/local/bin/node",  // フルパスを指定
  "args": ["./server.js"]
}

# 2. "Connection refused"
# → サーバーの起動を確認
npx @modelcontextprotocol/server-github  # 手動で起動テスト

# 3. "Authentication failed"
# → 環境変数（APIキー等）を確認
{
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxx"  // 有効なトークンか確認
  }
}

# 4. "Timeout"
# → サーバーの応答を確認、タイムアウト延長
{
  "timeout": 30000  // サーバー別にタイムアウト設定
}

# MCP サーバーをデバッグ起動
# stderr にログを出力させて確認
node ./my-mcp-server.js 2>&1 | tee mcp-debug.log