CLI 中的 MCP 組態 - Amazon Q Developer
組態命令遠端 MCP 伺服器

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

CLI 中的 MCP 組態

此頁面涵蓋設定 MCP 伺服器的 CLI 特定選項。

組態命令

用途: 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 伺服器引數

--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 伺服器

除了做為程序執行的本機 MCP 伺服器之外，Amazon Q Developer CLI 還支援透過 HTTP 通訊的遠端 MCP 伺服器。遠端伺服器可以使用 OAuth 身分驗證或開啟 （不需要身分驗證）。

Configuration

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

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

OAuth 身分驗證流程

使用需要 OAuth 身分驗證的遠端 MCP 伺服器時：

  1. 使用包含遠端 MCP 伺服器的代理程式啟動您的 Q CLI 工作階段

  2. 伺服器一開始會顯示為「尚未載入」

  3. 使用 /mcp命令開始身分驗證

  4. Q CLI 會指出伺服器需要身分驗證並提供 URL

  5. 在瀏覽器中開啟提供的 URL，同時保持 Q CLI 工作階段開啟

  6. 遵循瀏覽器中的身分驗證指示

  7. 返回 Q CLI 視窗 - 如果身分驗證成功，您將會登入 MCP 伺服器

一旦身分驗證完成，伺服器的工具就會變成可用。