Gologin MCP Server

AI एजेंटों के लिए GoLogin MCP सर्वर

AI वार्तालापों के माध्यम से GoLogin ब्राउज़र प्रोफ़ाइल, प्रॉक्सी, फ़िंगरप्रिंट, फ़ोल्डर और क्लाउड ब्राउज़र सत्र प्रबंधित करें। यह Model Context Protocol (MCP) सर्वर आपके AI क्लाइंट को GoLogin API से जोड़ता है।

त्वरित आरंभ

आपको Node.js 22 या नया संस्करण, एक सक्रिय GoLogin खाता और एक GoLogin API टोकन चाहिए। Node.js 22 और 24 LTS का परीक्षण macOS Apple Silicon पर किया गया है।

1. अपने GoLogin खाते में साइन इन करें, API & MCP खोलें, और API टैब में एक टोकन बनाएं।
2. यह कॉन्फ़िगरेशन अपने MCP क्लाइंट में जोड़ें, टोकन प्लेसहोल्डर को बदलते हुए। इसे किसी भी मौजूदा mcpServers कॉन्फ़िगरेशन में मर्ज करें।

{
  "mcpServers": {
    "gologin-mcp": {
      "command": "npx",
      "args": ["-y", "gologin-mcp"],
      "env": {
        "API_TOKEN": "your-gologin-api-token-here"
      }
    }
  }
}

3. अपने क्लाइंट का MCP कनेक्शन पुनः आरंभ या रीलोड करें, फिर पूछें: "मुझे मेरी GoLogin प्रोफ़ाइल दिखाएं।"

क्लाइंट सर्वर को स्वचालित रूप से शुरू करता है। -y npm को बिना इंटरैक्टिव पुष्टि के पैकेज इंस्टॉल करने देता है। यह सर्वर API_TOKEN पढ़ता है; अन्य GoLogin CLI द्वारा उपयोग किया जाने वाला GOLOGIN_TOKEN वेरिएबल यहाँ उपनाम नहीं है।

टर्मिनल स्टार्टअप जांच के लिए, आपके वातावरण में API_TOKEN पहले से सेट होने पर:

npx -y gologin-mcp

सर्वर मानक इनपुट/आउटपुट (stdio) पर संचार करता है और MCP क्लाइंट की प्रतीक्षा करता है। यह स्वयं ब्राउज़र नहीं खोलता या इंटरैक्टिव कमांड प्रॉम्प्ट प्रदान नहीं करता।

आप क्या कर सकते हैं

• ब्राउज़र प्रोफ़ाइल बनाएं, पढ़ें, अपडेट करें, हटाएं और व्यवस्थित करें।
• प्रोफ़ाइल प्रॉक्सी कॉन्फ़िगर करें और ब्राउज़र फ़िंगरप्रिंट रीफ़्रेश करें।
• फ़ोल्डर और उनकी प्रोफ़ाइल सदस्यता प्रबंधित करें।
• खाता जानकारी पढ़ें।
• GoLogin क्लाउड में ब्राउज़र प्रोफ़ाइल शुरू और बंद करें।

क्लाउड स्टार्टअप एक कनेक्शन URL लौटाता है। यह सर्वर पेज नेविगेशन, क्लिक, फ़ॉर्म भरने या स्थानीय Orbita लॉन्च टूल उजागर नहीं करता। पेज स्वचालन के लिए, एक अलग ब्राउज़र स्वचालन क्लाइंट या GoLogin Agent Browser CLI का उपयोग करें।

MCP प्रक्रिया स्थानीय रूप से चलती है; GoLogin API अनुरोध और क्लाउड ब्राउज़र सत्रों के लिए नेटवर्क पहुंच आवश्यक है। क्लाउड उपलब्धता और API संचालन आपके खाते की अनुमतियों और योजना पर निर्भर करते हैं।

उपकरण

