---
title: "Bird पर AI एजेंट क्या कर सकता है: CLI, MCP, टर्मिनल से साइनअप और खर्च पर नियंत्रण"
description: "AI एजेंट Bird पर क्या उपयोग करता है, लिंक सहित: bird CLI, होस्ट किया गया MCP सर्वर, टर्मिनल से खाता साइनअप और उसके खर्च पर लगने वाले नियंत्रण।"
canonical: "https://bird.com/hi-in/blog/what-an-ai-agent-can-do-on-bird"
---

सितंबर में हमने घोषणा की थी कि [Bird का संचार इंफ्रास्ट्रक्चर AI एजेंटों के लिए खुला है](/blog/bird-450-million-financing-agentic-harness)। यह पोस्ट उसी घोषणा का डेवलपर संस्करण है। इसमें बताया गया है कि एजेंट कौन-से कमांड चलाता है, किससे कनेक्ट होता है, उसे खाता कैसे मिलता है और आप उस पर कौन-सी सीमाएँ लगा सकते हैं। हर बात के साथ उसे दस्तावेज़ करने वाला पेज भी दिया गया है।

## CLI

जो एजेंट शेल कमांड चला सकता है, जैसे Claude Code, Cursor का टर्मिनल या कोई CI जॉब, उसे CLI से शुरू करना चाहिए, क्योंकि यह हर ऑपरेशन में MCP की तुलना में बहुत कम टोकन खर्च करता है। आगे बताया गया MCP सर्वर उन होस्ट के लिए है जो टूल कॉल करते हैं पर शेल नहीं चला सकते, और MCP Events के लिए है।

`bird` एक अकेली बाइनरी है, जिसे एजेंट द्वारा चलाए जाने के लिए बनाया गया है। आउटपुट stdout पर JSON के रूप में आता है, त्रुटियाँ stderr पर जाती हैं, और एग्ज़िट कोड विफलता की श्रेणी बताता है। इसलिए एजेंट गद्य पार्स किए बिना परिणाम के आधार पर अगला कदम चुन सकता है।

```bash
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth login
```

एजेंट का ज़्यादातर काम तीन फ़्लैग करते हैं। `--example` एक मान्य अनुरोध बॉडी प्रिंट करता है, `--dry-run` अनुरोध भेजे बिना उसे दिखाता है, और `--idempotency-key` प्रतिक्रिया खो जाने पर फिर से प्रयास करना सुरक्षित बनाता है। [एजेंटों के लिए CLI](/docs/ai/cli-for-agents) इस अनुबंध का वर्णन करता है, और [CLI संदर्भ](/docs/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 की कनेक्टर डायरेक्टरी](https://claude.ai/directory/bird) में सूचीबद्ध है।

सर्वर Bird API को टूल के रूप में उपलब्ध कराता है। इसलिए कनेक्ट किया गया एजेंट Bird द्वारा चलाए जाने वाले चैनलों पर भेज सकता है, उन चैनलों को सेट अप कर सकता है और आपके वर्कस्पेस की जाँच कर सकता है। जिस क्लाइंट पर टूल की संख्या की सीमा है, वह `https://mcp.bird.com/dynamic` से कनेक्ट हो सकता है, जिसमें दो टूल हैं: `search` कोई ऑपरेशन ढूँढता है और `execute` उसे कॉल करता है। [MCP Events](/docs/ai/mcp-events) के साथ क्लाइंट आपके वर्कस्पेस की घटनाओं की सदस्यता लेता है, जैसे आने वाला SMS या किसी मेलबॉक्स में नया मेल। इससे एजेंट को उनके लिए बार-बार जाँच नहीं करनी पड़ती।

[MCP सर्वर](/docs/ai/mcp-server) में हर क्लाइंट के चरण दिए गए हैं। CLI इंस्टॉल होने के बाद `bird mcp` stdio पर एक लोकल सर्वर चलाता है। इसमें साइनअप टूल और लोकल फ़ाइलों से अपलोड की सुविधा जुड़ जाती है, पर यह MCP Events उपलब्ध नहीं कराता।

## टर्मिनल से साइनअप

जिस एजेंट के पास खाता नहीं है, वह टर्मिनल से खाता बना सकता है, बिना ब्राउज़र सत्र और बिना डैशबोर्ड खोले। उसे किसी ईमेल इनबॉक्स तक पहुँच चाहिए, क्योंकि साइन-इन कोड ईमेल से आता है:

```bash
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 कुंजी बनाएँ](/docs/ai/agent-controls#choose-the-credential-the-agent-holds)। [सेल्फ़-सर्व साइनअप](/docs/ai/self-serve-signup) दोनों तरीकों को चरण दर चरण समझाता है।

## एजेंट क्या कर सकता है, इस पर नियंत्रण

Bird के ज़रिए भेजने वाले एजेंट के पास एक क्रेडेंशियल होता है और वह आपका बैलेंस खर्च करता है। [एजेंट नियंत्रण](/docs/ai/agent-controls) एक ही पेज पर बताता है कि उसे क्या सीमित करता है। बिना निगरानी एजेंट चलाने से पहले ये चार नियंत्रण सेट करें। गंतव्य अनुमति-सूची और दैनिक खर्च सीमा SMS पर लागू होती हैं। ईमेल और WhatsApp में इनमें से कोई नहीं है, इसलिए वहाँ कुंजी के स्कोप और वॉलेट ही एजेंट को सीमित करते हैं। यही पेज सुरक्षित तरीके से फिर से प्रयास करना भी समझाता है: `Idempotency-Key` हेडर भेजें, या CLI पर `--idempotency-key` का उपयोग करें, तो दोहराया गया अनुरोध केवल एक बार स्वीकार होता है।

**सीमित स्कोप वाली API कुंजियाँ।** एक API कुंजी एक ही वर्कस्पेस की होती है और उसमें वही स्कोप होते हैं जो आप उसे देते हैं, हर स्कोप एक उत्पाद क्षेत्र होता है जिसका स्तर `read` या `write` होता है। जो कुंजी केवल SMS भेजती है, उसके पास `sms:write` होता है, और उसके स्कोप से बाहर का अनुरोध `403` लौटाता है। कोई कुंजी दूसरी कुंजी जारी नहीं कर सकती, और बिलिंग तक नहीं पहुँच सकती।

```bash
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](/docs/guides/verify/destinations) की अपनी सूची है, जिसमें हर देश शुरू से सक्षम होता है, और [Voice](/docs/guides/voice/destinations) की भी अपनी सेटिंग्स हैं।

