सेल्फ़-सर्व साइनअप

अधिकांश एजेंट आपके पहले से मौजूद अकाउंट पर चलते हैं: आप अपना एजेंट सेट अप करते हैं और वह ब्राउज़र से साइन इन करता है। यह गाइड दूसरा रास्ता है, जहाँ कोई एजेंट जिसके पास अकाउंट नहीं है, टर्मिनल से ही खुद एक अकाउंट बनाता है। ईमेल पता सत्यापित करने और ऑर्गनाइज़ेशन, वर्कस्पेस और क्रेडेंशियल बनाने के लिए CLI या curl का उपयोग करें। लोकल stdio MCP को शुरू होने से पहले एक सेव किया हुआ क्रेडेंशियल चाहिए; होस्टेड MCP साइनअप टूल उपलब्ध नहीं कराता। सत्यापन कोड प्राप्त करने के लिए आपको ईमेल इनबॉक्स की पहुँच चाहिए। Bird CLI या MCP सर्वर से किए गए साइनअप उस टूल के नाम पर दर्ज होते हैं जिसने उन्हें बनाया।

CLI का उपयोग करें

नीचे दिए गए CLI कमांड के लिए आपको bird CLI इंस्टॉल करना होगा। साइनअप और सत्यापन रीजन-एग्नॉस्टिक हैं और किसी शुरुआती कॉन्फ़िगरेशन की ज़रूरत नहीं है। अंतिम चरण में, अकाउंट और उसका डेटा कहाँ रहेगा यह चुनने के लिए create-org को --region (us1 या eu1) पास करें। किसी होस्टनेम या एनवायरनमेंट वेरिएबल की ज़रूरत नहीं है।

1. साइन-इन कोड का अनुरोध करें

bird auth signup छह अंकों का साइन-इन कोड ईमेल करता है। उस कोड को सत्यापित करने पर, यदि ईमेल पता नया है तो अकाउंट बन जाता है। यह डैशबोर्ड जैसा ही पासवर्ड-रहित मैजिक-लिंक पथ उपयोग करता है, इसलिए ईमेल किया गया कोड ही पर्याप्त है। अगले चरण के लिए ईमेल पता सँभाल कर रखें।

bird auth signup you@example.com
# { "email": "you@example.com", "status": "code_sent" }

2. ईमेल सत्यापित करें

छह अंकों का कोड ईमेल से आता है, यानी CLI के बाहर से: इसे इनबॉक्स से पढ़ें। उसी ईमेल के साथ कोड bird auth verify-email को पास करें, जो आपको साइन इन कराता है और, बिलकुल नए अकाउंट के लिए, एक बार उपयोग होने वाला onboarding_ticket लौटाता है।

bird auth verify-email you@example.com --code 123456
# { "onboarding_ticket": "...", "user_id": "usr_..." }

3. ऑर्गनाइज़ेशन बनाएँ

bird auth create-org टिकट का उपयोग करके आपका ऑर्गनाइज़ेशन और वर्कस्पेस बनाता है, फिर मिंट किए गए क्रेडेंशियल को सहेजता है ताकि CLI और लोकल stdio MCP सर्वर यहाँ से नए अकाउंट के रूप में प्रमाणित हों। यह एक बार का है: दूसरी कॉल 409 लौटाती है। --region चुनता है कि अकाउंट और उसका डेटा कहाँ रहेगा (us1 या eu1) और कॉल को उस रीजन पर रूट करता है; CLI होस्ट इसी से निकालता है, इसलिए आपको URL सेट करने की ज़रूरत नहीं।

bird auth create-org "Acme" --workspace-name "Production" --region us1 --onboarding-ticket "YOUR_ONBOARDING_TICKET"

क्रेडेंशियल काम कर रहा है, इसकी पुष्टि करें:

bird auth status   # authenticated: true, valid: true

अकाउंट लाइव और प्रमाणित है। एजेंट अब चैनल कॉन्फ़िगर करने और संदेश भेजने के लिए CLI का उपयोग कर सकता है।

चलाने से पहले CLI इनपुट जाँचें

हर चरण स्वयं-वर्णनकारी है और किसी क्रेडेंशियल की ज़रूरत नहीं, इसलिए एजेंट कुछ भी भेजने से पहले पूरी शृंखला की योजना बना सकता है। bird auth --help क्रमबद्ध फ़्लो प्रिंट करता है, --example संपादन-योग्य रिक्वेस्ट बॉडी प्रिंट करता है, और --response-schema हर कमांड द्वारा लौटाए जाने वाले फ़ील्ड प्रिंट करता है।

curl का उपयोग करें

आपको curl और jq चाहिए, लेकिन कोई Bird CLI, MCP कनेक्शन, API कुंजी या ब्राउज़र सेशन नहीं। कमांड एक ही शेल में चलाएँ, और अनुरोध विफल होने पर रुकें। शुरू करने से पहले us1 या eu1 चुनें; ऑर्गनाइज़ेशन बनाने का अनुरोध उसके region से मेल खाते होस्ट पर जाना चाहिए।

umask 077
BIRD_SIGNUP_DIR=$(mktemp -d)
BIRD_REGION=us1
BIRD_BASE_URL="https://${BIRD_REGION}.platform.bird.com"
BIRD_EMAIL=you@example.com

