Inicio rápido: Automatiza tareas del navegador con el servidor remoto MCP de Espacios de trabajo de dramaturgo

Importante

El servidor remoto del Protocolo de Contexto de Modelo (MCP) de Espacios de trabajo de dramaturgo está en vista previa. Las funciones de vista previa no tienen un acuerdo de nivel de servicio y no se recomiendan para cargas de trabajo en producción. Las características, límites y disponibilidad pueden cambiar.

En este inicio rápido, conectas un agente de IA al servidor remoto MCP de Espacios de trabajo de dramaturgo. El agente utiliza un navegador en la nube gestionada para abrir una página web, inspeccionar su instantánea de accesibilidad, informar del contenido de la página y cerrar la sesión del navegador.

El servidor MCP remoto proporciona herramientas de automatización del navegador mediante HTTP streamable. No necesitas instalar Playwright, binarios del navegador ni un servidor MCP local en el entorno del agente.

Después de completar este inicio rápido, tienes un cliente MCP conectado a un espacio de trabajo de Playwright y puedes ejecutar una tarea de navegador dirigida por agente desde la CLI de GitHub Copilot o Microsoft Foundry.

Prerequisites

  • Una cuenta de Azure con una suscripción activa. Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
  • Un espacio de trabajo de Playwright habilitado para la vista previa remota del MCP.
  • El rol de Contribuidor o Propietario en Azure en el ámbito del espacio de trabajo. Este rol es necesario para crear un token de acceso al espacio de trabajo. Para más información, consulte Gestionar el acceso a un espacio de trabajo de dramaturgos.
  • Uno de los siguientes clientes MCP:
    • CLI de GitHub Copilot con soporte para MCP.
    • Un proyecto de Microsoft Foundry con permiso para crear conexiones de proyecto y configurar agentes.

Elección de un método de autenticación

Utiliza Microsoft Entra ID cuando tu cliente MCP soporte OAuth o identidad gestionada. El servidor MCP remoto utiliza este identificador de recurso y el alcance delegado:

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

El servidor publica metadatos de recursos protegidos OAuth. Los clientes que admiten el descubrimiento de OAuth, entre ellos Visual Studio Code, pueden detectar el servidor de autorización y el ámbito requerido a partir del punto de conexión MCP con ámbito de espacio de trabajo. La identidad que ha iniciado sesión debe tener acceso al espacio de trabajo de Playwright mediante el control de acceso basado en roles (RBAC) de Azure.

Usa un token de acceso al espacio de trabajo solo cuando el cliente MCP no pueda autenticarse con Microsoft Entra ID. Los tokens de acceso son menos seguros y están deshabilitados por defecto.

Crea un token de acceso al espacio de trabajo para compatibilidad

Omite esta sección cuando uses Microsoft Entra ID. Si la autenticación con token de acceso no está ya habilitada para el espacio de trabajo:

Crear un token de acceso al espacio de trabajo

Este inicio rápido utiliza autenticación basada en claves. El cliente MCP envía un token de acceso al espacio de trabajo en la cabecera de x-api-key la solicitud.

Caution

Microsoft Entra ID es el método de autenticación recomendado para Espacios de trabajo de dramaturgo. Los tokens de acceso son menos seguros y están deshabilitados por defecto. Trata un token de acceso como una contraseña. Nunca lo comprometas en control de versiones ni lo incluyas en instrucciones de agentes, prompts o registros.

  1. Inicie sesión en Azure Portal.
  2. Abre tu espacio de trabajo de Dramaturgo.
  3. En Configuración, selecciona Gestión de acceso.
  4. Selecciona la casilla Playwright Service Access Token si aún no está seleccionada.
  5. Seleccione Generar token.
  6. Introduce un nombre y una fecha de caducidad, y luego genera el token.
  7. Copie el token inmediatamente. No puedes recuperar su valor más adelante.

El token está asociado al usuario que lo crea. El servicio evalúa los permisos actuales de control de acceso basado en roles (RBAC) de Azure cuando se utiliza el token. Utiliza un periodo de caducidad corto para este inicio rápido.

Para más información, consulte Gestionar tokens de acceso al espacio de trabajo.

Crea el extremo remoto de MCP

En el portal de Azure, abre la página de Resumen de tu espacio de trabajo de Playwright. Utiliza la región del espacio de trabajo y el ID del espacio de trabajo para construir el endpoint MCP remoto.

