Quickstart: Automatizza le attività del browser con il server remoto MCP di Spazi di lavoro Playwright

Important

Il server remoto Spazi di lavoro Playwright Model Context Protocol (MCP) è in anteprima. Le funzionalità di anteprima non hanno un accordo di livello di servizio e non sono raccomandate per i carichi di lavoro di produzione. Funzionalità, limiti e disponibilità possono cambiare.

In questo quickstart, colleghi un agente AI al server remoto MCP di Spazi di lavoro Playwright. L'agente utilizza un browser cloud gestito per aprire una pagina web, ispezionarne l'istantanea di accessibilità, segnalare il contenuto della pagina e chiudere la sessione del browser.

Il server MCP remoto fornisce strumenti di automazione del browser tramite HTTP streamable. Non è necessario installare Playwright, binari del browser o un server MCP locale nell'ambiente agente.

Dopo aver completato questo avvio rapido, hai un client MCP collegato a uno spazio di lavoro Playwright e puoi eseguire un compito di browser guidato da agenti tramite GitHub Copilot CLI o Microsoft Foundry.

Prerequisiti

  • Un account Azure con una sottoscrizione attiva. Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
  • Uno spazio di lavoro Playwright abilitato per l'anteprima remota MCP.
  • Il ruolo Contributore o Proprietario Azure nell'ambito dello spazio di lavoro. Questo ruolo è necessario per creare un token di accesso allo spazio di lavoro. Per maggiori informazioni, vedi Gestire l'accesso a uno spazio di lavoro per drammaturghi.
  • Uno dei seguenti clienti MCP:
    • CLI di GitHub Copilot con supporto MCP.
    • Un progetto Microsoft Foundry con il permesso di creare connessioni di progetto e configurare agenti.

Scegliere un metodo di autenticazione

Usa Microsoft Entra ID quando il tuo client MCP supporta OAuth o identità gestita. Il server MCP remoto utilizza questo identificatore di risorsa e l'ambito delegato:

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

Il server pubblica metadati OAuth con risorse protette. I client che supportano la scoperta OAuth, tra cui Visual Studio Code, possono individuare il server di autorizzazione e lo scope richiesto dall'endpoint MCP con ambito workspace. L'identità con cui è stato effettuato l'accesso deve disporre dell'accesso allo spazio di lavoro Playwright tramite il controllo degli accessi in base al ruolo (RBAC) di Azure.

Usa un token di accesso allo spazio di lavoro solo quando il client MCP non può autenticarsi con Microsoft Entra ID. I token di accesso sono meno sicuri e sono disabilitati di default.

Crea un token di accesso allo spazio di lavoro per la compatibilità

Salta questa sezione quando usi Microsoft Entra ID. Se l'autenticazione tramite access-token non è già abilitata per lo spazio di lavoro:

Crea un token di accesso allo spazio di lavoro

Questo quickstart utilizza l'autenticazione basata su chiavi. Il client MCP invia un token di accesso allo spazio di lavoro nell'intestazione x-api-key della richiesta.

Caution

Microsoft Entra ID è il metodo di autenticazione consigliato per Spazi di lavoro Playwright. I token di accesso sono meno sicuri e sono disabilitati di default. Tratta un token di accesso come una password. Non eseguirne mai il commit nel controllo di origine né includerlo nelle istruzioni per gli agenti, nei prompt o nei log.

  1. Accedi al portale di Azure.
  2. Apri il tuo spazio di lavoro da Drammaturghino.
  3. Sotto Impostazioni, seleziona Gestione Accessi.
  4. Seleziona la casella Playwright Service Access Token se non è già selezionata.
  5. Selezionare Genera token.
  6. Inserisci un nome e una data di scadenza, poi genera il token.
  7. Copiare immediatamente il token. Non puoi recuperarne il valore in seguito.

Il token è associato all'utente che lo crea. Il servizio valuta i permessi attuali di controllo di accesso basato sul ruolo (RBAC) di Azure di quell'utente quando il token viene utilizzato. Usare un periodo di scadenza breve per questa guida di avvio rapido.

Per ulteriori informazioni, vedi Gestisci i token di accesso allo spazio di lavoro.

Costruisci l'endpoint MCP remoto

Nel portale Azure, apri la pagina Panoramica del tuo spazio di lavoro Playwright. Usa la regione dello spazio di lavoro e l'ID dello spazio per costruire l'endpoint remoto MCP.

