在 VS Code 中新增與管理 MCP 伺服器

模型上下文協定 (MCP) 是一項將 AI 模型連接至外部工具與服務的開放標準。在 Visual Studio Code 中，MCP 伺服器為檔案操作、資料庫或外部 API 等任務提供工具。MCP 伺服器亦可提供資源、提示詞 (Prompts) 與互動式應用程式。

有關 MCP 如何融入 AI 自訂架構的背景資訊，請參閱自訂概念與工具概念。

本文涵蓋如何新增、設定及管理 MCP 伺服器。若要深入了解如何在聊天中使用工具，請參閱搭配代理程式使用工具。

快速入門：在聊天中使用 MCP 伺服器

請遵循以下步驟安裝 MCP 伺服器並在聊天中使用其工具。此範例使用 Playwright MCP 伺服器，透過瀏覽器與網頁進行互動。

1. 開啟擴充功能檢視 (⇧⌘X (Windows, Linux Ctrl+Shift+X))，並在搜尋欄位中輸入 @mcp playwright。

2. 選擇 Install (安裝)，將 Playwright MCP 伺服器安裝至您的使用者設定檔中。

3. 當出現提示時，請確認您信任該伺服器以啟動它。VS Code 將會偵測伺服器的工具，並使其在聊天中可用。

4. 開啟聊天檢視 (⌃⌘I (Windows, Linux Ctrl+Alt+I))，並輸入一個使用 Playwright 工具的提示詞。例如：

   Go to code.visualstudio.com, decline the cookie banner, and give me a screenshot of the homepage.
   

   VS Code 將呼叫 Playwright 工具以在瀏覽器中開啟頁面並擷取螢幕截圖。您可能會被要求確認每次工具的呼叫。

新增 MCP 伺服器

從 MCP 伺服器庫安裝 MCP 伺服器：

1. 開啟擴充功能檢視 (⇧⌘X (Windows, Linux Ctrl+Shift+X))，並在搜尋欄位中輸入 @mcp。這會顯示庫中可用的 MCP 伺服器清單。

2. 您可以將 MCP 伺服器安裝到您的使用者設定檔或工作區中：

   • 若要安裝到使用者設定檔，請選擇 Install (安裝)。

   • 若要安裝到工作區，請以滑鼠右鍵點擊 MCP 伺服器並選擇 Install in Workspace (安裝至工作區)。這將會更新您工作區中的 .vscode/mcp.json 檔案。

3. 若要檢視 MCP 伺服器詳細資訊，請在清單中選擇該伺服器以開啟詳細資訊頁面。

設定 mcp.json 檔案

您可以透過編輯 mcp.json 檔案來手動設定 MCP 伺服器。此檔案有兩個存放位置：

• 工作區：在您的專案中建立或開啟 .vscode/mcp.json。將此檔案納入原始碼控制，以便與團隊共享 MCP 伺服器設定。
• 使用者設定檔：執行 MCP: Open User Configuration (MCP：開啟使用者設定) 指令，以開啟您使用者設定檔資料夾中的 mcp.json 檔案。在此設定的伺服器可在您的所有工作區中使用。當您使用多個設定檔時，每個設定檔皆可擁有各自的 MCP 伺服器設定。

您也可以在指令選擇區 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 執行 MCP: Add Server (MCP：新增伺服器)，透過引導式流程新增伺服器，並選擇 Workspace (工作區) 或 Global (全域) 作為目標。

以下範例顯示了一個同時設定遠端 MCP 伺服器與本機 MCP 伺服器的 mcp.json 檔案：

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp"
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@microsoft/mcp-server-playwright"]
    }
  }
}

VS Code 為設定檔提供 IntelliSense。有關完整的設定架構與欄位參考，請參閱 MCP 設定參考。

新增 MCP 伺服器的其他選項

{
  "image": "mcr.microsoft.com/devcontainers/typescript-node:latest",
  "customizations": {
    "vscode": {
      "mcp": {
        "servers": {
          "playwright": {
            "command": "npx",
            "args": ["-y", "@microsoft/mcp-server-playwright"]
          }
        }
      }
    }
  }
}

code --add-mcp "{\"name\":\"my-server\",\"command\": \"uvx\",\"args\": [\"mcp-server-fetch\"]}"

其他 MCP 功能

除了工具之外，MCP 伺服器還能提供其他功能：

沙盒化 MCP 伺服器

在 macOS 和 Linux 上，您可以為本機執行的 stdio MCP 伺服器啟用沙盒 (Sandboxing)，以限制其對檔案系統和網路的存取。沙盒化的伺服器會在隔離的環境中執行，且僅能存取您明確許可的檔案路徑與網路網域。

若要為伺服器啟用沙盒，請在 mcp.json 檔案的伺服器設定中將 "sandboxEnabled": true 設定為 true。您可以透過新增一個包含特定檔案系統與網路規則的頂層 sandbox 物件，進一步自訂沙盒限制。

