अपने कोडिंग एजेंट को उस ब्राउज़र का उपयोग करने दें जिसमें आप पहले से साइन इन हैं।

क्या कहाँ शुरू होता है

आपका MCP क्लाइंट npm पैकेज को stdio के ज़रिए एक लोकल चाइल्ड प्रोसेस के रूप में चलाता है। यह प्रोसेस केवल 127.0.0.1:17374 पर सुनता है। एक्सटेंशन उसी की ओर डायल करता है, और फिर चुने गए ब्राउज़र टैब में WebBrain के एजेंट लूप से हर टास्क निष्पादित करता है।

सर्वर दूसरा ब्राउज़र नहीं है और न ही Cookie कॉपी करता है। यह MCP क्लाइंट और एक्सटेंशन के बीच एक लोकल हैंडऑफ पॉइंट है। ब्राउज़र प्रोफ़ाइल—और इसलिए प्रमाणित सेशन—कभी नहीं हिलती।

कनेक्ट करने से पहले

अपने MCP क्लाइंट में सर्वर रजिस्टर करें

नीचे दी गई क्लाइंट-विशिष्ट सेटअप में से कोई एक चुनेँ, केवल एक बार। ये इंस्टॉलेशन कमांड हैं, ब्राउज़र टास्क माँगने का तरीका नहीं। रजिस्ट्रेशन के बाद क्लाइंट आपके लिए सर्वर शुरू कर देगा और आप सामान्य बातचीत जारी रखें; उसी पोर्ट पर मैनुअल कॉपी एक साथ न चलाएँ।

Codex ऐप, CLI या IDE एक्सटेंशन

codex mcp add webbrain -- npx -y @webbrain/mcp-server

Codex MCP सर्वर को ~/.codex/config.toml में सहेजता है; एक ही Codex होस्ट पर ऐप, CLI और IDE एक्सटेंशन यही सेटअप साझा करते हैं। लंबे ब्राउज़र टास्क के लिए यह फ़ाइल खोलें और टूल को Codex के डिफ़ॉल्ट प्रति-कॉल बजट से ज़्यादा समय दें:

[mcp_servers.webbrain]
command = "npx"
args = ["-y", "@webbrain/mcp-server"]
tool_timeout_sec = 360

फ़ाइल बदलने के बाद ऐप या IDE एक्सटेंशन दोबारा चालू करें। CLI में, codex mcp list चलाकर एंट्री की पुष्टि करें, और Codex सेशन में /mcp से जुड़े सर्वर की जाँच करें। साझा होस्ट सेटअप और सभी समर्थित विकल्पों के लिए आधिकारिक Codex MCP गाइड देखें।

Claude Code

claude mcp add --transport stdio webbrain -- npx -y @webbrain/mcp-server

स्पष्ट ट्रांसपोर्ट मौजूदा Claude Code MCP सेटअप से मेल खाता है। जोड़ने के बाद claude mcp list चलाकर सर्वर की स्थिति जाँचें।

Cursor

Cursor की MCP सेटिंग्स में लोकल stdio सर्वर जोड़ें, या यह सामग्री Cursor के MCP JSON फ़ाइल में डालें। फ़ॉर्मैट Cursor लोकल MCP सर्वर फ़ॉर्मैट का पालन करता है:

{
  "mcpServers": {
    "webbrain": {
      "command": "npx",
      "args": ["-y", "@webbrain/mcp-server"]
    }
  }
}

OpenCode

यह एंट्री ~/.config/opencode/opencode.json में जोड़ें, OpenCode के लोकल MCP सर्वर फ़ॉर्मैट का उपयोग करते हुए:

{
  "mcp": {
    "webbrain": {
      "type": "local",
      "command": ["npx", "-y", "@webbrain/mcp-server"]
    }
  }
}

OpenClaw

OpenClaw में WebBrain को आउटबाउंड MCP सर्वर के रूप में रजिस्टर करें। इस इंटीग्रेशन के लिए openclaw mcp serve उपयोग न करें: वह कमांड OpenClaw को स्वयं सर्वर बना देता है, जो उलटी दिशा है।

openclaw mcp add webbrain \
  --command npx \
  --arg -y \
  --arg @webbrain/mcp-server \
  --timeout 360

mcp add सहेजने से पहले stdio सर्वर को जाँचता है। सहेजी गई परिभाषा देखने के लिए openclaw mcp status --verbose चलाएँ। सामान्य coding और messaging टूल प्रोफ़ाइल में सेट किए MCP सर्वर शामिल होते हैं; minimal प्रोफ़ाइल, स्पष्ट bundle-mcp डीनाई या सैंडबॉक्स टूल पॉलिसी उन्हें छिपा सकती हैं। मौजूदा रजिस्ट्री और पॉलिसी विवरण के लिए OpenClaw MCP गाइड देखें।

