मुख्य सामग्री पर जाएं

एक अपना MCP-सरवर जोड़ना

अपने MCP-सरवर के साथ आप AI-School को अपनी एप्लिकेशन, डेटा-स्रोत या विशेषीकृत सेवा से जोड़ते हैं। पहले यह चुनें कि उपयोग के स्थान के लिए कौन-सा ट्रांसपोर्ट उपयुक्त है।

सही ट्रांसपोर्ट चुनें​

ट्रांसपोर्टवेबमोबाइलडेस्कटॉपउपयोग
Streamable HTTPहाँहाँहाँहोस्ट किए गए सर्वरों के लिए अनुशंसित
stdioनहींनहींहाँस्थानीय प्रक्रियाएँ और डेस्कटॉप एकीकरण
SSEकेवल मौजूदा कॉन्फ़िगरेशनकेवल मौजूदा कॉन्फ़िगरेशनहाँपुराना ट्रांसपोर्ट; नए सर्वरों के लिए Streamable HTTP चुनें

Streamable HTTP के लिए आवश्यकताएँ​

पूरा सार्वजनिक endpoint इस्तेमाल करें, MCP पथ सहित, उदाहरण के लिए:

https://mcp.example.nl/mcp

endpoint को:

  • HTTPS का उपयोग करना चाहिए;
  • URL में उपयोगकर्ता-नाम या पासवर्ड के बिना काम करना चाहिए;
  • किसी redirect की आवश्यकता नहीं होनी चाहिए;
  • सार्वजनिक DNS के माध्यम से पहुँच योग्य होना चाहिए;
  • एक वैध MCP initialize handshake का उत्तर देना चाहिए;
  • अनुमत tools का एक स्पष्ट सेट होना चाहिए।

स्थानीय पते, निजी नेटवर्क पते और cloud metadata endpoints ब्लॉक कर दिए जाते हैं। इसलिए आप web app से localhost पर एक server पंजीकृत नहीं कर सकते।

सर्वर जोड़ना​

  1. Voorkeuren → Tools खोलें।
  2. Tools toevoegen या MCP-server toevoegen चुनें। यह बटन केवल तभी दिखता है जब आपके पास MCP पहुँच हो।
  3. पहले उपलब्ध presets देखें।
  4. Zelf een MCP-server toevoegen चुनें।
  5. नाम, पूरा endpoint और authentication method भरें।
  6. कॉन्फ़िगरेशन सहेजें और connection check की प्रतीक्षा करें।
  7. अपने default toolset के लिए server चालू करें।

एक administrator Beheer → AI-instellingen → Tools → MCP के माध्यम से पूरे environment के लिए भी server पंजीकृत कर सकता है।

Authentication और secrets​

AI-School connector-OAuth और static secrets का समर्थन करता है। OAuth tokens, refresh tokens, API keys और passwords server-only storage में रहते हैं। एक chat केवल पंजीकृत connectorId प्राप्त करता है, कभी भी secret configuration नहीं।

किसी बदले हुए URL या authentication पर नई configuration को पहले फिर से जाँचा जाता है। अगर वह जाँच असफल होती है, तो एक पहले से स्वीकृत configuration समस्या हल होने तक सक्रिय रह सकती है।

Tool permissions​

केवल वे tools उपलब्ध कराएँ जो उपयोगकर्ताओं को वास्तव में चाहिए। एक MCP-server read- और write-actions दोनों दे सकता है, जैसे files हटाना, email भेजना या records बदलना। AI-School खोजे गए tools को server-side allowlist के विरुद्ध फ़िल्टर करता है, लेकिन server administrator उपयुक्त scopes और authorization के लिए ज़िम्मेदार रहता है।

स्थानीय परीक्षण​

एक स्थानीय stdio-server का परीक्षण आप desktop app में करते हैं। renderer मनमाने shell commands शुरू नहीं कर सकता: installation केवल एक approved preset या secure desktop flow के माध्यम से होती है। command, arguments, environment keys और माँगी गई access को installation से पहले दिखाया जाता है।

समस्याएँ हल करना​

  • Endpoint उपलब्ध नहीं है: HTTPS, DNS, firewall और पूरा /mcp path जाँचें।
  • पुनः कनेक्ट करना आवश्यक है: OAuth अनुमति या सहेजा गया secret ताज़ा करें।
  • किसी अन्य environment से संबंधित है: connector को वर्तमान environment के भीतर फिर से पंजीकृत करें।
  • कोई tools दिखाई नहीं दे रहे: tool allowlist, आपकी MCP पहुँच और server सक्रिय है या नहीं, यह जाँचें।
  • केवल desktop पर काम करता है: संभवतः server stdio या किसी local address का उपयोग कर रहा है।

विकास संसाधन​

यह भी देखें​

संपादन करते समय पंजीकृत server configuration प्राप्त की जाती है। सहेजी गई key छिपी रहती है: इसे बनाए रखने के लिए key field खाली छोड़ें। किसी अलग URL या authentication method के लिए फिर से जोड़ना आवश्यक है। एक MCP tool में हुई त्रुटि का अर्थ यह नहीं है कि उस server के सभी tools अनुपलब्ध हैं।

इस पृष्ठ पर