启动参数看官方文档启动时开启,输出 MCP 服务器错误的更多调试信息。全网调研整理典型场景MCP server 启动失败但 `/mcp` 无详细错误时,用此 flag 输出服务器 stderr 完整日志MCP server 显示 connected 但 tool 列表为空时,需要看协议握手过程中的具体报错首次集成自定义 MCP server 时,验证 Claude Code 能否正确启动和通信排查 npx / uvx 启动的 MCP server 路径或环境变量异常对比多个 MCP server 在同一会话中的初始化顺序与报错来源实用技巧启动形式为 `claude --debug mcp`,亦可写作 `--mcp-debug`,会把 server 的 stderr 直接打印到终端配合 `/mcp` 斜杠命令使用:先看 flag 输出的初始化日志,再用 `/mcp` 确认连接状态与工具列表macOS 日志落盘于 `~/Library/Logs/Claude/mcp-server-<NAME>.log`,Linux 在 `~/.local/share/Claude/logs/`,可独立 `tail -f` 监控先用 MCP Inspector (`npx @modelcontextprotocol/inspector`) 单独测试 server,确认 server 本身无误后再接入 Claude Code 对比调试与 `claude --safe-mode` 组合:先在 safe-mode 下确认基础连通,再加 `--debug mcp` 逐步缩小问题范围常见坑`.mcp.json` 里 `command` 或 `args` 使用相对路径时 Claude Code 会以启动目录解析,而非配置文件所在目录,导致找不到 binaryMCP server 若把日志写到 stdout 会污染 JSON-RPC 协议流,必须重定向到 stderr,否则 `--mcp-debug` 看到的是乱码而非真实错误`settings.json` 顶层 `env` 字段的环境变量不会自动传递给 MCP 子进程,需在 `.mcp.json` 每个 server 条目内单独设置 `env`来源CLI reference — Claude Code DocsDebug your configuration — Claude Code DocsHow to Debug MCP Server that fails to connect? · Issue #72 · anthropics/claude-codeMCP Servers Not Initializing · Issue #35452 · anthropics/claude-codeClaude Code MCP Server Error: Complete Fix Guide 2026创建于v0.2.31最近更新v0.2.31变化次数1新增 1变化时间线(按版本倒序)新增v0.2.31· 2025/03/06 · 2025/03/06新增 --mcp-debug 启动参数以获取 MCP 服务器错误的更多信息上一个--mcp-config回到命令字典下一个--model