मैन्युअल रूप से चलाएँ

लिस्टनर का निदान करने के लिए मैनुअल शुरुआत उपयोगी है, पर आम तौर पर MCP उपयोग में ज़रूरी नहीं:

npx -y @webbrain/mcp-server

उस टर्मिनल को खुला रखें। उसे बंद करने से ब्रिज लिस्टनर बंद हो जाता है। सोर्स चेकआउट से, mcp-server/ के अंदर npm install, npm run build, फिर npm start चलाएँ।

WebBrain को लोकल लिस्टनर की ओर मोड़ें

1. अपने MCP क्लाइंट को चालू या रीस्टार्ट करें।एक्सटेंशन के जुड़ने से पहले उसका WebBrain सर्वर चल रहा होना चाहिए।
2. WebBrain सेटिंग्स खोलें।सेटिंग्स → Bridge पर जाएँ।
3. सटीक URL सेट करें।ws://127.0.0.1:17374/extension दर्ज करें।
4. पेयरिंग की चिपकाएँ।टर्मिनल में npx -y @webbrain/mcp-server pairing-key चलाएँ (या ~/.webbrain/bridge-key खोलें), और कुंजी को पेयरिंग की फ़ील्ड में चिपकाएँ। सर्वर केवल उसी ब्राउज़र पर भरोसा करता है जो यह कुंजी रखने का सबूत दे। यदि फ़ील्ड नहीं दिखती, पहले WebBrain अपडेट करें।
5. क्लाउड ब्रिज चालू करें।स्थिति "कनेक्ट हो रहा है" से "कनेक्ट हो गया" होनी चाहिए। यह नाम ऐतिहासिक कारणों से है: यह गंतव्य लोकल है।
6. एंड-टू-एंड कनेक्शन जाँचें।MCP क्लाइंट से webbrain_connection कॉल करवाएँ। "Connected" इस बात का प्रमाण है कि क्लाइंट, लोकल सर्वर, WebSocket लिस्टनर और एक्सटेंशन हैंडशेक—सब तैयार हैं।

ब्राउज़र टास्क को स्वाभाविक भाषा में बताएँ

Codex, Claude Code, Cursor, OpenClaw या OpenCode में, वैसा ही लिखें जैसे किसी साथी को टास्क सौंपते। WebBrain का नाम लेने से आपका इरादा बिल्कुल स्पष्ट हो जाता है; पेज, अपेक्षित परिणाम, दायरा, और यह कि बदलाव की अनुमति है या नहीं—सब शामिल करें।

पेज बदले बिना पढ़ाई

WebBrain का उपयोग करके मेरे ब्राउज़र में खुले Stripe डैशबोर्ड को पढ़ो। पिछले सात दिनों की असफल पेमेंट्स की सूची दो—ग्राहक, राशि, मुद्रा, तारीख और असफलता का कारण शामिल करते हुए। कुछ भी मत बदलो।

पूर्वानुमेय JSON लौटाएँ

WebBrain का उपयोग करके मेरे ब्राउज़र में खुले डैशबोर्ड से सभी बकाया इनवॉइस निकालो। ग्राहक, राशि, मुद्रा, देय तिथि और इनवॉइस URL वाला JSON लौटाओ। कुछ भी मत बदलो।

पेज से इंटरैक्ट करें

WebBrain के Act मोड से मेरे ब्राउज़र में दिख रही कस्टमर रिकॉर्ड खोलो, और कंपनी का नाम Acme Europe में अपडेट करो। किसी भी अंतिम सबमिट या पुष्टि से पहले रुक जाओ।

कोडिंग एजेंट आम पढ़ाई या इंटरैक्शन के लिए webbrain_run चुनता है, और संरचित डेटा माँगे जाने पर webbrain_extract चुनता है। वह पैरामीटर देता है, रन की मॉनिटरिंग करता है, और WebBrain का परिणाम बातचीत में वापस प्रस्तुत करता है। Ask मोड पढ़ और एक्सट्रैक्ट सकता है; क्लिक, टाइप, नेविगेट या सबमिट नहीं कर सकता। Act मोड इंटरैक्ट कर सकता है, WebBrain की सामान्य ब्राउज़र-साइड अनुमतियों के अधीन रहते हुए।

webbrain_run(
  task: "read the open Stripe dashboard and list failed payments from the last 7 days with customer, amount, currency, date, and failure reason",
  mode: "ask"
)

जिन टास्क्स में इंटरैक्शन ज़रूरी है, साफ़ कहें "WebBrain का Act मोड उपयोग करें" और ब्राउज़र दृश्यमान रखें। WebBrain अपने सामान्य सोर्स-वार क्षमता अनुमोदन प्रॉम्प्ट लागू करेगा।

वे टूल जो आपका MCP क्लाइंट आपके लिए इस्तेमाल करता है

