本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 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 欄位](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#uselegacymcpjson-field)。
請注意，Q CLI 也可能使用 mcp.json 檔案。
如需有關如何在 MCP 工具上設定精細控制的資訊，請參閱[內建工具參考](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#tools-field)。
## 存取 MCP 組態 UI
若要在 IDE 的 Q Developer 中存取 MCP 組態 UI：
1. 開啟您的 IDE (VS Code、JetBrains 等)。
1. 開啟 Q Developer 面板。
1. 開啟**聊天**面板。
1. 選擇工具圖示。
## 新增 MCP 伺服器
AI 用戶端與 MCP 伺服器之間可透過兩種主要傳輸機制進行通訊：STDIO 和 HTTP。
### 新增 HTTP MCP 伺服器
若要將 HTTP MCP 伺服器新增至 IDE：
1. [存取 MCP 組態 UI](#mcp-ide-configuration-access-ui)。
1. 選擇加號 (\+) 符號。
1. 選取範圍：全域或本機。
如果您選擇全域範圍，MCP 伺服器組態會存放在 \~/.aws/amazonq/default.json 中，並可在所有專案中使用。如果您選擇本機範圍，組態會存放在目前專案中的 .amazonq/default.json 中。
1. 在**名稱**欄位中，輸入 MCP 伺服器的名稱。
1. 選取 `http` 作為傳輸通訊協定。
1. 在 **URL** 欄位中，輸入 MCP 伺服器初始化時將呼叫的 URL。
1. 在**標頭 - 選用**下，您可以輸入必須作為 HTTP 請求標頭傳送的鍵值對。
1. 輸入**逾時**值 (如適用)。
1. 選擇**儲存**。
組態面板將會取代為工具許可面板。
1. 請遵循 [檢閱和調整工具許可](#mcp-ide-configuration-review-adjust-tool) 下的程序。
**注意**
如果 MCP HTTP 端點需要授權，Amazon Q 將自動開啟瀏覽器頁面，讓您能夠授權 Amazon Q 存取 MCP 伺服器。
### 新增 STDIO MCP 伺服器
若要將 STDIO MCP 伺服器新增至 IDE：
1. [存取 MCP 組態 UI](#mcp-ide-configuration-access-ui)。
1. 選擇加號 (\+) 符號。
1. 選取範圍：全域或本機。
如果您選擇全域範圍，MCP 伺服器組態會存放在 \~/.aws/amazonq/default.json 中，並可在所有專案中使用。如果您選擇本機範圍，組態會存放在目前專案中的 .amazonq/default.json 中。
1. 在**名稱**欄位中，輸入 MCP 伺服器的名稱。
例如，如果我們安裝 [AWS 文件 MCP 伺服器](https://awslabs.github.io/mcp/servers/aws-documentation-mcp-server/)，則名稱可能是 {{AWS DocMCPServer}}。
1. 選取 `stdio` 作為傳輸通訊協定。
1. 在**命令**欄位中，輸入 MCP 伺服器初始化時將執行的 Shell 命令。
如果是 AWS 文件 MCP 伺服器，命令為 `uvx`。這是 `uv tool run` 的別名，其會建立暫時性的 Python 環境。
1. 在**引數**欄位中，輸入要提供給 Shell 命令的引數 (如適用)。
對於 AWS 文件 MCP 伺服器，引數為 {{awslabs.aws-documentation-mcp-server@latest}}。這是 Python 套件識別符，其指向 PyPI (Python 套件索引) 上託管的套件。
視需要新增更多引數。
1. 填入適用的環境變數。
在我們的範例中，我們首先填入名稱：{{FASTMCP\_LOG\_LEVEL}} 和值：{{ERROR}}。
我們也會使用名稱 {{AWS\_DOCUMENTATION\_PARTITION}} 和值 {{aws}} 來指出要使用的[分割區](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/partitions.html)。
1. 輸入**逾時**值 (如適用)。
在我們的範例中，我們會保留 60 (秒) 的建議值。
1. 選擇**儲存**。
組態面板將會取代為工具許可面板。
1. 請遵循 [檢閱和調整工具許可](#mcp-ide-configuration-review-adjust-tool) 下的程序。
## 對 MCP 組態進行故障診斷
您在 IDE 中新增 MCP 伺服器後，Amazon Q 將會嘗試連線該伺服器。
如果發生連線問題，則面板頂端會顯示警示。在解決警示之前，可能無法預期該 MCP 伺服器的工具能夠正常運作。
選擇**修正組態**以返回 MCP 組態畫面，您可以在此進行適當的變更。
## 啟用 MCP 伺服器
下列程序假設所指 MCP 伺服器尚未啟用。
若要在 IDE 中啟用 MCP 伺服器：
1. 開啟 MCP 伺服器面板。
1. 在您要啟用的伺服器旁，選擇**啟用**。
## 停用 MCP 伺服器
若要在 IDE 中停用 MCP 伺服器：
1. 開啟 MCP 伺服器面板。
1. 選擇您要停用的伺服器。
1. 選擇**編輯設定**旁的三個點。
1. 選擇**停用 MCP 伺服器**。
## 刪除目前啟用的 MCP 伺服器
若要從 IDE 刪除目前啟用的 MCP 伺服器：
1. 開啟 MCP 伺服器面板。
1. 選擇您要刪除的伺服器。
此時會開啟面板，其中包含該伺服器的詳細資訊。
1. 選擇**編輯設定**旁的三個點。
1. 選擇**刪除 MCP 伺服器**。
1. 出現提示時確認刪除。
## 刪除目前停用的 MCP 伺服器
若要從 IDE 刪除目前停用的 MCP 伺服器：
1. 開啟 MCP 伺服器面板。
1. 在您要刪除的伺服器旁，選擇**刪除**。
1. 出現提示時確認刪除。
## 檢閱和調整工具許可
若要檢閱和調整工具許可：
1. 開啟 MCP 伺服器面板。
1. 選擇您要檢閱和調整其許可的 MCP 伺服器。
1. 您可以為每一項工具設定下列其中一種許可層級：
+ 詢問：每次使用工具時提示許可。
+ 一律允許：允許工具執行，而不提示。
+ 拒絕：不使用此工具。