कॉन्फ़िगरेशन

Matthias Rohmer

José Luis Zapata

एजेंट के लिए Chrome DevTools को कॉन्फ़िगर किया जा सकता है, ताकि यह तय किया जा सके कि वह ब्राउज़र के साथ कैसे इंटरैक्ट करे, कौनसे टूल चालू हों, और वह डेटा को कैसे मैनेज करे.

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) क्लाइंट की कॉन्फ़िगरेशन फ़ाइल के args कलेक्शन में, कमांड-लाइन फ़्लैग पास करके सर्वर को कॉन्फ़िगर करें. आम तौर पर, यह config.json फ़ाइल होती है.

उदाहरण के लिए, बिना ग्राफ़िक यूज़र इंटरफ़ेस वाले ब्राउज़र मोड में Chrome चलाने और Canary चैनल का इस्तेमाल करने के लिए, इस कॉन्फ़िगरेशन का इस्तेमाल करें:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--headless",
        "--channel=canary"
      ]
    }
  }
}

कॉन्फ़िगरेशन से जुड़ी सामान्य स्थितियां

यहां दी गई स्थितियों में, एजेंट के लिए Chrome DevTools को कॉन्फ़िगर करने के सामान्य तरीके बताए गए हैं.

हेडलेस मोड में चलाएं

ब्राउज़र विंडो को दिखाए बिना बैकग्राउंड में टास्क करने के लिए, Chrome को हेडलेस (बिना यूज़र इंटरफ़ेस) मोड में चलाएं. अपने सर्वर के तर्कों में --headless फ़्लैग जोड़ें.

किसी मौजूदा ब्राउज़र सेशन से कनेक्ट करना

डिफ़ॉल्ट रूप से, एजेंट के लिए DevTools, Chrome का नया इंस्टेंस शुरू करता है. हालांकि, अपने एजेंट को किसी मौजूदा ब्राउज़र सेशन से कनेक्ट किया जा सकता है. यह तब काम आता है, जब आपके एजेंट को किसी ऐसे सेशन में समस्या की जांच करनी हो जो आपने पहले ही शुरू कर दिया है. उदाहरण के लिए, अगर आपने पहले ही साइन इन कर लिया है.

किसी मौजूदा सेशन से दो तरीकों से कनेक्ट किया जा सकता है:

अपने-आप कनेक्ट होने की सुविधा (Chrome 144 और इसके बाद के वर्शन)

--autoConnect फ़्लैग का इस्तेमाल करने पर, एमसीपी सर्वर अपने-आप चालू Chrome इंस्टेंस से कनेक्ट हो जाता है.

1. अपने Chrome ब्राउज़र में, chrome://inspect/#remote-debugging पर जाएं और रिमोट डीबगिंग चालू करें.
2. अपने एमसीपी कॉन्फ़िगरेशन में --autoConnect जोड़ें: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
3. जब एजेंट कनेक्ट करने की कोशिश करता है, तो Chrome एक डायलॉग दिखाता है. इसमें अनुमति मांगी जाती है. अनुमति दें पर क्लिक करें.

मैन्युअल तरीके से कनेक्ट करना

अगर --autoConnect का इस्तेमाल नहीं किया जा सकता (उदाहरण के लिए, सैंडबॉक्स वाले एनवायरमेंट में), तो डिबगिंग पोर्ट के साथ Chrome को मैन्युअल तरीके से शुरू किया जा सकता है. इसके बाद, --browser-url का इस्तेमाल करके कनेक्ट किया जा सकता है.

1. रिमोट डीबगिंग की सुविधा और उपयोगकर्ता के डेटा की कस्टम डायरेक्ट्री चालू करके, टर्मिनल से Chrome को शुरू करें.
   • macOS: shell /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
   • Windows: shell start chrome --remote-debugging-port=9222 --user-data-dir=%TEMP%\chrome-profile-stable
   • Linux: shell google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
2. अपने एजेंट को इस पोर्ट से कनेक्ट करने के लिए कॉन्फ़िगर करें: json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

अस्थायी डायरेक्ट्री के बाहर फ़ाइल ऐक्सेस करने की अनुमति दें

