Claude CodeでMCPサーバーが起動・接続に失敗する原因と対処法
現在、障害は発生していますか？
Claude Code の公式ステータスは正常です。このエラーが続く場合は、実装・環境側の要因の可能性が高いです。
Claude Code の稼働状況を見る →エラーの意味
設定した MCP（Model Context Protocol）サーバーが起動または接続に失敗した状態です（例:「MCP server "…" failed to connect」）。Claude Code 本体ではなく、MCP サーバー側のコマンド・引数・ランタイム・環境変数など設定起因のことが多いエラーです。
よくある原因
- •.mcp.json などの設定でコマンドパスや引数が誤っている
- •必要なランタイム（node / python / uvx 等）が未インストール・PATH 外
- •必要な環境変数（APIキー等）が未設定
- •MCP サーバープロセスの起動失敗・クラッシュ
- •stdio / SSE の種別や URL の指定ミス
- •実行権限の不足
対処法
- 1.`claude mcp list` で登録状況、`/mcp` で接続状態を確認する
- 2.設定のコマンド・引数・env を見直す
- 3.必要なランタイムをインストールし PATH を通す
- 4.そのコマンドを単体で手動実行し、起動できるか切り分ける
- 5.必要な環境変数（APIキー等）を設定する
- 6.ログでサーバー側のエラー内容を特定する
- 7.設定を修正して Claude Code を再起動する
待つべきケース／待っても直らないケース
MCP は設定・環境起因が多く、待っても直りません。設定とランタイムを確認してください。Anthropic 本体の障害とは独立しているため、本体が正常でも MCP だけ失敗することがあります。
Claude Code が使えないときの代替
関連するエラー
よくある質問
MCP server failed とは何ですか？
設定した MCP（Model Context Protocol）サーバーが起動または接続に失敗した状態です（例:「MCP server "…" failed to connect」）。Claude Code 本体ではなく、MCP サーバー側のコマンド・引数・ランタイム・環境変数など設定起因のことが多いエラーです。
MCP server failed の対処法は？
`claude mcp list` で登録状況、`/mcp` で接続状態を確認する、設定のコマンド・引数・env を見直す、必要なランタイムをインストールし PATH を通す、そのコマンドを単体で手動実行し、起動できるか切り分ける、必要な環境変数（APIキー等）を設定する、ログでサーバー側のエラー内容を特定する、設定を修正して Claude Code を再起動する