सामग्री पर जाएँ

व्यावहारिक गाइड

रोजमर्रा के Maguyva MCP कार्य के लिए व्यावहारिक व्यंजन। प्रत्येक नुस्खा उपकरण और अनुक्रम का नाम देता है - पूर्ण पैरामीटर संदर्भ नहीं। टूल पैरामीटर के लिए, MCP API संदर्भ का उपयोग करें। पहली बार सेटअप के लिए, त्वरित शुरुआत का उपयोग करें।

सही उपकरण चुनें#

अधिकांश प्रश्न एक कॉल से शुरू होते हैं। केवल तभी आगे बढ़ें जब पहला उत्तर बहुत व्यापक या बहुत पतला हो।

  • intelligent_search - किसी भी प्राकृतिक-भाषा कोडबेस प्रश्न के लिए यहां से प्रारंभ करें; यह semantic, symbol, स्ट्रक्चरल और dependency खोज को रूट करता है।
  • find_symbol - आप पहले से ही फ़ंक्शन, क्लास या वेरिएबल नाम जानते हैं।
  • dependency_search - ब्लास्ट त्रिज्या: कॉल करने वाले, आश्रित, या संपादन से पहले (और बाद में) प्रभाव।
  • get_task_context - अपरिचित क्षेत्र; फ़ाइलों का एक सीमित बंडल, symbol (सिंबल), और कार्य विवरण के लिए निर्भरताएँ।
  • repository_context - सुलभ रिपॉजिटरी को सूचीबद्ध करें या निरीक्षण करें कि रिपॉजिटरी नाम कैसे हल होता है।
  • operation="guidance" के साथ ask_maguyva - टूल चयन और Maguyva उपयोग पर स्थानीय सहायता (कोई रेपो म्यूटेशन नहीं)।

क्लाइंट स्थापित करें और सत्यापित करें#

अपने MCP क्लाइंट में Maguyva प्राप्त करें और वास्तविक रिपॉजिटरी सूची के साथ कनेक्शन की पुष्टि करें।

  1. app.maguyva.ai में एक API कुंजी बनाएं (कुंजियाँ mgv_ से शुरू होती हैं)।
  2. कम से कम एक GitHub रिपॉजिटरी को कनेक्ट और इंडेक्स करें जिसे आप पहले से ही समझते हैं।
  3. इंस्टालेशन गाइड (Claude Code प्लगइन, या Cursor, VS Code, Windsurf, Zed, और अन्य के लिए मूल रिमोट कॉन्फ़िगरेशन) का उपयोग करके अपने क्लाइंट को वायर करें।
  4. अपने एजेंट "मैंने कौन से रिपॉजिटरी कनेक्ट की हैं?" से पूछें - जो प्रमाणीकरण और repository_context को शुरू से अंत तक पूरा करता है।
  5. उस रेपो के बारे में एक वास्तविक प्रश्न पूछें जिसका उत्तर आप ग्रेड कर सकते हैं। आपको अनुक्रमित ट्री से फ़ाइल पथ और पंक्ति संख्याएँ देखनी चाहिए।

चाभियों, पुलों, या गायब रेपो पर अटक गए? समस्या निवारण.

संपादित करने से पहले पूछें#

साझा कोड बदलने से पहले symbol (सिंबल) और ब्लास्ट रेडियस को मैप करें। Maguyva उपकरण आपके रिपॉजिटरी को संशोधित नहीं करते हैं - वे आपके क्लाइंट द्वारा स्थानीय रूप से लागू किए गए संपादन को सूचित करते हैं।

  1. यदि आप symbol नाम जानते हैं, तो परिभाषाओं और उपयोगों के बारे में जानने के लिए find_symbol पर कॉल करें।
  2. यदि आपके पास केवल कार्य विवरण है ("SSO जोड़ें", "बिलिंग वेबहुक ठीक करें"), तो get_task_context या intelligent_search से प्रारंभ करें।
  3. साझा symbol को संपादित करने से पहले, आश्रित/प्रभाव विश्लेषण के साथ dependency_search को कॉल करें (या PR- शैली प्रभाव के लिए परिवर्तित पथ पास करें) ताकि आप ब्लास्ट त्रिज्या देख सकें।
  4. उद्धृत फ़ाइलें खोलें (डिस्क पर फ़ाइलों के लिए स्थानीय रीड; रिमोट/क्रॉस-रेपो पथों के लिए get_file) और वास्तविक कोड के विरुद्ध योजना की पुष्टि करें।
  5. संपादन के बाद, उसी symbol को dependency_search के साथ दोबारा जांचें (जब आपका क्लाइंट सत्यापित फ़्लैग का समर्थन करता है तो पोस्ट-एडिट सत्यापन सहित) ताकि कॉल करने वाले अभी भी अपेक्षा के अनुरूप समाधान कर सकें।