प्राइवेट डायरेक्टरी में सत्यापन प्रतिक्रिया और क्रेडेंशियल होते हैं। इन फ़ाइलों को सोर्स कंट्रोल, चैट ट्रांसक्रिप्ट और साझा लॉग से बाहर रखें।

1. साइन-इन कोड का अनुरोध करें

jq -n --arg email "$BIRD_EMAIL" '{email: $email}' |
  curl --fail-with-body --silent --show-error \
    "$BIRD_BASE_URL/v1/auth/magic-link" \
    -H 'Content-Type: application/json' --data-binary @-

सफल अनुरोध बिना बॉडी के 204 लौटाता है। ईमेल से छह अंकों का कोड पढ़ें; यह 15 मिनट बाद समाप्त हो जाता है। प्रतिक्रिया यह नहीं बताती कि अकाउंट पहले से मौजूद है या नहीं।

2. ईमेल सत्यापित करें

123456 को ईमेल किए गए कोड से बदलें। प्रतिक्रिया को उसका ऑनबोर्डिंग टिकट प्रिंट किए बिना सहेजें:

BIRD_CODE=123456
jq -n --arg email "$BIRD_EMAIL" --arg code "$BIRD_CODE" \
  '{email: $email, code: $code}' |
  curl --fail-with-body --silent --show-error \
    "$BIRD_BASE_URL/v1/auth/magic-link/verify-code" \
    -H 'Content-Type: application/json' --data-binary @- \
    --output "$BIRD_SIGNUP_DIR/verified.json"
jq -e '.onboarding_ticket | type == "string" and length > 0' \
  "$BIRD_SIGNUP_DIR/verified.json" > /dev/null

तभी आगे बढ़ें जब सत्यापन सफल हो और टिकट जाँच सफलतापूर्वक पूरी हो। नया सत्यापित अकाउंट एक बार उपयोग होने वाला onboarding_ticket प्राप्त करता है। ऑर्गनाइज़ेशन वाले मौजूदा अकाउंट को इस साइनअप फ़्लो की ज़रूरत नहीं; यदि सत्यापन के लिए MFA आवश्यक है, तो मौजूदा अकाउंट का साइन-इन फ़्लो पूरा करें।

3. ऑर्गनाइज़ेशन और वर्कस्पेस बनाएँ

अपने ऑर्गनाइज़ेशन और वर्कस्पेस के नाम चुनें, region को BIRD_BASE_URL के अनुरूप रखें। यह अनुरोध टिकट का उपयोग करता है, इसलिए कुकी जार या बियरर टोकन की ज़रूरत नहीं:

jq -n --arg region "$BIRD_REGION" \
  --slurpfile verified "$BIRD_SIGNUP_DIR/verified.json" \
  '{org_name: "Acme", workspace_name: "Production", region: $region,
    onboarding_ticket: $verified[0].onboarding_ticket}' |
  curl --fail-with-body --silent --show-error \
    "$BIRD_BASE_URL/v1/auth/onboarding" \
    -H 'Content-Type: application/json' --data-binary @- \
    --output "$BIRD_SIGNUP_DIR/account.json"

सफल प्रतिक्रिया 201 होती है और इसमें organization, workspace, access_token, token_type, और expires_in होते हैं, साथ ही जारी होने पर एक रिफ़्रेश टोकन भी। एक्सेस टोकन expires_in में दी गई सेकंड की संख्या के बाद समाप्त होता है। प्रतिक्रिया को सुरक्षित रूप से सहेजें। यह एक बार का अकाउंट सेटअप है; जिस अकाउंट में पहले से ऑर्गनाइज़ेशन है वह 409 प्राप्त करता है।

4. प्रमाणित अनुरोध करें

बियरर हेडर को एक प्राइवेट curl कॉन्फ़िगरेशन फ़ाइल में लिखें, फिर क्रेडेंशियल के पीछे की पहचान पढ़ें:

jq -er '.access_token | select(type == "string" and length > 0) |
  "header = \"Authorization: Bearer \(.)\""' \
  "$BIRD_SIGNUP_DIR/account.json" > "$BIRD_SIGNUP_DIR/curl-auth.conf"
curl --fail-with-body --silent --show-error \
  --config "$BIRD_SIGNUP_DIR/curl-auth.conf" "$BIRD_BASE_URL/v1/auth/me"

200 पहचान प्रतिक्रिया पुष्टि करती है कि क्रेडेंशियल काम कर रहा है। बाद के API कॉल के लिए वही बियरर हेडर और रीजनल होस्ट उपयोग करें। Curl क्रेडेंशियल को CLI या किसी MCP क्लाइंट में इंस्टॉल नहीं करता; अस्थायी डायरेक्टरी हटाने से पहले सहेजे गए क्रेडेंशियल अपने ऐप्लिकेशन के सीक्रेट स्टोर में ले जाएँ।

अगले कदम

• एजेंट के लिए CLI वह कमांड कॉन्ट्रैक्ट है जिसे मिंट किया गया क्रेडेंशियल अब अनलॉक करता है।
• MCP सर्वर CLI साइनअप के बाद लोकल stdio MCP कनेक्ट करता है, या OAuth के ज़रिए होस्टेड MCP।
• अपना पहला ईमेल भेजें अकाउंट बनने के बाद का हैप्पी पाथ है।