Quickstart: Automatisieren Sie Browser-Aufgaben mit dem entfernten MCP-Server von Arbeitsbereiche für Dramatiker

In diesem Quickstart verbindest du einen KI-Agenten mit dem entfernten MCP-Server von Arbeitsbereiche für Dramatiker. Der Agent verwendet einen verwalteten Cloud-Browser, um eine Webseite zu öffnen, deren Barrierefreiheitssnapshot zu überprüfen, Seiteninhalte zu melden und die Browsersitzung zu schließen.

Der entfernte MCP-Server stellt Tools zur Browserautomatisierung über streamingfähiges HTTP bereit. Du musst keine Playwright-, Browser-Binärdateien oder einen lokalen MCP-Server in der Agent-Umgebung installieren.

Nachdem du diesen Quickstart abgeschlossen hast, hast du einen MCP-Client mit einem Playwright-Arbeitsbereich verbunden und kannst eine agentengesteuerte Browser-Aufgabe von GitHub Copilot CLI oder Microsoft Foundry ausführen.

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie noch kein Azure-Abonnement haben, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.
• Ein Playwright-Arbeitsbereich , der für die entfernte MCP-Vorschau aktiviert ist.
• Die Mitwirkender- oder Besitzer-Azure-Rolle auf Workspace-Ebene. Diese Rolle ist erforderlich, um ein Workspace-Zugriffstoken zu erstellen. Weitere Informationen finden Sie unter Verwalten des Zugriffs auf einen Playwright-Arbeitsbereich.
• Einer der folgenden MCP-Kunden:
  • GitHub Copilot CLI mit MCP-Unterstützung.
  • Ein Microsoft Foundry-Projekt mit der Berechtigung, Projektverbindungen zu erstellen und Agenten zu konfigurieren.

Auswählen einer Authentifizierungsmethode

Verwenden Sie Microsoft Entra ID, wenn Ihr MCP-Client OAuth oder Managed Identity unterstützt. Der entfernte MCP-Server verwendet diese Ressourcenkennung und den delegierten Umfang:

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

Der Server veröffentlicht OAuth-Metadaten für geschützte Ressourcen. Clients, die OAuth-Erkennung unterstützen, einschließlich Visual Studio Code, können den Autorisierungsserver und den erforderlichen Scope über den arbeitsbereichsspezifischen MCP-Endpunkt ermitteln. Die angemeldete Identität muss über Azure Role-Based Access Control (RBAC) Zugriff auf den Playwright-Arbeitsbereich haben.

Verwenden Sie nur dann ein Workspace-Zugriffstoken, wenn der MCP-Client sich nicht mit Microsoft Entra ID authentifizieren kann. Zugriffstoken sind weniger sicher und standardmäßig deaktiviert.

Erstelle ein Workspace-Zugriffstoken zur Kompatibilität

Überspringen Sie diesen Abschnitt, wenn Sie Microsoft Entra ID verwenden. Wenn die Zugangstoken-Authentifizierung für den Arbeitsbereich noch nicht aktiviert ist:

Erstellen Sie einen Arbeitsbereichs-Zugriffstoken

Dieser Quickstart verwendet schlüsselbasierte Authentifizierung. Der MCP-Client sendet ein Workspace-Zugriffstoken im x-api-key Anfrage-Header.

1. Melden Sie sich im Azure-Portal an.
2. Öffnen Sie Ihren Playwright-Arbeitsbereich.
3. Wählen Sie unter EinstellungenZugriffsverwaltung aus.
4. Wählen Sie das Kästchen Playwright Service Access Token aus, falls es noch nicht ausgewählt ist.
5. Wählen Sie "Token generieren" aus.
6. Geben Sie einen Namen und ein Ablaufdatum ein und generieren Sie dann das Token.
7. Kopieren Sie das Token sofort. Man kann seinen Wert später nicht mehr zurückholen.

Das Token ist mit dem Benutzer verknüpft, der es erstellt. Der Dienst bewertet die aktuellen Azure-Berechtigungen des Nutzers für rollenbasierte Zugriffskontrolle (RBAC), wenn das Token verwendet wird. Verwenden Sie eine kurze Ablaufzeit für diesen Schnellstart.

Weitere Informationen finden Sie unter Workspace Access Tokens verwalten.

