本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# IDE 中 Q 开发者版的 MCP 配置
本页介绍配置 MCP 服务器的 IDE-specific 选项。
## 在 IDE 中了解 Q 开发人员的 MCP 配置文件
在 IDE 中使用 GUI 向 Q Developer 添加 MCP 服务器时，配置存储在以下两个文件之一中：
+ 在全局范围内：\~/。 aws/amazonq/默认.json
+ 在本地范围:. amazonq/default.json
但是，由于传统原因，也可以将 MCP 配置信息放在另外两个位置：
+ 在全局范围内：\~/。 aws/amazonq/mcp.json
+ 在本地范围:. amazonq/mcp.json
Q Developer 优先考虑 MCP 服务器的工作空间级别配置、其权限和存储的设置。
**注意**
如果您已经在 mcp.json 文件中设置了 MCP 配置，并且是首次使用 MCP 配置 GUI，则会在 GUI 中看到该配置。
对旧版 mcp.json 文件的支持由全局默认.json 配置文件中的 use LegacyMcpJson 字段启用。默认情况下，此字段设置为 true。有关更多信息，请参阅 Q Dev [UseLegacyMcpJson eloper CLI 存储 GitHub 库中的字段](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#uselegacymcpjson-field)。
请注意，Q CLI 也可以使用 mcp.json 文件。
有关如何在 MCP 工具上设置精细控制的信息，请参阅[Built-in 工具](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#tools-field)参考。
## 访问 MCP 配置用户界面
要在 IDE 的 Q Developer 中访问 MCP 配置用户界面，请执行以下操作：
1. 打开你的 IDE（VS Code JetBrains 等）。
1. 打开 Q 开发者版面板。
1. 打开**聊天**面板。
1. 选择工具图标。
## 添加 MCP 服务器
人工智能客户端和 MCP 服务器之间的通信主要有两种传输机制：STDIO 和 HTTP。
### 添加 HTTP 类型的 MCP 服务器
要在 IDE 中添加 HTTP 类型的 MCP 服务器，请执行以下操作：
1. [访问 MCP 配置用户界面](#mcp-ide-configuration-access-ui)。
1. 选择加号（\+）图标。
1. 选择范围：全局或本地。
如果选择全局范围，则 MCP 服务器配置存储在 \~/ 中。 aws/amazonq/default.json 并且适用于您的所有项目。如果选择本地范围，则配置将存储在中。 amazonq/default您当前项目中的.json。
1. 在**名称**字段中，输入 MCP 服务器的名称。
1. 选择 `http` 作为传输协议。
1. 在 **URL** 字段中，输入 MCP 服务器初始化时将调用的 URL。
1. 在**标头 - 可选**下，可输入需作为 HTTP 标头发送的键值对。
1. 按需输入**超时**值。
1. 选择**保存**。
配置面板将替换为工具权限面板。
1. 按照[查看和调整工具权限](#mcp-ide-configuration-review-adjust-tool)中的步骤操作。
**注意**
若 MCP 的 HTTP 端点需要授权，Amazon Q 将自动打开浏览器页面，以便您授权 Amazon Q 访问该 MCP 服务器。
### 添加 STDIO 类型的 MCP 服务器
要在 IDE 中添加 STDIO 类型的 MCP 服务器，请执行以下操作：
1. [访问 MCP 配置用户界面](#mcp-ide-configuration-access-ui)。
1. 选择加号（\+）图标。
1. 选择范围：全局或本地。
如果选择全局范围，则 MCP 服务器配置存储在 \~/ 中。 aws/amazonq/default.json 并且适用于您的所有项目。如果选择本地范围，则配置将存储在中。 amazonq/default您当前项目中的.json。
1. 在**名称**字段中，输入 MCP 服务器的名称。
例如，如果我们要安装[AWS 文档 MCP 服务器](https://awslabs.github.io/mcp/servers/aws-documentation-mcp-server/)，则名称可能是。{{AWS DocMCPServer}}
1. 选择 `stdio` 作为传输协议。
1. 在**命令**字段中，输入 MCP 服务器初始化时将运行的 shell 命令。
对于 AWS 文档 MCP 服务器，命令为`uvx`。此为 `uv tool run` 的别名，用于创建临时 Python 环境。
1. 在**参数**字段中，按需输入要转递给 shell 命令的参数。
对于 AWS 文档 MCP 服务器，参数是{{awslabs.aws-documentation-mcp-server@latest}}。这是指向 PyPI（Python 包索引）上托管包的 Python 包标识符。
按需添加更多参数。
1. 按需填写环境变量。
在我们的示例中，我们首先填写 “名称:” {{FASTMCP\_LOG\_LEVEL}} 和 “值:” {{ERROR}}。
我们还将使用名称{{AWS\_DOCUMENTATION\_PARTITION}}和值{{aws}}来表示我们将要使用的[分区](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/partitions.html)。
1. 按需输入**超时**值。
本示例中，保留建议值 60（秒）即可。
1. 选择**保存**。
配置面板将替换为工具权限面板。
1. 按照[查看和调整工具权限](#mcp-ide-configuration-review-adjust-tool)中的步骤操作。
## MCP 配置故障排查
在 IDE 中添加 MCP 服务器后，Amazon Q 将尝试与其建立连接。
若存在连接问题，面板顶部将显示警报。在警报解决前，该 MCP 服务器中的工具可能无法正常运行。
选择**修复配置**，返回 MCP 配置界面进行相应修改。
## 启用 MCP 服务器
以下步骤假设待启用的 MCP 服务器当前处于未启用状态。
要在 IDE 中启用 MCP 服务器，请执行以下操作：
1. 打开 MCP 服务器面板。
1. 在待启用的服务器旁，选择**启用**。
## 禁用 MCP 服务器
要在 IDE 中禁用 MCP 服务器，请执行以下操作：
1. 打开 MCP 服务器面板。
1. 选择待禁用的服务器。
1. 选择**编辑设置**旁边的三个点。
1. 选择**禁用 MCP 服务器**。
## 删除当前已启用的 MCP 服务器
要从 IDE 中删除当前已启用的 MCP 服务器，请执行以下操作：
1. 打开 MCP 服务器面板。
1. 选择待删除的服务器。
将打开显示该服务器详情的面板。
1. 选择**编辑设置**旁边的三个点。
1. 选择**删除 MCP 服务器**。
1. 出现提示时，确认删除操作。
## 删除当前已禁用的 MCP 服务器
要从 IDE 中删除当前已禁用的 MCP 服务器，请执行以下操作：
1. 打开 MCP 服务器面板。
1. 在待删除的服务器旁，选择**删除**。
1. 出现提示时，确认删除操作。
## 查看和调整工具权限
要查看和调整工具权限，请执行以下操作：
1. 打开 MCP 服务器面板。
1. 选择需查看和调整权限的 MCP 服务器。
1. 对于每个工具，可设置以下权限级别之一：
+ 询问：每次使用该工具时，均提示获取权限。
+ 始终允许：允许工具运行，无需提示。
+ 拒绝：不使用该工具。