AI कोडिंग एजेंट वेब पेज तो लिख सकते हैं, लेकिन ज़्यादातर यह नहीं देख पाते कि ब्राउज़र में चलने पर वह पेज असल में क्या करता है। Chrome DevTools MCP इसी कमी को दूर करता है। यह Chrome DevTools टीम का एक ओपन-सोर्स सर्वर है, जिसकी मदद से Claude Code, Cursor, Copilot या Gemini CLI जैसा एजेंट Chrome खोल सकता है, कंसोल पढ़ सकता है, नेटवर्क रिक्वेस्ट जांच सकता है, स्क्रीनशॉट ले सकता है और परफॉर्मेंस ट्रेस रिकॉर्ड कर सकता है। इस गाइड में आप जानेंगे कि इसे कैसे इंस्टॉल करें, पहला टेस्ट कैसे चलाएं, पहले से खुली Chrome विंडो से इसे कैसे जोड़ें और सेटअप की सबसे आम दिक्कतें कैसे ठीक करें।
14 नवंबर 2026 तक इसका सबसे नया रिलीज़ वर्ज़न 1.13.0 है, जो 11 नवंबर को आया था, और इस हफ्ते यह प्रोजेक्ट GitHub की डेली ट्रेंडिंग लिस्ट में था।
Chrome DevTools MCP क्या करता है
MCP (Model Context Protocol) एक स्टैंडर्ड तरीका है जिससे AI असिस्टेंट बाहरी टूल्स को इस्तेमाल करते हैं। chrome-devtools-mcp पैकेज एक MCP सर्वर है: आपका एजेंट इसे “यह URL खोलो” या “कंसोल एरर दिखाओ” जैसी रिक्वेस्ट भेजता है, और यह Chrome DevTools और Puppeteer की मदद से उन्हें एक असली Chrome ब्राउज़र में पूरा करता है।
टूल्स अलग-अलग कैटेगरी में बंटे हैं। इनपुट ऑटोमेशन (क्लिक करना, फ़ॉर्म भरना, टाइप करना, फ़ाइल अपलोड करना), नेविगेशन, एमुलेशन, परफॉर्मेंस ट्रेसिंग, नेटवर्क की जांच और डीबगिंग (कंसोल मैसेज, स्क्रीनशॉट, पेज स्नैपशॉट, Lighthouse ऑडिट) डिफ़ॉल्ट रूप से चालू रहते हैं। नेटवर्क मॉक, एक्सटेंशन और प्रोग्रेसिव वेब ऐप जैसी अतिरिक्त कैटेगरी तब तक बंद रहती हैं जब तक आप किसी फ़्लैग से उन्हें चालू न करें। 1.13.0 रिलीज़ में लॉगपॉइंट और पेज-स्तर के नेटवर्क मॉक जोड़े गए।
इसी पैकेज में chrome-devtools नाम का एक कमांड-लाइन टूल भी है, जिससे आप बिना किसी एजेंट के सीधे टर्मिनल से ब्राउज़र चला सकते हैं।
आपको क्या चाहिए
- Node.js का कोई LTS वर्ज़न। 14 नवंबर 2026 तक npm पैकेज Node
^20.19.0 || ^22.12.0 || >=23के सपोर्ट की बात करता है। - npm (यह Node के साथ आता है)।
- Google Chrome का मौजूदा स्टेबल वर्ज़न या उससे नया। प्रोजेक्ट आधिकारिक तौर पर सिर्फ़ Google Chrome और Chrome for Testing को सपोर्ट करता है; बाकी Chromium ब्राउज़र चल सकते हैं, लेकिन इसकी गारंटी नहीं है।
- MCP सपोर्ट करने वाला कोई एजेंट या एडिटर, जैसे Claude Code, Cursor, Copilot के साथ VS Code, Gemini CLI या Codex।
सबसे पहले अपना Node वर्ज़न चेक करें:
node --version
स्टेप 1: चेक करें कि सर्वर चलता है
अपने एजेंट की सेटिंग्स बदलने से पहले पक्का कर लें कि पैकेज आपकी मशीन पर चालू होता है। आधिकारिक ट्रबलशूटिंग गाइड यह टेस्ट सुझाती है:
npx chrome-devtools-mcp@latest --help
आपको --headless, --isolated और --browser-url जैसे विकल्पों की लिस्ट दिखनी चाहिए। अगर यहीं एरर आए, तो आगे बढ़ने से पहले उसे ठीक करें (नीचे एरर वाला सेक्शन देखें)।
स्टेप 2: इसे अपने एजेंट में जोड़ें
ज़्यादातर MCP क्लाइंट एक जैसा JSON ब्लॉक स्वीकार करते हैं। यह प्रोजेक्ट के README से लिया गया स्टैंडर्ड कॉन्फ़िगरेशन है:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest"]
}
}
}
@latest इस्तेमाल करने का मतलब है कि आपका क्लाइंट नए वर्ज़न अपने आप ले लेगा।
कई टूल्स में एक लाइन वाला इंस्टॉल भी है। ये प्रोजेक्ट की क्लाइंट कॉन्फ़िगरेशन गाइड से लिए गए हैं।
Claude Code:
claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest
Gemini CLI:
gemini mcp add chrome-devtools npx chrome-devtools-mcp@latest
OpenAI Codex:
codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest
VS Code (macOS और Linux):
code --add-mcp '{"name":"io.github.ChromeDevTools/chrome-devtools-mcp","command":"npx","args":["-y","chrome-devtools-mcp"],"env":{}}'
Cursor में गाइड के मुताबिक Cursor Settings (Cursor की सेटिंग्स), फिर MCP, फिर New MCP Server (नया MCP सर्वर) पर जाएं और स्टैंडर्ड कॉन्फ़िग पेस्ट करें। हर रिलीज़ के साथ मेन्यू के नाम बदल सकते हैं, इसलिए अगर यह रास्ता न मिले तो Cursor के अपने MCP डॉक्स देखें।
वैकल्पिक: इसे स्किल्स के साथ प्लगइन की तरह इंस्टॉल करें
प्रोजेक्ट “स्किल्स” भी देता है, यानी छोटी निर्देश फ़ाइलें जो आपके एजेंट को टूल्स ठीक से इस्तेमाल करना सिखाती हैं। Claude Code में आप सर्वर और स्किल्स एक साथ इंस्टॉल कर सकते हैं: पहले /plugin marketplace add ChromeDevTools/chrome-devtools-mcp चलाएं, फिर /plugin install chrome-devtools-mcp@chrome-devtools-plugins, और उसके बाद Claude Code रीस्टार्ट करें। अगर स्किल्स आपके लिए नई हैं, तो Claude Code में एजेंट स्किल्स इंस्टॉल और इस्तेमाल करने पर हमारी गाइड बताती है कि ये कैसे काम करती हैं।
स्टेप 3: अपना पहला प्रॉम्प्ट चलाएं
अपने एजेंट को रीस्टार्ट करें ताकि वह नया सर्वर लोड कर ले, फिर प्रोजेक्ट का सुझाया टेस्ट प्रॉम्प्ट टाइप करें:
Check the performance of https://developers.chrome.com
अपेक्षित नतीजा: एक Chrome विंडो खुलती है, पेज लोड होता है और आपका एजेंट परफॉर्मेंस ट्रेस की रिपोर्ट देता है। ब्राउज़र तभी शुरू होता है जब एजेंट पहली बार कोई ऐसा टूल इस्तेमाल करता है जिसे इसकी ज़रूरत हो, इसलिए सिर्फ़ सर्वर जोड़ने से Chrome नहीं खुलेगा।
यह चल जाए, तो अपने काम से जुड़े प्रॉम्प्ट आज़माएं:
Open http://localhost:3000, list any console errors, and tell me which network requests failed.
Take a screenshot of http://localhost:3000 at a mobile viewport and check the page for accessibility problems.
डिफ़ॉल्ट रूप से सर्वर Chrome को उसकी अपनी प्रोफ़ाइल के साथ चलाता है, जो macOS और Linux पर $HOME/.cache/chrome-devtools-mcp/chrome-profile में सेव रहती है। यह प्रोफ़ाइल हर रन के बाद भी बनी रहती है, इसलिए वहां किए गए लॉगिन सेव रहते हैं।
स्टेप 4: Chrome के चालू होने का तरीका बदलें (वैकल्पिक)
args ऐरे में फ़्लैग जोड़कर आप इसका व्यवहार कंट्रोल करते हैं। यह उदाहरण Chrome को बिना विंडो के चलाता है, एक अस्थायी प्रोफ़ाइल इस्तेमाल करता है जो बाद में डिलीट हो जाती है, और Google के यूज़ेज आंकड़ों से बाहर निकलता है, जो डिफ़ॉल्ट रूप से इकट्ठा किए जाते हैं:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": [
"-y",
"chrome-devtools-mcp@latest",
"--headless=true",
"--isolated=true",
"--no-usage-statistics"
]
}
}
}
प्राइवेसी की दो और सेटिंग्स जानने लायक हैं। परफॉर्मेंस टूल्स असली यूज़र्स का डेटा लाने के लिए ट्रेस URL को Google की Chrome UX Report (CrUX) API पर भेज सकते हैं; इसे रोकने के लिए --no-performance-crux जोड़ें। अगर आपको सिर्फ़ बेसिक ब्राउज़िंग चाहिए, तो --slim सिर्फ़ तीन टूल्स वाला छोटा सेट देता है।
स्टेप 5: पहले से इस्तेमाल हो रही Chrome विंडो से जोड़ें (वैकल्पिक)
कभी-कभी आप चाहते हैं कि एजेंट आपके अपने ब्राउज़र में काम करे, जैसे किसी ऐसी साइट पर जिसमें आप पहले से लॉग इन हैं। 14 नवंबर 2026 तक इस “ऑटो कनेक्ट” मोड के लिए Chrome 144 या उससे नया वर्ज़न चाहिए।
- Chrome में
chrome://inspect/#remote-debuggingपर जाएं और आने वाले डीबगिंग कनेक्शन की इजाज़त देने के लिए डायलॉग के निर्देश मानें। - अपने कॉन्फ़िग में
--autoConnectजोड़ें:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["chrome-devtools-mcp@latest", "--autoConnect"]
}
}
}
- Chrome को चालू रखें और एक प्रॉम्प्ट भेजें। Chrome इजाज़त मांगेगा; Allow (इजाज़त दें) पर क्लिक करें।
सर्वर आपकी डिफ़ॉल्ट Chrome प्रोफ़ाइल से जुड़ता है और उसमें खुली हर विंडो देख सकता है। पहले बैंकिंग, ईमेल या दूसरे संवेदनशील डेटा वाले टैब बंद कर दें। प्रोजेक्ट की अपनी चेतावनी कहती है कि एजेंट ब्राउज़र के किसी भी डेटा को देख और बदल सकता है।
अगर आपका एजेंट सैंडबॉक्स में चलता है, तो दूसरा तरीका यह है कि आप खुद Chrome को एक डीबगिंग पोर्ट और अलग प्रोफ़ाइल के साथ शुरू करें (यहां macOS दिखाया गया है; डॉक्स में Linux और Windows के पाथ भी हैं):
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
फिर args में "--browser-url=http://127.0.0.1:9222" इस्तेमाल करें। जब तक यह पोर्ट खुला है, आपकी मशीन का कोई भी ऐप ब्राउज़र को कंट्रोल कर सकता है, इसलिए उस विंडो में संवेदनशील साइटें न खोलें।
आम एरर और उनके हल
Error [ERR_MODULE_NOT_FOUND]: Cannot find module ...: आमतौर पर इसकी वजह Node का असमर्थित वर्ज़न या खराब npx कैश होती है। Node अपडेट करें, फिरnpm cache clean --forceसे कैश साफ़ करें और दोबारा इंस्टॉल करें। डॉक्सrm -rf ~/.npm/_npxका सुझाव भी देते हैं, जो कैश में रखे दूसरे npx टूल्स भी हटा देता है।Target closed: Chrome शुरू नहीं हो पाया। पक्का करें कि Chrome का कोई और इंस्टेंस नहीं चल रहा (चल रहा हो तो बंद करें) और Chrome का नया स्टेबल वर्ज़न इंस्टॉल है।- एजेंट को सर्वर नहीं मिल रहा, लेकिन टर्मिनल टेस्ट चल जाता है: पक्का करें कि आपका एडिटर वही Node और npm इस्तेमाल करता है जो आपका टर्मिनल।
- Windows:
MCP error -32000: Connection closed:"command": "cmd"सेट करें औरargsमें"/c", "npx", "-y", "chrome-devtools-mcp@latest"डालें। - macOS:
--autoConnectइस एरर के साथ फ़ेल होता है:EPERM: operation not permitted: System Settings > Privacy & Security > Files & Folders (सिस्टम सेटिंग्स > प्राइवेसी और सिक्योरिटी > फ़ाइलें और फ़ोल्डर) में जाकर अपने टर्मिनल या एडिटर को Google Chrome का एक्सेस दें। --autoConnectटाइम आउट हो जाता है: चेक करें कि Chrome 144+ पहले से चल रहा है,chrome://inspect/#remote-debuggingपर रिमोट डीबगिंग चालू है, आपने इजाज़त वाला संदेश स्वीकार किया है और कोई और चीज़ उसी डीबगिंग पोर्ट का इस्तेमाल नहीं कर रही।- कंटेनर या CI में Chrome शुरू नहीं होता: Chrome root यूज़र के रूप में नहीं चलता। सर्वर को किसी non-root यूज़र से चलाएं।
- VM के अंदर काम करना: Chrome VM से आने वाले कनेक्शन ठुकरा सकता है। डॉक्स VM से SSH टनल बनाने का सुझाव देते हैं, जैसे
ssh -N -L 127.0.0.1:9222:127.0.0.1:9222 user@server। अगर आपने पहले SSH इस्तेमाल नहीं किया है, तो हमारी SSH keys गाइड सेटअप समझाती है।
किसी भी और दिक्कत के लिए सर्वर को लॉग फ़ाइल के साथ चलाएं और एरर पढ़ें:
NODE_DEBUG=* npx chrome-devtools-mcp@latest --log-file=/tmp/chrome-devtools-mcp.log
आखिर में
Chrome DevTools MCP आपके एजेंट को अंदाज़ा लगाने के बजाय अपना फ्रंट-एंड काम खुद जांचने देता है: पेज लोड करना, एरर पढ़ना, नेटवर्क टैब देखना और परफॉर्मेंस मापना। स्टैंडर्ड कॉन्फ़िग और टेस्ट प्रॉम्प्ट से शुरू करें, साफ़ और एक बार इस्तेमाल वाला ब्राउज़र चाहिए तो --isolated या --headless जोड़ें, और ऑटो कनेक्ट सिर्फ़ ऐसी प्रोफ़ाइल में इस्तेमाल करें जिसमें AI के सब कुछ देखने से आपको दिक्कत न हो। Chrome को भी अपडेट रखें; हमारा Chrome zero-day एक्सप्लेनर बताता है कि यह क्यों ज़रूरी है।
स्रोत
लिंक आखिरी बार 15 नवंबर 2026 को जांचे गए।





प्रतिक्रिया लिखें