IDE 中 Q 开发者版的 MCP 配置 - Amazon Q 开发者版
MCP IDE 配置文件访问用户界面添加 MCP 服务器MCP 配置故障排查启用 MCP 服务器禁用 MCP 服务器删除当前已启用的 MCP 服务器删除当前已禁用的 MCP 服务器查看和调整工具权限

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

IDE 中 Q 开发者版的 MCP 配置

本页面介绍用于配置 MCP 服务器的 IDE 专属选项。

在 IDE 中了解 Q 开发人员的 MCP 配置文件

在 IDE 中使用 GUI 向 Q Developer 添加 MCP 服务器时，配置存储在以下两个文件之一中：

  • 在全局范围内：~/。 aws/amazonq/default.json

  • 在本地范围：.amazonq/default.json

但是，由于传统原因，也可以将 MCP 配置信息放在另外两个位置：

  • 在全局范围内：~/。 aws/amazonq/mcp.json

  • 在本地范围：.amazonq/mcp.json

Q Developer 优先考虑 MCP 服务器的工作空间级别配置、其权限和存储的设置。

注意

如果您已经在 mcp.json 文件中设置了 MCP 配置，并且是首次使用 MCP 配置 GUI，则会在 GUI 中看到该配置。

全局默认.json 配置文件中的 Json 字段启用了对旧版 mcp. useLegacyMcp json 文件的支持。默认情况下，此字段设置为 true。有关更多信息，请参阅 Q Dev UseLegacyMcpJson eloper CLI 存储 GitHub 库中的字段。

请注意，Q CLI 也可以使用 mcp.json 文件。

有关如何在 MCP 工具上设置精细控制的信息，请参阅内置工具参考。

访问 MCP 配置用户界面

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

  1. 打开你的 IDE（VS Code JetBrains 等）。

  2. 打开 Q 开发者版面板。

  3. 打开聊天面板。

  4. 选择工具图标。 tools icon

添加 MCP 服务器

人工智能客户端和 MCP 服务器之间的通信主要有两种传输机制：STDIO 和 HTTP。

添加 HTTP 类型的 MCP 服务器

要在 IDE 中添加 HTTP 类型的 MCP 服务器，请执行以下操作：

  1. 访问 MCP 配置用户界面。

  2. 选择加号（+）图标。

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

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

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

  5. 选择 http 作为传输协议。

  6. 在 URL 字段中，输入 MCP 服务器初始化时将调用的 URL。

  7. 在标头 - 可选下，可输入需作为 HTTP 标头发送的键值对。

  8. 按需输入超时值。

  9. 选择保存。

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

  10. 按照查看和调整工具权限中的步骤操作。

注意

若 MCP 的 HTTP 端点需要授权，Amazon Q 将自动打开浏览器页面，以便您授权 Amazon Q 访问该 MCP 服务器。

添加 STDIO 类型的 MCP 服务器

要在 IDE 中添加 STDIO 类型的 MCP 服务器，请执行以下操作：

  1. 访问 MCP 配置用户界面。

  2. 选择加号（+）图标。

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

    如果选择全局范围，则 MCP 服务器配置存储在 ~/ 中。 aws/amazonq/default.json and available across all your projects. If you select local scope, the configuration is stored in .amazonq/default您当前项目中的.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。这是指向 PyPI（Python 包索引）上托管包的 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. 对于每个工具，可设置以下权限级别之一：

    • 询问：每次使用该工具时，均提示获取权限。

    • 始终允许：允许工具运行，无需提示。

    • 拒绝：不使用该工具。