Quickstart: Automatyzacja zadań przeglądarki za pomocą zdalnego serwera MCP Playwright Workspaces

W tym szybkim starcie łączysz agenta AI z odległym serwerem MCP Playwright Workspaces. Agent korzysta z zarządzanej przeglądarki chmurowej do otwarcia strony internetowej, przeglądania jej przeglądu dostępności, raportowania treści strony oraz zamknięcia sesji przeglądarki.

Zdalny serwer MCP udostępnia narzędzia do automatyzacji przeglądarki za pośrednictwem strumieniowego protokołu HTTP. Nie musisz instalować Playwrighta, binarnych plików przeglądarkowych ani lokalnego serwera MCP w środowisku agenta.

Po ukończeniu tego szybkiego startu masz klienta MCP podłączonego do przestrzeni roboczej Playwright i możesz uruchomić zadanie przeglądarki sterowane agentem z GitHub Copilot CLI lub Microsoft Foundry.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Jeśli nie masz subskrypcji Azure, przed rozpoczęciem utwórz darmowe konto.
• Obszar roboczy Playwright obsługujący zdalny podgląd MCP.
• Rola współtwórcy lub właściciela Azure w zakresie przestrzeni roboczej. Ta rola jest wymagana do stworzenia tokena dostępu do przestrzeni roboczej. Więcej informacji można znaleźć w artykule Zarządzaj dostępem do przestrzeni roboczej dramaturga.
• Jeden z następujących klientów MCP:
  • GitHub Copilot CLI z wsparciem MCP.
  • Projekt Microsoft Foundry z uprawnieniami do tworzenia połączeń projektów i konfigurowania agentów.

Zbuduj zdalny punkt końcowy MCP

W portalu Azure otwórz stronę Przegląd obszaru roboczego Playwright. Użyj regionu przestrzeni roboczej i identyfikatora przestrzeni roboczej do zbudowania zdalnego punktu końcowego MCP.

Punkt końcowy używa następującego formatu:

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

Przykład:

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

Użyj endpointu dla regionu, w którym wdrożony jest workspace.

Stwórz token dostępu do przestrzeni roboczej

Ten szybki start wykorzystuje uwierzytelnianie oparte na kluczu. Klient MCP wysyła token dostępu do przestrzeni roboczej w nagłówku żądania x-api-key .

1. Zaloguj się do portalu Azure.
2. Otwórz swoją przestrzeń do pracy dla dramaturgów.
3. W Ustawieniach wybierz Zarządzanie dostępem.
4. Zaznacz pole Playwright Service Access Token , jeśli nie jest jeszcze zaznaczone.
5. Wybierz pozycję Generuj token.
6. Wprowadź nazwę i datę ważności, a następnie wygeneruj token.
7. Natychmiast skopiuj token. Nie da się odzyskać jej wartości później.

Token jest powiązany z użytkownikiem, który go tworzy. Usługa ocenia aktualne uprawnienia użytkownika do kontroli dostępu opartej na roli Azure (RBAC) podczas użycia tokena. Użyj krótkiego okresu ważności na ten szybki start.

Więcej informacji można znaleźć w artykule Zarządzaj tokenami dostępu do przestrzeni roboczej.

Podłącz klienta MCP

Wybierz klienta MCP, którego chcesz używać.

interfejs wiersza polecenia GitHub Copilot

Aby dodać zdalny serwer MCP Playwright Workspaces do CLI GitHub Copilot:

1. Otwórz GitHub Copilot CLI.
2. Wprowadź wartość /mcp add.
3. Wprowadź unikalną nazwę serwera, na przykład .playwrightWorkspace
4. Wybierz HTTP jako typ serwera.
5. Wprowadź zdalny punkt końcowy MCP.
6. Dodaj nagłówek HTTP o nazwie x-api-key i użyj tokena dostępu do przestrzeni roboczej jako jego wartości.
7. Wybierz Auto dla narzędzi uruchamianych z opóźnieniem.
8. Naciśnij Esc , aby dokończyć dodawanie serwera.

Microsoft Foundry

Połącz zdalny serwer jako własne narzędzie MCP. Foundry przechowuje token dostępu do przestrzeni roboczej w połączeniu z projektem.

Aby podłączyć zdalny serwer MCP:

1. Otwórz swój projekt w portalu Microsoft Foundry.
2. Wybierz Kompilacja>Narzędzia, a następnie wybierz >Niestandardowe>Model Context Protocol.
3. Wpisz playwrightWorkspace jako unikalną nazwę.
4. Wprowadź punkt końcowy zdalnego serwera MCP.
5. Wybierz uwierzytelnianie oparte na kluczu.
6. Wpisz x-api-key nazwę poświadczenia, a token dostępu do przestrzeni roboczej jako wartość poświadczenia.
7. Wybierz Połącz. Foundry tworzy połączenie z projektem.

Utwórz lub otwórz agenta, dodaj zdalne narzędzie MCP i wybierz połączenie z projektem. Wymagaj zatwierdzenia każdego wywołania narzędzia, gdy oceniasz integrację. Wymaganie zgody pozwala sprawdzić nazwę narzędzia i argumenty przed każdą operacją przeglądarki.

Aktualne pola połączenia i zachowanie zatwierdzania można znaleźć w artykule Połącz agentów Microsoft Foundry z punktami końcowymi serwerów MCP.

Uruchom swoje pierwsze zadanie przeglądarki

Prześlij następujący prompt agentowi:

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.

Sprawdź, czy agent podąża za następującą sekwencją:

1. Wywołuje create_browser_session i zachowuje zwrócone browserSessionId.
2. Wywołuje browser_navigate, podając identyfikator sesji oraz https://example.com.
3. Połączenia browser_snapshot lub browser_find z tym samym identyfikatorem sesji.
4. Raportuje przykładowy nagłówek domeny oraz adres URL strony.
5. Wywołuje close_browser_session z identyfikatorem sesji.

Udany wynik przypomina następujące wyniki:

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

Dokładna odpowiedź różni się w zależności od agenta i modelu. Wynik tworzenia sesji może również zawierać adres URL widoku na żywo. Sama końcowa odpowiedź nie potwierdza przeprowadzenia czyszczenia. Sprawdź historię wywołań narzędzia i upewnij się, że close_browser_session zakończyło się powodzeniem.

Uprzątnij zasoby

Po zakończeniu szybkiego startu:

1. Potwierdź, że agent zadzwonił do close_browser_session.
2. Usuń agenta testowego lub połączenie projektu, jeśli już go nie potrzebujesz.
3. Cofnij tymczasowe tokeny dostępu do przestrzeni roboczej.
4. W GitHub Copilot CLI usuń serwer MCP, jeśli połączenie nie jest już potrzebne.
5. Jeśli utworzyłeś Playwright workspace tylko dla tego szybkiego startu, usuń jego grupę zasobów. Nie usuwaj grupy zasobów, która zawiera zasoby, które chcesz zachować.

Następny krok