在 IDE 中为 Q Developer 进行的 MCP 配置 - Amazon Q 开发者版

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

在 IDE 中为 Q Developer 进行的 MCP 配置

本页介绍用于配置 MCP 服务器的 IDE 特定选项。有关 MCP 配置的一般信息,请参阅了解 MCP 配置。

访问 MCP 配置用户界面

下图显示了用于在 IDE 中为 Q Developer 配置 MCP 服务器的 GUI。

一个 GUI,其中包含用于 MCP 配置的主要元素的字段。

要在 IDE 的 Q Developer 中访问 MCP 配置用户界面,请执行以下操作:

  1. 打开你的 IDE(VS Code JetBrains 等)。

  2. 打开 Q 开发者面板。

  3. 打开 “聊天” 面板。

  4. 选择工具图标。 tools icon

添加 MCP 服务器

要向 IDE 中添加 MCP 服务器,请执行以下操作:

  1. 访问 MCP 配置用户界面

  2. 选择加号 (+)。

  3. 选择范围:全局或本地。

    如果选择全局范围,则 MCP 服务器配置存储在 ~/ 中。 aws/amazonq/mcp.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/mcp您当前项目中的.json。

  4. 在 “名称” 字段中,输入 MCP 服务器的名称。

    例如,如果我们要安装AWS 文档 MCP 服务器,则名称可能是。AWS DocMCPServer

  5. 选择传输协议。

    目前仅支持 stdio

  6. 在 “命令” 字段中,输入 MCP 服务器在初始化时将运行的 shell 命令。

    对于 AWS 文档 MCP 服务器,命令为uvx。这是的别名uv tool run,它创建了一个短暂的 Python 环境。

  7. 在 “参数” 字段中,输入要提供给 shell 命令的参数(如果适用)。

    对于 AWS 文档 MCP 服务器,参数是awslabs.aws-documentation-mcp-server@latest。这是一个 Python 包标识符,指向 PyPI 上托管的包(Python 包索引)。

    根据需要添加更多参数。

  8. 根据需要填写环境变量。

    在我们的示例中,我们首先填写 “名称:” FASTMCP_LOG_LEVEL 和 “值:” ERROR

    我们还将使用名称AWS_DOCUMENTATION_PARTITION和值aws来表示我们要使用的分区

  9. 输入时值(如果适用)。

    在我们的示例中,我们将保留建议值 60(秒)。

  10. 选择保存

    配置面板将替换为工具权限面板。

  11. 按照以下步骤操作查看和调整工具权限

对 MCP 配置进行故障排除

在 IDE 中添加 MCP 服务器后,Amazon Q 将尝试连接到该服务器。

如果出现连接问题,则会在面板顶部显示警报。在警报得到解决之前,您不应指望来自该 MCP 服务器的工具能够正常运行。

选择 “修复配置” 返回 MCP 配置屏幕,以便您可以进行相应的更改。

启用 MCP 服务器

以下过程假设相关的 MCP 服务器尚未启用。

要在 IDE 中启用 MCP 服务器,请执行以下操作:

  1. 打开 MCP 服务器面板。

  2. 在要启用的服务器旁边,选择启用

禁用 MCP 服务器

要在 IDE 中禁用 MCP 服务器,请执行以下操作:

  1. 打开 MCP 服务器面板。

  2. 选择要禁用的服务器。

  3. 选择 “编辑设置” 旁边的三个点。

  4. 选择 “禁用 MCP 服务器”。

删除当前启用的 MCP 服务器

要从 IDE 中删除当前已启用的 MCP 服务器,请执行以下操作:

  1. 打开 MCP 服务器面板。

  2. 选择要删除的服务器。

    将打开一个面板,其中包含有关该服务器的详细信息。

  3. 选择 “编辑设置” 旁边的三个点。

  4. 选择删除 MCP 服务器。

  5. 出现提示时确认删除。

删除当前已禁用的 MCP 服务器

要从 IDE 中删除当前已禁用的 MCP 服务器,请执行以下操作:

  1. 打开 MCP 服务器面板。

  2. 在要删除的服务器旁边,选择删除

  3. 出现提示时确认删除。

查看和调整工具权限

要查看和调整工具权限,请执行以下操作:

  1. 打开 MCP 服务器面板。

  2. 选择要查看和调整权限的 MCP 服务器。

  3. 对于每个工具,您可以设置以下权限级别之一:

    • 询问:每次使用该工具时都会提示您获得许可。

    • 始终允许:允许工具在不提示的情况下运行。

    • 拒绝:请勿使用此工具。

  4. 选择 “保存” 或 “应用” 以更新权限设置。