

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

# 配置 MCP 服务器
<a name="mcp-servers-desktop"></a>

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

## 什么是 MCP？
<a name="mcp-what-is"></a>

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

## 访问 MCP 设置
<a name="mcp-accessing-settings"></a>

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

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

## 添加 MCP 服务器
<a name="mcp-adding-server"></a>

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

### 本地
<a name="mcp-local"></a>

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

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


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

**添加本地 MCP 服务器**  
使用以下流程。

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

1. 选择 **MCP** 选项卡。

1. 选择 **\+ 添加 MCP**。

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

1. 输入**名称**和要运行的**命令**（例如，`python`）。

1. 输入命令所需的任何**参数**（例如，`-m my_mcp_server`）。

1. 选择 **\+ 添加 MCP** 进行保存。

### 导入
<a name="mcp-import"></a>

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

Quick 支持来自以下工具的配置文件。
+ Kiro
+ Claude Code
+ 瞄准
+ 反重力
+ QuickWork 出口

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


| 字段 | 必需 | 说明 | 
| --- | --- | --- | 
| Config 文件路径 | 是 | 计算机上配置文件的路径（例如，\~/.kiro/settings/mcp.json）。 | 

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

**从配置文件导入 MCP 服务器**  
使用以下流程。

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

1. 选择 **MCP** 选项卡。

1. 选择 **\+ 添加 MCP**。

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

1. 输入现有 MCP **配置文件的 Config 文件路径**。

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

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

### 远端
<a name="mcp-remote"></a>

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

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


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

**添加远程 MCP 服务器**  
使用以下流程。

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

1. 选择 **MCP** 选项卡。

1. 选择 **\+ 添加 MCP**。

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

1. 输入 MCP 端点的**名称**和 **URL**。

1. （可选）如果服务器需要身份验证，请输入**令牌**。

1. 选择 **\+ 添加 MCP** 进行保存。

## 管理 MCP 服务器
<a name="mcp-managing-servers"></a>

添加 MCP 服务器后，它们会出现在 MCP 选项卡上。您可以使用以下功能管理您的服务器。
+ **搜索**-使用搜索栏按名称查找服务器。
+ **筛选器**-使用下拉筛选器显示所有服务器或按状态筛选。
+ **视图切换**-在网格视图和列表视图之间切换。
+ **切换** — 在不移除单个 MCP 服务器的情况下将其打开或关闭。
+ **编辑**-修改服务器配置。
+ **删除**-删除服务器连接。

## 编码代理
<a name="mcp-coding-agents"></a>

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

**添加编码代理**  
使用以下流程。

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

1. 选择 **MCP** 选项卡。

1. 在 “**编码代理**” 部分中，选择 **\+ 添加代理**。

1. 配置代理连接设置。

1. 保存配置。

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

## 在定期代理中使用 MCP 工具
<a name="mcp-scheduled-agents"></a>

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

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

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