Screenshot di una pagina panoramica di un workspace Playwright che mostra la posizione dello spazio di lavoro e l'endpoint della base API.

L'endpoint utilizza il seguente formato:

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

Per esempio:

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

Usa l'endpoint per la regione in cui lo spazio di lavoro è distribuito.

Collega un client MCP

Scegli il client MCP che vuoi usare.

interfaccia della riga di comando (CLI) di GitHub Copilot

Per aggiungere il server remoto MCP di Spazi di lavoro Playwright alla CLI di GitHub Copilot:

  1. Apri la CLI di GitHub Copilot.
  2. Inserisci /mcp add.
  3. Inserisci un nome server univoco, come playwrightWorkspace.
  4. Seleziona HTTP come tipo di server.
  5. Inserisci l'endpoint MCP remoto.
  6. Aggiungi un'intestazione HTTP chiamata x-api-key e usa il token di accesso allo spazio di lavoro come suo valore.
  7. Seleziona Auto per gli strumenti posticipati.
  8. Premi Esc per completare l'aggiunta del server.

Screenshot dei prompt CLI di GitHub Copilot per aggiungere un server MCP HTTP remoto.

Microsoft Foundry

Collega il server remoto come uno strumento MCP personalizzato. Foundry memorizza il token di accesso allo spazio di lavoro in una connessione di progetto.

Note

Una chiave memorizzata in una connessione di progetto Foundry è un segreto condiviso di progetto. I membri del Project che utilizzano la connessione utilizzano l'identità e i permessi associati al token. Usa un token dedicato con il minimo privilegio e limita l'accesso al progetto.

Per collegare il server MCP remoto:

  1. Apri il tuo progetto nel portale Microsoft Foundry.
  2. Seleziona Strumenti di Build>, poi seleziona Aggiungi strumento>Custom>Model Context Protocol.
  3. Inserisci playwrightWorkspace come nome unico.
  4. Inserisci l'endpoint del server MCP remoto.
  5. Seleziona autenticazione basata su chiavi.
  6. Inserisci x-api-key come nome della credenziale e token di accesso allo spazio di lavoro come valore della credenziale.
  7. Selezionare Connetti. Foundry crea il collegamento con il progetto.

Screenshot delle impostazioni di Microsoft Foundry per aggiungere uno strumento remoto Model Context Protocol con autenticazione basata su chiavi.

Crea o apri un agente, aggiungi lo strumento MCP remoto e seleziona la connessione al progetto. Richiedi l'approvazione per ogni chiamata di strumento mentre valuti l'integrazione. Richiedere l'approvazione ti permette di ispezionare il nome dello strumento e gli argomenti prima di ogni operazione del browser.

Per i campi di connessione attuali e il comportamento di approvazione, vedi Collega Microsoft Foundry agents agli endpoint dei server MCP.

Esegui il tuo primo compito nel browser

Invia il seguente prompt all'agente:

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.

Verifica che l'agente segua questa sequenza:

  1. Chiama create_browser_session e conserva il valore restituito browserSessionId.
  2. Chiama browser_navigate con l'ID della sessione e https://example.com.
  3. Chiama browser_snapshot o browser_find con lo stesso ID di sessione.
  4. Riporta l'intestazione Example Domain e l'URL della pagina.
  5. Chiama close_browser_session con l'ID della sessione.

Un risultato positivo assomiglia al seguente risultato:

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

La risposta esatta varia a seconda dell'agente e del modello. Il risultato della creazione della sessione potrebbe anche contenere un URL di visualizzazione in tempo reale. La sola risposta finale non conferma la pulizia. Ispeziona la cronologia delle chiamate dello strumento e verifica che close_browser_session sia riuscito.

Caution

Le sessioni remote del browser consumano capacità di spazio di lavoro e potrebbero comportare addebiti. Chiudi ogni sessione non appena il compito termina.

Pulire le risorse

Al termine della guida di avvio rapido:

  1. Conferma che l'agente abbia chiamato close_browser_session.
  2. Se hai creato uno spazio di lavoro Playwright solo per questo avvio rapido, elimina il suo gruppo di risorse. Non cancellare un gruppo di risorse che contiene risorse che vuoi conservare.

Passo successivo

Automatizza i browser con il server remoto MCP di Spazi di lavoro Playwright

  • Ultimo aggiornamento: