本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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 身分驗證或開啟 （不需要身分驗證）。

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

遠端 MCP 伺服器是在您的代理程式組態檔案中，使用 `type`和 `url` 欄位進行設定：

```
{
  "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 伺服器

身分驗證完成後，即可使用伺服器的工具。