IDE 中 Q 開發人員的 MCP 組態 - Amazon Q Developer

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

IDE 中 Q 開發人員的 MCP 組態

此頁面涵蓋設定 MCP 伺服器的 IDE 特定選項。如需 MCP 組態的一般資訊,請參閱了解 MCP 組態

存取 MCP 組態 UI

下圖顯示用於在 IDE 中為 Q 開發人員設定 MCP 伺服器的 GUI。

具有 MCP 組態主要元素欄位的 GUI。

若要在 IDE 的 Q 開發人員中存取 MCP 組態 UI:

  1. 開啟您的 IDE (VS 程式碼、JetBrains 等)。

  2. 開啟 Q 開發人員面板。

  3. 開啟聊天面板。

  4. 選擇工具圖示。 tools icon

新增 MCP 伺服器

若要將 MCP 伺服器新增至 IDE:

  1. 存取 MCP 組態 UI

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

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

    如果您選擇全域範圍,MCP 伺服器組態會存放在 ~/.aws/amazonq/mcp.json 中,並可在所有專案中使用。如果您選取本機範圍,組態會儲存在目前專案中的 .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. 選擇儲存套用以更新許可設定。