Постоянный профиль входа¶
Используйте постоянный профиль, когда клиент MCP должен сохранять файлы cookie, локальное хранилище, кеш или состояние расширения между сеансами браузера.
npm¶
mkdir -p .profiles/default
PLAYWRIGHT_MCP_USER_DATA_DIR="$PWD/.profiles/default" \
npx -y cloakbrowser-mcp@latest
Направьте свой клиент MCP на ту же команду stdio. Сохраняйте по одному активному серверу в каждом каталоге профиля; мост отклоняет дублированное активное использование, чтобы снизить риск повреждения профиля Chromium.
После аварийного завершения мост удаляет .cloakbrowser-mcp-profile.lock только при корректном записанном идентификаторе процесса и подтверждённом отсутствии этого процесса. Блокировки с живым владельцем, нечитаемым или некорректным содержимым либо неопределённым состоянием процесса по-прежнему препятствуют запуску. Это восстановление не завершает оставшиеся процессы Chromium и не удаляет собственные блокировки Chromium.
Перезапускайте только один сервер на профиль одновременно: повторная проверка и удаление устаревшей блокировки не атомарны. Если запись во вновь созданный lock-файл завершается ошибкой, мост закрывает его файловый дескриптор и удаляет файл, только если путь по-прежнему указывает на этот файл.
Docker¶
docker run --rm -i \
-e PLAYWRIGHT_MCP_USER_DATA_DIR=/data/profiles/default \
-v "$PWD/artifacts:/data" \
swimmwatch/cloakbrowser-mcp:latest
Используйте пути к контейнерам в переменных среды. Путь к хосту используется только при монтировании -v.
Проверять¶
- Попросите клиент MCP открыть страницу входа и войдите в систему.
- Корректно остановите сервер.
- Запустите его снова с тем же
PLAYWRIGHT_MCP_USER_DATA_DIR. - Попросите клиент повторно открыть сайт и убедитесь, что состояние входа сохранилось.
Связанный¶
CloakBrowser 0.6.0¶
При включённом stealth CloakBrowser явно настроенный постоянный профиль сохраняет fingerprint seed в .cloakbrowser-seed. Первый запуск после обновления назначает seed, если файла нет. Явный --fingerprint, включая --fingerprint=off, имеет приоритет и оставляет файл без изменений. При выключенном stealth файл не изменяется. Повреждённый файл восстанавливается с предупреждением; ошибка доступа к файлу останавливает запуск.