Инструменты MCP и локальный HTTP API

1. check_connection → list_profiles
2. open_profile с точным profile_id; сохраняйте возвращённое browser_session_id.
3. browser_pages чтобы выбрать точное page_id.
4. browser_snapshot чтобы получить новые ссылки на элементы и snapshot_id.
5. Используйте соответствующие ссылки на сессию, страницу, снимок и элементы для действий. Сделайте новый снимок после изменения страницы.
6. release_browser когда закончите. Используйте close_profile только по запросу закрыть профиль.

У профиля в каждый момент времени есть только один эксклюзивный управляющий клиент. Идентификаторы непрозрачны и не могут быть повторно использованы после перезапуска браузера. Выберите visible режим, когда человеку нужно войти или проверить работу; headless предназначен для совместимых фоновых задач.

Профили и страницы

• check_connection
• list_profiles
• open_profile
• close_profile
• release_browser
• browser_pages
• browser_new_page
• browser_close_page
• browser_activate_page

Навигация и взаимодействие

• browser_navigate
• browser_back
• browser_forward
• browser_reload
• browser_snapshot
• browser_click
• browser_click_coordinates
• browser_type
• browser_press
• browser_hover
• browser_select
• browser_scroll
• browser_drag
• browser_wait
• browser_handle_next_dialog

Данные и файлы

• browser_screenshot
• browser_upload_files
• browser_get_cookies
• browser_set_cookies
• browser_clear_cookies
• browser_storage_get
• browser_storage_set
• browser_storage_clear
• browser_grant_permissions
• browser_prepare_download
• browser_wait_download
• browser_evaluate

Это названия инструментов, а не полные схемы запросов. Подключенный сервер MCP сообщает текущие имена параметров и обязательные поля клиенту AI; используйте эту схему вместо догадок о параметрах. Инструменты Cookie, хранилище, загрузка и JavaScript могут получать доступ к конфиденциальным данным.

Включить Локальный API только если локальной интеграции требуется HTTP. Скопируйте текущую конечную точку loopback и токен доступа из API и MCP; порт назначается динамически. MCP остается доступным при отключенном HTTP.

GET http://127.0.0.1:<port>/v1/status
Authorization: Bearer <access-token>
X-IFox9-Client-ID: my-integration

Токен обязателен. Необязательный идентификатор клиента рекомендуется и должен содержать 1–64 символа ASCII, цифры, подчеркивания или дефисы. Примеры используют только заполнители. Никогда не публикуйте свой реальный токен.

GET /v1/profiles перечисляет профили; POST /v1/profiles/open открывает один. Успешные ответы используют {"ok":true,"data":…}; ошибки используют {"ok":false,"error":{"code":…,"message":…}}. См. общие коды ошибок.

HTTP-слушатель привязывается к 127.0.0.1, проверяет заголовки Host и не включает CORS для браузера. Не открывайте его через публичный обратный прокси и не публикуйте его файлы обнаружения. Смена токена делает недействительными старые учетные данные; обновите вашу локальную интеграцию после этого.