अपना MCP-सर्वर जोड़ना
अपने MCP-सर्वर के साथ आप AI-School को अपनी खुद की एप्लिकेशन, डेटा स्रोत या विशेषज्ञ सेवा से जोड़ सकते हैं। पहले उस ट्रांसपोर्ट का चयन करें जो उपयोग के स्थान के लिए उपयुक्त हो।
सही ट्रांसपोर्ट चुनें
| ट्रांसपोर्ट | वेब | मोबाइल | डेस्कटॉप | उपयोग |
|---|---|---|---|---|
| Streamable HTTP | हाँ | हाँ | हाँ | होस्ट किए गए सर्वरों के लिए अनुशंसित |
| stdio | नहीं | नहीं | हाँ | स्थानीय प्रक्रियाएं और डेस्कटॉप इंटीग्रेशन |
| SSE | केवल मौजूदा कॉन्फ़िगरेशन | केवल मौजूदा कॉन्फ़िगरेशन | हाँ | पुराना ट्रांसपोर्ट; नए सर्वरों के लिए Streamable HTTP चुनें |
Streamable HTTP के लिए आवश्यकताएँ
पूर्ण सार्वजनिक endpoint का उपयोग करें, जिसमें MCP पथ शामिल हो, उदाहरण के लिए:
https://mcp.example.nl/mcp
Endpoint को निम्नलिखित होना चाहिए:
- HTTPS का उपयोग करना;
- URL में उपयोगकर्ता नाम या पासवर्ड के बिना काम करना;
- कोई रीडायरेक्ट आवश्यक न होना;
- सार्वजनिक DNS के माध्यम से पहुंच योग्य होना;
- एक मान्य MCP
initialize-हैंडशेक का जवाब देना; - स्पष्ट रूप से अनुमत टूल्स का सेट होना।
स्थानीय पते, निजी नेटवर्क पते और क्लाउड मेटाडेटा endpoints अवरुद्ध किए जाते हैं। इसलिए आप वेब ऐप से localhost पर सर्वर को पंजीकृत नहीं कर सकते।
सर्वर जोड़ना
- प्राथमिकताएँ → टूल्स खोलें।
- टूल्स जोड़ें या MCP-सर्वर जोड़ें चुनें।
- उपलब्ध प्रीसेट्स देखें।
- खुद का MCP-सर्वर जोड़ें चुनें।
- नाम, पूर्ण endpoint और प्रमाणीकरण विधि भरें।
- कॉन्फ़िगरेशन सहेजें और कनेक्शन जांच का इंतजार करें।
- अपने डिफ़ॉल्ट टूलसेट के लिए सर्वर चालू करें।
एक व्यवस्थापक प्रबंधन → AI-सेटिंग्स → टूल्स → MCP के माध्यम से पूरे वातावरण के लिए भी सर्वर पंजीकृत कर सकता है।
प्रमाणीकरण और सीक्रेट्स
AI-School कनेक्टर-OAuth और स्थैतिक सीक्रेट्स का समर्थन करता है। OAuth टोकन, रिफ्रेश टोकन, API कुंजी और पासवर्ड केवल सर्वर-संग्रहण में रहते हैं। एक चैट केवल पंजीकृत connectorId प्राप्त करता है, कभी भी गुप्त कॉन्फ़िगरेशन नहीं।
URL या प्रमाणीकरण में बदलाव होने पर नई कॉन्फ़िगरेशन पहले पुनः जांची जाती है। यदि वह जांच विफल होती है, तो पहले से स्वीकृत कॉन्फ़िगरेशन तब तक सक्रिय रह सकती है जब तक समस्या हल न हो जाए।
टूल अधिकार
केवल वे टूल्स सक्षम करें जिनकी उपयोगकर्ताओं को वास्तव में आवश्यकता है। एक MCP-सर्वर पढ़ने और लिखने दोनों क्रियाएं प्रदान कर सकता है, जैसे फ़ाइलें हटाना, ईमेल भेजना या रिकॉर्ड संशोधित करना। AI-School सर्वर-साइड अलाउलिस्ट के खिलाफ खोजे गए टूल्स को फ़िल्टर करता है, लेकिन सर्वर व्यवस्थापक उपयुक्त स्कोप और प्राधिकरण के लिए जिम्मेदार रहता है।
स्थानीय परीक्षण
स्थानीय stdio-सर्वर को आप डेस्कटॉप ऐप में परीक्षण कर सकते हैं। रेंडरर को मनमाने शेल कमांड शुरू करने की अनुमति नहीं है: स्थापना एक स्वीकृत प्रीसेट या सुरक्षित डेस्कटॉप फ्लो के माध्यम से होती है। कमांड, तर्क, पर्यावरण कुंजी और मांगी गई पहुंच स्थापना से पहले दिखाई जाती है।
समस्या निवारण
- Endpoint उपलब्ध नहीं है: HTTPS, DNS, फ़ायरवॉल और पूर्ण
/mcpपथ जांचें। - पुनः कनेक्ट आवश्यक: OAuth अनुमति या संग्रहीत सीक्रेट को नवीनीकृत करें।
- दूसरे वातावरण से संबंधित है: वर्तमान वातावरण में कनेक्टर को पुनः पंजीकृत करें।
- कोई टूल दिखाई नहीं दे रहा: टूल अलाउलिस्ट, आपका MCP एक्सेस और सर्वर सक्रिय है या नहीं जांचें।
- केवल डेस्कटॉप पर काम करता है: संभवतः सर्वर stdio या स्थानीय पते का उपयोग कर रहा है।
