VS Code यूज़र्स के लिए

Copilot आपका वर्कस्पेस देखता है। Maguyva पूरे रिपो का नक्शा बनाता है।

VS Code में एजेंट वे फ़ाइलें पढ़ता है जो आप अटैच करते हैं और वे जो उसकी सर्च में मिलती हैं। Maguyva पूरा रिपो इंडेक्स करता है और उसे MCP पर देता है, ताकि एजेंट बदलाव से पहले पूछे कि कोई सिंबल कहां है और उसे कौन कॉल करता है।

मुफ़्त शुरू करें VS Code सेटअप पढ़ें

Free स्तर: 3 रिपॉज़िटरी, 50K तक इंडेक्स्ड रिपॉज़िटरी लाइनें, क्रेडिट कार्ड की ज़रूरत नहीं।

.vscode/mcp.json में एक servers एंट्री: एक URL और एक Authorization हेडर।

VS Code के बारे में क्या जानना ज़रूरी है

VS Code से जुड़ी चार खास बातें।

// कॉन्फ़िग फ़ाइल

.vscode/mcp.json

सर्वर servers के नीचे जाते हैं, mcpServers के नीचे नहीं। हर वर्कस्पेस के लिए MCP: Open User Configuration चलाएं और वही एंट्री अपनी प्रोफ़ाइल की mcp.json में जोड़ें।

// ट्रांसपोर्ट

type: http

VS Code, Maguyva के एंडपॉइंट से Streamable HTTP पर कनेक्ट होता है और SSE पर तभी लौटता है जब सर्वर उसे सपोर्ट न करे। लोकल कुछ नहीं चलता।

// कुंजी

एक एनवायरनमेंट रेफ़रेंस

हेडर Bearer ${env:MAGUYVA_API_KEY} है, जिसे VS Code उस एनवायरनमेंट से पढ़ता है जिसमें वह शुरू हुआ, इसलिए कुंजी उस फ़ाइल से बाहर रहती है जिसे आप कमिट करते हैं। पूछे जाना पसंद है? एक इनपुट वेरिएबल एक बार पूछता है और कुंजी सेव कर लेता है।

// भरोसा

वर्कस्पेस ट्रस्ट

.vscode/mcp.json के सर्वर वर्कस्पेस पर भरोसा करते ही बिना अलग प्रॉम्प्ट के शुरू हो जाते हैं, और प्रतिबंधित मोड में कभी शुरू नहीं होते। चैट इनपुट में Configure Tools अलग-अलग टूल चालू या बंद करता है।

कस्टम इंस्ट्रक्शन एक वर्किंग एग्रीमेंट हैं। इनका उपयोग करें।

# .github/copilot-instructions.md
- किसी बदलाव को पूरा कहने से पहले npm test चलाओ।
- src/gen/ में जनरेट हुई फ़ाइलें कभी एडिट मत करो।