Baue den entfernten MCP-Endpunkt

Im Azure-Portal öffnen Sie die Übersichtsseite Ihres Playwright-Arbeitsbereichs. Verwenden Sie die Workspace-Region und die Workspace-ID, um den entfernten MCP-Endpunkt zu erstellen.

Der Endpunkt verwendet folgendes Format:

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

Beispiel:

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

Verwenden Sie den Endpunkt für die Region, in der der Arbeitsbereich bereitgestellt wird.

Verbinden Sie einen MCP-Client

Wähle den MCP-Client, den du verwenden möchtest.

GitHub Copilot-CLI

Um den Arbeitsbereiche für Dramatiker Remote-MCP-Server zur GitHub Copilot CLI hinzuzufügen:

1. Öffnen Sie die GitHub Copilot-CLI.
2. Geben Sie /mcp add ein.
3. Geben Sie einen eindeutigen Servernamen ein, wie zum Beispiel playwrightWorkspace.
4. Wählen Sie HTTP als Servertyp aus.
5. Geben Sie den Remote-MCP-Endpunkt ein.
6. Füge einen HTTP-Header mit dem Namen x-api-key hinzu und verwende den Workspace Access Token als Wert.
7. Wähle Auto für aufgeschobene Werkzeuge.
8. Drücken Sie Esc, um das Hinzufügen des Servers abzuschließen.

Microsoft Foundry

Verbinde den entfernten Server als benutzerdefiniertes MCP-Tool. Foundry speichert den Arbeitsbereich-Zugriffstoken in einer Projektverbindung.

Um den entfernten MCP-Server zu verbinden:

1. Öffnen Sie Ihr Projekt im Microsoft Foundry Portal.
2. Wählen Sie Build>Tools aus, und wählen Sie dann >>Model Context Protocol.
3. Geben Sie playwrightWorkspace als eindeutigen Namen ein.
4. Geben Sie den Remote-MCP-Serverendpunkt ein.
5. Wählen Sie schlüsselbasierte Authentifizierung.
6. Geben Sie als Namen der Anmeldeinformationen x-api-key und als Wert der Anmeldeinformationen das Workspace-Zugriffstoken ein.
7. Wählen Sie Verbinden aus. Foundry stellt die Projektverbindung her.

Erstellen oder öffnen Sie einen Agenten, fügen Sie das Remote-MCP-Tool hinzu und wählen Sie die Projektverbindung aus. Fordern Sie die Genehmigung für jeden Tool-Aufruf, während Sie die Integration evaluieren. Die Genehmigungspflicht ermöglicht es Ihnen, den Toolnamen und die Argumente vor jedem Browserbesuch zu überprüfen.

Für aktuelle Verbindungsfelder und Genehmigungsverhalten siehe Verbinden von Microsoft Foundry Agents mit MCP-Server-Endpunkten.

Führe deine erste Browser-Aufgabe aus

Senden Sie den folgenden Prompt an den 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.

Überprüfen Sie, dass der Agent dieser Reihenfolge folgt:

1. Ruft create_browser_session auf und speichert das zurückgegebene browserSessionId.
2. Ruft browser_navigate mit der Session-ID und https://example.com auf.
3. Rufen Sie browser_snapshot oder browser_find mit derselben Session-ID auf.
4. Gibt die Beispiel-Domain-Überschrift und die Seiten-URL an.
5. Ruft close_browser_session mit der Sitzungs-ID auf.

Ein erfolgreiches Ergebnis ähnelt folgendem Ergebnis:

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

Die genaue Antwort variiert je nach Agent und Modell. Das Ergebnis der Sitzungserstellung könnte auch eine Live-View-URL enthalten. Die endgültige Antwort allein bestätigt keine Reinigung. Prüfen Sie den Verlauf der Tool-Aufrufe und vergewissern Sie sich, dass close_browser_session erfolgreich ausgeführt wurde.

Bereinigen von Ressourcen

Wenn du den Quickstart beendet hast:

1. Bestätigen Sie, dass der Agent close_browser_session angerufen hat.
2. Wenn du einen Playwright-Arbeitsbereich nur für diesen Quickstart erstellt hast, lösche die Ressourcengruppe. Lösche keine Ressourcengruppe, die Ressourcen enthält, die du behalten möchtest.

Nächster Schritt