आप आम तौर पर परिणाम चुनते हैं, टूल नहीं। आपका MCP क्लाइंट ये विवरण पढ़ता है, उपयुक्त टूल चुनता है, आपके अनुरोध के अनुसार उसके इनपुट भरता है, और आगे की कॉल्स संभालता है। यह रेफरेंस आपको यह व्यवहार समझने या डीबग करने के लिए है।

संरचित JSON माँगें

आम उपयोग में, बताएँ क्या निकालना है और चाहिए वाले फ़ील्डों के नाम लें: "WebBrain से खुले डैशबोर्ड से सभी बकाया इनवॉइस निकालो और ग्राहक, राशि, मुद्रा, देय तिथि और इनवॉइस URL वाला JSON लौटाओ।" सक्षम MCP क्लाइंट इन फ़ील्डों को ज़रूरी schema में बदलकर आपके लिए webbrain_extract कॉल कर सकता है।

नीचे दिया गया फ़ंक्शन-रूप उदाहरण क्लाइंट डेवलपर्स और डीबगिंग के लिए बराबर टूल कॉल दिखाता है। task में चयन तर्क बताएँ; सिर्फ़ आउटपुट का रूप output_schema में बताएँ।

webbrain_extract(
  task: "extract every overdue invoice visible in this account; preserve the displayed currency and use ISO dates where the page provides a full date",
  output_schema: {
    type: "object",
    properties: {
      invoices: {
        type: "array",
        items: {
          type: "object",
          properties: {
            customer: { type: "string" },
            amount: { type: "number" },
            currency: { type: "string" },
            due_date: { type: "string" },
            invoice_url: { type: "string" }
          },
          required: ["customer", "amount", "currency", "due_date"]
        }
      }
    },
    required: ["invoices"]
  }
)

• स्पष्ट properties और required फ़ील्ड वाले ऑब्जेक्ट रूट का उपयोग करें।
• जितना कम डेटा चाहिए उतना ही माँगें। Schema उस डेटा तक पहुँच नहीं देता जो ब्राउज़र सेशन को दिखता ही नहीं।
• यह टूल केवल-पढ़ने वाला है, पर पेज का टेक्स्ट और परिणाम फिर भी WebBrain के सेट LLM प्रदाता तक जाते हैं।
• अगर परिणाम रन के स्थायी स्नैपशॉट के लिए बहुत बड़ा है, तो स्थिति रिपोर्ट कर सकती है कि सहेजा गया परिणाम कट गया। अनुरोध छोटा करें और दोबारा चलाएँ।

रन लाइफसाइकल समझें

ज़्यादातर MCP क्लाइंट यह लाइफसाइकल आपके लिए संभालते हैं: वे परिणाम का इंतज़ार करते हैं, जब मानव इनपुट चाहिए तब WebBrain का स्पष्टीकरण सवाल दिखाते हैं, और आपके जवाब से आगे बढ़ते हैं। नीचे दिए स्पष्ट कॉल क्लाइंट डेवलपर्स, समस्या निवारण, या जानबूझकर क्लाइंट से लंबा टास्क बैकग्राउंड में शुरू करवाने के लिए उपयोगी हैं।

फ़ोरग्राउंड कॉल डिफ़ॉल्ट रूप से इंतज़ार करते हैं। लंबे काम के लिए क्लाइंट wait: false सेट करके webbrain_status से पोल कर सकता है।

# टूल-स्तरीय संदर्भ
# बिना प्रतीक्षा के शुरू करें
webbrain_run(task: "compare the invoices across all visible pages", mode: "ask", wait: false)

# लौटे ID को बार-बार चेक करें
webbrain_status(run_id: "mcp_…")

WebBrain रन का टाइमआउट नियंत्रण MCP क्लाइंट को लौटा देता है, पर जानबूझकर ब्राउज़र टास्क को रोकता नहीं है। लौटे run_id को पोल करें। इससे बचाव होता है कि टाइमआउट किसी ऐसे टास्क को चुपचाप न मार दे जो शायद पहले ही महत्वपूर्ण ऑपरेशन कर चुका हो।

जब WebBrain सवाल पूछे

रुका हुआ स्नैपशॉट इंसानी भाषा का सवाल और clarify_id दोनों रखता है। वह सवाल उपयोगकर्ता को दिखाएँ। उनका जवाब शब्दशः भेजें; अनुमान न लगाएँ।

webbrain_respond(
  run_id: "mcp_…",
  clarify_id: "clarify_…",
  answer: "Use the Acme EU account."
)

सबसे छोटी अनुमति चुनें

MCP क्लाइंट का अनुमोदन और WebBrain का अनुमोदन अलग-अलग स्तर हैं। आपका क्लाइंट webbrain_run कॉल करने से पहले पूछ सकता है; WebBrain किसी सोर्स पर महत्वपूर्ण ऑपरेशन से पहले पूछ सकता है। एक अनुमोदन दूसरे की जगह नहीं लेता।

