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

# MCP (Model Context Protocol)

> Model Context Protocol का उपयोग करके agents को बाहरी सिस्टम और tools से कनेक्ट करें

Model Context Protocol (MCP) एक खुला मानक है जो आपको अपने डेटा स्रोतों और AI-संचालित tools के बीच सुरक्षित, द्विदिश कनेक्शन बनाने की अनुमति देता है। MCP को एक सार्वभौमिक अनुवादक के रूप में सोचें जो AI Agents को डेटाबेस, फ़ाइल सिस्टम, वेब सेवाओं और APIs जैसे किसी भी बाहरी सिस्टम के साथ निर्बाध रूप से संवाद करने की अनुमति देता है।

## अवलोकन

MCP servers आपके agent की क्षमताओं का विस्तार करते हैं:

* **बाहरी Tool पहुँच** - तृतीय-पक्ष सेवाओं और APIs से कनेक्ट करें
* **डेटा स्रोत एकीकरण** - डेटाबेस, फ़ाइल सिस्टम और क्लाउड स्टोरेज तक पहुँचें
* **कस्टम कार्यक्षमता** - अपने विशिष्ट उपयोग के मामलों के लिए विशिष्ट tools जोड़ें
* **मानकीकृत इंटरफ़ेस** - सभी एकीकरण के लिए एक सुसंगत प्रोटोकॉल का उपयोग करें
* **सुरक्षित प्रमाणीकरण** - OAuth 2.0 और कस्टम headers का समर्थन

## यह कैसे काम करता है

### 1. MCP Server कनेक्शन

जब आप अपने agent में MCP server जोड़ते हैं:

1. **सर्वर पंजीकरण** - सर्वर आपकी agent कॉन्फ़िगरेशन में पंजीकृत होता है
2. **टूल खोज** - Agent MCP server से उपलब्ध tools खोजता है
3. **टूल एकीकरण** - Tools वार्तालापों के दौरान agent के लिए उपलब्ध हो जाते हैं
4. **गतिशील निष्पादन** - Agent आवश्यकता पड़ने पर इन tools को कॉल कर सकता है

### 2. Tool निष्पादन प्रवाह

```
उपयोगकर्ता Query → Agent → MCP Tool Call → MCP Server → बाहरी System → प्रतिक्रिया → Agent → उपयोगकर्ता
```

### 3. एकाधिक Servers

आप प्रति agent कई MCP servers कॉन्फ़िगर कर सकते हैं:

* प्रत्येक सर्वर अपना tool सेट प्रदान करता है
* Tools सर्वर नाम से उपसर्गित होते हैं (जैसे, `sentry_get_errors`)
* Servers को स्वतंत्र रूप से सक्षम या अक्षम किया जा सकता है

## त्वरित आरंभ

### लोकप्रिय MCP Servers जोड़ना

1. साइडबार में **Agents** पर नेविगेट करें
2. एक agent चुनें या बनाएँ
3. Agent Builder खोलने के लिए **Edit** पर क्लिक करें
4. **MCP** टैब पर जाएँ
5. **Quick Add Popular Servers** अनुभाग में, जोड़ने के लिए सर्वर टाइल पर क्लिक करें

### लोकप्रिय Servers

#### Sentry

अपने एप्लिकेशन में त्रुटियों और प्रदर्शन समस्याओं की निगरानी करें।

* **URL**: `https://mcp.sentry.dev/mcp`
* **ट्रांसपोर्ट**: HTTP
* **प्रमाणीकरण**: OAuth 2.0
* **Scopes**: `org:read project:write team:write event:write`

**क्षमताएँ:**

* त्रुटि रिपोर्ट देखें
* प्रदर्शन मेट्रिक्स की निगरानी करें
* प्रोजेक्ट और टीम प्रबंधित करें
* घटनाओं और मुद्दों को ट्रैक करें

## वीडियो ट्यूटोरियल

यह देखने के लिए यह वीडियो देखें कि MCP servers कैसे जोड़ें और कॉन्फ़िगर करें:

## कस्टम MCP Servers जोड़ना

### चरण 1: MCP कॉन्फ़िगरेशन तक पहुँचें

