IDE 中 Q Developer 的 MCP 組態 - Amazon Q Developer
MCP IDE 組態檔案存取 UI新增 MCP 伺服器對 MCP 組態進行故障診斷啟用 MCP 伺服器停用 MCP 伺服器刪除目前啟用的 MCP 伺服器刪除目前停用的 MCP 伺服器檢閱和調整工具許可

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

IDE 中 Q Developer 的 MCP 組態

此頁面涵蓋設定 MCP 伺服器的 IDE 特定選項。

了解 IDE 中 Q 開發人員的 MCP 組態檔案

當您使用 GUI 將 MCP 伺服器新增至 IDE 中的 Q 開發人員時，組態會存放在兩個檔案中的其中一個：

  • 全域範圍：~/.aws/amazonq/default.json

  • 在本機範圍內：.amazonq/default.json

不過，基於傳統原因，也可以將 MCP 組態資訊放在其他兩個位置：

  • 在全球範圍內：~/.aws/amazonq/mcp.json

  • 在本機範圍內：.amazonq/mcp.json

Q 開發人員優先考慮 MCP 伺服器的工作區層級組態、其許可和儲存的設定。

注意

如果您已在 mcp.json 檔案中設定 MCP 組態，而且您第一次使用 MCP 組態 GUI，您會在 GUI 中看到該組態。

全域 default.json 組態檔案中的 useLegacyMcpJson 欄位會啟用舊版 mcp.json 檔案的支援。根據預設，此欄位會設為 true。如需詳細資訊，請參閱 Q Developer CLI GitHub 儲存庫中的 UseLegacyMcpJson 欄位。

請注意，Q CLI 也可以使用 mcp.json 檔案。

如需如何在 MCP 工具上設定精細控制項的詳細資訊，請參閱內建工具參考。

存取 MCP 組態 UI

若要在 IDE 的 Q Developer 中存取 MCP 組態 UI：

  1. 開啟您的 IDE (VS Code、JetBrains 等)。

  2. 開啟 Q Developer 面板。

  3. 開啟聊天面板。

  4. 選擇工具圖示。 tools icon

新增 MCP 伺服器

AI 用戶端與 MCP 伺服器之間可透過兩種主要傳輸機制進行通訊：STDIO 和 HTTP。

新增 HTTP MCP 伺服器

若要將 HTTP MCP 伺服器新增至 IDE：

  1. 存取 MCP 組態 UI。

  2. 選擇加號 (+) 符號。

  3. 選取範圍：全域或本機。

    如果您選擇全域範圍，MCP 伺服器組態會存放在 ~/.aws/amazonq/default.json 中，並可在所有專案中使用。如果您選擇本機範圍，組態會存放在目前專案中的 .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 伺服器

若要將 STDIO MCP 伺服器新增至 IDE：

  1. 存取 MCP 組態 UI。

  2. 選擇加號 (+) 符號。

  3. 選取範圍：全域或本機。

    如果您選擇全域範圍，MCP 伺服器組態會存放在 ~/.aws/amazonq/default.json 中，並可在所有專案中使用。如果您選擇本機範圍，組態會存放在目前專案中的 .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。這是 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. 您可以為每一項工具設定下列其中一種許可層級：

    • 詢問：每次使用工具時提示許可。

    • 一律允許：允許工具執行，而不提示。

    • 拒絕：不使用此工具。