सीधे कंटेंट पर जाएं
Browsa
  1. गाइड
  2. MCP सर्वर

Claude, Cursor और VS Code में Browsa MCP सर्वर सेट अप करें।

Browsa MCP सर्वर (@browsa/mcp) एक Model Context Protocol सर्वर है जो AI असिस्टेंट को क्लाउड में एक असली ब्राउज़र देता है। आप आम भाषा में पूछते हैं, Browsa पर एक ब्राउज़र एजेंट काम करता है, और असिस्टेंट को जवाब के साथ ब्राउज़र को लाइव देखने का लिंक मिलता है।

समय
लगभग 2 मिनट
ज़रूरत
Node.js 18 या नया, एक Browsa API की
पैकेज
@browsa/mcp npm पर, MIT

ब्राउज़र MCP सर्वर क्या है?

MCP एक ओपन प्रोटोकॉल है जिससे AI ऐप मॉडल के बाहर के टूल कॉल कर सकता है। ब्राउज़र MCP सर्वर ऐसे टूल जोड़ता है जो वेब पेज खोलते हैं, क्लिक करते हैं, टाइप करते हैं और पढ़ते हैं, ताकि असिस्टेंट उन वेबसाइटों का भी इस्तेमाल कर सके जिनका कोई API नहीं है। Browsa सर्वर ये स्टेप आपकी मशीन पर नहीं, बल्कि क्लाउड ब्राउज़र में चलाता है, यानी आपके अपने ब्राउज़र, कुकीज़ और पासवर्ड को कोई नहीं छूता, और पेज धीमा हो तब भी काम चलता रहता है।

सर्वर ख़ुद एक छोटा Node.js प्रोसेस है जिसे आपका MCP क्लाइंट npx से शुरू करता है। इसकी हर रिक्वेस्ट आपकी agt_live_ की के साथ Browsa API पर जाती है।

  1. API की पाएं

    साइन अप करें और डैशबोर्ड में Keys से अपनी की कॉपी करें। ईमेल वेरिफ़ाई करते ही आपको 100 मुफ़्त क्रेडिट मिलते हैं, कोई कार्ड नहीं।

  2. सर्वर को अपने क्लाइंट में जोड़ें

    Claude Desktop

    कॉन्फ़िग फ़ाइल खोलें: macOS पर ~/Library/Application Support/Claude/claude_desktop_config.json या Windows पर %APPDATA%\Claude\claude_desktop_config.json। सर्वर जोड़ें, सेव करें और Claude Desktop रीस्टार्ट करें।

    claude_desktop_config.json
    {
      "mcpServers": {
        "browsa": {
          "command": "npx",
          "args": ["-y", "@browsa/mcp"],
          "env": {
            "BROWSA_API_KEY": "agt_live_..."
          }
        }
      }
    }

    Claude Code

    इसे टर्मिनल से जोड़ें। सर्वर का नाम -e से पहले लिखें, और -- के बाद का सब कुछ वह कमांड है जो Claude Code चलाता है।

    टर्मिनल
    claude mcp add browsa -e BROWSA_API_KEY=agt_live_... -- npx -y @browsa/mcp

    यह कनेक्ट हुआ या नहीं, देखने के लिए claude mcp list चलाएं।

    Cursor

    हर प्रोजेक्ट के लिए यही ब्लॉक ~/.cursor/mcp.json में जोड़ें, या किसी एक प्रोजेक्ट के लिए .cursor/mcp.json में।

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "browsa": {
          "command": "npx",
          "args": ["-y", "@browsa/mcp"],
          "env": { "BROWSA_API_KEY": "agt_live_..." }
        }
      }
    }

    VS Code

    VS Code आपके वर्कस्पेस में .vscode/mcp.json पढ़ता है। इसके फ़ॉर्मैट में mcpServers की जगह servers होता है। यह वर्शन सर्वर पहली बार शुरू होने पर की मांगता है, इसलिए की फ़ाइल में सेव नहीं होती।

    .vscode/mcp.json
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "browsa-api-key",
          "description": "Browsa API key (agt_live_...)",
          "password": true
        }
      ],
      "servers": {
        "browsa": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "@browsa/mcp"],
          "env": { "BROWSA_API_KEY": "${input:browsa-api-key}" }
        }
      }
    }

    Cline, Continue, Zed और दूसरे क्लाइंट

    कोई भी क्लाइंट जो stdio पर MCP सर्वर शुरू करता है, चलेगा। उसे npx -y @browsa/mcp पर पॉइंट करें और सर्वर के एनवायरनमेंट में BROWSA_API_KEY सेट करें।

  3. आज़माकर देखें

    अपने असिस्टेंट से कुछ ऐसा पूछें जिसके लिए लाइव वेब पेज चाहिए, जैसे:

    • "news.ycombinator.com पर जाओ और टॉप स्टोरी बताओ।"
    • "books.toscrape.com खोलो और पहली पांच किताबें उनकी कीमत के साथ लिस्ट करो।"
    • "हर सुबह इस प्रोडक्ट पेज पर कीमत चेक करो और नतीजा मेरे वेबहुक पर भेजो।"

    असिस्टेंट run_task कॉल करता है। नतीजे के साथ एक live_url आता है: ब्राउज़र देखने के लिए इसे खोलें, और अगर किसी पेज पर इंसान की ज़रूरत हो तो माउस और कीबोर्ड इस्तेमाल करें।

