Инструменты 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 сообщает текущие имена параметров и обязательные поля клиенту ИИ; используйте эту схему вместо догадок о параметрах. Инструменты Cookie, хранилище, загрузка и JavaScript могут получать доступ к конфиденциальным данным.

Включите Local 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 для браузера. Не открывайте его через публичный обратный прокси и не публикуйте его файлы обнаружения. Смена токена делает недействительными старые учетные данные; обновите вашу локальную интеграцию после этого.