本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
在 IDE 中为 Q Developer 进行的 MCP 配置
本页介绍用于配置 MCP 服务器的 IDE 特定选项。有关 MCP 配置的一般信息,请参阅了解 MCP 配置。
访问 MCP 配置用户界面
下图显示了用于在 IDE 中为 Q Developer 配置 MCP 服务器的 GUI。

要在 IDE 的 Q Developer 中访问 MCP 配置用户界面,请执行以下操作:
-
打开你的 IDE(VS Code JetBrains 等)。
-
打开 Q 开发者面板。
-
打开 “聊天” 面板。
-
选择工具图标。
添加 MCP 服务器
要向 IDE 中添加 MCP 服务器,请执行以下操作:
-
选择加号 (+)。
-
选择范围:全局或本地。
如果选择全局范围,则 MCP 服务器配置存储在 ~/ 中。 aws/amazonq/mcp.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/mcp您当前项目中的.json。
-
在 “名称” 字段中,输入 MCP 服务器的名称。
例如,如果我们要安装AWS 文档 MCP 服务器
,则名称可能是。 AWS DocMCPServer
-
选择传输协议。
目前仅支持
stdio
。 -
在 “命令” 字段中,输入 MCP 服务器在初始化时将运行的 shell 命令。
对于 AWS 文档 MCP 服务器,命令为
uvx
。这是的别名uv tool run
,它创建了一个短暂的 Python 环境。 -
在 “参数” 字段中,输入要提供给 shell 命令的参数(如果适用)。
对于 AWS 文档 MCP 服务器,参数是
awslabs.aws-documentation-mcp-server@latest
。这是一个 Python 包标识符,指向 PyPI 上托管的包(Python 包索引)。根据需要添加更多参数。
-
根据需要填写环境变量。
在我们的示例中,我们首先填写 “名称:”
FASTMCP_LOG_LEVEL
和 “值:”ERROR
。我们还将使用名称
AWS_DOCUMENTATION_PARTITION
和值aws
来表示我们要使用的分区。 -
输入超时值(如果适用)。
在我们的示例中,我们将保留建议值 60(秒)。
-
选择保存。
配置面板将替换为工具权限面板。
-
按照以下步骤操作查看和调整工具权限。
对 MCP 配置进行故障排除
在 IDE 中添加 MCP 服务器后,Amazon Q 将尝试连接到该服务器。
如果出现连接问题,则会在面板顶部显示警报。在警报得到解决之前,您不应指望来自该 MCP 服务器的工具能够正常运行。
选择 “修复配置” 返回 MCP 配置屏幕,以便您可以进行相应的更改。
启用 MCP 服务器
以下过程假设相关的 MCP 服务器尚未启用。
要在 IDE 中启用 MCP 服务器,请执行以下操作:
-
打开 MCP 服务器面板。
-
在要启用的服务器旁边,选择启用。
禁用 MCP 服务器
要在 IDE 中禁用 MCP 服务器,请执行以下操作:
-
打开 MCP 服务器面板。
-
选择要禁用的服务器。
-
选择 “编辑设置” 旁边的三个点。
-
选择 “禁用 MCP 服务器”。
删除当前启用的 MCP 服务器
要从 IDE 中删除当前已启用的 MCP 服务器,请执行以下操作:
-
打开 MCP 服务器面板。
-
选择要删除的服务器。
将打开一个面板,其中包含有关该服务器的详细信息。
-
选择 “编辑设置” 旁边的三个点。
-
选择删除 MCP 服务器。
-
出现提示时确认删除。
删除当前已禁用的 MCP 服务器
要从 IDE 中删除当前已禁用的 MCP 服务器,请执行以下操作:
-
打开 MCP 服务器面板。
-
在要删除的服务器旁边,选择删除。
-
出现提示时确认删除。
查看和调整工具权限
要查看和调整工具权限,请执行以下操作:
-
打开 MCP 服务器面板。
-
选择要查看和调整权限的 MCP 服务器。
-
对于每个工具,您可以设置以下权限级别之一:
-
询问:每次使用该工具时都会提示您获得许可。
-
始终允许:允许工具在不提示的情况下运行。
-
拒绝:请勿使用此工具。
-
-
选择 “保存” 或 “应用” 以更新权限设置。