डिलीवरी सूचना भेजने वाले असिस्टेंट को प्रेषक, प्राप्तकर्ता और संदेश की सामग्री चाहिए। कनेक्ट किया गया टूल उसे ये फ़ील्ड बातचीत में आपका क्रेडेंशियल डाले बिना सबमिट करने देता है।
MCP वह प्रोटोकॉल है जो एप्लिकेशन को इन टूल से जोड़ता है।
MCP सर्वर क्या प्रदान करता है?
सर्वर आपके AI क्लाइंट को टूल के नाम, इनपुट स्कीमा और कॉल किए जा सकने वाले ऑपरेशन देता है।
MCP टूल मॉडल में क्लाइंट टूल खोजता है। जब एजेंट कोई टूल चुनता है, तो क्लाइंट संरचित आर्ग्युमेंट भेजता है।
Bird के टूल में ईमेल, SMS और WhatsApp संदेश भेजना शामिल है। सेटअप टूल भेजने वाले डोमेन, नंबर और प्रेषक की आवश्यकताओं का प्रबंधन करते हैं। सत्यापन टूल सत्यापन शुरू करते हैं। वे कोड की जाँच भी करते हैं। एक अलग टूल दूसरे चैनल पर आगे बढ़ता है।
आपके क्लाइंट में उपलब्ध टूल की सूची हर ऑपरेशन और उसके आवश्यक इनपुट बताती है। अगर कोई अपेक्षित ऑपरेशन नहीं दिखता, तो यह सूची जाँचें।
मैं होस्टेड सर्वर से कैसे कनेक्ट करूँ?
https://mcp.bird.com को रिमोट MCP सर्वर के रूप में जोड़ें। फिर ब्राउज़र से साइन इन करें।
आपको CLI इंस्टॉल करने या API कुंजी देने की ज़रूरत नहीं है। ब्राउज़र साइन-इन से क्लाइंट को एक टोकन मिलता है, जिसमें आपकी अनुमतियों का एक हिस्सा होता है। Bird हर अनुरोध को उस टोकन की अनुमतियों से जाँचता है।
कुछ क्लाइंट तब तक सर्वर को प्रमाणीकरण की ज़रूरत वाला दिखाते हैं, जब तक आप साइन-इन शुरू नहीं करते। केवल URL वाला क्लाइंट टूल की सूची देख सकता है। प्रमाणीकरण के बिना टूल कॉल 401 लौटा सकता है।
टूल कॉल का परीक्षण करने से पहले प्रमाणीकरण पूरा करें। कनेक्शन गाइड में समर्थित क्लाइंट के लिए सेटअप के चरण दिए गए हैं।
एजेंट संदेश कैसे भेजता है और उसकी जाँच कैसे करता है?
पुष्टि करें कि प्राप्तकर्ता ने इस संदेश के लिए सहमति दी है और सामग्री आप पर लागू नीति को पूरा करती है। चैनल के भेजने वाले टूल को कॉल करें। फिर बने हुए संदेश के डिलीवरी इवेंट पढ़ें।
ईमेल के लिए क्रम यह है:
- वर्कस्पेस, भेजने वाली पहचान, प्राप्तकर्ता और सामग्री की पुष्टि करें।
email_sendको उसके इनपुट स्कीमा के आवश्यक फ़ील्ड के साथ कॉल करें।- लौटाई गई संदेश ID सहेजें।
- डिलीवरी स्थिति, प्राप्तकर्ता परिणाम और इवेंट टाइमलाइन देखने के लिए
email_getका उपयोग करें।
भेजने का अनुरोध स्वीकार होने से यह साबित नहीं होता कि संदेश पहुँच गया। बाद में बाउंस या अस्वीकृति होने पर आपके एजेंट या एप्लिकेशन को उस विफलता को संभालना होगा।
सेंडर या अनुमति न होने पर संदेश नहीं भेजा जा सकता। सेटअप और डायग्नोस्टिक टूल से एजेंट फिर से प्रयास करने से पहले इन आवश्यकताओं की जाँच कर सकता है।
क्या मैं सर्वर को लोकल रूप से चला सकता हूँ?
हाँ। Bird CLI इंस्टॉल करें। bird auth login से साइन इन करें। अपने क्लाइंट को bird mcp लॉन्च करने के लिए कॉन्फ़िगर करें।
क्लाइंट प्रोसेस शुरू करता है। वह प्रोसेस की इनपुट और आउटपुट स्ट्रीम के ज़रिए संवाद करता है। इसके लिए कमांड के रूप में bird और आर्गुमेंट के रूप में mcp चाहिए।
लोकल और होस्टेड सर्वर एक जैसे टूल उपलब्ध कराते हैं। प्रोसेस लोकल रूप से चलाने पर भी Bird API ऑपरेशन के लिए नेटवर्क एक्सेस चाहिए।
अगर आप प्रोसेस को खुद मैनेज करना चाहते हैं, तो लोकल प्रोसेस का उपयोग करें। इसके लिए आपके क्लाइंट को कमांड लॉन्च करने में सक्षम होना चाहिए। अगर आपका क्लाइंट लोकल बाइनरी नहीं चला सकता, तो होस्टेड URL का उपयोग करें।
एजेंट कौन-सी कार्रवाइयाँ कर सकता है, इसे क्या नियंत्रित करता है?
कनेक्ट किया गया क्रेडेंशियल एक्सेस को सीमित करता है। टूल चलाने से पहले कब पुष्टि चाहिए, यह आपका AI होस्ट तय करता है।
Bird विनाशकारी टूल पर एनोटेशन लगाता है, ताकि होस्ट उन्हें पहचान सके। उदाहरण के लिए, ईमेल सप्रेशन हटाने को विनाशकारी चिह्नित किया जाता है, क्योंकि इससे अनचाहे संदेश फिर से भेजे जा सकते हैं।
एनोटेशन अपने आप मंज़ूरी का प्रॉम्प्ट लागू नहीं करते। प्रोडक्शन संसाधनों में बदलाव की अनुमति देने से पहले अपने होस्ट की नीति कॉन्फ़िगर करें।
जो एजेंट ईमेल टेम्पलेट का ड्राफ़्ट बनाकर उसे सबमिट कर सकता है, वह उसे प्रकाशित भी कर सकता है। केवल ड्राफ़्ट वाला चरण एजेंट को सबमिट टूल कॉल करने से नहीं रोकता।
WhatsApp टेम्पलेट सबमिट करने पर टेम्पलेट Meta के पास समीक्षा के लिए भेजा जाता है। यह एजेंट की बाकी हर कार्रवाई के लिए मानवीय मंज़ूरी का चरण नहीं देता।
वॉइस टूल कॉल की जाँच करते हैं। वे क्लाइंट क्रेडेंशियल भी जारी करते हैं। कोई भी MCP टूल वॉइस कॉल नहीं करता। टेस्ट कॉल की सुविधा CLI देता है।
शेल चला सकने वाले एजेंटों के लिए CLI JSON आउटपुट और एग्ज़िट कोड देता है। वह इंटरफ़ेस चुनें जिसे आपका होस्ट चला सके। जिन कार्रवाइयों का इरादा है, उनके लिए उसकी पुष्टि नीति सेट करें।
संक्षेप में
कनेक्ट करें और साइन इन करें।
होस्ट किए गए सर्वर के लिए उसका URL और ब्राउज़र में अधिकृति, दोनों ज़रूरी हैं। सिर्फ़ URL जोड़ने से टूल कॉल अधिकृत नहीं होते।
होस्ट किया गया या लोकल एक्सेस चुनें।
रिमोट क्लाइंट के लिए https://mcp.bird.com का उपयोग करें, या CLI से साइन इन करने के बाद अपने क्लाइंट को bird mcp लॉन्च करने दें।
भेजने के बाद संदेश को ट्रैक करें।
send का परिणाम केवल यह पुष्टि करता है कि संदेश स्वीकार हुआ। डिलीवरी जानने के लिए संदेश और उसके इवेंट पढ़ें।
होस्ट की पुष्टि नीति कॉन्फ़िगर करें।
टूल एनोटेशन कार्रवाइयों का वर्णन करते हैं, पर अनुमोदन लागू नहीं करते। उन्हें चलाने से पहले कब पूछना है, यह आपका होस्ट तय करता है।