ब्राउज़र टास्क कौन-सा मॉडल चलाता है?

ब्राउज़र एजेंट को एक लैंग्वेज मॉडल चाहिए। आपको कॉन्फ़िग में मॉडल की डालने की ज़रूरत नहीं। हर कॉल के लिए, जो पहले मैच करे वही चलता है:

  1. कॉल पर llm: "browsa"Browsa का होस्टेड मॉडल, कोई की नहीं, हर टास्क पर 5 क्रेडिट ज़्यादा।
  2. BROWSA_LLM_API_KEYआपकी Anthropic, OpenAI या Google की, हर टास्क के साथ भेजी जाती है, टास्क चलने तक एन्क्रिप्ट रहती है और ख़त्म होते ही डिलीट हो जाती है।
  3. BROWSA_LLM_KEY_IDडैशबोर्ड में सेव की गई की, id से।
  4. कुछ सेट नहींवर्कस्पेस की डिफ़ॉल्ट सेव की गई की। अगर कोई सेव की गई की नहीं है और कोई मॉडल नहीं बताया गया, तो टास्क Browsa के होस्टेड मॉडल पर चलता है और नतीजे में यह लिखा होता है।

BROWSA_LLM एक डिफ़ॉल्ट मॉडल सेट करता है, जैसे anthropic:claude-sonnet-5-5। अगर आप मॉडल का नाम देते हैं और उसकी कोई की उपलब्ध नहीं है, तो टूल फ़ॉलबैक करने की जगह LLM_KEY_REQUIRED लौटाता है।

असिस्टेंट को कौन-से टूल मिलते हैं?

run_task
आम भाषा में बताया गया ब्राउज़र टास्क चलाता है और नतीजा व लाइव व्यू लिंक लौटाता है।
get_job
लंबे चलने वाले टास्क का हाल देखता है, चाहें तो सर्वर पर इंतज़ार करते हुए।
cancel_job
चल रहा टास्क कैंसिल करता है।
respond_to_job
उस टास्क को जवाब देता है जो इनपुट मांगने के लिए रुका है।
list_job_files
टास्क की लिखी फ़ाइलें लिस्ट करता है, जैसे डाउनलोड की गई रिपोर्ट।
create_schedule, list_schedules
दोहराए जाने वाले टास्क, हर घंटे से लेकर हर 30 दिन तक।
list_webhooks, create_webhook, delete_webhook
नतीजे कहां डिलीवर होते हैं, HMAC-साइन किए वेबहुक के रूप में।
list_identities
परसिस्टेंट आइडेंटिटी, जिनके सेव किए लॉगिन कोई टास्क दोबारा इस्तेमाल कर सकता है।
list_llm_keys
सेव की गई मॉडल की, मास्क करके। यह कभी सीक्रेट नहीं लौटाता।
credits
क्रेडिट बैलेंस और पैक।

इसकी लागत क्या है?

