> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# एमसीपी सर्वर

> SUNRA के MCP सर्वर को कर्सर, वीएस कोड, क्लाइन, विंडसर्फ और अन्य विकास परिवेशों के साथ एकीकृत करना सीखें ताकि एआई मॉडल तक निर्बाध पहुंच हो सके।

# SUNRA MCP सर्वर सेट अप करना

SUNRA मॉडल संदर्भ प्रोटोकॉल (MCP) सर्वर लोकप्रिय विकास परिवेशों के साथ निर्बाध एकीकरण प्रदान करता है, जिससे आप अपने संपादक या IDE से सीधे SUNRA के AI मॉडल तक पहुंच सकते हैं। यह मार्गदर्शिका आपको विभिन्न उपकरणों के साथ MCP सर्वर सेट अप करने के बारे में बताएगी।

## MCP क्या है?

मॉडल संदर्भ प्रोटोकॉल (MCP) AI सहायकों के लिए बाहरी संसाधनों और उपकरणों तक सुरक्षित रूप से पहुंचने का एक मानकीकृत तरीका है। SUNRA MCP सर्वर आपको इसकी अनुमति देता है:

* SUNRA पर उपलब्ध **AI मॉडल की सूची बनाना और खोजना**
* किसी भी मॉडल एंडपॉइंट पर **अनुरोध सबमिट करना**
* कतार प्रणाली से **स्थिति जांचना** और परिणाम प्राप्त करना
* **फ़ाइलें अपलोड करना** और मॉडल स्कीमा प्रबंधित करना
* **API प्रमाणीकरण को निर्बाध रूप से प्रबंधित करना**

## पूर्वापेक्षाएँ

MCP सर्वर सेट अप करने से पहले, सुनिश्चित करें कि आपके पास है:

1. **Node.js** स्थापित (संस्करण 18 या उच्चतर)
2. [आपके डैशबोर्ड](https://sunra.ai/dashboard/api-tokens) से **SUNRA API कुंजी**
3. आपका पसंदीदा संपादक/IDE स्थापित

## स्थापना

SUNRA MCP सर्वर एक npm पैकेज के रूप में उपलब्ध है:

```bash theme={null}
npm install -g @sunra/mcp-server
```

या इसे सीधे npx के साथ उपयोग करें (अनुशंसित):

```bash theme={null}
npx @sunra/mcp-server
```

## संपादक द्वारा विन्यास

### कर्सर

कर्सर अपनी कॉन्फ़िगरेशन फ़ाइल के माध्यम से MCP का समर्थन करता है। अपने प्रोजेक्ट रूट में `.cursor/mcp.json` बनाएं या अपडेट करें:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"]
    }
  }
}
```

आपकी उपयोगकर्ता सेटिंग्स में **वैकल्पिक वैश्विक कॉन्फ़िgeration**:

1. कर्सर सेटिंग्स खोलें
2. "MCP सर्वर" पर नेविगेट करें
3. इसके साथ एक नया सर्वर जोड़ें:
   * **नाम**: `sunra-mcp-server`
   * **आदेश**: `npx`
   * **तर्क**: `@sunra/mcp-server`

### वीएस कोड

MCP समर्थन के साथ वीएस कोड के लिए (संगत एक्सटेंशन की आवश्यकता है):

`.vscode/mcp.json` बनाएं:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "your-api-key-here"
      }
    }
  }
}
```

### क्लाइन

क्लाइन अपनी सेटिंग्स के माध्यम से MCP सर्वर का समर्थन करता है। अपनी क्लाइन कॉन्फ़िगरेशन में जोड़ें:

```json theme={null}
{
  "mcpServers": {
    "sunra": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "description": "SUNRA AI मॉडल एक्सेस"
    }
  }
}
```

### विंडसर्फ

विंडसर्फ आईडीई के लिए, कार्यक्षेत्र सेटिंग्स में MCP को कॉन्फ़िगर करें:

```json theme={null}
{
  "mcp": {
    "servers": {
      "sunra-mcp-server": {
        "command": "npx",
        "args": ["@sunra/mcp-server"],
        "timeout": 30000
      }
    }
  }
}
```

### क्लाउड डेस्कटॉप

अपनी क्लाउड डेस्कटॉप कॉन्फ़िगरेशन फ़ाइल में जोड़ें:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"]
    }
  }
}
```

### अन्य MCP-संगत उपकरण

MCP का समर्थन करने वाले किसी भी अन्य उपकरण के लिए, इस सामान्य कॉन्फ़िगरेशन पैटर्न का उपयोग करें:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "${SUNRA_KEY}"
      }
    }
  }
}
```

## पर्यावरण सेटअप

### अपनी एपीआई कुंजी सेट करना

आप अपनी SUNRA API कुंजी को कई तरीकों से कॉन्फ़िगर कर सकते हैं:

#### विकल्प 1: पर्यावरण चर (अनुशंसित)

```bash theme={null}
export SUNRA_KEY="your-api-key-here"
```

विंडोज के लिए:

```cmd theme={null}
set SUNRA_KEY=your-api-key-here
```

