Início Rápido: Automatize tarefas do navegador com o servidor remoto MCP do Workspaces do dramaturgo

Neste quickstart, você conecta um agente de IA ao servidor remoto MCP do Workspaces do dramaturgo. O agente usa um navegador em nuvem gerenciada para abrir uma página web, inspecionar seu instantâneo de acessibilidade, reportar o conteúdo da página e fechar a sessão do navegador.

O servidor MCP remoto fornece ferramentas de automação de navegador por HTTP com streaming. Você não precisa instalar Playwright, binários do navegador ou um servidor MCP local no ambiente do agente.

Depois de concluir esse quickstart, você terá um cliente MCP conectado a um workspace do Playwright e poderá executar uma tarefa de navegador orientada por agente a partir do GitHub Copilot CLI ou Microsoft Foundry.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
• Um espaço de trabalho do Playwright habilitado para a prévia remota do MCP.
• A função do Azure Colaborador ou Proprietário no escopo do espaço de trabalho. Esse papel é necessário para criar um token de acesso ao espaço de trabalho. Para mais informações, veja Gerenciar acesso a um espaço de trabalho de Playwright.
• Um dos seguintes clientes MCP:
  • CLI do GitHub Copilot com suporte a MCP.
  • Um projeto Microsoft Foundry com permissão para criar conexões de projeto e configurar agentes.

Escolher um método de autenticação

Use o Microsoft Entra ID quando seu cliente MCP for compatível com OAuth ou identidade gerenciada. O servidor MCP remoto usa este identificador de recurso e escopo delegado:

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

O servidor publica metadados de recursos protegidos OAuth. Clientes que oferecem suporte à descoberta do OAuth, incluindo o Visual Studio Code, podem descobrir o servidor de autorização e o escopo necessário a partir do endpoint MCP com escopo no workspace. A identidade logada deve ter acesso ao espaço de trabalho Playwright por meio do controle de acesso baseado em função (RBAC) do Azure.

Use um token de acesso ao workspace apenas quando o cliente MCP não conseguir se autenticar com o Microsoft Entra ID. Tokens de acesso são menos seguros e estão desativados por padrão.

Crie um token de acesso ao espaço de trabalho para compatibilidade

Pule esta seção quando usar o Microsoft Entra ID. Se a autenticação por token de acesso ainda não estiver ativada para o workspace:

Crie um token de acesso ao espaço de trabalho

Esse quickstart utiliza autenticação baseada em chaves. O cliente MCP envia um token de acesso ao workspace no cabeçalho da x-api-key requisição.

1. Entre no portal do Azure.
2. Abra seu espaço de trabalho de Playwright.
3. Em Configurações, selecione Gerenciamento de Acesso.
4. Selecione a caixa de seleção Playwright Service Access Token se ainda não estiver selecionada.
5. Selecione Gerar token.
6. Insira um nome e data de validade, e então gere o token.
7. Copie o token imediatamente. Você não pode recuperar seu valor depois.

O token está associado ao usuário que o cria. O serviço avalia as permissões atuais de controle de acesso baseado em funções (RBAC) do Azure desse usuário quando o token é utilizado. Use um período de expiração curto para esse quickstart.

Para mais informações, veja Gerenciar tokens de acesso ao espaço de trabalho.

Construa o endpoint remoto do MCP

No portal Azure, abra a página de Visão Geral do seu espaço de trabalho de Playwright. Use a região e a ID do espaço de trabalho para criar o ponto de extremidade MCP remoto.

O endpoint utiliza o seguinte formato:

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

Por exemplo:

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

Use o endpoint da região onde o workspace está implantado.

Conecte um cliente MCP

Escolha o cliente MCP que você quer usar.

CLI do GitHub Copilot

Para adicionar o servidor remoto MCP do Workspaces do dramaturgo ao GitHub Copilot CLI:

1. Abra a CLI do GitHub Copilot.
2. Insira /mcp add.
3. Insira um nome único de servidor, como playwrightWorkspace.
4. Selecione HTTP como tipo de servidor.
5. Digite o endpoint remoto do MCP.
6. Adicione um cabeçalho HTTP chamado x-api-key e use o token de acesso ao workspace como valor.
7. Selecione Auto para ferramentas diferidas.
8. Aperte Esc para terminar de adicionar o servidor.

Microsoft Foundry

Conecte o servidor remoto como uma ferramenta MCP personalizada. O Foundry armazena o token de acesso ao workspace em uma conexão de projeto.

Para conectar o servidor MCP remoto:

1. Abra seu projeto no portal do Microsoft Foundry.
2. Selecione Compilação>, e depois selecione Adicionar ferramenta>Personalizado>Model Context Protocol.
3. Insira playwrightWorkspace como o nome único.
4. Insira o endpoint do servidor MCP remoto.
5. Selecione autenticação baseada em chaves.
6. Insira x-api-key como nome da credencial e o token de acesso ao workspace como valor da credencial.
7. Selecione Conectar. A Foundry cria a conexão do projeto.

Crie ou abra um agente, adicione a ferramenta MCP remota e selecione a conexão do projeto. Exija aprovação para cada chamada de ferramenta enquanto avalia a integração. Exigir aprovação permite que você inspecione o nome da ferramenta e os argumentos antes de cada operação do navegador.

Para campos de conexão atuais e comportamento de aprovação, veja Conectar agentes do Microsoft Foundry aos endpoints do servidor MCP.

Execute sua primeira tarefa de navegador

Envie o seguinte prompt ao 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.

Verifique se o agente segue esta sequência:

1. Chama create_browser_session e mantém o valor retornado em browserSessionId.
2. Chama browser_navigate com o ID da sessão e https://example.com.
3. Chama browser_snapshot ou browser_find com o mesmo ID de sessão.
4. Reporta o título do Domínio de Exemplo e a URL da página.
5. Chama close_browser_session com o ID da sessão.

Um resultado bem-sucedido se assemelha ao seguinte resultado:

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

A resposta exata varia de agente para agente e modelo. O resultado da criação da sessão também pode conter uma URL de visualização ao vivo. A resposta final, por si só, não confirma a limpeza. Inspecione o histórico de chamadas de ferramentas e verifique se close_browser_session foi bem-sucedido.

Limpar os recursos

Quando você terminar o quickstart:

1. Confirme que o agente ligou close_browser_session.
2. Se você criou um espaço de trabalho do Playwright apenas para este início rápido, exclua o grupo de recursos dele. Não apague um grupo de recursos que contenha recursos que você quer manter.

Próximas etapas