1. साइडबार में **Agents** पर नेविगेट करें
2. एक agent चुनें या बनाएँ
3. Agent Builder खोलने के लिए **Edit** पर क्लिक करें
4. **MCP** टैब पर जाएँ
5. **Advanced Configuration** अनुभाग तक स्क्रॉल करें

### चरण 2: नया सर्वर जोड़ें

1. **Add Server** बटन पर क्लिक करें
2. सर्वर कॉन्फ़िगरेशन फ़ॉर्म दिखाई देगा

### चरण 3: सर्वर सेटिंग्स कॉन्फ़िगर करें

#### सर्वर नाम

अपने MCP server के लिए एक अद्वितीय नाम दर्ज करें (जैसे, `my-custom-server`, `weather-api`, `database-connector`)।

**सर्वोत्तम प्रथाएँ:**

* लोअरकेस अक्षरों और हाइफ़न का उपयोग करें
* वर्णनात्मक लेकिन संक्षिप्त रहें
* विशेष अक्षरों से बचें

#### ट्रांसपोर्ट प्रकार

चुनें कि agent MCP server के साथ कैसे संवाद करेगा:

**HTTP (streamable\_http)**

* मानक HTTP अनुरोध
* REST APIs और वेब सेवाओं के लिए सर्वोत्तम
* Request/response पैटर्न का समर्थन करता है

**SSE (Server-Sent Events)**

* रीयल-टाइम स्ट्रीमिंग संचार
* लाइव डेटा फ़ीड के लिए सर्वोत्तम
* एक-दिशा सर्वर-से-क्लाइंट स्ट्रीमिंग का समर्थन करता है

#### सर्वर URL

अपने MCP server का endpoint URL दर्ज करें:

**HTTP उदाहरण:**

* `https://api.example.com/mcp`
* `http://localhost:8000/mcp/`
* `https://mcp.example.com/v1`

**SSE उदाहरण:**

* `https://api.example.com/sse`
* `https://stream.example.com/events`

### चरण 4: प्रमाणीकरण कॉन्फ़िगर करें

#### कोई प्रमाणीकरण नहीं

यदि आपके MCP server को प्रमाणीकरण की आवश्यकता नहीं है तो **No Authentication** चुनें।

#### OAuth 2.0

OAuth-संरक्षित servers के लिए:

1. प्रमाणीकरण विधि के रूप में **OAuth 2.0** चुनें
2. **OAuth Scopes** दर्ज करें (space-separated)
   * उदाहरण: `read write admin`
   * उदाहरण: `org:read project:write team:write`

**OAuth Flow:**

* जब उपयोगकर्ता agent के साथ इंटरैक्ट करता है, तो उसे प्राधिकरण के लिए कहा जाएगा
* प्राधिकरण स्वचालित रूप से संभाला जाता है
* Tokens सुरक्षित रूप से संग्रहीत होते हैं और आवश्यकता अनुसार रीफ्रेश होते हैं

### चरण 5: कस्टम Headers (वैकल्पिक)

यदि आपके MCP server को कस्टम HTTP headers की आवश्यकता है:

1. **Add Header** पर क्लिक करें
2. Header नाम दर्ज करें (जैसे, `X-API-Key`, `Authorization`)
3. Header मान दर्ज करें
4. आवश्यकतानुसार अतिरिक्त headers जोड़ें

### चरण 6: सर्वर सक्षम/अक्षम करें

सर्वर सक्रिय है या नहीं यह नियंत्रित करने के लिए **Enabled** चेकबॉक्स टॉग करें।

### चरण 7: कनेक्शन परीक्षण करें

1. कनेक्शन सत्यापित करने के लिए **Test** बटन पर क्लिक करें
2. परीक्षण परिणाम की प्रतीक्षा करें:
   * **सफल**: सर्वर पहुँचने योग्य और सही ढंग से कॉन्फ़िगर किया गया
   * **त्रुटि**: अपनी कॉन्फ़िगरेशन और नेटवर्क कनेक्टिविटी जाँचें

### चरण 8: कॉन्फ़िगरेशन सहेजें

1. अपनी MCP server कॉन्फ़िगरेशन सहेजने के लिए **Save** पर क्लिक करें
2. सर्वर अब आपके agent के लिए उपलब्ध है

