Démarrage rapide : Automatisez les tâches du navigateur avec le serveur distant MCP Espaces de travail pour les dramaturges

Dans ce démarrage rapide, vous connectez un agent IA au serveur MCP distant Espaces de travail pour les dramaturges. L’agent utilise un navigateur cloud géré pour ouvrir une page web, inspecter son instantané d’accessibilité, signaler le contenu de la page et fermer la session du navigateur.

Le serveur MCP distant fournit des outils d’automatisation du navigateur via HTTP en streaming. Vous n’avez pas besoin d’installer Playwright, les binaires du navigateur ou un serveur MCP local dans l’environnement de l’agent.

Après avoir terminé ce démarrage rapide, vous avez un client MCP connecté à un espace de travail Playwright et pouvez exécuter une tâche de navigateur piloté par agent depuis GitHub Copilot CLI ou Microsoft Foundry.

Conditions préalables

• Un compte Azure avec un abonnement actif. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
• Un espace de travail Playwright activé pour l’aperçu MCP à distance.
• Le rôle Azure Contributeur ou Propriétaire au niveau de l’espace de travail. Ce rôle est nécessaire pour créer un jeton d’accès à l’espace de travail. Pour plus d’informations, voir Gérer l’accès à un espace de travail pour dramaturges.
• L’un des clients MCP suivants :
  • GitHub Copilot CLI avec support MCP.
  • Un projet Microsoft Foundry avec la permission de créer des connexions de projet et de configurer des agents.

Choisir une méthode d’authentification

Utilisez Microsoft Entra ID lorsque votre client MCP prend en charge OAuth ou identité managée. Le serveur MCP distant utilise cet identifiant de ressource et cette portée déléguée :

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

Le serveur publie les métadonnées OAuth à ressource protégée. Les clients qui prennent en charge la découverte OAuth, y compris Visual Studio Code, peuvent découvrir le serveur d’autorisation et la portée requise depuis le point de terminaison MCP à portée de l’espace de travail. L’identité connectée doit avoir accès à l’espace de travail Playwright via le contrôle d’accès basé sur les rôles (RBAC) Azure.

Utilisez un jeton d'accès à l'espace de travail uniquement lorsque le client MCP ne peut pas s'authentifier avec Microsoft Entra ID. Les jetons d’accès sont moins sécurisés et désactivés par défaut.

Créer un jeton d’accès à l’espace de travail pour la compatibilité

Passez cette section lorsque vous utilisez Microsoft Entra ID. Si l’authentification par jeton d’accès n’est pas déjà activée pour l’espace de travail :

Créer un jeton d’accès à l’espace de travail

Ce démarrage rapide utilise une authentification basée sur des clés. Le client MCP envoie un jeton d’accès à l’espace de travail dans l’en-tête x-api-key de la requête.

1. Connectez-vous au portail Azure.
2. Ouvrez votre espace de travail pour dramaturge.
3. Dans Paramètres, sélectionnez Gestion d’accès.
4. Sélectionnez la case Playwright Service Access Token si elle n’est pas déjà sélectionnée.
5. Sélectionnez Générer un jeton.
6. Saisissez un nom et une date d’expiration, puis générez le jeton.
7. Copiez immédiatement le jeton. Vous ne pourrez pas en récupérer la valeur plus tard.

Le jeton est associé à l’utilisateur qui le crée. Le service évalue les autorisations actuelles de contrôle d’accès en fonction du rôle Azure (RBAC) de cet utilisateur lors de l’utilisation du jeton. Utilisez une courte période d’expiration pour ce démarrage rapide.

Pour plus d’informations, voir Gérer les jetons d’accès à l’espace de travail.

Construisez le point de terminaison MCP distant

Dans le portail Azure, ouvrez la page Aperçu de votre espace de travail Playwright. Utilisez la région de l’espace de travail et l’identifiant de l’espace de travail pour construire le point de terminaison MCP distant.

Le point de terminaison utilise le format suivant :

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

Par exemple:

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

Utilisez le point de terminaison pour la région où l’espace de travail est déployé.

Connectez un client MCP

Choisissez le client MCP que vous souhaitez utiliser.

GitHub Copilot CLI

Pour ajouter le serveur distant MCP de Espaces de travail pour les dramaturges à la CLI de GitHub Copilot :

1. Ouvrez l’interface de ligne de commande GitHub Copilot.
2. Appuyez sur /mcp add.
3. Entrez un nom de serveur unique, tel que playwrightWorkspace.
4. Sélectionnez HTTP comme type de serveur.
5. Saisissez le point de terminaison MCP distant.
6. Ajoutez un en-tête HTTP nommé x-api-key et utilisez le jeton d’accès à l’espace de travail comme valeur.
7. Sélectionnez Auto pour les outils différés.
8. Appuie sur Échap pour finir d’ajouter le serveur.

Microsoft Foundry

Connectez le serveur distant comme un outil MCP personnalisé. Foundry stocke le jeton d’accès à l’espace de travail dans une connexion de projet.

Pour connecter le serveur MCP distant :

1. Ouvrez votre projet dans le portail Microsoft Foundry.
2. Sélectionnez Outils de compilation>, puis sélectionnez Ajouter outil>Modèle personnalisé>Protocole de contexte.
3. Entrez playwrightWorkspace comme nom unique.
4. Saisissez le point de terminaison du serveur MCP distant.
5. Sélectionnez l’authentification basée sur les clés.
6. Entrez x-api-key comme nom de l’identifiant et le jeton d’accès à l’espace de travail comme valeur de l’identifiant.
7. Sélectionnez Se connecter. Foundry crée la connexion du projet.

Créez ou ouvrez un agent, ajoutez l’outil MCP distant, et sélectionnez la connexion au projet. Exigez l’approbation de chaque appel d’outil pendant que vous évaluez l’intégration. Exiger l’approbation vous permet d’inspecter le nom de l’outil et les arguments avant chaque opération de navigateur.

Pour les champs de connexion actuels et le comportement d’approbation, voir Connecter les agents Microsoft Foundry aux points de terminaison serveur MCP.

Exécutez votre première tâche de navigateur

Soumettez la consigne suivante à l’agent :

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.

Vérifiez que l’agent suit cette séquence :

1. Appelle create_browser_session et conserve la valeur renvoyée browserSessionId.
2. Appelle browser_navigate avec l’identifiant de session et https://example.com.
3. Appels browser_snapshot ou browser_find avec le même identifiant de session.
4. Rapporte l’en-tête du domaine d’exemple et l’URL de la page.
5. Appeler close_browser_session avec l’identifiant de session.

Un résultat réussi ressemble au résultat suivant :

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

La réponse exacte varie selon l’agent et le modèle. Le résultat de création de session peut également contenir une URL de vue en direct. La réponse finale seule ne confirme pas le nettoyage. Examinez l’historique des appels à l’outil et vérifiez que close_browser_session a réussi.

Nettoyer les ressources

Quand vous avez terminé le démarrage rapide :

1. Confirmez que l’agent a appelé close_browser_session.
2. Si vous avez créé un espace de travail Playwright uniquement pour ce démarrage rapide, supprimez son groupe de ressources. Ne supprimez pas un groupe de ressources qui contient des ressources que vous souhaitez conserver.

Étape suivante