# MCP命令
**codearts mcp**命令用于管理MCP服务器，支持添加、列出、认证和调试MCP服务器。
#### codearts mcp add
执行该命令可新增一个MCP服务器。
本示例以Windows系统的项目级配置为例：
1. 进入"D:/tmp/test_hc_cli"鼠标右键，选择"在终端中打开"，在打开的PowerShell界面上输入如下命令，根据提示进行选择。 
   ```
   codearts mcp add
   ```
   
   
2. 按提示配置"Location"参数，本示例选择"Location"。 
   图1配置"Location"参数   
   ![](https://support.huaweicloud.com/usermanual-cli/zh-cn_image_0000002616115171.png "点击放大")
   Location参数的填写指导请参考[表1]。
    表1Location参数说明 
   | 参数              | 解释                                                  |
   |:---|:---|
   | 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配置示例   
   ![](https://support.huaweicloud.com/usermanual-cli/zh-cn_image_0000002585680710.png "点击放大")
   各参数的配置详情请参考[表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服务器的命令                                                                                                                                                                                                                                                                                                                                                                                        |
      
   
   
4. 如果您需要确认当前配置的MCP服务器是否可用，请执行[codearts mcp list]查看。
 
 #### codearts mcp list
执行该命令将列出所有已配置的MCP服务器及其连接状态。
例如，执行如下命令，查看项目目录"D:/tmp/test_hc_cli"下已配置的MCP服务器及其连接状态。
```
codearts mcp list
```
当前目录下共4个MCP服务器，各MCP服务器状态为：git-mcp-server、sentry、mcp-character-tools已连接，composio待认证。
图3查询示例   
![](https://support.huaweicloud.com/usermanual-cli/zh-cn_image_0000002585654614.png "点击放大")
MCP服务器的状态解释，请参考下表：
表3MCP服务器状态 
| 图标 | 状态        |
|:---|:---|
| ✓  | 已连接       |
| ⚠  | 待认证       |
| ○  | 未初始化或者已禁用 |
| ✗  | 失败        |
   
#### codearts mcp auth list
执行该命令，将列出支持认证的MCP服务器及其认证状态。
例如，在项目目录"D:/tmp/test_hc_cli"执行该命令，将列出该目录下支持认证的MCP服务器及状态。
```
codearts mcp auth list
```
例如下图所示，查询到当前项目下有2个MCP服务器待验证。
图4待认证的服务器   
![](https://support.huaweicloud.com/usermanual-cli/zh-cn_image_0000002585696222.png "点击放大")
#### codearts mcp auth \[name\]
执行该命令，可对MCP服务器进行认证。
1. 执行如下命令，将列出没有认证过的MCP服务器，请根据回显选择需要认证的MCP服务器，回车即可启动认证。 
   ```
   codearts mcp auth
   ```
   例如下图所示，查询到当前项目下有2个MCP服务器待验证，选择需要认证的MCP服务器，回车即可启动认证。
   图5待验证的MCP服务器   
   ![](https://support.huaweicloud.com/usermanual-cli/zh-cn_image_0000002585528808.png "点击放大")
   您可参考如下示例配置进行认证：
   ```
   "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账户认证。
   图6Sentry账户认证   
   ![](https://support.huaweicloud.com/usermanual-cli/zh-cn_image_0000002585856688.png "点击放大")
   
   
3. 授权成功后，再次执行**codearts mcp auth ls** ，可以查看"sentry"已经被授权。
   
   图7授权成功   
   ![](https://support.huaweicloud.com/usermanual-cli/zh-cn_image_0000002616216381.png "点击放大")
   
   
 
#### codearts mcp logout \[name\]
执行该命令，将移除MCP服务器的认证凭据。
例如，进入项目目录"D:/tmp/test_hc_cli"，执行如下命令，将移除该项目下的认证凭据。
此时，"\~/.codeartsdoer/cli-data/mcp-auth.json"文件中对应的MCP配置被删除。
图8删除认证凭据   
![](https://support.huaweicloud.com/usermanual-cli/zh-cn_image_0000002616095537.png)
#### codearts mcp debug \<name\>
执行该命令，将显示认证信息和连接测试结果。
示例：
图示为调试OAuth登出的MCP服务器。
图9调试图   
![](https://support.huaweicloud.com/usermanual-cli/zh-cn_image_0000002585657324.png "点击放大")
图示为调试OAuth授权成功的MCP服务器。
图10调试图   
![](https://support.huaweicloud.com/usermanual-cli/zh-cn_image_0000002616216109.png "点击放大")