--mcp-config · Claude Code 命令 · Claude Code 中文学习站

从JSON文件或字符串加载MCP服务器

Syntax

--mcp-config <file|string>

示例

claude --mcp-config ./mcp.json

全网调研整理

典型场景

实用技巧

同时接受文件路径（./mcp.json）和内联 JSON 字符串两种形式，后者适合一次性会话
搭配 --strict-mcp-config 使用可屏蔽 ~/.claude.json 和 .mcp.json 中的所有环境 MCP，获得完全可复现的工具边界
JSON 结构与 .mcp.json 完全相同：{"mcpServers":{"name":{"command":"...","args":[],"env":{}}}}，支持 stdio/http/sse/ws 四种 transport
可结合 MCP_TIMEOUT 环境变量控制服务器启动超时，例如 MCP_TIMEOUT=15000 claude --mcp-config ./mcp.json
在 shell 中传内联 JSON 时需注意单引号包裹整体、内部使用双引号，避免 shell 转义问题

常见坑

--strict-mcp-config 无法覆盖 ~/.claude.json 中的 disabledMcpServers 列表，已被禁用的服务器仍会被忽略（已知 bug，官方标记为 not planned）
内联 JSON 字符串在 shell 中若含特殊字符（如 $、!）需额外转义，否则解析失败且无错误提示
该 flag 为会话级一次性覆盖，不会写入任何配置文件，重启后失效，不能替代持久化配置

来源

创建于

v0.2.75

修复v2.1.206· 2026/07/10 · 23 小时前

修复了忽略 per-server request_timeout_ms 的问题

修复v2.1.85· 2026/03/27 · 2026/03/27

修复 Python Agent SDK 中 type:'sdk' MCP 服务器在启动时被丢弃

修复v2.1.83· 2026/03/25 · 2026/03/25

修复标志绕过 allowedMcpServers/deniedMcpServers 托管策略执行

修复v2.1.69· 2026/03/05 · 2026/03/05

修复了 `--mcp-config` 指向损坏文件时的 hang 问题。

修复v2.0.30· 2025/10/31 · 2025/10/31

修复了该参数无法正确覆盖基于文件的 MCP 配置的问题

新增v0.2.75· 2026/05/22 · 2026/05/22

新增 flag 用于运行 one-off MCP 服务器

变化时间线(按版本倒序)