## MCP Servers प्रबंधित करना

### कॉन्फ़िगर किए गए Servers देखना

**MCP** टैब में, आप देख सकते हैं:

* **सर्वर गणना** - कॉन्फ़िगर किए गए servers की संख्या
* **सर्वर स्थिति** - सक्षम/अक्षम स्थिति
* **सर्वर नाम** - सभी कॉन्फ़िगर किए गए servers की सूची

### सर्वर कॉन्फ़िगरेशन संपादित करना

1. **Advanced Configuration** अनुभाग में सर्वर ढूँढें
2. सर्वर कॉन्फ़िगरेशन विस्तारित करने के लिए क्लिक करें
3. कोई भी सेटिंग्स संशोधित करें
4. परिवर्तनों को सत्यापित करने के लिए **Test** पर क्लिक करें

### Servers हटाना

1. हटाने के लिए सर्वर ढूँढें
2. **Remove** आइकन पर क्लिक करें
3. हटाने की पुष्टि करें

<Warning>
  MCP server को हटाने से उसके tools agent के लिए अनुपलब्ध हो जाएँगे। सुनिश्चित करें कि कोई सक्रिय वार्तालाप इन tools पर निर्भर नहीं है।
</Warning>

## ट्रांसपोर्ट प्रकार

### HTTP (streamable\_http)

**उपयोग करें जब:**

* REST APIs से कनेक्ट हो रहे हों
* मानक request/response पैटर्न
* वेब सेवाएँ और microservices

**कॉन्फ़िगरेशन:**

* URL MCP endpoint की ओर इंगित करना चाहिए
* मानक HTTP methods का समर्थन करता है

```
URL: https://api.example.com/mcp
ट्रांसपोर्ट: HTTP
```

### SSE (Server-Sent Events)

**उपयोग करें जब:**

* रीयल-टाइम डेटा स्ट्रीम
* लाइव अपडेट और सूचनाएँ

```
URL: https://stream.example.com/sse
ट्रांसपोर्ट: SSE
```

## प्रमाणीकरण विधियाँ

### कोई प्रमाणीकरण नहीं

सार्वजनिक APIs, आंतरिक सेवाओं, विकास/परीक्षण servers के लिए उपयोग करें।

### OAuth 2.0

तृतीय-पक्ष सेवाओं, उपयोगकर्ता-विशिष्ट डेटा एक्सेस, scoped अनुमतियों के लिए उपयोग करें।

## उपयोग के मामले

### त्रुटि निगरानी

**Sentry MCP Server**

```json theme={null}
{
  "server_name": "sentry",
  "transport": "streamable_http",
  "url": "https://mcp.sentry.dev/mcp",
  "auth_type": "oauth",
  "oauth_scopes": "org:read project:write team:write event:write"
}
```

### डेटाबेस पहुँच

**कस्टम Database MCP Server**

```json theme={null}
{
  "server_name": "postgres-db",
  "transport": "streamable_http",
  "url": "https://mcp.example.com/database",
  "auth_type": "oauth",
  "headers": {
    "X-Database-Name": "production"
  }
}
```

### फ़ाइल सिस्टम पहुँच

```json theme={null}
{
  "server_name": "filesystem",
  "transport": "streamable_http",
  "url": "https://mcp.example.com/files",
  "auth_type": "oauth"
}
```

### रीयल-टाइम डेटा स्ट्रीम

```json theme={null}
{
  "server_name": "live-data",
  "transport": "sse",
  "url": "https://stream.example.com/sse",
  "auth_type": "oauth"
}
```

## सर्वोत्तम प्रथाएँ

### सर्वर नामकरण

* **वर्णनात्मक रहें**: स्पष्ट, सार्थक नामों का उपयोग करें
* **लोअरकेस का उपयोग करें**: हाइफ़न के साथ लोअरकेस को प्राथमिकता दें
* **विशेष अक्षरों से बचें**: अक्षरों, संख्याओं और हाइफ़न तक सीमित रहें

**अच्छे उदाहरण:** `sentry-monitoring`, `postgres-production`, `weather-api`

**खराब उदाहरण:** `Server1`, `my_mcp_server`, `MCP-Server!!!`

### URL कॉन्फ़िगरेशन

