Перейти к содержанию

Постоянный профиль входа

Используйте постоянный профиль, когда клиент 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.

Проверять

  1. Попросите клиент MCP открыть страницу входа и войдите в систему.
  2. Корректно остановите сервер.
  3. Запустите его снова с тем же PLAYWRIGHT_MCP_USER_DATA_DIR.
  4. Попросите клиент повторно открыть сайт и убедитесь, что состояние входа сохранилось.

Связанный

CloakBrowser 0.6.0

При включённом stealth CloakBrowser явно настроенный постоянный профиль сохраняет fingerprint seed в .cloakbrowser-seed. Первый запуск после обновления назначает seed, если файла нет. Явный --fingerprint, включая --fingerprint=off, имеет приоритет и оставляет файл без изменений. При выключенном stealth файл не изменяется. Повреждённый файл восстанавливается с предупреждением; ошибка доступа к файлу останавливает запуск.