Alat & API HTTP lokal MCP

1. check_connection → list_profiles
2. open_profile dengan tepat profile_id; pertahankan yang dikembalikan browser_session_id.
3. browser_pages untuk memilih yang tepat page_id.
4. browser_snapshot untuk mendapatkan referensi elemen terbaru dan sebuah snapshot_id.
5. Gunakan sesi, halaman, snapshot, dan referensi elemen yang cocok untuk tindakan. Ambil snapshot baru setelah halaman berubah.
6. release_browser ketika selesai. Gunakan close_profile hanya ketika diminta untuk menutup profil.

Satu profil hanya memiliki satu klien pengontrol eksklusif pada satu waktu. ID bersifat tertutup dan tidak dapat digunakan kembali setelah browser di-restart. Pilih visible mode ketika seseorang perlu masuk atau memeriksa pekerjaan; headless adalah untuk tugas latar belakang yang kompatibel.

Profil & halaman

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

Navigasi & interaksi

• 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

Data & file

• 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

Ini adalah nama alat, bukan skema permintaan lengkap. Server MCP yang terhubung mengiklankan nama parameter saat ini dan bidang yang diperlukan ke klien AI; gunakan skema itu daripada menebak argumen. Alat Cookie, penyimpanan, unggahan, dan JavaScript dapat mengakses data sensitif.

Aktifkan API Lokal hanya jika integrasi lokal membutuhkan HTTP. Salin endpoint loopback saat ini dan token akses dari API & MCP; port ditetapkan secara dinamis. MCP tetap tersedia dengan HTTP dinonaktifkan.

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

Token diperlukan. ID klien opsional direkomendasikan dan harus berupa 1–64 huruf ASCII, angka, garis bawah, atau tanda hubung. Contoh hanya menggunakan placeholder. Jangan pernah mempublikasikan token asli Anda.

GET /v1/profiles menampilkan daftar profil; POST /v1/profiles/open membuka salah satunya. Respons sukses menggunakan {"ok":true,"data":…}; kegagalan menggunakan {"ok":false,"error":{"code":…,"message":…}}. Lihat kode kesalahan umum.

Listener HTTP terikat ke 127.0.0.1, memvalidasi header Host, dan tidak mengaktifkan CORS browser. Jangan mengeksposnya melalui reverse proxy publik atau menerbitkan file penemuannya. Rotasi token membuat kredensial lama tidak berlaku; perbarui integrasi lokal Anda setelahnya.