कस्टम कनेक्टर

कस्टम कनेक्टर किसी संगठन व्यवस्थापक को एक HTTPS API या, जहाँ सक्षम हो, एक Streamable HTTP MCP सर्वर पंजीकृत करने देता है जो अंतर्निहित कैटलॉग में नहीं है। यह नेटवर्क सीमा और प्रमाणीकरण विधि परिभाषित करता है। यह एजेंट के लिए पूर्ण API संदर्भ स्वतः उत्पन्न नहीं करता।

कौन क्या कॉन्फ़िगर करता है

• संगठन व्यवस्थापक कनेक्टर परिभाषा बनाते, संपादित और हटाते हैं।
• सदस्य अपना सीक्रेट जोड़ते हैं या कनेक्टर का OAuth प्रवाह पूरा करते हैं।
• एजेंट प्राधिकरण नियंत्रित करता है कि कौन से एजेंट जुड़ी क्रेडेंशियल उपयोग कर सकते हैं और उन्हें कौन सी नामित अनुमतियाँ मिलती हैं।

परिभाषा संगठन में साझा होती है। सदस्य क्रेडेंशियल सदस्य और संगठन तक सीमित रहती हैं।

HTTP API कनेक्टर

1. Connectors → Custom खोलें और New connector चुनें।
2. HTTP API चुनें और एक प्रदर्शन नाम दर्ज करें।
3. एक या अधिक HTTPS Prefixes जोड़ें, प्रति पंक्ति एक। कनेक्टर अनुरोध को अधिकृत करने से पहले अनुरोध को कॉन्फ़िगर किए गए उपसर्ग से मेल खाना चाहिए।
4. यदि API को आवश्यकता हो तो प्रमाणीकरण जोड़ें:
   • API authentication: हेडर नाम और {{secret}} युक्त हेडर टेम्पलेट दर्ज करें, जैसे Authorization और Bearer {{secret}}।
   • OAuth 2.0: प्राधिकरण URL, टोकन URL, क्लाइंट ID, क्लाइंट सीक्रेट, स्कोप और टोकन-एंडपॉइंट प्रमाणीकरण विधि दर्ज करें। फ़ॉर्म में दिखाया गया सटीक रीडायरेक्ट URL प्रदाता के पास पंजीकृत करें।
5. कनेक्टर बनाएँ। फिर हर सदस्य जिसे इसकी आवश्यकता है, Connect चुनता है और अपना सीक्रेट देता है या OAuth पूरा करता है।
6. आवश्यक एजेंट और अनुमतियाँ अधिकृत करें।

मौजूदा OAuth परिभाषा या उसकी क्लाइंट क्रेडेंशियल बदलने से वर्तमान OAuth कनेक्शन कट जाते हैं। बदलाव के बाद सदस्यों को फिर जुड़ना होगा।

MCP कनेक्टर

यदि आपके वर्कस्पेस में कनेक्टर प्रकार के रूप में MCP दिखता है, तो एक HTTPS Streamable HTTP MCP एंडपॉइंट दर्ज करें और उसी फ़ॉर्म में API या OAuth प्रमाणीकरण कॉन्फ़िगर करें। यदि चयनकर्ता में MCP नहीं दिया गया है, तो वह उस वर्कस्पेस के लिए सक्षम नहीं है।

एजेंट को API प्रक्रिया सिखाएँ

कस्टम कनेक्टर सुरक्षित नेटवर्क पहुँच और क्रेडेंशियल इंजेक्शन देता है। निर्माण फ़ॉर्म कोई OpenAPI दस्तावेज़ अपलोड या स्वतः-खोज नहीं करता। अनुरोध में एजेंट को एंडपॉइंट, विधि, पैरामीटर और अपेक्षित प्रतिक्रिया दें, या उस प्रक्रिया को फ़ाइल के रूप में संलग्न API संदर्भ के साथ एक वर्कफ़्लो में दर्ज करें।

नए कनेक्टर को किसी ज्ञात एंडपॉइंट पर एक संकीर्ण, केवल-पढ़ने अनुरोध से मान्य करें। कोई सामान्य Test connection अनुरोध नहीं है क्योंकि कई API कोई सार्थक रूट एंडपॉइंट उजागर नहीं करते।

सुरक्षा सीमाएँ

• केवल HTTPS उपसर्ग और MCP एंडपॉइंट स्वीकार किए जाते हैं।
• फ़ायरवॉल सहेजी गई क्रेडेंशियल को केवल मिलते अनुरोधों में इंजेक्ट करता है।
• सहेजा गया सीक्रेट आराम अवस्था में एन्क्रिप्टेड है और एजेंट को पर्यावरण चर के रूप में उजागर नहीं होता।
• कुंजियाँ, टोकन या क्लाइंट सीक्रेट चैट संदेशों, वर्कफ़्लो निर्देशों या संलग्न फ़ाइलों में न रखें।
• वर्कफ़्लो के लिए आवश्यक न्यूनतम अपस्ट्रीम स्कोप वाली सेवा क्रेडेंशियल उपयोग करें।

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

आगे क्या

• दोहराए जाने वाले कस्टम-कनेक्टर कार्य दर्ज करने के लिए Workflows देखें।
• कस्टम-कनेक्टर क्रेडेंशियल कैसे संभाली जाती हैं इसके लिए Permissions देखें।
• खुद बनाने से पहले Catalog देखें — आपकी सेवा शायद पहले से समर्थित हो।