本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# CLI 中的 MCP 配置
<a name="command-line-mcp-config-CLI"></a>

本页介绍用于配置 MCP 服务器的 CLI 特定选项。

## 配置命令
<a name="command-line-mcp-config-commands"></a>

使用方法：`qchat mcp [OPTIONS] COMMAND `


**MCP 配置命令**  

| 命令 | 描述 | 
| --- | --- | 
|  qchat mcp add  | 添加或替换已配置的服务器 | 
|  qchat mcp remove  | 从 MCP 配置中移除服务器 | 
|  qchat mcp list  | 列出配置的服务器 | 
|  qchat mcp import  | 从另一个文件导入服务器配置 | 
|  qchat mcp status  | 获取所配置的服务器的状态 | 
|  qchat mcp help  | 打印给定子命令的命令列表或帮助 | 

### MCP 服务器参数
<a name="command-line-mcp-enhanced-args"></a>

该`--args`参数现在支持使用转义或 JSON 数组格式的包含逗号的参数：

```
# Escaped commas
q mcp add --name server --command cmd --args "arg1,arg2\,with\,commas,arg3"

# JSON array format  
q mcp add --name server --command cmd --args '["arg1", "arg2,with,commas", "arg3"]'
```

## 远程 MCP 服务器
<a name="command-line-mcp-remote-servers"></a>

除了作为进程运行的本地 MCP 服务器外，Amazon Q Developer CLI 还支持通过 HTTP 进行通信的远程 MCP 服务器。远程服务器可以使用 OAuth 身份验证或处于开放状态（无需身份验证）。

### 配置
<a name="command-line-mcp-remote-config"></a>

在代理配置文件中使用`type`和`url`字段配置远程 MCP 服务器：

```
{
  "mcpServers": {
    "find-a-domain": {
      "type": "http",
      "url": "https://api.findadomain.dev/mcp"
    }
  }
}
```

### OAuth 身份验证流程
<a name="command-line-mcp-oauth-flow"></a>

使用需要 OAuth 身份验证的远程 MCP 服务器时：

1. 使用包含远程 MCP 服务器的代理启动 Q CLI 会话

1. 服务器最初将显示为 “尚未加载”

1. 使用`/mcp`命令开始身份验证

1. Q CLI 将指示服务器需要身份验证并提供 URL

1. 在浏览器中打开提供的 URL，同时保持 Q CLI 会话处于打开状态

1. 按照浏览器中的身份验证说明进行操作

1. 返回 Q CLI 窗口-如果身份验证成功，您将登录到 MCP 服务器

身份验证完成后，服务器的工具将变为可用。