快速入門：透過 劇作家工作區 遠端 MCP 伺服器自動化瀏覽器任務

Important

劇作家工作區 遠端模型情境協定（MCP）伺服器目前處於預覽階段。 預覽功能沒有服務等級協議，也不建議用於生產工作負載。 功能、限制和可用性可能會改變。

在這個快速入門中，你會將 AI 代理連接到 劇作家工作區 遠端 MCP 伺服器。 代理使用受管理的雲端瀏覽器開啟網頁、檢查其無障礙快照、報告頁面內容，並關閉瀏覽器會話。

遠端 MCP 伺服器透過可串流的 HTTP 提供瀏覽器自動化工具。 你不需要在代理環境安裝 Playwright、瀏覽器二進位檔或本地 MCP 伺服器。

完成這個快速入門後，你會有一個連接到 Playwright 工作空間的 MCP 用戶端，並能從 GitHub Copilot CLI 或 Microsoft Foundry 執行代理驅動的瀏覽器任務。

先決條件

  • 一個有有效訂閱的 Azure 帳號。 如果您沒有 Azure 訂用帳戶，請在開始前建立免費帳戶。
  • 一個啟用遠端 MCP 預覽的 Playwright 工作區 。
  • 工作空間範圍內的 Azure 貢獻者或擁有者角色。 此角色是建立工作區存取權杖所必需的。 欲了解更多資訊，請參閱 管理Playwright工作區存取權。
  • 以下 MCP 客戶端之一：
    • GitHub Copilot CLI 支援 MCP。
    • 一個 Microsoft Foundry 專案，擁有建立專案連線及設定代理程式的權限。

選擇驗證方法

當您的 MCP 用戶端支援 OAuth 或受管理身份時，請使用 Microsoft Entra ID。 遠端 MCP 伺服器使用此資源識別碼及委派範圍：

Resource: https://mcp.playwright.microsoft.com
Scope: https://mcp.playwright.microsoft.com/Playwright.Mcp.Tools

伺服器會發布 OAuth 受保護資源的元資料。 支援 OAuth 發現的用戶端，包括 Visual Studio Code，可以從工作空間範圍內的 MCP 端點中發現授權伺服器及所需範圍。 登入的身份必須透過 Azure 角色基礎存取控制（RBAC）存取 Playwright 工作區。

只有當 MCP 用戶端無法用 Microsoft Entra ID 認證時，才使用工作區存取權杖。 存取權杖安全性較低，預設會被停用。

建立一個工作區存取權杖以促進相容性

使用 Microsoft Entra ID 時請跳過此部分。 如果工作區尚未啟用存取權杖驗證：

建立工作區存取權杖

此快速入門使用基於金鑰的認證。 MCP 用戶端會在請求標頭中 x-api-key 傳送工作區存取權杖。

Caution

Microsoft Entra ID 是 劇作家工作區 推薦的認證方法。 存取權杖安全性較低，預設會被停用。 把存取權杖當作密碼來對待。 切勿將其提交至原始碼控制，或包含在代理指令、提示或日誌中。

  1. 登入 Azure 入口網站。
  2. 打開你的劇作家工作空間。
  3. 在 設定中，選擇 存取管理。
  4. 如果尚未選中，請勾選 Playwright 服務存取令牌 的勾選框。
  5. 選擇 產生代幣。
  6. 輸入名稱和有效期限，然後產生代幣。
  7. 立刻複製令牌。 你無法事後找回它的價值。

該令牌會與創建它的使用者相關聯。 該服務會評估該使用者目前在使用該憑證時的 Azure 角色基礎存取控制（RBAC）權限。 在本快速入門中，請設定較短的過期時間。

欲了解更多資訊，請參閱管理工作區存取權杖。

建立遠端 MCP 端點

在 Azure 入口網站中，開啟 Playwright 工作區的概覽頁面。 使用工作區區域和工作區 ID 來建立遠端 MCP 端點。

Playwright 工作區概覽頁面的截圖，顯示工作區的位置和 API 基礎端點。

端點格式如下：

