सितंबर में हमने घोषणा की थी कि Bird का संचार इंफ्रास्ट्रक्चर AI एजेंटों के लिए खुला है। यह पोस्ट उसी घोषणा का डेवलपर संस्करण है। इसमें बताया गया है कि एजेंट कौन-से कमांड चलाता है, किससे कनेक्ट होता है, उसे खाता कैसे मिलता है और आप उस पर कौन-सी सीमाएँ लगा सकते हैं। हर बात के साथ उसे दस्तावेज़ करने वाला पेज भी दिया गया है।
CLI
जो एजेंट शेल कमांड चला सकता है, जैसे Claude Code, Cursor का टर्मिनल या कोई CI जॉब, उसे CLI से शुरू करना चाहिए, क्योंकि यह हर ऑपरेशन में MCP की तुलना में बहुत कम टोकन खर्च करता है। आगे बताया गया MCP सर्वर उन होस्ट के लिए है जो टूल कॉल करते हैं पर शेल नहीं चला सकते, और MCP Events के लिए है।
bird एक अकेली बाइनरी है, जिसे एजेंट द्वारा चलाए जाने के लिए बनाया गया है। आउटपुट stdout पर JSON के रूप में आता है, त्रुटियाँ stderr पर जाती हैं, और एग्ज़िट कोड विफलता की श्रेणी बताता है। इसलिए एजेंट गद्य पार्स किए बिना परिणाम के आधार पर अगला कदम चुन सकता है।
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth login
एजेंट का ज़्यादातर काम तीन फ़्लैग करते हैं। --example एक मान्य अनुरोध बॉडी प्रिंट करता है, --dry-run अनुरोध भेजे बिना उसे दिखाता है, और --idempotency-key प्रतिक्रिया खो जाने पर फिर से प्रयास करना सुरक्षित बनाता है। एजेंटों के लिए CLI इस अनुबंध का वर्णन करता है, और CLI संदर्भ में हर कमांड की सूची है।
होस्ट किया गया MCP सर्वर
कुछ होस्ट टूल कॉल करते हैं पर शेल नहीं चला सकते, जैसे Claude Desktop, ChatGPT या कोई मोबाइल ऐप। उनके लिए Bird MCP सर्वर https://mcp.bird.com पर चलता है। यह URL किसी MCP क्लाइंट को दें और अपने ब्राउज़र से साइन इन करें। इसके बाद क्लाइंट के पास एक टोकन होता है जो आपकी ओर से काम करता है। सहमति स्क्रीन पर वे अनुमतियाँ दिखती हैं जो क्लाइंट माँगता है, और जिनकी एजेंट को ज़रूरत नहीं है, उन्हें आप हटा सकते हैं। आपको कुछ इंस्टॉल नहीं करना पड़ता और कोई API कुंजी कॉपी नहीं करनी पड़ती। समर्थित क्लाइंट में Claude Code, Cursor, VS Code, Codex, Claude, ChatGPT और Muse शामिल हैं, और Bird Claude की कनेक्टर डायरेक्टरी में सूचीबद्ध है।
सर्वर Bird API को टूल के रूप में उपलब्ध कराता है। इसलिए कनेक्ट किया गया एजेंट Bird द्वारा चलाए जाने वाले चैनलों पर भेज सकता है, उन चैनलों को सेट अप कर सकता है और आपके वर्कस्पेस की जाँच कर सकता है। जिस क्लाइंट पर टूल की संख्या की सीमा है, वह https://mcp.bird.com/dynamic से कनेक्ट हो सकता है, जिसमें दो टूल हैं: search कोई ऑपरेशन ढूँढता है और execute उसे कॉल करता है। MCP Events के साथ क्लाइंट आपके वर्कस्पेस की घटनाओं की सदस्यता लेता है, जैसे आने वाला SMS या किसी मेलबॉक्स में नया मेल। इससे एजेंट को उनके लिए बार-बार जाँच नहीं करनी पड़ती।
MCP सर्वर में हर क्लाइंट के चरण दिए गए हैं। CLI इंस्टॉल होने के बाद bird mcp stdio पर एक लोकल सर्वर चलाता है। इसमें साइनअप टूल और लोकल फ़ाइलों से अपलोड की सुविधा जुड़ जाती है, पर यह MCP Events उपलब्ध नहीं कराता।
टर्मिनल से साइनअप
जिस एजेंट के पास खाता नहीं है, वह टर्मिनल से खाता बना सकता है, बिना ब्राउज़र सत्र और बिना डैशबोर्ड खोले। उसे किसी ईमेल इनबॉक्स तक पहुँच चाहिए, क्योंकि साइन-इन कोड ईमेल से आता है:
bird auth signup you@example.com
bird auth verify-email you@example.com --code 123456
bird auth create-org "Acme" --workspace-name "Production" --region eu1 --onboarding-ticket "YOUR_ONBOARDING_TICKET"
bird auth create-org संगठन और उसका वर्कस्पेस बनाता है, और एक क्रेडेंशियल सहेजता है जिसे CLI और स्थानीय MCP सर्वर इसके बाद इस्तेमाल करते हैं। --region तय करता है कि खाता और उसका डेटा कहाँ रहेगा, us1 या eu1। जिस एजेंट के पास CLI नहीं है, उसके लिए यही तीन चरण curl से भी काम करते हैं। होस्ट किया गया MCP सर्वर साइनअप की सुविधा नहीं देता, क्योंकि वहाँ कनेक्ट होने से पहले क्लाइंट के पास क्रेडेंशियल होना ज़रूरी है।
यह पहला क्रेडेंशियल व्यापक होता है। इसमें वे सभी अनुमतियाँ होती हैं जो नए संगठन का मालिक सौंप सकता है, संगठन की बिलिंग समेत, और साइनअप इसे सीमित करने के लिए कोई सहमति स्क्रीन नहीं दिखाता। किसी एजेंट को बिना निगरानी चलाने से पहले उसके लिए सीमित स्कोप वाली API कुंजी बनाएँ। सेल्फ़-सर्व साइनअप दोनों तरीकों को चरण दर चरण समझाता है।
एजेंट क्या कर सकता है, इस पर नियंत्रण
Bird के ज़रिए भेजने वाले एजेंट के पास एक क्रेडेंशियल होता है और वह आपका बैलेंस खर्च करता है। एजेंट नियंत्रण एक ही पेज पर बताता है कि उसे क्या सीमित करता है। बिना निगरानी एजेंट चलाने से पहले ये चार नियंत्रण सेट करें। गंतव्य अनुमति-सूची और दैनिक खर्च सीमा SMS पर लागू होती हैं। ईमेल और WhatsApp में इनमें से कोई नहीं है, इसलिए वहाँ कुंजी के स्कोप और वॉलेट ही एजेंट को सीमित करते हैं। यही पेज सुरक्षित तरीके से फिर से प्रयास करना भी समझाता है: Idempotency-Key हेडर भेजें, या CLI पर --idempotency-key का उपयोग करें, तो दोहराया गया अनुरोध केवल एक बार स्वीकार होता है।
सीमित स्कोप वाली API कुंजियाँ। एक API कुंजी एक ही वर्कस्पेस की होती है और उसमें वही स्कोप होते हैं जो आप उसे देते हैं, हर स्कोप एक उत्पाद क्षेत्र होता है जिसका स्तर read या write होता है। जो कुंजी केवल SMS भेजती है, उसके पास sms:write होता है, और उसके स्कोप से बाहर का अनुरोध 403 लौटाता है। कोई कुंजी दूसरी कुंजी जारी नहीं कर सकती, और बिलिंग तक नहीं पहुँच सकती।
bird auth login --scope api_keys:write --scope sms:write # an existing account
bird api-keys create --name "Support agent" --scope sms:write
साइन-इन के पास api_keys:write और वे स्कोप होने चाहिए जो कुंजी में होंगे। टर्मिनल साइनअप से मिले क्रेडेंशियल में ये पहले से होते हैं, इसलिए bird auth create-org के बाद आप सिर्फ़ दूसरा कमांड चलाएँ। वहाँ दोबारा साइन इन न करें: नया साइन-इन साइनअप क्रेडेंशियल की जगह ले लेता है। इसे ऐसे शेल में चलाएँ जहाँ BIRD_API_KEY सेट न हो, क्योंकि CLI साइन-इन के बजाय उस कुंजी को प्राथमिकता देता है, और कुंजी दूसरी कुंजियाँ जारी नहीं कर सकती।
फिर एजेंट को केवल वह कुंजी दें, उससे अधिक कुछ नहीं। एजेंट के एनवायरनमेंट में BIRD_API_KEY सेट करें, या अपने कोड से कुंजी को बेयरर टोकन के रूप में भेजें। साइन-इन उसी मशीन पर सहेजा रहता है जहाँ वह किया गया था, और वहाँ BIRD_API_KEY के बिना चलने वाला एजेंट उसी का उपयोग करता है। एजेंट को किसी दूसरी जगह चलाएँ, या bird auth logout से साइन-इन हटा दें।
डिफ़ॉल्ट रूप से अवरुद्ध SMS गंतव्य। एक वर्कस्पेस केवल अपनी गंतव्य अनुमति-सूची के देशों में SMS भेजता है। अनुमति-सूची खाली से शुरू होती है, और संगठन का गृह देश सेट होने पर Bird उसे जोड़ देता है। SMS API के ज़रिए किसी अन्य देश में भेजा गया संदेश प्रेषक तय होने से पहले ही 422 SMSDestinationNotEnabled के साथ अस्वीकार हो जाता है, इसलिए किसी अनपेक्षित देश की ओर भेजने वाले एजेंट को मना कर दिया जाता है। सत्यापन कोड इस सूची का उपयोग नहीं करते। Verify की अपनी सूची है, जिसमें हर देश शुरू से सक्षम होता है, और Voice की भी अपनी सेटिंग्स हैं।
दैनिक खर्च सीमाएँ। हर SMS गंतव्य देश पर आपके वॉलेट की मुद्रा में दैनिक खर्च सीमा लगाई जा सकती है। जब उस देश पर दिन का खर्च सीमा तक पहुँच जाता है, तो Bird आधी रात UTC तक वहाँ नए संदेश अस्वीकार करता है। यह सीमा सटीक नहीं है: खर्च तब गिना जाता है जब संदेश का शुल्क लगता है, इसलिए पहले से स्वीकार हो चुके संदेश दिन का कुल खर्च सीमा से ऊपर ले जा सकते हैं। SMS से भेजे गए सत्यापन कोड इस सीमा में गिने जाते हैं। यह कमांड ऐसे वर्कस्पेस में, जिसका वॉलेट EUR में है, नीदरलैंड्स को 25 EUR प्रतिदिन की सीमा के साथ सक्षम करता है:
bird sms destinations update --destination "NL=true;25EUR"
अनुमति-सूची या सीमा बदलने के लिए write स्तर पर sms_management स्कोप चाहिए। भेजने वाले एजेंट को sms दें और sms_management को उस क्रेडेंशियल के लिए रखें जो वर्कस्पेस कॉन्फ़िगर करता है, तब एजेंट अपनी सीमाएँ खुद नहीं बढ़ा सकता।
प्रीपेड वॉलेट। पे-एज़-यू-गो भेजे गए संदेशों का भुगतान आपके संगठन के प्रीपेड वॉलेट से होता है। जिस SMS संदेश का खर्च बैलेंस से पूरा नहीं हो सकता, उसे 402 के साथ अस्वीकार कर दिया जाता है। कुछ शुल्क संदेश स्वीकार होने के बाद लगते हैं (सशुल्क Email प्लान पर ईमेल, और डिलीवरी पर लगने वाले शुल्क), और स्वचालित टॉप-अप सहेजे गए कार्ड से वॉलेट को फिर से भर देता है, इसलिए बैलेंस को पक्की सीमा मानने से पहले वॉलेट के नियम पढ़ें। बिलिंग कार्यों के लिए संगठन की बिलिंग अनुमति चाहिए, जो किसी API कुंजी के पास नहीं हो सकती। बिना निगरानी चलने वाले एजेंट को सीमित स्कोप वाली कुंजी दें, ताकि धनराशि जोड़ने का काम बजट के मालिकों के पास ही रहे।
आगे कहाँ जाएँ
- एजेंट को उसका अपना फ़ोन नंबर और इनबॉक्स दें: एक
inbox.aiपता और एक समर्पित नंबर, जो दोनों संदेश भेजते और प्राप्त करते हैं। पहला नंबर लेने से पहले कोई व्यक्ति वॉलेट में धनराशि डालता है और संगठन का कोई मालिक पहचान सत्यापन पूरा करता है। गाइड बताती है कि ऑर्डर के किन चरणों में किसी व्यक्ति की ज़रूरत होती है। - यूरोपीय ग्राहकों के लिए Bird: वह डच इकाई जिसके साथ आप अनुबंध करते हैं,
eu1क्षेत्र, और डेटा प्रोसेसिंग समझौता। - Bird के साथ Supabase Auth SMS कोड भेजें: किसी Supabase प्रोजेक्ट के लिए फ़ोन साइन-इन कोड, जो Bird SMS API के माध्यम से भेजे जाते हैं।
- अपना कोडिंग एजेंट सेट करें: एक प्रॉम्प्ट पेस्ट करें, और आपका एजेंट CLI और Bird की स्किल्स इंस्टॉल कर देता है।