MCP命令

codearts mcp add

执行该命令可新增一个MCP服务器。

本示例以Windows系统的项目级配置为例：

1. 进入“D:/tmp/test_hc_cli”鼠标右键，选择“在终端中打开”，在打开的PowerShell界面上输入如下命令，根据提示进行选择。

   codearts mcp add

2. 按提示配置“Location”参数，本示例选择“Location”。
   图1 配置“Location”参数
   
   Location参数的填写指导请参考表1。

   表1 “Location”参数

   参数	解释
   Current project	将MCP配置到当前项目下：项目根目录/.codeartsdoer/codearts_cli.jsonc
   Global	将MCP配置到用户路径下：~/.codeartsdoer/codearts_cli.jsonc

3. 如下图所示，继续根据提示配置参数“Enter MCP server name”、“Select MCP server type”、“Enter command to run”。
   图2 配置示例
   

4. 各参数的配置详情请参考表2。

   表2 其他MCP服务器配置参数

   参数	解释
   Enter MCP server name	输入自定义的MCP服务器名称
   Select MCP server type	选择MCP服务器的运行模式： Local，表示这个服务器通过本地执行一条命令启动，例如（npx、uvx或者python等），通信方式是stdio Remote，表示配置远程MCP服务器，后续需要输入服务器的URL，码道CLI将通过网络（HTTP/SSE）连接
   Enter command to run	运行此MCP服务器的命令

5. 如果您需要确认当前配置的MCP服务器是否可用，请执行codearts mcp list查看。

codearts mcp list

执行该命令将列出所有已配置的MCP服务器及其连接状态。

例如，执行如下命令，查看项目目录“D:/tmp/test_hc_cli”下已配置的MCP服务器及其连接状态。

codearts mcp ls

例如下图所示，当前目录下共4个MCP服务器，各MCP服务器状态为：git-mcp-server、sentry、mcp-character-tools已连接，composio待认证

图3 查询示例

MCP服务器的状态解释，请参考下表：

codearts mcp auth list

执行该命令，将列出支持认证的MCP服务器及其认证状态。

codearts mcp auth ls

例如下图所示，查询到当前项目下有2个MCP服务器待验证。

图4 待认证的服务器

codearts mcp auth [name]

执行该命令，可对MCP服务器进行认证。

示例如下：

1. 执行如下命令，将列出没有认证过的MCP服务器，请根据回显选择需要认证的MCP服务器，回车即可启动认证。

   codearts mcp auth

   例如下图所示，查询到当前项目下有2个MCP服务器待验证，选择需要认证的MCP服务器，回车即可启动认证。

   图5 待验证的MCP服务器
   

   您可参考如下示例配置进行认证：

   "mcp": {
       "sentry": {
         "type": "remote",
         "url": "https://mcp.sentry.dev/mcp",
         "oauth": {}
       }
     }

2. 配置完成后，执行如下如下命令，可打开浏览器窗口完成认证，将码道CLI连接到你的Sentry账户，命令中的“sentry”为上述步骤中配置的MCP名称。
   认证完成后，“~/.codeartsdoer/cli-data/mcp-auth.json”文件会增加Sentry配置。

   codearts mcp auth sentry

   如下图所示，完成Sentry账户认证。用户可以继续在CLI开发模式下使用Sentry工具继续会话。

   图6 Sentry账户认证
   

3. 授权成功后，再次执行codearts mcp auth ls，可以查看“sentry”已经被授权。
   图7 授权成功
   

codearts mcp logout [name]

执行该命令，将移除MCP服务器的认证凭据。

例如，进入项目目录“D:/tmp/test_hc_cli”，执行如下命令，将移除该项目下的认证凭据。

此时，“~/.codeartsdoer/cli-data/mcp-auth.json”文件中对应的MCP配置被删除。

图8 删除认证凭据

codearts mcp debug <name>

执行该命令，将显示认证信息和连接测试结果。

示例：

下图表示调试logout的MCP服务器。

图9 调试图

下图表示调试OAuth认证成功的MCP服务器。