https://<region>.mcp.playwright.microsoft.com/playwrightworkspaces/<workspace-id>/mcp

例如：

https://eastus.mcp.playwright.microsoft.com/playwrightworkspaces/00000000-0000-0000-0000-000000000000/mcp

使用該工作區部署區域的端點。

連接 MCP 用戶端

選擇你想使用的 MCP 客戶端。

GitHub Copilot 命令列界面 (CLI)

要將 劇作家工作區 遠端 MCP 伺服器加入 GitHub Copilot CLI：

  1. 開啟 GitHub Copilot CLI。
  2. 輸入 /mcp add。
  3. 輸入唯一的伺服器名稱，例如 playwrightWorkspace。
  4. 選擇 HTTP 作為伺服器類型。
  5. 輸入遠端 MCP 端點。
  6. 新增一個名為 x-api-key 的 HTTP 標頭，並使用工作區存取權杖作為其值。
  7. 為延後執行的工具選擇 自動。
  8. 按 Esc 鍵完成伺服器新增。

GitHub Copilot CLI 為新增 HTTP 遠端 MCP 伺服器而設的提示截圖。

Microsoft Foundry

將遠端伺服器連接成自訂的 MCP 工具。 Foundry 將工作區存取權杖儲存在專案連線中。

Note

存放在 Foundry 專案連線中的金鑰是共享的專案秘密。 使用 Connection 的 Project 成員會使用與該 token 相關的身份與權限。 使用專用且權限最低的令牌，並限制對專案的存取權限。

要連接遠端 MCP 伺服器：

  1. 請在 Microsoft Foundry 入口網站開啟您的專案。
  2. 選擇 建置>工具，然後選擇 新增工具>自訂>模型情境協定。
  3. 輸入 playwrightWorkspace 這個獨特名稱。
  4. 輸入遠端 MCP 伺服器端點。
  5. 選擇基於金鑰的驗證。
  6. x-api-key輸入為憑證名稱，工作區存取權杖作為憑證值。
  7. 選擇 連線。 Foundry 建立專案連結。

用於新增採用金鑰式驗證的遠端 Model Context Protocol 工具之 Microsoft Foundry 設定的螢幕擷取畫面。

建立或開啟代理程式，新增遠端 MCP 工具，並選擇專案連線。 在評估整合過程中，要求每次工具呼叫都獲得批准。 要求核准讓你在每次瀏覽器操作前檢查工具名稱和參數。

如需了解目前的連線欄位和核准行為，請參閱 Connect Microsoft Foundry agents to MCP server endpoints。

執行你的第一個瀏覽器任務

請向代理人提交以下提示：

Use the Playwright workspace tools to create a browser session, open
https://example.com, inspect the page snapshot, and report the main heading
and page URL. Close the browser session when the task finishes. Always close
the session if a browser step fails.

確認代理人是否遵循以下序列：

  1. 呼叫 create_browser_session 並保留傳回的 browserSessionId。
  2. 以 session ID 和 browser_navigate 呼叫 https://example.com。
  3. 以相同的工作階段 ID 呼叫 browser_snapshot 或 browser_find。
  4. 報告 範例網域 標題及頁面網址。
  5. 使用工作階段 ID 呼叫 close_browser_session。

成功的結果如下：

Heading: Example Domain
URL: https://example.com/
Browser session closed.

具體的反應會因代理人和模型而異。 會話建立結果也可能包含即時檢視的網址。 僅憑最終回覆並不代表已經清理乾淨。 檢查工具呼叫紀錄並確認是否 close_browser_session 成功。

Caution

遠端瀏覽器會佔用工作空間容量，並可能產生費用。 任務一結束就立即關閉每場會議。

清理資源

完成快速啟動後：

  1. 確認客服人員已致電 close_browser_session。
  2. 如果您只是為了這個快速入門而建立 Playwright 工作區，請刪除該資源群組。 不要刪除包含你想保留資源的資源群組。

後續步驟

透過 劇作家工作區 遠端 MCP 伺服器將瀏覽器自動化

  • 上次更新時間：