IDE 中 Q Developer 的 MCP 組態 - Amazon Q Developer

IDE 中 Q Developer 的 MCP 組態

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

存取 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/agents/default.json 中,且可在所有專案中使用。如果您選擇本機範圍,組態會儲存在目前專案內的 .aws/amazonq/agents/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/mcp.json 中,且可在所有專案中使用。如果您選擇本機範圍,組態會儲存在目前專案內的 .amazonq/mcp.json 中。

  4. 名稱欄位中,輸入 MCP 伺服器的名稱。

    例如,如果我們安裝 AWS 文件 MCP 伺服器,則名稱可能是 AWSDocMCPServer

  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. 您可以為每一項工具設定下列其中一種許可層級:

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

    • 一律允許:允許工具執行,而不提示。

    • 拒絕:不使用此工具。