* **HTTPS का उपयोग करें**: हमेशा सुरक्षित कनेक्शन को प्राथमिकता दें
* **पूर्ण Path शामिल करें**: पूरा endpoint URL निर्दिष्ट करें
* **URL का परीक्षण करें**: सहेजने से पहले सत्यापित करें कि URLs पहुँचने योग्य हैं

### प्रमाणीकरण

* **जहाँ संभव हो OAuth का उपयोग करें**: API keys से अधिक सुरक्षित
* **Scopes कम करें**: केवल आवश्यक अनुमतियाँ माँगें
* **परीक्षण प्राधिकरण**: सत्यापित करें कि OAuth flow सही ढंग से काम करता है

### त्रुटि हैंडलिंग

* **कनेक्शन परीक्षण करें**: सहेजने से पहले Test बटन का उपयोग करें
* **लॉग की निगरानी करें**: कनेक्शन त्रुटियों की जाँच करें
* **समस्याग्रस्त servers को अक्षम करें**: यदि आवश्यक हो तो अस्थायी रूप से अक्षम करें

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

### कनेक्शन विफलताएँ

**समस्या**: Test कनेक्शन विफल

**संभावित कारण:** गलत URL, नेटवर्क कनेक्टिविटी समस्याएँ, सर्वर नहीं चल रहा, फ़ायरवॉल ब्लॉकिंग

**समाधान:** URL सत्यापित करें, नेटवर्क कनेक्टिविटी जाँचें, सुनिश्चित करें कि सर्वर चल रहा है, फ़ायरवॉल नियमों की समीक्षा करें

### प्रमाणीकरण त्रुटियाँ

**समस्या**: OAuth प्रमाणीकरण विफल

**संभावित कारण:** गलत OAuth scopes, सर्वर OAuth का समर्थन नहीं करता, उपयोगकर्ता ने प्राधिकृत नहीं किया, Token समाप्त

**समाधान:** OAuth scopes सत्यापित करें, सर्वर OAuth दस्तावेज़ीकरण जाँचें, कनेक्शन को पुन: प्राधिकृत करें

### Tools उपलब्ध नहीं

**समस्या**: MCP server tools दिखाई नहीं देते

**समाधान:** सर्वर सक्षम करें, कनेक्शन का परीक्षण करें, सत्यापित करें कि सर्वर चल रहा है, सर्वर लॉग जाँचें

### Timeout त्रुटियाँ

**समस्या**: अनुरोध timeout हो जाते हैं

**समाधान:** सर्वर प्रदर्शन जाँचें, नेटवर्क गति सत्यापित करें, सर्वर भार कम करें, timeout settings समायोजित करें

## सुरक्षा विचार

### OAuth सुरक्षा

* **Token संग्रहण**: Tokens सुरक्षित रूप से संग्रहीत होते हैं
* **Token रीफ्रेश**: समाप्त होने पर स्वचालित रीफ्रेश
* **Scope सीमांकन**: न्यूनतम आवश्यक scopes माँगें

### कस्टम Headers

* **संवेदनशील डेटा**: यदि संभव हो तो headers में संवेदनशील डेटा न रखें
* **API Keys**: संभव हो तो API keys के बजाय OAuth का उपयोग करें

### नेटवर्क सुरक्षा

* **केवल HTTPS**: प्रोडक्शन servers के लिए हमेशा HTTPS का उपयोग करें
* **Internal URLs**: निजी servers के लिए internal URLs का उपयोग करें
* **VPN पहुँच**: आवश्यकता पर सुरक्षित कनेक्शन के लिए VPN का उपयोग करें

## संबंधित सुविधाएँ

* **Toolkits** - पूर्व-निर्मित एकीकरण और tools
* **Tools** - कस्टम tools और actions
* **Agent कॉन्फ़िगरेशन** - Agent व्यवहार कॉन्फ़िगर करें

<Card title="Toolkits" icon="toolbox" href="/agents/toolkits/overview">
  पूर्व-निर्मित toolkits और एकीकरण के बारे में जानें
</Card>

## सहायता

MCP servers के साथ सहायता चाहिए? [support@automationanywhere.com](mailto:support@automationanywhere.com) पर सहायता से संपर्क करें।