फ़ाइलें पढ़ने या लिखने वाले टूल (उदाहरण के लिए, स्क्रीनशॉट, ट्रेस सेव करना या एक्सटेंशन लोड करना) सिर्फ़ कॉन्फ़िगर किए गए वर्कस्पेस रूट में मौजूद पाथ को ऐक्सेस कर सकते हैं. सर्वर, उन रूट का इस्तेमाल करता है जो आपका एमसीपी क्लाइंट, एमसीपी रूट की सुविधा के ज़रिए उपलब्ध कराता है. साथ ही, उन डायरेक्ट्री का इस्तेमाल करता है जिन्हें आपने --filesystemRoot (उपनाम --workspace) के साथ पास किया है. अगर आपका क्लाइंट रूट उपलब्ध नहीं कराता है और आपने --filesystemRoot सेट नहीं किया है, तो फ़ाइल का ऐक्सेस, ओएस की अस्थायी डायरेक्ट्री तक ही सीमित रहेगा. अन्य पाथ के लिए किए गए अनुरोध, Access denied: ... is not within any of the configured workspace roots गड़बड़ी की वजह से पूरे नहीं हो पाते.

किसी प्रोजेक्ट डायरेक्ट्री का ऐक्सेस देने के लिए, अपने सर्वर के आर्ग्युमेंट में --filesystemRoot जोड़ें. एक से ज़्यादा डायरेक्ट्री की अनुमति देने के लिए, फ़्लैग को दोहराया जा सकता है:

"args": ["chrome-devtools-mcp@latest", "--filesystemRoot=/path/to/project"]

कॉन्फ़िगरेशन के विकल्पों का रेफ़रंस

यहां दिए गए सेक्शन में, उपलब्ध कॉन्फ़िगरेशन फ़्लैग की सूची दी गई है. नए विकल्पों और अपडेट के लिए, Chrome DevTools MCP GitHub रिपॉज़िटरी देखें.

कनेक्शन के विकल्प

इन विकल्पों का इस्तेमाल करके, यह कॉन्फ़िगर करें कि सर्वर, Chrome से कैसे कनेक्ट होगा.

ब्राउज़र लॉन्च करने के विकल्प

ये विकल्प तब लागू होते हैं, जब एमसीपी सर्वर Chrome को चालू करता है.

सुरक्षा और निजता के विकल्प

सुरक्षा सेटिंग और डेटा की निजता को मैनेज करने के लिए, इन विकल्पों का इस्तेमाल करें.

सुविधा की कैटगरी

इन फ़्लैग का इस्तेमाल करके, टूल के ग्रुप को चालू या बंद किया जा सकता है.

स्क्रीनशॉट के विकल्प

इन विकल्पों का इस्तेमाल करके, यह तय करें कि एजेंट स्क्रीनशॉट कैसे कैप्चर करेगा.

एक्सपेरिमेंटल विकल्प

इन विकल्पों का इस्तेमाल करके, एक्सपेरिमेंट के तौर पर उपलब्ध उन सुविधाओं को चालू करें जिन्हें डेवलप किया जा रहा है.

दूसरे विकल्प

लॉगिंग, पेज रूटिंग, और सोर्स मैप को कॉन्फ़िगर करने या टूल के आसान सेट को चालू करने के लिए, इन विकल्पों का इस्तेमाल करें.

एनवायरमेंट वैरिएबल

सर्वर को कॉन्फ़िगर करने के लिए, इन एनवायरमेंट वैरिएबल का भी इस्तेमाल किया जा सकता है:

• CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: अगर सेट किया गया है, तो इस्तेमाल के आंकड़े इकट्ठा करने की सुविधा बंद हो जाती है (यह --no-usage-statistics के बराबर है).
• CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS: अगर इसे सेट किया जाता है, तो समय-समय पर अपडेट की जांच करने की सुविधा बंद हो जाती है.
• CI: अगर इसे सेट किया जाता है, तो इस्तेमाल के आंकड़े इकट्ठा करने की सुविधा बंद हो जाती है.
• NODE_DEBUG: वर्बोस डीबग लॉगिंग को चालू करने के लिए, इसे * पर सेट करें. यह --logFile के साथ काम करता है.