View a markdown version of this page

配置 MCP 服务器 - Amazon Quick

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

配置 MCP 服务器

Amazon Quick 桌面应用程序支持模型上下文协议 (MCP),这是一种开放标准,通过自定义工具和集成扩展了 Quick 的功能。您可以连接 MCP 服务器,以便快速访问无法通过内置连接使用的数据库、内部 API、开发人员工具和其他系统。

什么是 MCP?

模型上下文协议 (MCP) 是一种允许 AI 助手与外部工具和数据源进行交互的协议。当您将 MCP 服务器连接到 Quick 时,该服务器提供的工具将在您的聊天对话和预定代理中可用。例如,您可以连接提供数据库查询工具的 MCP 服务器,然后让 Quick 直接在聊天中查询您的数据库。

访问 MCP 设置

要管理 MCP 服务器,请在边栏中打开 “设置”,选择 “功能”,然后选择 “MCP” 选项卡。

MCP 选项卡显示您连接的服务器,包括搜索栏、筛选器下拉列表以及网格或列表视图切换。您可以通过选择 + 添加 MCP 来添加新服务器。

添加 MCP 服务器

选择 + 添加 MCP 时,会出现一个对话框,其中包含三种连接类型:本地导入远程。选择与 MCP 服务器运行方式相匹配的连接类型。

本地

使用本地连接类型在计算机上将 MCP 服务器作为命令运行。对于开发工具和本地安装的服务器,这是最常见的选项。

下表描述了本地 MCP 连接的字段。

字段 必需 说明
名称 用于标识此 MCP 服务器的友好名称(例如,“我的数据库 MCP”)。
命令 要运行的可执行文件。常见值包括pythonnpxnode、和uvx
参数 命令行参数,用空格分隔(例如,-m mcp_server --port 8080)。
描述 对此 MCP 服务器的作用及其提供的工具的描述。这有助于快速了解何时使用服务器的工具。
环境变量 服务器所需的环境变量。选择 + 添加变量以添加键值对。
超时(秒) 等待服务器启动的最长时间,从 5 到 300 秒不等。默认值为 30 秒。
添加本地 MCP 服务器

使用以下流程。

  1. 在边栏中打开 “设置”,然后选择 “功能”。

  2. 选择 MCP 选项卡。

  3. 选择 + 添加 MCP

  4. 选择 “本地” 作为连接类型。

  5. 输入名称和要运行的命令(例如,python)。

  6. 输入命令所需的任何参数(例如,-m my_mcp_server)。

  7. 选择 + 添加 MCP 进行保存。

导入

使用 “导入” 连接类型从现有配置文件加载 MCP 服务器配置。如果您已经为其他工具配置了 MCP 服务器,并且想要在 Quick 中重复使用该配置,则此功能非常有用。

Quick 支持来自以下工具的配置文件。

  • Kiro

  • Claude Code

  • 瞄准

  • 反重力

  • QuickWork 出口

下表描述了 “导入 MCP” 连接的字段。

字段 必需 说明
Config 文件路径 计算机上配置文件的路径(例如,~/.kiro/settings/mcp.json)。

当您输入配置文件路径时,Quick 会自动扫描该文件并检测其中定义的 MCP 服务器。Quick 还会检测系统上安装的工具,并在此系统上的 “检测到” 下将其显示为芯片(例如 “Kiro”、“AIM”、“Claude Code”)。

从配置文件导入 MCP 服务器

使用以下流程。

  1. 在边栏中打开 “设置”,然后选择 “功能”。

  2. 选择 MCP 选项卡。

  3. 选择 + 添加 MCP

  4. 选择 “导入” 作为连接类型。

  5. 输入现有 MCP 配置文件的 Config 文件路径

  6. 查看检测到的服务器和系统工具。

  7. 选择 “加载文件” 以导入服务器。

远端

使用远程连接类型通过 HTTP 连接到在远程计算机或云服务上运行的 MCP 服务器。这对于共享团队服务器或托管的 MCP 服务非常有用。

下表描述了远程 MCP 连接的字段。

字段 必需 说明
名称 用于标识此 MCP 服务器的友好名称。
URL MCP 端点的网址(例如,https://mcp.example.com/sse)。
令牌 用于通过远程服务器进行身份验证的持有者令牌。
描述 对此 MCP 服务器的作用及其提供的工具的描述。
超时(秒) 等待服务器响应的最长时间,从 5 到 300 秒不等。默认值为 30 秒。
添加远程 MCP 服务器

使用以下流程。

  1. 在边栏中打开 “设置”,然后选择 “功能”。

  2. 选择 MCP 选项卡。

  3. 选择 + 添加 MCP

  4. 选择 “远程” 作为连接类型。

  5. 输入 MCP 端点的名称URL

  6. (可选)如果服务器需要身份验证,请输入令牌

  7. 选择 + 添加 MCP 进行保存。

管理 MCP 服务器

添加 MCP 服务器后,它们会出现在 MCP 选项卡上。您可以使用以下功能管理您的服务器。

  • 搜索-使用搜索栏按名称查找服务器。

  • 筛选器-使用下拉筛选器显示所有服务器或按状态筛选。

  • 视图切换-在网格视图和列表视图之间切换。

  • 切换 — 在不移除单个 MCP 服务器的情况下将其打开或关闭。

  • 编辑-修改服务器配置。

  • 删除-删除服务器连接。

编码代理

MCP 选项卡还包括 MCP 服务器下方的编码代理部分。编码代理使用代理客户端协议 (ACP) 将编码任务委托给本地编码代理,例如 Kiro 或 Claude Code。

添加编码代理

使用以下流程。

  1. 在边栏中打开 “设置”,然后选择 “功能”。

  2. 选择 MCP 选项卡。

  3. 在 “编码代理” 部分中,选择 + 添加代理

  4. 配置代理连接设置。

  5. 保存配置。

配置编码代理后,您可以通过聊天向其委派任务。例如,你可以说 “使用 Kiro 重构这个模块” 或 “让 Claude Code 为这个函数编写测试”。Quick 将工作分派给编码代理,并将结果报告给您。

在定期代理中使用 MCP 工具

您可以将 MCP 服务器作为功能附加到定时代理。创建或编辑定时代理时,可以选择该代理可以访问哪些 MCP 服务器。这样,您的自动代理就可以在按计划运行时使用自定义工具。

要将 MCP 功能附加到计划代理,请在 “设置” > “功能” > “计划任务” 中打开代理,选择该代理的功能选项卡,然后选择要提供的 MCP 服务器。

注意

当定时代理尝试使用其工具时,MCP 服务器必须处于运行状态并且可以访问。对于本地 MCP 服务器,服务器进程会在需要时自动启动。对于远程服务器,请验证服务器是否处于联机状态且可访问。