टूल नाम GoLogin OpenAPI विनिर्देश में HTTP विधि और पथ से उत्पन्न होते हैं, जिसे सर्वर स्टार्टअप पर लोड करता है। निम्नलिखित उपलब्ध टूलों का चयन है, उपनामों की निश्चित सूची नहीं। वर्तमान नामों और इनपुट स्कीमा के लिए अपने MCP क्लाइंट में tools/list क्वेरी करें।

टूल	विवरण
get_profile_v2	प्रोफ़ाइल सूचीबद्ध और खोजें, पेजिनेशन और फ़ोल्डर फ़िल्टर के साथ
post_profile_custom	नाम, OS और प्रॉक्सी जैसी आंशिक सेटिंग्स के साथ प्रोफ़ाइल बनाएं
get_profile_id	ID द्वारा प्रोफ़ाइल पढ़ें
put_profile_id_custom	चयनित प्रोफ़ाइल सेटिंग्स अपडेट करें
delete_profile	profilesToDelete में सूचीबद्ध प्रोफ़ाइल हटाएं
patch_profile_proxy_many_v2	एक या अधिक प्रोफ़ाइल के लिए प्रॉक्सी कॉन्फ़िगर करें
patch_profile_fingerprints	browsersIds में सूचीबद्ध प्रोफ़ाइल के लिए फ़िंगरप्रिंट रीफ़्रेश करें
get_proxy_v2	प्रॉक्सी सूचीबद्ध करें
get_folders	फ़ोल्डर सूचीबद्ध करें
post_folders_folder	नाम से फ़ोल्डर बनाएं
patch_folders_folder	फ़ोल्डर से प्रोफ़ाइल जोड़ें या हटाएं
delete_folders_folder	नाम से फ़ोल्डर हटाएं
post_profile_id_web	क्लाउड में प्रोफ़ाइल शुरू करें और कनेक्शन URL लौटाएं
delete_profile_id_web	क्लाउड प्रोफ़ाइल बंद करें
get_user	खाता जानकारी पढ़ें

उदाहरण के लिए, एक MCP क्लाइंट प्रोफ़ाइल पढ़ने के लिए यह tools/call अनुरोध भेज सकता है:

{
  "name": "get_profile_id",
  "arguments": {
    "id": "your-profile-id"
  }
}

तर्क प्रत्येक टूल के इनपुट स्कीमा का पालन करते हैं। पथ और क्वेरी पैरामीटर, और अनुरोध निकाय फ़ील्ड, शीर्ष-स्तरीय तर्क के रूप में पारित किए जाते हैं।

उदाहरण प्रॉम्प्ट

• "मुझे मेरी GoLogin प्रोफ़ाइल दिखाएं।"
• "'Research' नाम की एक Linux प्रोफ़ाइल बनाएं।"
• "प्रोफ़ाइल PROFILE_ID का नाम बदलकर 'Research US' करें।"
• "प्रोफ़ाइल PROFILE_ID को इन प्रॉक्सी सेटिंग्स का उपयोग करने के लिए अपडेट करें।"
• "प्रोफ़ाइल PROFILE_ID के लिए फ़िंगरप्रिंट रीफ़्रेश करें।"
• "'Research' नाम का एक फ़ोल्डर बनाएं और उसमें प्रोफ़ाइल PROFILE_ID जोड़ें।"
• "प्रोफ़ाइल PROFILE_ID को क्लाउड में शुरू करें और मुझे कनेक्शन URL दें।"
• "प्रोफ़ाइल PROFILE_ID के लिए क्लाउड सत्र बंद करें।"
• "मेरी GoLogin खाता जानकारी दिखाएं।"

MCP क्लाइंट के लिए सेटअप

Claude Desktop

Settings > Developer > Edit Config खोलें और claude_desktop_config.json में त्वरित आरंभ कॉन्फ़िगरेशन जोड़ें। Claude Desktop को पूरी तरह से बंद करें और पुनः आरंभ करें, फिर जांचें कि gologin-mcp और इसके टूल उपलब्ध हैं।

कॉन्फ़िगरेशन पथ और समस्या निवारण के लिए आधिकारिक स्थानीय MCP सेटअप गाइड देखें।