Captura de pantalla de una página de visión general del espacio de trabajo de Playwright que muestra la ubicación del espacio de trabajo y el punto final de la base de la API.

El endpoint utiliza el siguiente formato:

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

Por ejemplo:

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

Utiliza el endpoint de la región donde se despliega el workspace.

Conecta un cliente MCP

Elige el cliente MCP que quieras usar.

CLI de GitHub Copilot

Para añadir el servidor remoto MCP de Espacios de trabajo de dramaturgo a la CLI de GitHub Copilot:

  1. Abra la CLI de GitHub Copilot.
  2. Escribe /mcp add.
  3. Introduce un nombre único de servidor, como playwrightWorkspace.
  4. Selecciona HTTP como tipo de servidor.
  5. Introduzca el extremo remoto de MCP.
  6. Añade un encabezado HTTP nombrado x-api-key y usa el token de acceso al espacio de trabajo como su valor.
  7. Selecciona Auto para herramientas diferidas.
  8. Pulsa Esc para terminar de añadir el servidor.

Captura de pantalla de las indicaciones de la CLI de GitHub Copilot para añadir un servidor MCP remoto por HTTP.

Microsoft Foundry

Conecta el servidor remoto como una herramienta MCP personalizada. Foundry almacena el token de acceso al espacio de trabajo en una conexión de proyecto.

Note

Una clave almacenada en una conexión de proyecto Foundry es un secreto compartido del proyecto. Los miembros del Project que usan la conexión emplean la identidad y los permisos asociados al token. Utiliza un token dedicado con el menor privilegio y restringe el acceso al proyecto.

Para conectar el servidor MCP remoto:

  1. Abre tu proyecto en el portal de Microsoft Foundry.
  2. Selecciona Herramientas de compilación> y luego selecciona Añadir herramienta>Protocolo de contexto personalizado> del modelo.
  3. Introduce playwrightWorkspace como nombre único.
  4. Introduzca el punto de conexión remoto del servidor MCP.
  5. Selecciona autenticación basada en claves.
  6. Introduce x-api-key como nombre de credencial y token de acceso al espacio de trabajo como valor de la credencial.
  7. Seleccione Conectar. Foundry crea la conexión con el proyecto.

Captura de pantalla de la configuración de Microsoft Foundry para añadir una herramienta remota de Model Context Protocol con autenticación basada en claves.

Crea o abre un agente, añade la herramienta MCP remota y selecciona la conexión del proyecto. Exige aprobación para cada llamada de herramienta mientras evalúas la integración. Exigir aprobación te permite inspeccionar el nombre de la herramienta y los argumentos antes de cada operación de navegador.

Para los campos de conexión actuales y el comportamiento de aprobación, véase Conectar agentes de Microsoft Foundry a los extremos del servidor MCP.

Ejecuta tu primera tarea de navegador

Introduce la siguiente instrucción al 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 que el agente siga esta secuencia:

  1. Llama a create_browser_session y conserva el browserSessionId devuelto.
  2. Llama a browser_navigate con el ID de sesión y https://example.com.
  3. Llama a browser_snapshot o a browser_find con el mismo ID de sesión.
  4. Informa sobre el encabezado Example Domain y la URL de la página.
  5. Llama a close_browser_session con el ID de sesión.

Un resultado exitoso se asemeja al siguiente resultado:

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

La respuesta exacta varía según el agente y el modelo. El resultado de creación de sesión también puede contener una URL de visualización en vivo. La respuesta final por sí sola no confirma la limpieza. Revisa el historial de llamadas a la herramienta y verifica si close_browser_session ha funcionado.

Caution

Las sesiones remotas del navegador consumen capacidad de espacio de trabajo y pueden generar cargos. Cierra cada sesión tan pronto como termine la tarea.

Limpieza de recursos

Cuando termines el inicio rápido:

  1. Confirma que el agente llamó a close_browser_session.
  2. Si creaste un espacio de trabajo de Playwright solo para este inicio rápido, elimina su grupo de recursos. No borres un grupo de recursos que contiene recursos que quieres conservar.

Paso siguiente

Automatiza los navegadores con el servidor remoto MCP de Espacios de trabajo de dramaturgo

  • Se actualizó por última vez el