पूर्ण पैरामीटर: MCP API संदर्भ.

खोजें, फिर बदलें#

एक डिफ़ॉल्ट एजेंट लूप: एक्सप्लोर करें → symbol (सिंबल) पिन करें → साक्ष्य के साथ संपादित करें।

  1. intelligent_search और एक सामान्य भाषा की क्वेरी ("सत्र समाप्ति कैसे काम करती है", "पुनः प्रयास करने का तर्क कहां है") से प्रारंभ करें।
  2. पहली विंडो में शोर होने पर भाषा या पथ फ़िल्टर से संकीर्ण करें।
  3. वही अस्पष्ट प्रश्न दोबारा पूछने के बजाय find_symbol या dependency_search पर आशाजनक हिट को बढ़ावा दें।
  4. get_file का उपयोग केवल तभी करें जब आपको एक विशिष्ट अनुक्रमित पथ की आवश्यकता हो जो डिस्क पर न हो।
  5. अपने सामान्य क्लाइंट टूल में संपादित करें. Maguyva खोज और सत्यापन के लिए है - लिखने के लिए नहीं।

यह लूप क्यों काम करता है: यह काम किस प्रकार करता है.

खाली या पतले परिणाम#

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

  1. पुष्टि करें कि रिपॉजिटरी कनेक्ट है और app.maguyva.ai में अनुक्रमण समाप्त हो गया है।
  2. रिपॉजिटरी स्ट्रिंग की जाँच करें: "owner/repo" डिफ़ॉल्ट शाखा का उपयोग करता है; "owner/repo:branch" एक शाखा को पिन करता है। मिलान केस-असंवेदनशील है, अस्पष्ट नहीं - टाइपो त्रुटियाँ स्वतः-सही नहीं होतीं।
  3. action="info" के साथ repository_context पर कॉल करें और रिज़ॉल्यूशन मेटाडेटा का निरीक्षण करें (उदाहरण के लिए metadata.resolution_reason)।
  4. repository को केवल तभी हटाएं जब आपका MCP क्लाइंट अनुरोध डिफ़ॉल्ट प्रदान करता है या कुंजी बिल्कुल एक रिपॉजिटरी तक पहुंच सकती है; अन्यथा इसे स्पष्ट रूप से पारित करें।
  5. अधिक विशिष्ट क्वेरी, find_symbol के माध्यम से ज्ञात symbol नाम, या भाषा/पथ फ़िल्टर के साथ पुनः प्रयास करें। यदि कनेक्शन स्वयं टूट गया है, तो समस्या निवारण का उपयोग करें।

सेटअप विफलताएँ: समस्या निवारण.

एकाधिक रिपॉजिटरी में कार्य करें#

जब एक कुंजी एक से अधिक देख सकती है तो सही अनुक्रमित रेपो को लक्षित करें।

  1. आपकी कुंजी द्वारा खोजे जा सकने वाले सटीक स्लग जानने के लिए एक बार action="list" के साथ repository_context पर कॉल करें।
  2. जब आपको गैर-डिफ़ॉल्ट रेपो (उदाहरण के लिए "owner/other-repo" या "owner/other-repo:develop") की आवश्यकता हो तो खोज और symbol टूल पर स्पष्ट रूप से repository पास करें।
  3. जब तक आप जानबूझकर अलग-अलग कॉल में रिपोज़ की तुलना नहीं करते, तब तक एक प्रश्न = एक रिपॉजिटरी रखें।
  4. जब फ़ाइल एक अनुक्रमित रेपो में रहती है जो आपका वर्तमान कार्यशील पेड़ नहीं है तो get_file का उपयोग करें।
  5. याद रखें: उपकरण कभी भी GitHub पर वापस नहीं लिखते - कई रीपो का संदर्भ केवल पढ़ने और योजना बनाने के लिए है।

रिपॉजिटरी प्रारूप विवरण: MCP API संदर्भ।

Maguyva में नये हैं? पहले त्वरित शुरुआत चलें, फिर दिन-दो लूप के लिए यहां वापस आएं।

अगले कदम#