MCP araçları ve yerel HTTP API

1. check_connection → list_profiles
2. open_profile aracını doğru profile_id ile çağırın ve döndürülen browser_session_id değerini saklayın.
3. browser_pages ile doğru page_id değerini seçin.
4. browser_snapshot ile güncel öğe referanslarını ve snapshot_id değerini alın.
5. İşlemlerde birbiriyle eşleşen oturum, sayfa, anlık görüntü ve öğe referanslarını kullanın. Sayfa değiştiğinde yeni bir anlık görüntü alın.
6. İşiniz bittiğinde release_browser aracını çağırın. close_profile aracını yalnızca profilin kapatılması istendiğinde kullanın.

Bir profili aynı anda yalnızca bir istemci kontrol edebilir. Kimlik değerlerinden anlam çıkarılmamalıdır ve bu değerler tarayıcı yeniden başlatıldıktan sonra kullanılamaz. Bir kişinin oturum açması veya işi incelemesi gerekiyorsa visible modunu seçin; headless modu 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 yapay zekâ istemcisine gerekli alanları bildirir; tahmin etmek yerine o şemayı kullanın. Çerez, depolama, yükleme ve JavaScript araçları hassas verilere erişebilir.

Local API seçeneğini yalnızca yerel entegrasyon HTTP gerektiriyorsa etkinleştirin. Geçerli loopback uç noktasını ve erişim tokenını API & MCP bölümünden kopyalayın; 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ın biçimi {"ok":true,"data":…}; hata yanıtlarının biçimi {"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.