MCP टूल्स और लोकल HTTP API
प्रोफाइल लीज़, ब्राउज़र सत्र, पेज स्नैपशॉट, और वैकल्पिक प्रमाणीकृत लूपबैक API को समझें।
आवश्यक अनुक्रम
check_connection→list_profilesopen_profileबिल्कुल के साथprofile_id; लौटाए गए को बनाए रखेंbrowser_session_id.browser_pagesको ठीक से चुनने के लिएpage_id.browser_snapshotताजा तत्व संदर्भ और एक पाने के लिएsnapshot_id.- कार्रवाई के लिए मेल खाते हुए सेशन, पेज, स्नैपशॉट और तत्व संदर्भ का उपयोग करें। पेज बदलने के बाद नया स्नैपशॉट लें।
release_browserसमाप्त होने पर। उपयोग करेंclose_profileकेवल तभी जब प्रोफ़ाइल बंद करने के लिए कहा गया हो।
एक प्रोफ़ाइल के पास एक समय में केवल एक विशेष नियंत्रक क्लाइंट होता है। आईडी अस्पष्ट होती हैं और ब्राउज़र रीस्टार्ट के बाद पुन: उपयोग नहीं की जा सकती। चुनें visible मोड जब किसी व्यक्ति को साइन इन करने या काम की जाँच करने की आवश्यकता हो; headless पृष्ठभूमि कार्यों के लिए मेल खाने वाला होता है।
टूल समूह
प्रोफ़ाइल और पृष्ठ
check_connectionlist_profilesopen_profileclose_profilerelease_browserbrowser_pagesbrowser_new_pagebrowser_close_pagebrowser_activate_page
नेविगेशन और इंटरैक्शन
browser_navigatebrowser_backbrowser_forwardbrowser_reloadbrowser_snapshotbrowser_clickbrowser_click_coordinatesbrowser_typebrowser_pressbrowser_hoverbrowser_selectbrowser_scrollbrowser_dragbrowser_waitbrowser_handle_next_dialog
डेटा और फ़ाइलें
browser_screenshotbrowser_upload_filesbrowser_get_cookiesbrowser_set_cookiesbrowser_clear_cookiesbrowser_storage_getbrowser_storage_setbrowser_storage_clearbrowser_grant_permissionsbrowser_prepare_downloadbrowser_wait_downloadbrowser_evaluate
ये टूल के नाम हैं, पूर्ण अनुरोध स्कीमा नहीं। कनेक्टेड MCP सर्वर वर्तमान पैरामीटर नाम और आवश्यक फ़ील्ड AI क्लाइंट को विज्ञापित करता है; तर्कों के बारे में अनुमान लगाने के बजाय उस स्कीमा का उपयोग करें। कुकी, स्टोरेज, अपलोड, और जावास्क्रिप्ट टूल संवेदनशील डेटा तक पहुँच सकते हैं।
वैकल्पिक लोकल HTTP API
सक्षम करें स्थानीय API केवल तभी यदि स्थानीय एकीकरण को HTTP की आवश्यकता होती है। वर्तमान लूपबैक एंडपॉइंट और एक्सेस टोकन को कॉपी करें API और MCP; पोर्ट डायनेमिक रूप से असाइन किया जाता है। MCP HTTP अक्षम होने पर भी उपलब्ध रहता है।
GET http://127.0.0.1:<port>/v1/status Authorization: Bearer <access-token> X-IFox9-Client-ID: my-integration
टोकन आवश्यक है। वैकल्पिक क्लाइंट ID की सिफारिश की जाती है और इसमें 1–64 ASCII अक्षर, अंक, अंडरस्कोर, या हाइफ़न होने चाहिए। उदाहरण केवल प्लेसहोल्डर्स का उपयोग करते हैं। कभी भी अपना वास्तविक टोकन प्रकाशित न करें।
GET /v1/profiles प्रोफाइल सूचीबद्ध करता है; POST /v1/profiles/open एक को खोलता है। सफल प्रतिक्रियाएं उपयोग करती हैं {"ok":true,"data":…}; असफलताएं उपयोग करती हैं {"ok":false,"error":{"code":…,"message":…}}। देखें सामान्य त्रुटि कोड.
API को स्थानीय रखें
HTTP लिसनर 127.0.0.1 से बाइंड होता है, होस्ट हेडर को मान्य करता है, और ब्राउज़र CORS सक्षम नहीं करता। इसे सार्वजनिक रिवर्स प्रॉक्सी के माध्यम से उजागर न करें या इसके डिस्कवरी फ़ाइल प्रकाशित न करें। टोकन घुमाव पुराने प्रमाणपत्र को अमान्य कर देता है; इसके बाद अपने स्थानीय इंटीग्रेशन को अपडेट करें।