IDE 中 Q Developer 的 MCP 組態
此頁面涵蓋設定 MCP 伺服器的 IDE 特定選項。
存取 MCP 組態 UI
若要在 IDE 的 Q Developer 中存取 MCP 組態 UI:
-
開啟您的 IDE (VS Code、JetBrains 等)。
-
開啟 Q Developer 面板。
-
開啟聊天面板。
-
選擇工具圖示。
新增 MCP 伺服器
AI 用戶端與 MCP 伺服器之間可透過兩種主要傳輸機制進行通訊:STDIO 和 HTTP。
新增 HTTP MCP 伺服器
若要將 HTTP MCP 伺服器新增至 IDE:
-
選擇加號 (+) 符號。
-
選取範圍:全域或本機。
如果您選擇全域範圍,MCP 伺服器組態會儲存在 ~/.aws/amazonq/agents/default.json 中,且可在所有專案中使用。如果您選擇本機範圍,組態會儲存在目前專案內的 .aws/amazonq/agents/default.json 中。
-
在名稱欄位中,輸入 MCP 伺服器的名稱。
-
選取
http作為傳輸通訊協定。 -
在 URL 欄位中,輸入 MCP 伺服器初始化時將呼叫的 URL。
-
在標頭 - 選用下,您可以輸入必須作為 HTTP 請求標頭傳送的鍵值對。
-
輸入逾時值 (如適用)。
-
選擇儲存。
組態面板將會取代為工具許可面板。
-
請遵循 檢閱和調整工具許可 下的程序。
注意
如果 MCP HTTP 端點需要授權,Amazon Q 將自動開啟瀏覽器頁面,讓您能夠授權 Amazon Q 存取 MCP 伺服器。
新增 STDIO MCP 伺服器
若要將 STDIO MCP 伺服器新增至 IDE:
-
選擇加號 (+) 符號。
-
選取範圍:全域或本機。
如果您選擇全域範圍,MCP 伺服器組態會儲存在 ~/.aws/amazonq/mcp.json 中,且可在所有專案中使用。如果您選擇本機範圍,組態會儲存在目前專案內的 .amazonq/mcp.json 中。
-
在名稱欄位中,輸入 MCP 伺服器的名稱。
例如,如果我們安裝 AWS 文件 MCP 伺服器
,則名稱可能是 AWSDocMCPServer。 -
選取
stdio作為傳輸通訊協定。 -
在命令欄位中,輸入 MCP 伺服器初始化時將執行的 Shell 命令。
如果是 AWS 文件 MCP 伺服器,則命令為
uvx。這是uv tool run的別名,其會建立暫時性的 Python 環境。 -
在引數欄位中,輸入要提供給 Shell 命令的引數 (如適用)。
如果是 AWS 文件 MCP 伺服器,則引數為
awslabs.aws-documentation-mcp-server@latest。這是 Python 套件識別符,其指向 PyPI (Python 套件索引) 上託管的套件。視需要新增更多引數。
-
填入適用的環境變數。
在我們的範例中,我們首先填入名稱:
FASTMCP_LOG_LEVEL和值:ERROR。我們也會使用名稱
AWS_DOCUMENTATION_PARTITION和值aws來指出要使用的分割區。 -
輸入逾時值 (如適用)。
在我們的範例中,我們會保留 60 (秒) 的建議值。
-
選擇儲存。
組態面板將會取代為工具許可面板。
-
請遵循 檢閱和調整工具許可 下的程序。
對 MCP 組態進行故障診斷
您在 IDE 中新增 MCP 伺服器後,Amazon Q 將會嘗試連線該伺服器。
如果發生連線問題,則面板頂端會顯示警示。在解決警示之前,可能無法預期該 MCP 伺服器的工具能夠正常運作。
選擇修正組態以返回 MCP 組態畫面,您可以在此進行適當的變更。
啟用 MCP 伺服器
下列程序假設所指 MCP 伺服器尚未啟用。
若要在 IDE 中啟用 MCP 伺服器:
-
開啟 MCP 伺服器面板。
-
在您要啟用的伺服器旁,選擇啟用。
停用 MCP 伺服器
若要在 IDE 中停用 MCP 伺服器:
-
開啟 MCP 伺服器面板。
-
選擇您要停用的伺服器。
-
選擇編輯設定旁的三個點。
-
選擇停用 MCP 伺服器。
刪除目前啟用的 MCP 伺服器
若要從 IDE 刪除目前啟用的 MCP 伺服器:
-
開啟 MCP 伺服器面板。
-
選擇您要刪除的伺服器。
此時會開啟面板,其中包含該伺服器的詳細資訊。
-
選擇編輯設定旁的三個點。
-
選擇刪除 MCP 伺服器。
-
出現提示時確認刪除。
刪除目前停用的 MCP 伺服器
若要從 IDE 刪除目前停用的 MCP 伺服器:
-
開啟 MCP 伺服器面板。
-
在您要刪除的伺服器旁,選擇刪除。
-
出現提示時確認刪除。
檢閱和調整工具許可
若要檢閱和調整工具許可:
-
開啟 MCP 伺服器面板。
-
選擇您要檢閱和調整其許可的 MCP 伺服器。
-
您可以為每一項工具設定下列其中一種許可層級:
-
詢問:每次使用工具時提示許可。
-
一律允許:允許工具執行,而不提示。
-
拒絕:不使用此工具。
-