CLI 中的 MCP 配置 - Amazon Q 开发者版
配置命令远程 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 身份验证或处于开放状态（无需身份验证）。

配置

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

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

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