本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
IDE 中 Q 開發人員的 MCP 組態
此頁面涵蓋設定 MCP 伺服器的 IDE 特定選項。如需 MCP 組態的一般資訊,請參閱了解 MCP 組態。
存取 MCP 組態 UI
下圖顯示用於在 IDE 中為 Q 開發人員設定 MCP 伺服器的 GUI。

若要在 IDE 的 Q 開發人員中存取 MCP 組態 UI:
-
開啟您的 IDE (VS 程式碼、JetBrains 等)。
-
開啟 Q 開發人員面板。
-
開啟聊天面板。
-
選擇工具圖示。
新增 MCP 伺服器
若要將 MCP 伺服器新增至 IDE:
-
選擇加號 (+) 符號。
-
選取範圍:全域或本機。
如果您選擇全域範圍,MCP 伺服器組態會存放在 ~/.aws/amazonq/mcp.json 中,並可在所有專案中使用。如果您選取本機範圍,組態會儲存在目前專案中的 .amazonq/mcp.json 中。
-
在名稱欄位中,輸入 MCP 伺服器的名稱。
例如,如果我們安裝AWS 文件 MCP 伺服器
,名稱可能是 AWS DocMCPServer
。 -
選取傳輸通訊協定。
目前僅支援
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 伺服器。
-
對於每個工具,您可以設定下列其中一個許可層級:
-
詢問:每次使用工具時提示 許可。
-
一律允許:允許工具在沒有提示的情況下執行。
-
拒絕:請勿使用此工具。
-
-
選擇儲存或套用以更新許可設定。