सुरक्षा सीमाएँ जो आपको बनाए रखनी चाहिए

• लिस्टनर को लोकल रखें।यह 127.0.0.1 से बँधा है। पोर्ट 17374 फ़ॉरवर्ड न करें, कंटेनर ब्रिज से पब्लिश न करें, या प्रॉक्सी के ज़रिए नेटवर्क पर न ले जाएँ।
• पेयरिंग की को सुरक्षित रखें।लोकल लूपबैक अपने आप में प्रमाणीकरण नहीं है, इसलिए सर्वर सॉकेट पर तभी भरोसा करता है जब वह पेयरिंग की से कुंजीपटल वाले HMAC से एक बार की चुनौती का जवाब दे; कुंजी स्वयं कभी सॉकेट से नहीं गुज़रती। ~/.webbrain/bridge-key पढ़ने वाला कोई भी व्यक्ति पेयर कर सकता है, इसलिए कुंजी चैट में न चिपकाएँ। एक्सटेंशन सर्वर की पहचान जाँचता नहीं, इसलिए लोकल कोड और MCP पैकेजों को फिर भी भरोसेमंद सॉफ़्टवेयर मानें।
• पहले Ask उपयोग करें।केवल-पढ़ने वाला काम जाँचने में आसान है और उसका असर-दायरा छोटा होता है।
• Act मोड में ब्राउज़र दृश्यमान रखें।आप साइडबार में रन रोक सकते हैं, और अप्रत्याशित नेविगेशन या टाइपिंग को रोकने का कारण मानना चाहिए।
• प्रदाता सीमा याद रखें।MCP ब्रिज लोकल रहता है, पर पेज की सामग्री WebBrain में सेट मॉडल प्रदाता तक जाती है। जब सामग्री डिवाइस पर ही रहनी हो, लोकल मॉडल उपयोग करें।
• टाइमआउट को रॉलबैक न समझें।अबॉर्ट आगे के स्टेप्स रोकता है; भेजी गई ईमेल, सबमिट किए फ़ॉर्म, खरीद या अन्य पूर्ण ऑपरेशन उसे वापस नहीं कर सकते।

पूरा डिज़ाइन देखने के लिए सुरक्षा मॉडल, गोपनीयता और डेटा प्रवाह, और मोड, सुरक्षा और गोपनीयता गाइड देखें।

लक्षण के अनुसार समस्या निवारण

एनवायरनमेंट कॉन्फ़िगरेशन

stdio क्लाइंट के लिए, उस क्लाइंट की MCP सेटिंग्स में एनवायरनमेंट वेरिएबल सेट करें। अगर पोर्ट या पाथ बदलें, तो WebBrain सेटिंग्स के क्लाउड ब्रिज URL को बिल्कुल वैसा ही अपडेट करें।

LM Studio उपयोग कर रहे हैं?

LM Studio अलग WebBrain Web Tools प्लगइन उपयोग करता है, इस MCP पैकेज को नहीं। उसके fetch_url और research_url टूल ब्राउज़र एक्सटेंशन के बिना सार्वजनिक पेज पढ़ सकते हैं; उसके ब्राउज़र टूल पोर्ट 17375 से लक्ष्य आपके साइन इन किए Chromium सेशन को सौंप सकते हैं।

ये सर्वर जानबूझकर क्या नहीं करता

• यह हेडलेस ब्राउज़र नहीं चलाता और न ही बिल्कुल नया ब्राउज़र प्रोफ़ाइल बनाता है।
• यह Firefox बिल्ड से काम नहीं करता।
• यह Cookie, क्रेडेंशियल या सेशन स्टोरेज एक्सपोर्ट नहीं करता।
• यह WebBrain के लगभग पचास क्लिक, टाइपिंग, फ़्रेम, स्क्रीनशॉट, नेटवर्क और DOM प्राइमेटिव्स को सीधे MCP क्लाइंट को नहीं दिखाता।
• यह ब्रिज को दूर से सुरक्षित रूप से उजागर नहीं करता।
• यह WebBrain के अंदर मॉडल सेट करने की ज़रूरत खत्म नहीं करता।

अगर आपको अलग-थलग प्रोफ़ाइल में डिटर्मिनिस्टिक लो-लेवल ब्राउज़र ऑटोमेशन चाहिए, तो Playwright-शैली का MCP सर्वर ज़्यादा उपयुक्त हो सकता है। जब तय करने वाली ज़रूरत आपका पहले से साइन इन ब्राउज़र सेशन और WebBrain का ब्राउज़र-अंदर सुरक्षा मॉडल हो, तब WebBrain MCP उपयोग करें।