Quickstart: Automatisera webbläsaruppgifter med Arbetsutrymmen för dramatiker fjärrservern MCP

I den här snabbstarten ansluter du en AI-agent till Arbetsutrymmen för dramatiker fjärranslutna MCP-server. Agenten använder en hanterad molnwebbläsare för att öppna en webbsida, inspektera dess tillgänglighetsögonblicksbild, rapportera sidans innehåll och stänga webbläsarsessionen.

Den fjärrstyrda MCP-servern tillhandahåller webbläsarautomatiseringsverktyg över strömbärbar HTTP. Du behöver inte installera Playwright, webbläsarbinärer eller en lokal MCP-server i agentmiljön.

Efter att du har slutfört denna snabbstart har du en MCP-klient ansluten till ett Playwright-arbetsområde och kan köra en agentdriven webbläsaruppgift från GitHub Copilot CLI eller Microsoft Foundry.

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Om du inte har en Azure-prenumeration, skapa ett gratis konto innan du börjar.
• Ett Playwright-arbetsområde som är aktiverat för fjärrförhandsvisningen av MCP.
• Deltagare- eller Ägare-Azure-roll på arbetsområdesnivå. Denna roll krävs för att skapa en arbetsyteåtkomsttoken. För mer information, se Hantera åtkomst till en Playwright-arbetsyta.
• En av följande MCP-klienter:
  • GitHub Copilot CLI med MCP-stöd.
  • Ett Microsoft Foundry-projekt med tillstånd att skapa projektanslutningar och konfigurera agenter.

Välj en autentiseringsmetod

Använd Microsoft Entra ID när din MCP-klient stödjer OAuth eller managed identity. Den fjärrstyrda MCP-servern använder denna resursidentifierare och delegerade omfattning:

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

Servern publicerar OAuth-metadata för skyddade resurser. Klienter som stöder OAuth-upptäckt, inklusive Visual Studio Code, kan identifiera auktorisationsservern och det behörighetsomfång som krävs via den arbetsyteavgränsade MCP-slutpunkten. Den inloggade identiteten måste ha tillgång till Playwrights arbetsyta via Azure rollbaserad åtkomstkontroll (RBAC).

Använd en åtkomsttoken för arbetsområdet endast när MCP-klienten inte kan autentisera med Microsoft Entra ID. Åtkomsttokens är mindre säkra och inaktiveras som standard.

Skapa en åtkomsttoken för arbetsområdet för kompatibilitet

Hoppa över denna sektion när du använder Microsoft Entra ID. Om åtkomsttoken-autentisering inte redan är aktiverad för arbetsytan:

Skapa en åtkomsttoken för arbetsytan

Denna snabbstart använder nyckelbaserad autentisering. MCP-klienten skickar en åtkomsttoken för arbetsytan i begäranderubriken x-api-key.

1. Logga in på Azure-portalen.
2. Öppna din Playwright-arbetsplats.
3. Under Inställningar, välj Åtkomsthantering.
4. Välj kryssrutan för Playwright Service Access Token om den inte redan är markerad.
5. Välj Generera token.
6. Ange ett namn och utgångsdatum och generera sedan token.
7. Kopiera token omedelbart. Du kan inte återfå dess värde senare.

Token är kopplad till användaren som skapar den. Tjänsten utvärderar användarens nuvarande Azure-rollbaserade åtkomstkontrollrättigheter (RBAC) när tokenen används. Använd en kort utgångstid för den här snabbstarten.

För mer information, se Hantera åtkomsttoken för arbetsytan.

Bygg den fjärrstyrda MCP-endpointen

I Azure-portalen, öppna Översiktssidan för din Playwright-arbetsyta. Använd workspace-regionen och workspace-ID:t för att bygga den fjärrstyrda MCP-endpointen.

Slutpunkten använder följande format:

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

Ett exempel:

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

Använd endpointen för regionen där arbetsytan är distribuerad.

Anslut en MCP-klient

Välj den MCP-klient du vill använda.

GitHub Copilot CLI

För att lägga till Arbetsutrymmen för dramatiker fjärr-MCP-server i GitHub Copilot CLI:

1. Öppna GitHub Copilot CLI.
2. Ange /mcp add.
3. Ange ett unikt servernamn, såsom playwrightWorkspace.
4. Välj HTTP som servertyp.
5. Ange den fjärranslutna MCP-ändpunkten.
6. Lägg till en HTTP-header med namnet x-api-key och använd workspace access token som dess värde.
7. Välj Auto för uppskjutna verktyg.
8. Tryck på Esc för att slutföra tillägget av servern.

Microsoft Foundry

Anslut fjärrservern som anpassat MCP-verktyg. Foundry lagrar arbetsytans åtkomsttoken i en projektanslutning.

För att ansluta den fjärranslutna MCP-servern:

1. Öppna ditt projekt i Microsoft Foundry-portalen.
2. Välj Byggverktyg> och välj sedanLägg till verktyg>Custom>Model Context Protocol.
3. Ange playwrightWorkspace som det unika namnet.
4. Ange den fjärrstyrda MCP-serverns endpoint.
5. Välj nyckelbaserad autentisering.
6. Ange x-api-key som legitimationsnamn och arbetsyteåtkomsttoken som legitimationsvärde.
7. Välj Anslut. Foundry skapar projektkopplingen.

Skapa eller öppna en agent, lägg till fjärr-MCP-verktyget och välj projektanslutningen. Kräv godkännande för varje verktygssamtal medan du utvärderar integrationen. Att kräva godkännande låter dig inspektera verktygets namn och argument innan varje webbläsaroperation.

För aktuella anslutningsfält och godkännandebeteende, se Koppla Microsoft Foundry-agenter till MCP-serverns slutpunkter.

Kör din första webbläsaruppgift

Skicka följande prompt till agenten:

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.

Verifiera att agenten följer denna sekvens:

1. Kallar create_browser_session och behåller den returnerade browserSessionId.
2. Anropar browser_navigate med sessions-ID:t och https://example.com.
3. Anropar browser_snapshot eller browser_find med samma sessions-ID.
4. Rapporterar rubriken Exempel på Domän och sidans URL.
5. Anropar close_browser_session med sessions-ID:t.

Ett lyckat resultat liknar följande resultat:

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

Det exakta svaret varierar beroende på agent och modell. Resultatet för sessionsskapandet kan också innehålla en live-view-URL. Det slutgiltiga svaret bekräftar inte att det är städat. Granska verktygsanropshistoriken och verifiera att det close_browser_session lyckades.

Rensa resurser

När du är klar med quickstart:

1. Bekräfta att agenten ringde close_browser_session.
2. Om du skapade ett Playwright-arbetsområde enbart för denna snabbstart, ta bort dess resursgrupp. Ta inte bort en resursgrupp som innehåller resurser du vill behålla.

Nästa steg