# इंस्टॉलेशन गाइड

Canonical source: https://maguyva.ai/hi/docs/installation

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

5 मिनट से भी कम समय में तैयार हो जाएँ। इस गाइड में Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cline, Goose, Continue, LM Studio, Kiro CLI, JetBrains, Zed, Trae, OpenCode, BoltAI, LibreChat, Antigravity, Claude Cowork, ChatGPT, और Warp समेत 23 MCP क्लाइंट के लिए सेटअप शामिल है।

**ज़रूरी शर्तें**: आपको [app.maguyva.ai](https://app.maguyva.ai) से एक API कुंजी और एक कनेक्ट की गई GitHub रिपॉज़िटरी चाहिए।

## एनवायरनमेंट सेटअप

सबसे पहले अपनी API कुंजी एक एनवायरनमेंट वेरिएबल में सेट करें। जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो `repository` छोड़ दें; अन्यथा इसे स्पष्ट रूप से पास करें।

### macOS/Linux (Bash/Zsh)

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

### Windows (PowerShell)

```powershell
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE
```

`mgv_xxxx` को [app.maguyva.ai](https://app.maguyva.ai) से मिली अपनी असली API कुंजी से बदलें।

## क्लाइंट कॉन्फ़िगरेशन

विशिष्ट सेटअप निर्देशों के लिए नीचे अपना MCP क्लाइंट चुनें।

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

Maguyva स्टैंडर्ड MCP का उपयोग करता है। प्रोटोकॉल को सपोर्ट करने वाला कोई भी क्लाइंट कनेक्ट हो सकता है — भले ही ऊपर उसके लिए हमारी अपनी गाइड न हो। 23 क्लाइंट के दस्तावेज़ उपलब्ध हैं, और नियमित रूप से नए जोड़े जाते हैं।

## अपना सेटअप वेरिफ़ाई करें

कनेक्ट करने के बाद, अपने एजेंट से कुछ सवाल पूछने की कोशिश करें:

- "मेरे पास कौन सी रिपॉज़िटरी कनेक्ट हैं?" — यह वेरिफ़ाई करता है कि कनेक्शन काम कर रहा है
- "इस कोडबेस में प्रमाणीकरण कैसे संभाला जाता है?" — सिमेंटिक सर्च को टेस्ट करता है
- "वे सभी फ़ंक्शन खोजें जो डेटाबेस को कॉल करते हैं" — डिपेंडेंसी सर्च को टेस्ट करता है
- "UserService क्लास किस पर निर्भर है?" — सिंबल लुकअप को टेस्ट करता है

आपको अपनी कनेक्ट की गई रिपॉज़िटरी से फ़ाइल पथ और लाइन नंबर वाले परिणाम दिखने चाहिए। अगर नहीं, तो नीचे [troubleshooting](https://maguyva.ai/hi/docs/troubleshooting) देखें।

## रिपॉज़िटरी फ़ॉर्मैट

रिपॉज़िटरी बताते समय:

- ब्रांच के साथ: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- डिफ़ॉल्ट ब्रांच: `"owner/repo"`

**सुझाव**: रिपॉज़िटरी की पहचान जाँचने के लिए `repository_context(action="info", repository="...")` इस्तेमाल करें। डिफ़ॉल्ट रिपॉज़िटरी को बदलने वाला स्पष्ट चयन सिर्फ़ मौजूदा कॉल पर लागू होता है।

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

### API कुंजी से जुड़ी समस्याएं

- जांचें कि आपकी कुंजी mgv_ प्रीफ़िक्स से शुरू होती है
- जांचें कि कुंजी आपके एनवायरनमेंट में सही ढंग से सेट है
- सुनिश्चित करें कि कुंजी की अवधि समाप्त नहीं हुई है

### रिपॉज़िटरी नहीं मिली

- जांचें कि रिपॉज़िटरी app.maguyva.ai में कनेक्ट है
- जांचें कि owner/repo फ़ॉर्मैट सही है
- सुनिश्चित करें कि आपके पास रिपॉज़िटरी तक पहुंच है

### MCP कनेक्शन से जुड़ी समस्याएं

- अगर आपका क्लाइंट @maguyva/mcp ब्रिज इस्तेमाल करता है, तो जाँचें कि npx आपके PATH में उपलब्ध है
- जांचें कि आपका API टोकन मान्य है और समाप्त नहीं हुआ है
- https://maguyva.tools/mcp से कनेक्टिविटी टेस्ट करें
- अपने क्लाइंट के MCP कॉन्फ़िगरेशन सिंटैक्स को जांचें

## अगले कदम

- MCP API रेफ़रेंस: पूरा API दस्तावेज़ीकरण
- यह कैसे काम करता है: संदर्भ अनुकूलन को समझें
- समस्या निवारण: सेटअप और कनेक्शन समस्याएं ठीक करें