VS Code पूरे प्रोजेक्ट के निर्देश .github/copilot-instructions.md या AGENTS.md से पढ़ता है, और लक्षित निर्देश applyTo पैटर्न वाली .github/instructions/*.instructions.md फ़ाइलों से। इन्हें इनके लिए इस्तेमाल करें:

बिल्ड, टेस्ट और लिंट कमांड।
वे कन्वेंशन जिनमें एजेंट बार-बार गलती करता है।
वे फ़ोल्डर जिन्हें एजेंट को नहीं छूना चाहिए।

निर्देश एजेंट को बताते हैं कि कैसे काम करना है। वे यह नहीं बता सकते कि चार हज़ार फ़ाइलों में से कौन-सी उस टाइप को import करती हैं जिसका नाम वह बदलने वाला है।

जहां वर्कस्पेस व्यू कम पड़ता है

तीन बातें जो एजेंट खुली फ़ाइलों से नहीं सीख सकता।

// अटैच किया हुआ सब कुछ नहीं है

एजेंट उसी से काम करता है जो आप अटैच करते हैं और जो उसकी सर्च लौटाती है। दूसरे पैकेज का वह कॉलर, जो बदलाव के बाद टूटता है, किसी भी लिस्ट में नहीं था।

// टेक्स्ट मैच रेफ़रेंस नहीं है

वर्कस्पेस सर्च स्ट्रिंग ढूंढ लेती है। पर वह असली कॉल को कमेंट, mock या किसी दूसरी क्लास के उसी नाम वाले मेथड से अलग नहीं कर सकती।

// हर रीड कॉन्टेक्स्ट खर्च करता है

दिशा समझने के लिए एजेंट जो भी फ़ाइल खोलता है, वह उस कॉन्टेक्स्ट को खर्च करती है जिसकी ज़रूरत बदलाव के लिए है। file:line के साथ एक रैंक किया गया जवाब दस खोजी रीड्स से सस्ता है।

VS Code में MCP सर्वर के तौर पर Maguyva

एक servers एंट्री एजेंट को देती है:

आपके इंडेक्स किए गए रिपो पर 11 टूल सिमेंटिक, स्ट्रक्चरल (AST), ग्राफ़ और टेक्स्ट सर्च, साथ में सिंबल लुकअप, डिपेंडेंट्स और फ़ाइल रिट्रीवल।
फ़ाइल पाथ और लाइन नंबर के साथ जवाब 285+ भाषाओं में, ताकि एजेंट पहली बार में ही सही फ़ाइल खोले।
सिर्फ़ पढ़ने वाले टूल Maguyva के टूल सिर्फ़ इंडेक्स से क्वेरी करते हैं। कोई भी आपकी फ़ाइलें एडिट नहीं करता, इसलिए हर अप्रूवल पढ़ने के बारे में है, लिखने के बारे में नहीं।

VS Code एजेंट को आपका वर्कस्पेस देता है।
Maguyva एजेंट को रिपो का नक्शा देता है।

दो वर्कफ़्लो

पहले नक़्शे से पूछें, फिर एडिट करें।

// workflow 01

पार्सर बदलने से पहले टेस्ट ढूंढें

vscode agent> कौन-से टेस्ट parseConfig तक पहुंचते हैं?

dependency_search("parseConfig", dependents)
  tests/config/parse.test.ts:12
  tests/cli/flags.test.ts:88

→ एडिट के बाद एजेंट पूरा सूट नहीं, सिर्फ़ ये दो फ़ाइलें चलाता है।
[exit 0]

जवाब उन दो टेस्ट फ़ाइलों का नाम बताता है जो पार्सर तक पहुंचती हैं, ताकि एजेंट बदलाव वहीं जांचे जहां वह टूट सकता है।

// workflow 02

पहले एडिट से पहले रीनेम का दायरा आंकें

vscode agent> OrderStatus.PENDING का नाम बदलकर OrderStatus.QUEUED करो

find_symbol("OrderStatus", references)
  9 फ़ाइलों में 23 रेफ़रेंस

→ एजेंट नौ फ़ाइलों पर एक ही पास की योजना बनाता है।
[exit 0]

रेफ़रेंस की गिनती एडिट से पहले आ जाती है, टाइप चेकर के फ़ेल होने के बाद नहीं।

VS Code में सेटअप

तीन चरण। Free स्तर: 3 रिपॉज़िटरी, 50K तक इंडेक्स्ड रिपॉज़िटरी लाइनें, क्रेडिट कार्ड की ज़रूरत नहीं।

// step 01

maguyva.ai पर एक रिपो इंडेक्स करें

ऐसा रिपो चुनें जिसे आप पहले से जानते हैं, ताकि आप जवाबों को परख सकें।

// step 02

Maguyva को .vscode/mcp.json में जोड़ें

.vscode/mcp.json

{
  "servers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

// step 03

अपनी कुंजी सेट करें और सर्वर शुरू करें

जिस एनवायरनमेंट से आप VS Code शुरू करते हैं, उसमें MAGUYVA_API_KEY सेट करें, फिर उसकी एंट्री के ऊपर वाले कोड लेंस से सर्वर शुरू करें। एजेंट से एक ऐसा सवाल पूछें जिसका जवाब आप पहले से जानते हैं।

सेल्फ़-सर्व साइनअप खुले हैं।

एक ऐसा रिपो इंडेक्स करें जिसे आप पहले से जानते हैं।

VS Code को MCP पर कनेक्ट करें, फिर एक ऐसा सवाल पूछें जिसे आप जांच सकें।

अपनी पहली रिपॉज़िटरी इंडेक्स करें संगतता डॉक्स देखें

Free योजना: 3 रिपॉज़िटरी, 50K तक इंडेक्स्ड रिपॉज़िटरी लाइनें, क्रेडिट कार्ड की ज़रूरत नहीं।