मदद · एजेंट (MCP)

Mokbi का MCP सर्वर सेट करना।

संक्षेप में। सर्वर को अपने एजेंट में जोड़ें, टर्मिनल से एक बार साइन इन करें, फिर /mokbi:screenshots माँगें। एजेंट आपकी अपनी मशीन पर ऐप को हर भाषा में कैप्चर करता है और सेट आपके Mokbi प्रोजेक्ट में तैयार रख देता है। आप एडिटर में एक क्लिक से अप्लाई कर देते हैं।

आपको क्या चाहिए

  • Node 20 या उससे नया, उसी मशीन पर जहाँ आपका एजेंट चलता है। node --version से जाँचें।
  • MCP समझने वाला एजेंट। Claude Code, Cursor, Codex और Windsurf सब चलते हैं; Model Context Protocol बोलने वाला कोई भी चलेगा।
  • Android Studio के SDK Platform-Tools और एक एमुलेटर, Android 13 या उससे नया (API 33+)। उससे नीचे प्रति-ऐप भाषा होती ही नहीं और हर भाषा के लिए डिवाइस रीस्टार्ट करना पड़ता। टूल आपके PATH में न हों तो ANDROID_HOME सेट करें।
  • एक Mokbi अकाउंट, उस प्रोजेक्ट के साथ जिसे आप भरना चाहते हैं। सब कुछ किसी प्रोजेक्ट में तैयार रखा जाता है, इसलिए न हो तो पहले बना लें।
  • iOS कैप्चर अभी शामिल नहीं है। उसके लिए macOS चाहिए और वह अलग से आएगा; आज कैप्चर वाला हिस्सा Android है।

1. अपनी मशीन जाँचें

npx -y @mokbi/mcp doctor चलाएँ। यह आपका Node वर्ज़न, adb और एमुलेटर कहाँ खोजे जा रहे हैं, और आप साइन इन हैं या नहीं — सब दिखा देता है। जिस पर ✗ हो, पहले उसे ठीक करें: कैप्चर टूल किसी ग़ायब SDK के आसपास से रास्ता नहीं निकाल सकते।

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

Claude Code में एक कमांड काफ़ी है:

claude mcp add mokbi -- npx -y @mokbi/mcp

Cursor, Codex, Windsurf और दूसरे होस्ट में अपनी MCP कॉन्फ़िगरेशन में कमांड npx और आर्ग्युमेंट ["-y","@mokbi/mcp"] वाला सर्वर जोड़ें। उसके बाद होस्ट को रीस्टार्ट करें ताकि वह सर्वर पहचान ले।

3. एक बार साइन इन करें

npx -y @mokbi/mcp login चलाएँ। ब्राउज़र में Mokbi खुलेगा, आप अनुरोध मंज़ूर करेंगे और टोकन 127.0.0.1 पर वापस आ जाएगा — यह कभी किसी URL में नहीं जाता। मंज़ूरी वाली स्क्रीन एक पोर्ट नंबर बताती है; मंज़ूरी देने से पहले देख लें कि वह टर्मिनल में दिखे नंबर से मेल खाता है।

उस मशीन पर ब्राउज़र नहीं है? npx -y @mokbi/mcp login --paste चलाएँ और टोकन ख़ुद बनाएँ: Mokbi → मेन्यू → एजेंट (MCP) → "एजेंट एक्सेस" → "नया टोकन"। टोकन एक ही बार दिखता है, इसलिए तुरंत कॉपी कर लें।

टोकन ~/.mokbi/config.json में 0600 परमिशन के साथ रखा जाता है। यह आपका सेशन नहीं है: इसे रद्द करने से आपके अकाउंट पर कोई असर नहीं पड़ता। CI के लिए एनवायरनमेंट वेरिएबल MOKBI_TOKEN फ़ाइल से पहले आता है।

4. आपका पहला राउंड

एजेंट से स्क्रीनशॉट फ़्लो माँगें। सर्वर तीन स्लैश-कमांड साथ लाता है, और Claude Code में वे ठीक ऐसे ही दिखते हैं:

  • /mokbi:screenshots — रिपॉज़िटरी पढ़ना, कौन-सी स्क्रीन कैप्चर हों यह सुझाना, आपकी जाँच के लिए एक भाषा चलाना, और आपकी हाँ के बाद सारी भाषाएँ चलाकर सेट तैयार रखना।
  • /mokbi:localize — हर स्टोर की कैरेक्टर सीमा के भीतर आपके स्टोर टेक्स्ट लिखना।
  • /mokbi:check — बताना कि क्या तैयार है और हर भाषा में हर स्टोर के लिए क्या बाक़ी है।

आप बस अपनी ज़रूरत बता भी सकते हैं; सर्वर ख़ुद एजेंट को समझा देता है कि फ़्लो कैसा होना चाहिए। पहले राउंड में एक ही भाषा रखें। तब एक ग़लत टैप बीस राउंड नहीं, सिर्फ़ एक राउंड लेता है।

5. एजेंट का तैयार किया हुआ अप्लाई करें

