Claude Code格式

除码道CLI原生配置格式外，码道CLI还兼容Claude Code的MCP配置格式。如果您已有Claude Code的MCP配置文件，可直接在码道CLI中使用，无需重新编写。两种格式功能等价，选择任一即可。

默认的MCP配置支持项目级配置，配置路径如表1 MCP可配置路径表所示。

表1 MCP可配置路径表
级别	作用范围	配置路径
项目级	仅当前项目	项目根目录/.codeartsdoer/mcp/mcp_settings.json

本地MCP

采用stdio传输模式，以拉起本地进程的方式对接MCP服务端。

参数配置

表2 本地MCP配置选项表
参数名称	参数类型	说明
command	字符串	必填，启动MCP服务器进程的命令，如npx、uvx、node、python
args	字符串数组	启动命令的参数列表
env	对象	环境变量，用于传递API密钥等配置
disabled	布尔值	控制MCP服务器启用状态
timeout	数值	连接超时时间，单位毫秒

配置示例

本文以Windows系统为例，演示本地MCP服务器的配置方法。

在“D:/tmp/test_hc_cli/.codeartsdoer/”路径下，创建路径文件“mcp/mcp_settings.json”，写入如下配置并重启码道CLI：

{
  "mcpServers": {
       "git-mcp-server": {
      "transportType": "stdio",
      "disabled": false,
      "timeout": 100000,
      "args": [
        "@cyanheads/git-mcp-server"
      ],
      "command": "npx",
      "env": {
        "GIT_SIGN_COMMITS": "false",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

输入如下命令，查看此配置是否生效。
```
/mcps
```
如下图所示，MCP服务器“git-mcp-server”的状态为“Enabled”，表示此MCP服务器已启用。

图1 启用状态
在TUI对话框发送如下指令：
```
git-mcp-server能做什么？
```
如下图所示，返回功能介绍和使用方法，表示此本地MCP服务器配置已生效。

图2 配置生效

远程MCP

采用StreamableHttp传输模式，经由HTTP协议对接远程MCP服务端。

参数配置

表3 远程MCP配置选项表
参数名称	参数类型	说明
url	字符串	必填，MCP服务器的HTTP地址
headers	对象	HTTP请求头，用于认证
disabled	布尔值	控制MCP服务器启用状态
timeout	数值	连接超时时间，单位毫秒
autoApprove	字符串数组	自动批准的工具列表

配置示例

本示例以Windows系统为例。

在“D:/tmp/test_hc_cli/.codeartsdoer/”路径下，创建路径文件“mcp/mcp_settings.json”，写入如下配置并重启码道CLI：
```
{
  "mcpServers": {
    "socket-mcp": {
      "url": "https://mcp.socket.dev/",
      "headers": {
        "Content-Type": "application/json"
      },
      "timeout": 30000,
      "disabled": false
    }
  }
}
```
该MCP服务器是一个依赖项扫描服务，用于评估软件包的质量和安全性。
输入如下命令，查看此配置是否生效。
```
/mcps
```
如下图所示，MCP服务器“socket-mcp”的状态为“Enabled”，表示此MCP服务器已启用。

图3 启用状态
在TUI对话框输入如下指令并回车：
```
检查express版本4.18.2的安全评分
```
如下图所示，返回安全评分结果，表示此远程MCP服务器配置已生效。