इंस्टॉलेशन गाइड
5 मिनट से भी कम समय में तैयार हो जाएँ। इस गाइड में Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, और Devin Desktop (Windsurf) समेत 23 MCP क्लाइंट के लिए सेटअप शामिल है।
ज़रूरी शर्तें: आपको app.maguyva.ai से एक API कुंजी और एक कनेक्ट की गई GitHub रिपॉज़िटरी चाहिए।
एनवायरनमेंट सेटअप
#सबसे पहले अपनी API कुंजी एक एनवायरनमेंट वेरिएबल में सेट करें। जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो repository छोड़ दें; अन्यथा इसे स्पष्ट रूप से पास करें।
macOS/Linux (Bash/Zsh)
## Add to your shell profile for persistence:
echo 'export MAGUYVA_API_KEY="mgv_xxxx"' >> ~/.zshrc # or ~/.bashrc
source ~/.zshrc # reloadWindows (PowerShell)
## Make it persist in your profile:
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILEmgv_xxxx को app.maguyva.ai से मिली अपनी असली API कुंजी से बदलें।
क्लाइंट कॉन्फ़िगरेशन
#विशिष्ट सेटअप निर्देशों के लिए नीचे अपना MCP क्लाइंट चुनें।
संगतता नोट: Maguyva स्टैंडर्ड MCP का इस्तेमाल करता है। MCP सपोर्ट वाला कोई भी क्लाइंट उसी सर्वर से कनेक्ट हो सकता है, भले ही हमने अभी तक उसके लिए फर्स्ट-पार्टी सेटअप गाइड न लिखी हो।
Claude Code
Claude Code मार्केटप्लेस से Maguyva प्लगइन इंस्टॉल करें:
Maguyva मार्केटप्लेस जोड़ें, फिर प्लगइन इंस्टॉल करें (हर कमांड Claude Code के अंदर चलाएँ):
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva/plugin install प्लगइन का विवरण खोलता है, जहाँ आप इंस्टॉल स्कोप चुनते हैं: सिर्फ़ आप (user), इस रिपॉज़िटरी में काम करने वाले सभी लोग (project), या इस रिपॉज़िटरी में सिर्फ़ आप (local)। सेशन के अंदर चलने वाली इन कमांड में --scope फ़्लैग नहीं होता।
प्लगइन MAGUYVA_API_KEY एनवायरनमेंट वेरिएबल के ज़रिए ऑथेंटिकेट होता है। इसे अपने शेल में सेट करें:
export MAGUYVA_API_KEY=mgv_xxxxप्रति-प्रोजेक्ट direnv (.envrc) की सिफ़ारिश की जाती है — कुंजियाँ रिपॉज़िटरी-स्कोप्ड होती हैं, इसलिए प्रति-प्रोजेक्ट वैल्यू हर प्रोजेक्ट की एक्सेस से मेल खाती है। अगर एक ही कुंजी आपके सारे काम को कवर करती है, तो ग्लोबल शेल एक्सपोर्ट भी काम करता है।
टीम के लिए, आप इसके बजाय Claude Code के बाहर, रिपॉज़िटरी रूट से दोनों कमांड का शेल रूप चला सकते हैं:
claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope projectproject स्कोप प्लगइन को रिपॉज़िटरी की .claude/settings.json में दर्ज करता है, जिसे आप कमिट करते हैं। इससे प्लगइन टीम के साथियों के लिए चालू हो जाता है, पर डाउनलोड नहीं होता, इसलिए हर साथी इंस्टॉल कमांड एक बार चलाता है।
मैनुअल (.mcp.json) — एडवांस्ड
claude mcp add --transport http maguyva https://maguyva.tools/mcp --header 'Authorization: Bearer ${MAGUYVA_API_KEY}'{
"mcpServers": {
"maguyva": {
"type": "http",
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}mgv_xxxx को app.maguyva.ai से मिली अपनी API कुंजी से बदलें।
Claude Desktop
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %AppData%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
अपनी Claude Desktop कॉन्फ़िगरेशन फ़ाइल में जोड़ें:
{
"mcpServers": {
"maguyva": {
"command": "npx",
"args": [
"-y",
"@maguyva/mcp"
],
"env": {
"MAGUYVA_API_KEY": "mgv_xxxx"
}
}
}
}mgv_xxxx को app.maguyva.ai से मिली अपनी API कुंजी से बदलें।
claude_desktop_config.json सिर्फ़ लोकल सर्वर शुरू करता है, इसलिए यह सेटअप @maguyva/mcp ब्रिज इस्तेमाल करता है (Node.js / npx ज़रूरी)। Claude Desktop, Maguyva तक authorization रिक्वेस्ट हेडर के साथ कस्टम कनेक्टर (Customize → Connectors) के रूप में भी पहुंच सकता है, लेकिन रिक्वेस्ट हेडर सीमित संगठनों के लिए बीटा में हैं।
Cursor
macOS: ~/.cursor/mcp.json
Windows: %UserProfile%\.cursor\mcp.json
Linux: ~/.cursor/mcp.json
अपने प्रोजेक्ट रूट में .cursor/mcp.json में जोड़ें:
{
"mcpServers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
}
}
}
}यह कॉन्फ़िग आपकी कुंजी MAGUYVA_API_KEY एनवायरनमेंट वेरिएबल से पढ़ता है। जिस एनवायरनमेंट से आपका क्लाइंट शुरू होता है, उसमें इसे app.maguyva.ai से मिली अपनी API कुंजी पर सेट करें।
VS Code / GitHub Copilot
अपने प्रोजेक्ट की .vscode/mcp.json में जोड़ें, या अपनी प्रोफ़ाइल की mcp.json में (MCP: Open User Configuration चलाएं):
{
"servers": {
"maguyva": {
"type": "http",
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
}
}
}
}यह कॉन्फ़िग आपकी कुंजी MAGUYVA_API_KEY एनवायरनमेंट वेरिएबल से पढ़ता है। जिस एनवायरनमेंट से आपका क्लाइंट शुरू होता है, उसमें इसे app.maguyva.ai से मिली अपनी API कुंजी पर सेट करें।
यह VS Code फ़ॉर्मैट है (servers कुंजी)। VS Code, MAGUYVA_API_KEY रेफ़रेंस को उस एनवायरनमेंट से पढ़ता है जिसमें वह शुरू होता है। उसका Add Server फ़्लो अब पोर्टेबल .mcp.json (mcpServers कुंजी) को प्राथमिकता देता है, जिसे GitHub Copilot CLI भी पढ़ता है; वह फ़ाइल VS Code के इनपुट वेरिएबल या एनवायरनमेंट फ़ाइलें सपोर्ट नहीं करती।
Devin Desktop (Windsurf)
macOS: ~/.config/devin/mcp_config.json
Windows: %APPDATA%\devin\mcp_config.json
Linux: ~/.config/devin/mcp_config.json
Windsurf अब Devin Desktop है। इसकी MCP कॉन्फ़िगरेशन फ़ाइल में जोड़ें:
{
"mcpServers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
}
}
}
}यह कॉन्फ़िग आपकी कुंजी MAGUYVA_API_KEY एनवायरनमेंट वेरिएबल से पढ़ता है। जिस एनवायरनमेंट से आपका क्लाइंट शुरू होता है, उसमें इसे app.maguyva.ai से मिली अपनी API कुंजी पर सेट करें।
डिफ़ॉल्ट एजेंट Devin Local संस्करण 3.6 से यह फ़ाइल पढ़ता है; पुराने संस्करण सर्वर मुख्य कॉन्फ़िगरेशन फ़ाइल में रखते थे और शुरू होने पर उन्हें यहाँ ले आते हैं। पुराना Cascade एजेंट, जिससे नई बातचीत शुरू नहीं होती, भी यही फ़ाइल पढ़ता है। Devin Desktop, MAGUYVA_API_KEY रेफ़रेंस को उस एनवायरनमेंट से पढ़ता है जिसमें वह शुरू होता है।
Codex
macOS: ~/.codex/config.toml
Windows: %UserProfile%\.codex\config.toml
Linux: ~/.codex/config.toml
अपने Codex CLI कॉन्फ़िग (~/.codex/config.toml) में जोड़ें:
[mcp_servers.maguyva]
url = "https://maguyva.tools/mcp"
bearer_token_env_var = "MAGUYVA_API_KEY"यह कॉन्फ़िग आपकी कुंजी MAGUYVA_API_KEY एनवायरनमेंट वेरिएबल से पढ़ता है। जिस एनवायरनमेंट से आपका क्लाइंट शुरू होता है, उसमें इसे app.maguyva.ai से मिली अपनी API कुंजी पर सेट करें।
GitHub Copilot CLI
~/.copilot/mcp-config.json में जोड़ें:
{
"mcpServers": {
"maguyva": {
"type": "http",
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer mgv_xxxx"
}
}
}
}copilot mcp add --transport http --header "Authorization: Bearer mgv_xxxx" maguyva https://maguyva.tools/mcpmgv_xxxx को app.maguyva.ai से मिली अपनी API कुंजी से बदलें।
Gemini CLI
macOS: ~/.gemini/settings.json
Windows: %UserProfile%\.gemini\settings.json
Linux: ~/.gemini/settings.json
अपनी Gemini CLI सेटिंग्स (~/.gemini/settings.json) में जोड़ें:
{
"mcpServers": {
"maguyva": {
"httpUrl": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}यह कॉन्फ़िग आपकी कुंजी MAGUYVA_API_KEY एनवायरनमेंट वेरिएबल से पढ़ता है। जिस एनवायरनमेंट से आपका क्लाइंट शुरू होता है, उसमें इसे app.maguyva.ai से मिली अपनी API कुंजी पर सेट करें।
Cline
macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Windows: %AppData%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
अपनी Cline MCP सेटिंग्स में जोड़ें:
{
"mcpServers": {
"maguyva": {
"type": "streamableHttp",
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer mgv_xxxx"
},
"disabled": false,
"autoApprove": []
}
}
}mgv_xxxx को app.maguyva.ai से मिली अपनी API कुंजी से बदलें।
Goose
macOS: ~/.config/goose/config.yaml
Windows: %APPDATA%\Block\goose\config\config.yaml
Linux: ~/.config/goose/config.yaml
अपने Goose कॉन्फ़िग में जोड़ें:
extensions:
maguyva:
name: maguyva
type: streamable_http
uri: https://maguyva.tools/mcp
enabled: true
headers:
Authorization: Bearer mgv_xxxx
timeout: 300mgv_xxxx को app.maguyva.ai से मिली अपनी API कुंजी से बदलें।
LM Studio
LM Studio में दाईं साइडबार का Program टैब खोलें, Install → Edit mcp.json चुनें, और जोड़ें:
{
"mcpServers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer mgv_xxxx"
}
}
}
}mgv_xxxx को app.maguyva.ai से मिली अपनी API कुंजी से बदलें।
Continue
अपने वर्कस्पेस में .continue/mcpServers/maguyva.yaml के रूप में सेव करें (या mcpServers एंट्री ~/.continue/config.yaml में जोड़ें), फिर ~/.continue/.env में MAGUYVA_API_KEY सेट करें:
name: Maguyva
version: 0.0.1
schema: v1
mcpServers:
- name: maguyva
type: streamable-http
url: https://maguyva.tools/mcp
requestOptions:
headers:
Authorization: Bearer ${{ secrets.MAGUYVA_API_KEY }}यह कॉन्फ़िग आपकी कुंजी MAGUYVA_API_KEY एनवायरनमेंट वेरिएबल से पढ़ता है। जिस एनवायरनमेंट से आपका क्लाइंट शुरू होता है, उसमें इसे app.maguyva.ai से मिली अपनी API कुंजी पर सेट करें।
Continue MCP सर्वर सिर्फ़ एजेंट मोड में इस्तेमाल करता है। वह सीक्रेट को पहले ~/.continue/.env में, फिर वर्कस्पेस की .continue/.env और .env में, और आखिर में प्रोसेस एनवायरनमेंट में ढूंढता है।
Kiro CLI (Amazon Q Developer CLI)
macOS: ~/.kiro/settings/mcp.json
Windows: %USERPROFILE%\.kiro\settings\mcp.json
Linux: ~/.kiro/settings/mcp.json
Kiro CLI के MCP कॉन्फ़िग में जोड़ें (~/.kiro/settings/mcp.json, या किसी प्रोजेक्ट में .kiro/settings/mcp.json):
{
"mcpServers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer mgv_xxxx"
}
}
}
}mgv_xxxx को app.maguyva.ai से मिली अपनी API कुंजी से बदलें।
Kiro CLI ने Amazon Q Developer CLI की जगह ली है। इंस्टॉल करते समय यह आपके सर्वर एक बार ~/.aws/amazonq/mcp.json से ~/.kiro/settings/mcp.json में कॉपी करता है, और प्रोजेक्ट की .kiro/settings/mcp.json को यूज़र फ़ाइल पर प्राथमिकता मिलती है।
PyCharm
Settings | Tools | AI Assistant | Model Context Protocol (MCP) → Add में JSON कॉन्फ़िगरेशन के रूप में पेस्ट करें:
{
"mcpServers": {
"maguyva": {
"command": "npx",
"args": [
"-y",
"@maguyva/mcp"
],
"env": {
"MAGUYVA_API_KEY": "mgv_xxxx"
}
}
}
}mgv_xxxx को app.maguyva.ai से मिली अपनी API कुंजी से बदलें।
यह सेटअप @maguyva/mcp ब्रिज का उपयोग करता है (इसके लिए Node.js / npx आवश्यक हैं)। इस गाइड में इस क्लाइंट के नेटिव रिमोट कॉन्फ़िगरेशन को सत्यापित नहीं किया गया है; इसका मतलब यह नहीं है कि क्लाइंट में नेटिव रिमोट सपोर्ट नहीं है। Maguyva पूरी तरह रिमोट रूप से चलता है — केवल ब्रिज स्थानीय रूप से चलता है।
Zed
macOS: ~/.config/zed/settings.json
Windows: %AppData%\Zed\settings.json
Linux: ~/.config/zed/settings.json
अपनी Zed सेटिंग्स (~/.config/zed/settings.json) में जोड़ें:
{
"context_servers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer mgv_xxxx"
}
}
}
}mgv_xxxx को app.maguyva.ai से मिली अपनी API कुंजी से बदलें।
Trae
Settings → MCP में Enable Project MCP चालू करें, फिर अपने प्रोजेक्ट रूट की .trae/mcp.json में जोड़ें:
{
"mcpServers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer mgv_xxxx"
}
}
}
}mgv_xxxx को app.maguyva.ai से मिली अपनी API कुंजी से बदलें।
OpenCode
अपने प्रोजेक्ट रूट में opencode.json में जोड़ें:
{
"mcp": {
"maguyva": {
"type": "remote",
"url": "https://maguyva.tools/mcp",
"enabled": true,
"headers": {
"Authorization": "Bearer {env:MAGUYVA_API_KEY}"
}
}
}
}यह कॉन्फ़िग आपकी कुंजी MAGUYVA_API_KEY एनवायरनमेंट वेरिएबल से पढ़ता है। जिस एनवायरनमेंट से आपका क्लाइंट शुरू होता है, उसमें इसे app.maguyva.ai से मिली अपनी API कुंजी पर सेट करें।
BoltAI
macOS: ~/.boltai/mcp.json
अपने BoltAI MCP कॉन्फ़िगरेशन में जोड़ें:
{
"mcpServers": {
"maguyva": {
"command": "npx",
"args": [
"-y",
"@maguyva/mcp"
],
"env": {
"MAGUYVA_API_KEY": "mgv_xxxx"
}
}
}
}mgv_xxxx को app.maguyva.ai से मिली अपनी API कुंजी से बदलें।
यह सेटअप @maguyva/mcp ब्रिज का उपयोग करता है (इसके लिए Node.js / npx आवश्यक हैं)। इस गाइड में इस क्लाइंट के नेटिव रिमोट कॉन्फ़िगरेशन को सत्यापित नहीं किया गया है; इसका मतलब यह नहीं है कि क्लाइंट में नेटिव रिमोट सपोर्ट नहीं है। Maguyva पूरी तरह रिमोट रूप से चलता है — केवल ब्रिज स्थानीय रूप से चलता है।
LibreChat
librechat.yaml में जोड़ें और LibreChat सर्वर के एनवायरनमेंट में MAGUYVA_API_KEY सेट करें:
mcpServers:
maguyva:
type: streamable-http
url: https://maguyva.tools/mcp
headers:
Authorization: Bearer ${MAGUYVA_API_KEY}
requiresOAuth: falseयह कॉन्फ़िग आपकी कुंजी MAGUYVA_API_KEY एनवायरनमेंट वेरिएबल से पढ़ता है। जिस एनवायरनमेंट से आपका क्लाइंट शुरू होता है, उसमें इसे app.maguyva.ai से मिली अपनी API कुंजी पर सेट करें।
Antigravity
macOS: ~/.gemini/config/mcp_config.json
Windows: %UserProfile%\.gemini\config\mcp_config.json
Linux: ~/.gemini/config/mcp_config.json
अपने Antigravity MCP कॉन्फ़िगरेशन में जोड़ें:
{
"mcpServers": {
"maguyva": {
"serverUrl": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer mgv_xxxx"
}
}
}
}mgv_xxxx को app.maguyva.ai से मिली अपनी API कुंजी से बदलें।
Claude Cowork
Claude Cowork, claude_desktop_config.json से सर्वर लोड नहीं करता; वह रिमोट सर्वर तक कस्टम कनेक्टर के रूप में पहुंचता है। Customize → Connectors में https://maguyva.tools/mcp URL के साथ एक कस्टम कनेक्टर जोड़ें, No sign-in चुनें, और एक authorization रिक्वेस्ट हेडर जोड़ें जिसकी वैल्यू Bearer के बाद आपकी API कुंजी हो। रिक्वेस्ट हेडर सीमित संगठनों के लिए बीटा में हैं; अगर डायलॉग में Request headers सेक्शन नहीं है, तो Cowork अभी Maguyva पर ऑथेंटिकेट नहीं कर सकता। दस्तावेज़ देखें →
ChatGPT
ChatGPT, Business, Enterprise, और Edu प्लान पर Settings → Apps → Create के ज़रिए रिमोट MCP सर्वर सपोर्ट करता है। एक रिमोट HTTPS एंडपॉइंट आवश्यक है — ChatGPT लोकल stdio सर्वर सपोर्ट नहीं करता। सेटअप के लिए OpenAI की MCP गाइड देखें। दस्तावेज़ देखें →
Warp
~/.warp/.mcp.json में जोड़ें (या किसी प्रोजेक्ट की .warp/.mcp.json में), या Settings → Agents → MCP servers → + Add में पेस्ट करें:
{
"mcpServers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer mgv_xxxx"
}
}
}
}mgv_xxxx को app.maguyva.ai से मिली अपनी API कुंजी से बदलें।
Maguyva स्टैंडर्ड MCP का उपयोग करता है। प्रोटोकॉल को सपोर्ट करने वाला कोई भी क्लाइंट कनेक्ट हो सकता है — भले ही ऊपर उसके लिए हमारी अपनी गाइड न हो। 23 क्लाइंट के दस्तावेज़ उपलब्ध हैं, और नियमित रूप से नए जोड़े जाते हैं।
अपना सेटअप वेरिफ़ाई करें
#कनेक्ट करने के बाद, अपने एजेंट से कुछ सवाल पूछने की कोशिश करें:
- "मेरे पास कौन सी रिपॉज़िटरी कनेक्ट हैं?" — यह वेरिफ़ाई करता है कि कनेक्शन काम कर रहा है
- "इस कोडबेस में प्रमाणीकरण कैसे संभाला जाता है?" — सिमेंटिक सर्च को टेस्ट करता है
- "वे सभी फ़ंक्शन खोजें जो डेटाबेस को कॉल करते हैं" — डिपेंडेंसी सर्च को टेस्ट करता है
- "UserService क्लास किस पर निर्भर है?" — सिंबल लुकअप को टेस्ट करता है
आपको अपनी कनेक्ट की गई रिपॉज़िटरी से फ़ाइल पथ और लाइन नंबर वाले परिणाम दिखने चाहिए। अगर नहीं, तो नीचे troubleshooting section देखें।
रिपॉज़िटरी फ़ॉर्मैट
#रिपॉज़िटरी बताते समय:
- ब्रांच के साथ:
"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 दस्तावेज़ीकरण
- यह कैसे काम करता है - संदर्भ अनुकूलन को समझें
- समस्या निवारण - सेटअप और कनेक्शन समस्याएं ठीक करें