MCP сервер для Playwright

MCP сервер для Playwright — это приложение, которое предоставляет AI-ассистентам возможности автоматизации браузера и взаимодействия с веб-страницами через стандартный протокол Model Context Protocol (MCP). Сервер использует структурированные accessibility-снимки страниц и не требует моделей со зрением. Разворачивается на виртуальной машине в Yandex Cloud.

Основные возможности и преимущества

• Интеграция с Yandex AI Studio. MCP сервер интегрируется с AI Studio MCP Серверы — подключите его к вашим AI-агентам в несколько кликов.
• Автоматизация браузера. Навигация по страницам, клики, ввод текста, заполнение форм и другие действия в Chromium через AI-ассистента.
• Accessibility-снимки страниц. Работа со структурированным представлением страницы без необходимости в распознавании изображений.
• Headless-режим. Браузер запускается без графического интерфейса для эффективной работы на серверах.
• Извлечение содержимого. Получение текста, ссылок, форм и других элементов веб-страниц.
• Скриншоты и PDF. Создание снимков экрана и PDF-документов из веб-страниц.
• Авторизация Bearer-токеном. Все запросы к MCP-серверу защищены Bearer-токеном, который хранится в Yandex Lockbox.
• Стандартный протокол MCP. Использует открытый протокол Model Context Protocol для взаимодействия с AI-моделями.
• HTTP with SSE транспорт. MCP сервер доступен на порту 8000 (HTTP with SSE).
• Минимальные ресурсы. Приложение работает на виртуальной машине с минимальной конфигурацией (2 vCPU, 2 GB RAM).
• Docker-контейнеризация. Сервер запускается в Docker-контейнерах (MCP + nginx auth proxy).

1. Создайте секрет в Yandex Lockbox для хранения Bearer-токена авторизации. Секрет должен содержать ключ bearer_token с произвольным токеном.
2. Создайте сервисный аккаунт с ролями compute.editor, iam.serviceAccounts.admin, lockbox.payloadViewer, vpc.admin (роль admin включает все указанные роли).
3. В консоли управления выберите сервис Cloud Apps.
4. На панели слева выберите Магазин приложений.
5. Выберите MCP Playwright и нажмите кнопку Использовать.
6. Укажите:
   • Имя приложения.
   • (Опционально) Описание приложения.
   • Сервисный аккаунт, созданный ранее.
   • Облачную подсеть, в которой будет развёрнута виртуальная машина.
   • Идентификатор секрета Lockbox с Bearer-токеном для авторизации.
7. Нажмите кнопку Установить и дождитесь, пока приложение установится.
8. После установки MCP сервер будет доступен по адресу http://<vm-ip>:8000.
9. Настройте ваш AI-клиент (Claude Desktop, Cursor и др.) для подключения к MCP серверу, указав заголовок Authorization: Bearer <ваш-токен>.

Подключение MCP-сервера к Yandex AI Studio

1. В консоли управления откройте сервис AI Studio и перейдите в раздел MCP Hub.
2. Нажмите Создать MCP-сервер и выберите тип Внешний MCP-сервер.
3. Укажите имя сервера и идентификатор сети VPC, в которой развёрнута виртуальная машина MCP-сервера. Идентификатор сети доступен на странице приложения в разделе Данные приложения, поле Идентификатор сети VPC.
4. На шаге подключения к MCP-серверу заполните параметры значениями из раздела Данные приложения:
   • Тип MCP-сервера — значение из поля Тип MCP-сервера.
   • URL MCP-сервера — значение из поля URL MCP-сервера (внутренний).
   • В блоке HTTP-заголовков добавьте заголовок Authorization со значением Bearer <bearer_token>, где <bearer_token> — токен из секрета Yandex Lockbox, указанного при установке приложения.
5. Нажмите Подключиться. После успешной проверки подключения выберите необходимые инструменты (tools) и нажмите Подключить — MCP-сервер будет зарегистрирован в AI Studio и доступен для использования AI-агентами.

• Автоматизация рутинных действий в браузере через AI-ассистента: заполнение форм, навигация по сайтам, сбор данных.
• Извлечение информации с веб-страниц с помощью accessibility-снимков без распознавания изображений.
• End-to-end тестирование веб-приложений с управлением сценариями через естественный язык.
• Создание скриншотов и PDF-снимков страниц для отчётов и архивации.
• Построение AI-агентов, способных взаимодействовать с современными веб-приложениями.

Служба технической поддержки Yandex Cloud отвечает на запросы 24 часа в сутки, 7 дней в неделю. Доступные виды запросов и срок их обработки зависят от тарифного плана. Подключить платную поддержку можно в консоли управления. Подробнее о порядке оказания технической поддержки.