MCP सर्वर मुफ़्त है। हर run_task एक एजेंट टास्क है, जिसका बिल क्रेडिट में बनता है: उसका ब्राउज़र टाइम (हर शुरू हुए 12 मिनट पर 1 क्रेडिट), प्लस 1 क्रेडिट, प्लस हर 5 स्टेप पर 1 क्रेडिट। Browsa का होस्टेड मॉडल 5 क्रेडिट जोड़ता है।

टास्क (12 मिनट के अंदर पूरा)आपकी अपनी मॉडल कीBrowsa का होस्टेड मॉडल
10 स्टेप4 क्रेडिट9 क्रेडिट
20 स्टेप6 क्रेडिट11 क्रेडिट

फ़ेल हुए टास्क को ब्राउज़र का चार्ज वापस मिलता है और स्टेप का चार्ज नहीं लगता। अपनी की के साथ, टोकन का बिल आपका मॉडल प्रोवाइडर भेजता है; Browsa कोई मार्कअप नहीं जोड़ता। $20 के Starter पैक पर एक क्रेडिट $0.10 का है। पूरी प्राइसिंग।

ट्रबलशूटिंग

सर्वर दिखाई नहीं देता

कॉन्फ़िग बदलने के बाद क्लाइंट रीस्टार्ट करें, देखें कि JSON सही है, और टर्मिनल में node --version चलाएं: सर्वर को Node.js 18 या नया चाहिए, और क्लाइंट जिस पाथ का इस्तेमाल करता है उस पर npx होना चाहिए।

LLM_KEY_REQUIRED

आपने मॉडल का नाम दिया, लेकिन उसकी कोई की उपलब्ध नहीं है। dashboard/llm-keys पर की सेव करें, BROWSA_LLM_API_KEY सेट करें, या llm: "browsa" मांगें।

402 INSUFFICIENT_CREDIT या BUDGET_REACHED

बैलेंस बहुत कम है, या आपकी मंथली ख़र्च सीमा पूरी हो गई है। असिस्टेंट से credits टूल चलाने को कहें, या डैशबोर्ड में Credits पेज देखें।

सवाल

क्या ब्राउज़र मेरे कंप्यूटर पर चलता है?

नहीं। MCP सर्वर आपकी मशीन पर एक छोटा Node.js प्रोसेस है जो Browsa API को कॉल करता है। ब्राउज़र Browsa के क्लाउड में चलता है, इसलिए और कुछ इंस्टॉल नहीं करना पड़ता और आपके अपने ब्राउज़र को कोई नहीं छूता।

क्या मुझे Anthropic या OpenAI की चाहिए?

नहीं। सिर्फ़ BROWSA_API_KEY सेट हो और कोई सेव की गई की न हो, तो टास्क Browsa के होस्टेड मॉडल पर हर टास्क 5 क्रेडिट ज़्यादा में चलते हैं, और सर्वर नतीजे में यह बताता है। अपना मॉडल इस्तेमाल करने के लिए डैशबोर्ड में Anthropic, OpenAI या Google की सेव करें, या BROWSA_LLM_API_KEY सेट करें।

हर रिक्वेस्ट की लागत क्या है?

हर run_task कॉल एक एजेंट टास्क है: उसका ब्राउज़र टाइम (हर शुरू हुए 12 मिनट पर 1 क्रेडिट), प्लस 1 क्रेडिट, प्लस हर 5 स्टेप पर 1 क्रेडिट। 12 मिनट के अंदर पूरा होने वाला 10 स्टेप का टास्क आपकी अपनी की से 4 क्रेडिट का और Browsa के होस्टेड मॉडल पर 9 का पड़ता है। MCP सर्वर ख़ुद मुफ़्त है।

यह किन MCP क्लाइंट के साथ चलता है?

कोई भी क्लाइंट जो stdio पर लोकल MCP सर्वर शुरू कर सके, जैसे Claude Desktop, Claude Code, Cursor, VS Code, Cline, Continue और Zed। npx के लिए सर्वर को Node.js 18 या नया चाहिए।

आगे क्या

अपने असिस्टेंट को ब्राउज़र दें।

100 मुफ़्त क्रेडिट। कोई कार्ड नहीं, कोई सब्सक्रिप्शन नहीं।