MCP araçları ve yerel HTTP API

1. check_connection → list_profiles
2. open_profile tam olarak ile profile_id; döndürüleni koruyun browser_session_id.
3. browser_pages tam olarak seçmek için page_id.
4. browser_snapshot taze öğe referanslarını almak ve bir snapshot_id.
5. İşlemler için eşleşen oturum, sayfa, anlık görüntü ve öğe referanslarını kullanın. Sayfa değişikliklerinden sonra yeni bir anlık görüntü alın.
6. release_browser tamamlandığında. Kullanın close_profile yalnızca profil kapatmanız istendiğinde.

Bir profilin aynı anda bir tek özel kontrol eden istemcisi vardır. Kimlikler opaktır ve tarayıcı yeniden başlatıldıktan sonra yeniden kullanılamaz. Seçin visible bir kişi giriş yapması veya işi incelemesi gerektiğinde mod; headless uyumlu arka plan görevleri içindir.

Profiller ve sayfalar

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

Gezinti ve etkileşim

• 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

Veri ve dosyalar

• 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

Bunlar araç isimleridir, tam istek şemaları değildir. Bağlı MCP sunucusu mevcut parametre adlarını ve AI istemcisine gerekli alanları bildirir; tahmin etmek yerine o şemayı kullanın. Çerez, depolama, yükleme ve JavaScript araçları hassas verilere erişebilir.

Etkinleştir Yerel API yalnızca yerel bir bütünleşme HTTP gerektiriyorsa. Mevcut loopback uç noktasını ve erişim belirtecini kopyalayın API ve MCP; port dinamik olarak atanır. HTTP devre dışı bırakılmış olsa bile MCP kullanılabilir durumda kalır.

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

Belirteç gereklidir. İsteğe bağlı istemci kimliği önerilir ve 1–64 ASCII harfi, rakam, alt çizgi veya kısa çizgi olmalıdır. Örnekler yalnızca yer tutucu kullanır. Gerçek belirtecinizi asla yayınlamayın.

GET /v1/profiles profilleri listeler; POST /v1/profiles/open birini açar. Başarılı yanıtlar kullanır {"ok":true,"data":…}; hatalar kullanır {"ok":false,"error":{"code":…,"message":…}}. Bkz. yaygın hata kodları.

HTTP dinleyici 127.0.0.1 adresine bağlanır, Host başlıklarını doğrular ve tarayıcı CORS’unu etkinleştirmez. Bunu bir genel ters proxy üzerinden açmayın veya keşif dosyalarını yayınlamayın. Jeton döndürme, eski kimlik bilgilerini geçersiz kılar; sonra yerel entegrasyonunuzu güncelleyin.