Інструменти 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 для браузера. Не відкривайте його через публічний зворотний проксі або не публікуйте його файли виявлення. Ротація токенів анулює старі облікові дані; оновіть вашу локальну інтеграцію після цього.