**दैनिक खर्च सीमाएँ।** हर SMS गंतव्य देश पर आपके वॉलेट की मुद्रा में दैनिक खर्च सीमा लगाई जा सकती है। जब उस देश पर दिन का खर्च सीमा तक पहुँच जाता है, तो Bird आधी रात UTC तक वहाँ नए संदेश अस्वीकार करता है। यह सीमा सटीक नहीं है: खर्च तब गिना जाता है जब संदेश का शुल्क लगता है, इसलिए पहले से स्वीकार हो चुके संदेश दिन का कुल खर्च सीमा से ऊपर ले जा सकते हैं। SMS से भेजे गए सत्यापन कोड इस सीमा में गिने जाते हैं। यह कमांड ऐसे वर्कस्पेस में, जिसका वॉलेट EUR में है, नीदरलैंड्स को 25 EUR प्रतिदिन की सीमा के साथ सक्षम करता है:

```bash
bird sms destinations update --destination "NL=true;25EUR"
```

अनुमति-सूची या सीमा बदलने के लिए `write` स्तर पर `sms_management` स्कोप चाहिए। भेजने वाले एजेंट को `sms` दें और `sms_management` को उस क्रेडेंशियल के लिए रखें जो वर्कस्पेस कॉन्फ़िगर करता है, तब एजेंट अपनी सीमाएँ खुद नहीं बढ़ा सकता।

**प्रीपेड वॉलेट।** पे-एज़-यू-गो भेजे गए संदेशों का भुगतान आपके संगठन के प्रीपेड वॉलेट से होता है। जिस SMS संदेश का खर्च बैलेंस से पूरा नहीं हो सकता, उसे `402` के साथ अस्वीकार कर दिया जाता है। कुछ शुल्क संदेश स्वीकार होने के बाद लगते हैं (सशुल्क Email प्लान पर ईमेल, और डिलीवरी पर लगने वाले शुल्क), और स्वचालित टॉप-अप सहेजे गए कार्ड से वॉलेट को फिर से भर देता है, इसलिए बैलेंस को पक्की सीमा मानने से पहले [वॉलेट के नियम](/docs/guides/billing-and-usage#the-wallet) पढ़ें। बिलिंग कार्यों के लिए संगठन की बिलिंग अनुमति चाहिए, जो किसी API कुंजी के पास नहीं हो सकती। बिना निगरानी चलने वाले एजेंट को सीमित स्कोप वाली कुंजी दें, ताकि धनराशि जोड़ने का काम बजट के मालिकों के पास ही रहे।

## आगे कहाँ जाएँ

- [एजेंट को उसका अपना फ़ोन नंबर और इनबॉक्स दें](/docs/ai/agent-number-and-inbox): एक `inbox.ai` पता और एक समर्पित नंबर, जो दोनों संदेश भेजते और प्राप्त करते हैं। पहला नंबर लेने से पहले कोई व्यक्ति वॉलेट में धनराशि डालता है और संगठन का कोई मालिक पहचान सत्यापन पूरा करता है। गाइड बताती है कि ऑर्डर के किन चरणों में किसी व्यक्ति की ज़रूरत होती है।
- [यूरोपीय ग्राहकों के लिए Bird](/docs/knowledge-base/compliance/european-customers): वह डच इकाई जिसके साथ आप अनुबंध करते हैं, `eu1` क्षेत्र, और डेटा प्रोसेसिंग समझौता।
- [Bird के साथ Supabase Auth SMS कोड भेजें](/docs/knowledge-base/integrations/supabase): किसी Supabase प्रोजेक्ट के लिए फ़ोन साइन-इन कोड, जो Bird SMS API के माध्यम से भेजे जाते हैं।
- [अपना कोडिंग एजेंट सेट करें](/docs/ai/set-up-your-agent): एक प्रॉम्प्ट पेस्ट करें, और आपका एजेंट CLI और Bird की स्किल्स इंस्टॉल कर देता है।

## Related resources

- [Bird pricing](/pricing) (product)
- [Setting up your coding agent](/learn/basics/setting-up-your-coding-agent) (video)
- [What is an MCP server, and how does an agent use one to send messages?](/explained/platform/what-is-an-mcp-server-and-how-does-an-agent-send-messages) (answer)
- [Build with AI agents](/learn/paths/agents) (course)

[Get an implementation brief](/learn/workspace?topic=billing)