以下範例顯示如何為本機 MCP 伺服器啟用沙盒，並限制其僅能寫入工作區中的檔案以及存取特定的 API 網域：

{
  "servers": {
    "myServer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@example/mcp-server"],
      "sandboxEnabled": true
    }
  },
  "sandbox": {
    "filesystem": {
      "allowWrite": ["${workspaceFolder}"]
    },
    "network": {
      "allowedDomains": ["api.example.com"]
    }
  }
}

當啟用沙盒時，來自伺服器的工具呼叫會自動獲得批准，因為它們在受控環境中執行。

有關完整的沙盒設定架構，請參閱沙盒設定參考。

管理 MCP 伺服器

VS Code 提供了多種管理 MCP 伺服器的選項，例如啟動或停止伺服器、檢視日誌、解除安裝或清除快取的工具。

方法	說明
擴充功能檢視	在 MCP SERVERS - INSTALLED (已安裝的 MCP 伺服器) 區段中右鍵點擊伺服器，或選擇齒輪圖示。
mcp.json 編輯器	開啟設定檔並使用內嵌動作 (code lenses)。使用 MCP: Open User Configuration (MCP：開啟使用者設定) 或 MCP: Open Workspace Folder Configuration (MCP：開啟工作區資料夾設定) 來開啟檔案。
命令面板	執行 MCP: List Servers (MCP：列出伺服器)，選擇一個伺服器，並選擇一個動作。

啟用或停用 MCP 伺服器

您可以全域或針對特定工作區啟用或停用 MCP 伺服器。當 MCP 伺服器停用時，它不會啟動，且其工具、提示詞、資源與 MCP 應用程式將會從聊天中排除。

若要啟用或停用 MCP 伺服器：

• 在擴充功能檢視的 MCP SERVERS - INSTALLED (已安裝的 MCP 伺服器) 區段中右鍵點擊伺服器，並選擇 Enable (啟用) 或 Disable (停用)。
• 從指令選擇區執行 MCP: List Servers (MCP：列出伺服器)，選擇一個伺服器，並選擇 Enable (啟用) 或 Disable (停用)。
• 使用代理程式自訂編輯器來切換伺服器的啟用狀態。

啟用/停用狀態是與 mcp.json 中的伺服器設定分開儲存的，因此不會影響共享的設定檔。

在 VS Code 中集中管理 MCP 伺服器的存取權限

企業組織可透過 GitHub 政策集中管理 MCP 伺服器的存取權限。深入了解企業級 MCP 伺服器管理。

自動啟動 MCP 伺服器

當您新增 MCP 伺服器或變更其設定時，VS Code 需要 (重新) 啟動伺服器以探索其提供的工具。

您可以透過 chat.mcp.autoStart 在 VS Code 中開啟 在 VS Code Insiders 中開啟 設定（實驗性）將 VS Code 設定為在偵測到設定變更時自動重啟 MCP 伺服器。

MCP 伺服器信任

當您將 MCP 伺服器新增至工作區或變更其設定時，您需要在啟動前確認您信任該伺服器及其功能。首次啟動伺服器時，VS Code 會顯示一個對話框供您確認信任。在對話框中，選擇 MCP 伺服器的連結以審查其設定。

如果您不信任該 MCP 伺服器，它將不會啟動，且聊天請求將在不使用該伺服器所提供工具的情況下繼續進行。

您可以透過在指令選擇區執行 MCP: Reset Trust (MCP：重設信任) 指令，來重設 MCP 伺服器的信任狀態。

跨裝置同步 MCP 設定

啟用 設定同步 (Settings Sync) 後，您可以跨裝置同步設定與配置，包括 MCP 伺服器設定。這讓您能夠保持開發環境的一致性，並在所有裝置上存取相同的 MCP 伺服器。

若要使用設定同步來同步 MCP 伺服器設定：

1. 從指令選擇區執行 Settings Sync: Configure (設定同步：設定) 指令。

2. 在同步設定清單中啟用 MCP Servers (MCP 伺服器) 選項。

疑難排解與偵錯 MCP 伺服器

MCP 輸出日誌

當 VS Code 在 MCP 伺服器上遇到問題時，它會在聊天檢視中顯示錯誤指標。

選取聊天檢視中的錯誤通知，然後選擇 Show Output (顯示輸出) 選項以檢視伺服器日誌。或者，從指令選擇區執行 MCP: List Servers (MCP：列出伺服器)，選擇該伺服器，然後選擇 Show Output (顯示輸出)。

常見問題

相關資源

• MCP 設定參考
• 搭配 Agent 使用工具
• 模型上下文協定文件
• VS Code 中的 MCP 應用程式支援
• 探索並管理代理程式外掛程式，包括外掛程式中的 MCP 伺服器