एडिटर में अपना प्रोजेक्ट खोलें। डिलीवरी "आपके एजेंट से" में इंतज़ार कर रही है — टूलबार में रोबोट वाला बटन, वही पैनल जो मेन्यू → एजेंट (MCP) → "एजेंट एक्सेस" से खुलता है, और स्क्रीनशॉट मेन्यू में "आपके एजेंट से" बटन। उस बटन पर बना निशान बताता है कि कितना इंतज़ार में है।

  • "अप्लाई करें" स्क्रीनशॉट उसी योजना के अनुसार लगाता है जो बटन के ऊपर दिखती है: कौन-सा स्क्रीनशॉट किस पैनल में, किस भाषा के लिए। एक Ctrl+Z पूरा सेट वापस निकाल देता है।
  • "अप्लाई करें और डिज़ाइन करें" तब दिखता है जब एजेंट ने आपकी ऐप के बारे में छोटा ब्रीफ़ भेजा हो। यह एडिटर के नारंगी बटन वाला ही AI Designer राउंड चलाता है, उसी 2 क्रेडिट की क़ीमत पर, तैयार रखे स्क्रीनशॉट के साथ।
  • "सब स्वीकार करें" तब दिखता है जब स्टोर टेक्स्ट या कैप्शन अनुवाद थोक में तैयार हों। यह उन्हें एक ही स्टेप में अप्लाई करता है, और एक अनडू सबको हटा देता है।
  • "हटा दें" उस डिलीवरी को मिटा देता है जो आपको नहीं चाहिए। आपका एजेंट दोबारा भेज सकता है।

कुछ भी अपने आप अप्लाई नहीं होता, और यह जान-बूझकर है। आपके प्रोजेक्ट का इकलौता लेखक एडिटर है: खुला हुआ टैब पूरा दस्तावेज़ वापस सेव करता है। अगर डिलीवरी सीधे आपके डिज़ाइन में गिरती, तो कहीं और खुला रह गया एडिटर टैब उसे चुपचाप ओवरराइट कर सकता था।

जब कुछ गड़बड़ हो

  • "adb not found"। SDK Platform-Tools इंस्टॉल नहीं हैं या आपके PATH में नहीं हैं। उन्हें Android Studio के SDK Manager से इंस्टॉल करें, या ANDROID_HOME को अपने SDK फ़ोल्डर पर सेट करें।
  • शुरू होते ही एमुलेटर 'offline' दिखता है। नया एमुलेटर तैयार होने की सूचना देने के बाद भी थोड़ी देर बूट होता रहता है। सर्वर तीन बूट-संकेतों का इंतज़ार करता है और दोबारा कोशिश करता है; बंद करने से पहले उसे एक मिनट दें।
  • "भाषा नहीं बदली"। सेट करने के बाद हम वापस पढ़ते हैं कि डिवाइस क्या बता रहा है। मेल न खाए तो सबसे संभावित बात यही है कि आपकी ऐप में वह भाषा है ही नहीं, या ऐप पहले से किसी और भाषा में चल रही थी। उस भाषा के लिए राउंड दोबारा चलाएँ।
  • दो भाषाएँ एक जैसी दिखती हैं। यह जाँच का अपना काम करना है: स्क्रीन एक जैसी हैं, यानी उस भाषा के लिए ऐप अनुवादित नहीं है। भाषा तब निकालें जब ऐप भी तैयार हो।
  • ब्राउज़र वाला लॉगिन पूरा नहीं होता। npx -y @mokbi/mcp login --paste इस्तेमाल करें और एडिटर में बनाया टोकन पेस्ट करें।
  • एडिटर में कुछ भी इंतज़ार नहीं कर रहा। देखें कि वही प्रोजेक्ट खुला है जिसमें एजेंट ने भेजा था, और टोकन अब भी वैध है: npx -y @mokbi/mcp doctor
  • राउंड ऐसी स्क्रीन पर अटक जाता है जहाँ आपकी ऐप कभी पहुँचती ही नहीं। कैप्चर ड्राइवर बताता है कि वह किस स्क्रीन को देख रहा था, साथ में तस्वीर भी। वह अपने एजेंट को लौटाएँ और फ़्लो सुधारें; सर्वर आपकी जगह ऐप टेस्ट नहीं करता।

टोकन क्या कर सकता है और क्या नहीं

  • यह तैयार रखता है, पब्लिश नहीं करता। App Store और Google Play पर पब्लिश करना Mokbi में ही रहता है, आपके क्लिक पर।
  • यह पैसे ख़र्च नहीं कर सकता। डिज़ाइन राउंड का भुगतान उसी वक़्त आपके अपने एडिटर सेशन से होता है जब आप बटन दबाते हैं — एजेंट से कभी नहीं।
  • यह आपका सेशन नहीं है। मेन्यू → एजेंट (MCP) → "एजेंट एक्सेस" में इसे रद्द करें, आपका अकाउंट जस का तस रहता है। हर टोकन के साथ दिखता है कि वह आख़िरी बार कब इस्तेमाल हुआ।
  • आपका कोड आपके पास रहता है। कैप्चर वाला हिस्सा पूरी तरह आपकी मशीन पर चलता है; प्रोजेक्ट तक सिर्फ़ तैयार तस्वीरें और टेक्स्ट जाते हैं।

एडिटर खोलें → MCP सर्वर क्या करता है