使用 MCP 伺服器擴充代理程式

MCP 伺服器將代理程式連接到外部工具和資料來源。在本指南中,您將安裝一個 MCP 伺服器、在聊天中使用其中一個工具、選擇正確的設定範圍,並決定何時將伺服器放入沙箱中。

先決條件

開始之前,請安裝 VS Code、啟用 AI 功能,並登入 GitHub Copilot。您還需要存取 MCP 伺服器,或具備從市集新增伺服器的能力。

從一個具體的伺服器開始

在本課程中,我們以 Playwright MCP 伺服器為範例。它賦予代理程式瀏覽器工具,以便其能開啟網頁、與網頁互動並擷取螢幕畫面。

  1. 開啟「擴充功能」檢視。

  2. 搜尋 @mcp playwright

  3. 選取 Install 將 Playwright MCP 伺服器安裝到您的使用者設定檔中。

  4. 當 VS Code 詢問您是否信任該伺服器時,請檢視發行者與伺服器詳細資料,然後確認是否信任它。

當伺服器啟動時,VS Code 會發現其工具並使其可在聊天中使用。

Screenshot showing the MCP servers in the Extensions view.

在聊天中使用伺服器

現在,給代理程式一個實際需要存取瀏覽器的任務。

  1. 開啟對話檢視。

  2. 選取 Agent

  3. 選取 Configure Tools

  4. 啟用 Playwright 工具。

  5. 送出以下提示詞

    Go to code.visualstudio.com, decline the cookie banner if it appears, and describe the main navigation items on the homepage.
    

由於任務需要與瀏覽器互動,代理程式應會呼叫 Playwright MCP 工具。如果在呼叫工具前要求批准,請檢視動作並在符合任務時予以批准。

Screenshot showing an MCP tool invocation in chat with the input and output shown.

決定設定檔應放置的位置

安裝伺服器會將設定寫入 mcp.json 檔案中。請根據誰應該使用該伺服器來選擇範圍。

範圍 適用時機 範例
使用者設定檔 該伺服器對您自己的所有工作區都很有用。 瀏覽器自動化伺服器或說明文件查詢伺服器。
工作區 該伺服器是專案運作方式的一部分。 專案專屬的 API 伺服器或資料庫檢查工具。
遠端使用者設定檔 伺服器必須在遠端機器上執行。 需要存取安裝在開發容器或遠端環境中工具的伺服器。

使用 MCP: Open User Configuration 來檢查您的使用者設定檔設定。當您想為目前專案建立 .vscode/mcp.json 檔案時,請使用 MCP: Open Workspace Folder Configuration

對於需要憑證的伺服器,請勿將機密資訊寫死在工作區檔案中。請使用輸入變數或環境檔案來儲存敏感數值。

提示

VS Code 為 mcp.json 提供 IntelliSense 與內嵌動作,這使得啟動、停止和檢查伺服器變得更加容易。

MCP server configuration with lenses to manage server.

了解 MCP 能提供什麼

MCP 是圍繞著幾項核心功能建構的。每一項功能都解決不同的問題。

  • Tools 讓代理程式能夠採取行動,例如開啟瀏覽器或查詢 API。
  • Resources 提供您附加到請求中的唯讀內容,例如資料庫結構描述或文件。
  • Prompts 提供來自伺服器的可重複使用範本,例如標準的研究提示詞。
  • 當伺服器支援更豐富的輸入或輸出時,MCP Apps 會在聊天中呈現互動式 UI。

當代理程式需要執行動作時,請使用工具。當它需要讀取內容時,請使用資源。當您的團隊需要可重複的互動模式時,請使用提示詞。

將本機伺服器放入沙箱

將本機 MCP 伺服器視為可以在您的機器上執行的程式碼。在安裝之前,請先檢視發行者與設定。

根據預設,MCP 工具呼叫在執行前會提示要求批准,這保留了人工介入的環節。對於 macOS 和 Linux 上的本機 stdio 伺服器,您可以啟用沙箱來限制檔案系統和網路存取。

當伺服器需要強大的功能但又必須維持在明確的界線內時,請加入沙箱。例如,使用 Playwright MCP 伺服器時,沙箱可讓代理程式導覽網頁並執行瀏覽器任務,而不需要在每個步驟都進行提示,因為工作已與您的主機隔離。

若要為本機 stdio 伺服器啟用沙箱,請在伺服器設定中將 sandboxEnabled 設定為 true。如果伺服器需要更多存取權限,請更新該伺服器的沙箱規則,而不是放寬整臺機器的存取權限。

{
  "servers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@microsoft/mcp-server-playwright"],
      "sandboxEnabled": true
    }
  }
}

Screenshot showing the MCP server trust prompt.

使用第二個伺服器進行練習

在您試用過 Playwright 後,請安裝一個以說明文件或 API 為主的 MCP 伺服器,並比較其工作流程。

  1. 在「擴充功能」檢視中搜尋 @mcp

  2. 挑選一個連接至說明文件、問題追蹤或您使用的其他系統的伺服器。

  3. 如果這是個人工具,請將其安裝在您的使用者設定檔中;如果這是專案應共用的工具,則安裝在工作區中。

  4. 在聊天中啟用其工具。

  5. 輸入需要該外部來源的提示詞。

例如,啟用說明文件 MCP 伺服器後,提出一個應該根據該說明文件(而不是模型的通用知識)來回答的問題。

管理 MCP 伺服器

您可以在 VS Code 的多個地方管理伺服器:

  • 「擴充功能」檢視。
  • mcp.json 編輯器。
  • 命令選擇區,包含 MCP: List Servers
  • 聊天檢視中齒輪圖示裡的代理程式自訂檢視。

使用這些介面來啟動或停止伺服器、瀏覽市集,以及安裝額外的伺服器。

Screenshot showing the actions for an MCP server in the Command Palette.

若要對伺服器進行偵錯,請從伺服器的動作中選取 Show Output,以查看伺服器處理的每個請求的記錄。

Screenshot showing the MCP server output panel with logs.

為什麼這很重要

MCP 為代理程式提供了一種標準的方式,能夠突破模型本身的限制,與您已在使用的系統協同運作。這意味著減少臨時起意的提示詞,並帶來更多可重複的工作流程。

接下來要做什麼

接下來,您將會看到代理程式外掛程式如何將技能、代理程式、勾點和 MCP 伺服器打包成單一可安裝的套件。

深入了解

English 한국어 中文(简体) 中文(繁體)
© . This website operates independently and is not affiliated with or endorsed by Microsoft. All brand names, logos, and trademarks are the property of their respective owners.