新增並管理 VS Code 中的 MCP 伺服器

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

若要了解 MCP 如何融入 AI 自訂框架的背景資訊，請參閱自訂概念和工具概念。

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

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

依照這些步驟安裝 MCP 伺服器並在聊天中使用其工具。此範例使用 Playwright MCP 伺服器，透過瀏覽器與網頁互動。

1. 開啟「延伸模組」檢視 (⇧⌘X (Windows、Linux Ctrl+Shift+X))，然後在搜尋欄位中輸入 @mcp playwright。

2. 選取「安裝」以在您的使用者設定檔中安裝 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 伺服器安裝到您的使用者設定檔或工作區

   • 若要安裝到您的使用者設定檔，請選取「安裝」。

   • 若要安裝到您的工作區，請在 MCP 伺服器上按一下右鍵並選取「安裝到工作區」。這會更新您工作區中的 .vscode/mcp.json 檔案。

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

設定 mcp.json 檔案

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

• 工作區：在您的專案中建立或開啟 .vscode/mcp.json。將此檔案包含在原始檔控制中，以便與您的團隊共用 MCP 伺服器組態。
• 使用者設定檔：執行「MCP：開啟使用者組態」命令，以在您的使用者設定檔資料夾中開啟 mcp.json 檔案。在此處設定的伺服器可在您的所有工作區中使用。當您使用多個設定檔時，每個設定檔都可以有其自己的 MCP 伺服器組態。

您也可以在「命令選擇區」(⇧⌘P (Windows、Linux Ctrl+Shift+P)) 中執行「MCP：新增伺服器」，透過引導式流程新增伺服器，並選擇「工作區」或「全域」作為目標。

以下範例顯示 mcp.json 檔案，該檔案設定了遠端 MCP 伺服器和本機 MCP 伺服器

{
  "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 伺服器啟用沙盒化，以限制它們對檔案系統和網路的存取。沙盒化伺服器在隔離的環境中執行，並且只能存取您明確允許的檔案路徑和網路網域。

若要為伺服器啟用沙盒化，請在您的 mcp.json 檔案中的伺服器組態中設定 "sandboxEnabled": 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 伺服器」區段中按一下伺服器右鍵，或選取齒輪圖示。
mcp.json 編輯器	開啟組態檔並使用行內動作 (程式碼透鏡)。使用「MCP：開啟使用者組態」或「MCP：開啟工作區資料夾組態」來開啟檔案。
命令面板	執行「MCP：列出伺服器」，選取伺服器，然後選擇一個動作。

啟用或停用 MCP 伺服器

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

若要啟用或停用 MCP 伺服器

• 在「延伸模組」檢視的「已安裝的 MCP 伺服器」區段中按一下伺服器右鍵，然後選取「啟用」或「停用」。
• 從「命令選擇區」執行「MCP：列出伺服器」，選取伺服器，然後選擇「啟用」或「停用」。
• 使用聊天自訂編輯器來切換伺服器的啟用狀態。

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

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

組織可以透過 GitHub 策略集中管理 MCP 伺服器的存取權。請了解更多關於MCP 伺服器的企業管理。

自動啟動 MCP 伺服器

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

您可以設定 VS Code，在偵測到組態變更時自動重新啟動 MCP 伺服器，方法是使用 chat.mcp.autoStart 在 VS Code 中開啟 在 VS Code Insiders 中開啟 設定 (實驗性)。

MCP 伺服器信任

當您新增 MCP 伺服器或變更其組態時，您需要在啟動伺服器之前確認您信任該伺服器及其功能。當您第一次啟動伺服器時，VS Code 會顯示一個對話方塊來確認您是否信任該伺服器。在對話方塊中，選取 MCP 伺服器的連結以檢閱其組態。

如果您不信任 MCP 伺服器，它將不會啟動，聊天請求將繼續執行，而不使用伺服器提供的工具。

您可以透過從「命令選擇區」執行「MCP：重設信任」命令來重設您的 MCP 伺服器的信任狀態。

跨裝置同步 MCP 組態

啟用設定同步功能後，您可以同步跨裝置的設定和組態，包括 MCP 伺服器組態。這使您能夠維持一致的開發環境，並在您所有的裝置上存取相同的 MCP 伺服器。

若要透過設定同步功能同步 MCP 伺服器組態

1. 從「命令選擇區」執行「設定同步：設定」命令

2. 在同步組態清單中啟用「MCP 伺服器」選項

疑難排解與偵錯 MCP 伺服器

MCP 輸出日誌

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

選取「聊天」檢視中的錯誤通知，然後選取「顯示輸出」選項以檢視伺服器日誌。或者，從「命令選擇區」執行「MCP：列出伺服器」，選取伺服器，然後選擇「顯示輸出」。

常見問題

相關資源

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