Cursor

अपने उपयोगकर्ता खाते के लिए ~/.cursor/mcp.json में, या किसी प्रोजेक्ट के लिए .cursor/mcp.json में त्वरित आरंभ कॉन्फ़िगरेशन जोड़ें। MCP कनेक्शन रीलोड करें और सर्वर के टूल सक्षम करें। API टोकन वाले कॉन्फ़िगरेशन को संस्करण नियंत्रण से बाहर रखें।

वर्तमान क्लाइंट सेटिंग्स के लिए Cursor का MCP दस्तावेज़ीकरण देखें।

अन्य MCP क्लाइंट

एक क्लाइंट का उपयोग करें जो स्थानीय stdio MCP सर्वर का समर्थन करता है। npx को कमांड के रूप में, -y और gologin-mcp को इसके तर्क के रूप में, और API_TOKEN को सर्वर वातावरण में कॉन्फ़िगर करें। कॉन्फ़िगरेशन प्रारूप और स्थान क्लाइंट पर निर्भर करते हैं।

समस्या निवारण

• सर्वर कनेक्ट नहीं होता: जांचें कि Node.js और npx क्लाइंट के लिए उपलब्ध हैं, फिर इसका MCP कनेक्शन पुनः आरंभ करें। सर्वर को अपने टूल परिभाषाएं लोड करने के लिए docs-download.gologin.com तक पहुंच की भी आवश्यकता है।
• API 401 Unauthorized लौटाता है: सर्वर को पारित API_TOKEN और GoLogin में टोकन की वैधता जांचें। इसे बदलने के बाद कनेक्शन पुनः आरंभ करें।
• टूल नाम नहीं मिला: टूल सूची रीफ़्रेश करें और tools/list द्वारा लौटाए गए नामों का उपयोग करें; list_profiles और start_browser जैसे नाम अंतर्निहित उपनाम नहीं हैं।
• क्लाउड स्टार्टअप विफल: API प्रतिक्रिया और अपने खाते की क्लाउड पहुंच जांचें। स्थानीय MCP स्टार्टअप स्वयं आपके कंप्यूटर पर Orbita शुरू नहीं करता।

विकास

git clone https://github.com/gologinapp/gologin-mcp.git
cd gologin-mcp
npm ci
npm run build

API_TOKEN पहले से कॉन्फ़िगर होने पर अपने स्थानीय बिल्ड को चलाने के लिए:

node dist/index.js

प्रकाशन से पहले, चलाएं:

npm run release:check

पैकेज में केवल निर्मित सर्वर, पैकेज मेटाडेटा, README और लाइसेंस शामिल है। रिलीज़ जांच इस अनुमत सूची को सत्यापित करती है ताकि स्थानीय स्थिति, डेटाबेस, क्रेडेंशियल और विकास फ़ाइलें अतिरिक्त फ़ाइलों के रूप में शामिल नहीं की जा सकें। npm publish स्वचालित रूप से वही जांच चलाता है।

MCP रजिस्ट्री रिलीज़

server.json आधिकारिक MCP रजिस्ट्री के लिए io.github.gologinapp/gologin-mcp के तहत इस सर्वर का वर्णन करता है। npm पैकेज mcpName में समान पहचानकर्ता घोषित करता है।

package.json, package-lock.json और server.json में संस्करण संरेखित रखें। पहले जांचे गए npm पैकेज को प्रकाशित करें, फिर रिपॉजिटरी के Actions टैब से main पर Publish to MCP Registry चलाएं। वर्कफ़्लो सत्यापित करता है कि npm रिलीज़ में सही रजिस्ट्री पहचानकर्ता है और GitHub OIDC का उपयोग करके प्रमाणित करता है, बिना अलग रजिस्ट्री टोकन के। यह npm पर प्रकाशित नहीं करता।

लिंक

• GoLogin
• GoLogin API दस्तावेज़ीकरण
• npm पैकेज
• Glama निर्देशिका

लाइसेंस

MIT, कॉपीराइट GoLogin।