Claude Code MCP 伺服器無法啟動/連線的原因與解決方法
現在有故障嗎？
Claude Code 官方狀態正常。若此錯誤持續出現，多半是實作或你的運作環境問題。
查看 Claude Code 的運作狀態 →錯誤含義
設定的 MCP（Model Context Protocol）伺服器啟動或連線失敗（例如「MCP server '…' failed to connect」）。這通常是 MCP 伺服器端的設定問題——指令、引數、執行階段（runtime）或環境變數，而非 Claude Code 本身。
常見原因
- •.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」）。這通常是 MCP 伺服器端的設定問題——指令、引數、執行階段（runtime）或環境變數，而非 Claude Code 本身。
MCP server failed 如何解決？
用 `claude mcp list` 查看註冊狀況，用 `/mcp` 查看連線狀態 / 檢查設定中的指令、引數與 env / 安裝所需執行階段並加入 PATH / 單獨執行該指令，確認能否啟動 / 設定必要的環境變數（API 金鑰等） / 查看記錄檔定位伺服器端錯誤 / 修正設定後重新啟動 Claude Code