#### विकल्प 2: कॉन्फ़िगरेशन फ़ाइल

कुछ संपादक आपको MCP कॉन्फ़िगरेशन में सीधे पर्यावरण चर सेट करने की अनुमति देते हैं:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "your-api-key-here"
      }
    }
  }
}
```

#### विकल्प 3: रनटाइम कॉन्फ़िगरेशन

MCP सर्वर `set-sunra-key` टूल का उपयोग करके रनटाइम पर API कुंजी सेट करने का भी समर्थन करता है।

## उपलब्ध एमसीपी उपकरण

एक बार कॉन्फ़िगर हो जाने पर, आप अपने AI सहायक के माध्यम से इन उपकरणों तक पहुंच प्राप्त करेंगे:

### मॉडल प्रबंधन

* `list-models` - सभी उपलब्ध AI मॉडल ब्राउज़ करें
* `search-models` - कीवर्ड द्वारा मॉडल खोजें
* `model-schema` - विशिष्ट मॉडलों के लिए इनपुट/आउटपुट स्कीमा प्राप्त करें

### अनुरोध प्रबंधन

* `submit` - मॉडल एंडपॉइंट पर अनुरोध सबमिट करें
* `status` - अनुरोध की स्थिति और लॉग जांचें
* `result` - पूर्ण परिणाम प्राप्त करें
* `cancel` - चल रहे अनुरोधों को रद्द करें
* `subscribe` - सबमिट करें और पूरा होने की प्रतीक्षा करें

### फ़ाइल प्रबंधन

* `upload` - SUNRA स्टोरेज पर फ़ाइलें अपलोड करें

## उपयोग के उदाहरण

### उपलब्ध मॉडल सूचीबद्ध करना

```
उपलब्ध AI मॉडल दिखाने के लिए list-models टूल का उपयोग करें।
```

### एक छवि बनाना

```
black-forest-labs/flux-1.1-pro/text-to-image एंडपॉइंट के साथ एक छवि बनाने के लिए सबमिट टूल का उपयोग करें।
प्रॉम्प्ट का उपयोग करें: "सूर्यास्त के समय एक शांत पहाड़ी परिदृश्य"
```

### अनुरोध की स्थिति की जाँच करना

```
अनुरोध आईडी की स्थिति जांचें: pd_xxxxxx
```

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

### सामान्य मुद्दे

**एमसीपी सर्वर नहीं मिला**

* सुनिश्चित करें कि Node.js स्थापित और सुलभ है
* विश्व स्तर पर स्थापित करने का प्रयास करें: `npm install -g @sunra/mcp-server`
* सत्यापित करें कि कमांड पथ सही है

**प्रमाणीकरण त्रुटियां**

* जांचें कि आपका SUNRA\_KEY पर्यावरण चर सेट है
* [SUNRA डैशबोर्ड](https://sunra.ai/dashboard/api-tokens) पर अपनी API कुंजी की वैधता सत्यापित करें
* `set-sunra-key` टूल का उपयोग करके कुंजी सेट करने का प्रयास करें

**कनेक्शन टाइमआउट**

* अपनी कॉन्फ़िगरेशन में टाइमआउट मान बढ़ाएँ
* अपने इंटरनेट कनेक्शन की जाँच करें
* SUNRA API स्थिति सत्यापित करें

**अनुमति त्रुटियां**

* कॉन्फ़िगरेशन फ़ाइलों के लिए उचित फ़ाइल अनुमतियाँ सुनिश्चित करें
* उपयुक्त उपयोगकर्ता अनुमतियों के साथ चलाने का प्रयास करें

### मदद प्राप्त करना

यदि आपको समस्याएँ आती हैं:

1. [SUNRA दस्तावेज़ीकरण](https://docs.sunra.ai) देखें
2. अपने संपादक के MCP दस्तावेज़ीकरण की समीक्षा करें
3. [गिटहब](https://github.com/sunra-ai/sunra-clients/issues) पर एक मुद्दा उठाएं

## अगले कदम

एक बार जब आपका MCP सर्वर कॉन्फ़िगर हो जाए:

1. **मॉडल एक्सप्लोर करें**: सभी उपलब्ध AI क्षमताओं को देखने के लिए `list-models` का उपयोग करें
2. **उदाहरण आज़माएं**: सरल टेक्स्ट-टू-इमेज या टेक्स्ट-टू-वीडियो पीढ़ी के साथ शुरू करें
3. **वर्कफ़्लो बनाएं**: जटिल AI पाइपलाइनों के लिए कई मॉडलों को मिलाएं
4. **उपयोग की निगरानी करें**: [SUNRA डैशबोर्ड](https://sunra.ai/dashboard/) में अपने API उपयोग को ट्रैक करें

MCP एकीकरण आपके विकास वर्कफ़्लो में शक्तिशाली AI मॉडल को सीधे शामिल करना आसान बनाता है, जिससे आपके अनुप्रयोगों में तेजी से प्रोटोटाइप और निर्बाध AI-संचालित सुविधाएँ सक्षम होती हैं।