अध्याय 18: @seameet/mcp CLI को कनेक्ट करना

@seameet/mcp CLI एक हेडलेस Model Context Protocol सर्वर है जो दूसरे टूल (Claude Desktop, IDE, एजेंट) को आपके SeaMeet खाते से पढ़ने और उसमें लिखने देता है। क्योंकि वह हेडलेस है, आप उसे एक डिवाइस-ऑथराइज़ेशन फ़्लो (RFC 8628) से मंज़ूरी देते हैं — CLI आपको एक छोटा कोड दिखाता है, आप एक URL खोलते हैं, कोड की पुष्टि करते हैं, हो गया।

यह अध्याय वेब-ऐप पक्ष कवर करता है: /link पेज, अनुमोदन कार्य, और सुरक्षा कवच।

फ़्लो, शुरू से अंत तक

CLI चलाएँ (जैसे npx @seameet/mcp या उसे बुलाने वाला कोई क्लाइंट)।
CLI एक छोटा कोड और एक URL छापता है — आम तौर पर app.seameet.ai/link और ABCD-EFGH जैसा कोड।
URL अपने ब्राउज़र में खोलें।
/link पेज पर कोड डालें (या CLI क्वेरी स्ट्रिंग से उसे पहले से भर सकता है)।
Approve पर क्लिक करें।
CLI आपकी ओर से एक पढ़ने+लिखने की API कुंजी प्राप्त करता है और अब काम कर सकता है।

बस इतना ही। पूरा फ़्लो आम तौर पर 30 सेकंड से कम में हो जाता है।

"आपकी ओर से" का मतलब

/link से जारी API कुंजी आपके SeaMeet खाते तक सीमित एक असली प्रति-उपयोगकर्ता टोकन है। CLI उससे जो भी करे, वह आपकी लाइब्रेरी में आपके काम के रूप में दिखता है। ठोस रूप से:

पढ़ना — CLI आपकी रिकॉर्डिंग सूचीबद्ध कर सकता है, ट्रांसक्रिप्ट और सारांश ला सकता है, आपके आर्काइव पर Meeting Memory क्वेरी कर सकता है।
लिखना — CLI रिकॉर्डिंग बना सकता है (अपलोड के ज़रिए), शीर्षक और विवरण अपडेट कर सकता है, शेयर बना सकता है, और आम तौर पर वह सब कर सकता है जो आपका सामान्य सेशन कर सकता है।

चूँकि टोकन आपके खाते से बँधा है, अपना सेशन रद्द करने (हर जगह साइन आउट) से CLI का टोकन रद्द नहीं होता — टोकन एक अलग क्रेडेंशियल है। नीचे "CLI अनुमोदन रद्द करना" देखें।

साइन-इन ज़रूरी

/link पेज एक असली साइन-इन, सत्यापित खाते माँगता है। इसका मतलब:

साइन आउट। पेज आपको कोड ले जाने वाले returnTo पैरामीटर के साथ /signin पर रीडायरेक्ट करता है, इसलिए साइन इन के बाद फ़्लो कोड सलामत रखते हुए /link पर दोबारा शुरू होता है।
गुमनाम गेस्ट सेशन। साइन आउट जैसा ही — गेस्ट सेशन CLI को मंज़ूरी नहीं दे सकता, क्योंकि CLI को बँधने के लिए एक असली पहचान चाहिए। आपको सेशन को असली खाते में बदलने के लिए /signin भेजा जाता है।
साइन-इन और सत्यापित। अनुमोदन कार्य चालू है।

यह एक जानबूझकर रखा सुरक्षा कवच है। इसके बिना कोई CLI किसी ऐसे थ्रोअवे गुमनाम सेशन की "ओर से" काम कर सकता जिसे किसी इंसान ने जानबूझकर नहीं खोला।

स्पष्ट क्लिक-करके-मंज़ूरी

/link पेज कभी स्वतः अधिकृत नहीं करता। यहाँ तक कि कोड ?code=<value> से पहले से भरा होने पर भी, आपको स्पष्ट रूप से Approve पर क्लिक करना होता है। यह रक्षात्मक है: लोड पर ऑटो-अप्रूव एक फ़िशिंग मार्ग होता — दुर्भावनापूर्ण पेज आपके ब्राउज़र में /link?code=<आक्रमणकारी-का-कोड> खोलकर आपके ध्यान जाने से पहले आक्रमणकारी के लिए टोकन ढाल सकता था।

Approve पर क्लिक करने से पहले हमेशा जाँचें कि पेज पर दिखा कोड आपके CLI के दिखाए कोड से मेल खाता है। मेल न खाए तो पेज बंद कर दें।

अनुमोदन कार्य

Approve पर क्लिक करें और:

वेब ऐप कोड की SeaMeet के सर्वरों के साथ पुष्टि करता है।
सर्वर जाँचता है कि कोड मान्य है, असमाप्त है, और एक असली (गुमनाम-रहित) खाते से बँधा है।
मान्य होने पर वह एक API कुंजी ढालता है, उसे कोड से जोड़ता है, और सफलता लौटाता है।
CLI, जो टोकन एंडपॉइंट पर पोलिंग कर रहा है, कुंजी प्राप्त करता है और सफलता संदेश छापता है।
वेब ऐप का /link पेज "Approved" दिखाता है — टैब बंद किया जा सकता है।

अगर कोड समाप्त हो गया हो (RFC 8628 कोड अल्पकालिक होते हैं — आम तौर पर 15 मिनट), तो CLI को ताज़ा कोड बनाकर फिर से शुरू करना होगा।

CLI अनुमोदन रद्द करना

दो तरीके:

CLI पक्ष से। CLI के लोकल स्टोरेज में टोकन हटाएँ (या CLI का logout कमांड चलाएँ, अगर उपलब्ध हो)। टोकन सर्वर-साइड तब तक मान्य रहता है जब तक आप वहाँ भी रद्द न करें।
खाता पक्ष से। खाता → Connected apps → आख़िरी-उपयोग टाइमस्टैम्प से CLI अनुमोदन ढूँढें → Revoke। यह टोकन को सर्वर-साइड तुरंत अमान्य कर देता है।

शंकालुओं के लिए: सर्वर-साइड रद्द करें। CLI-पक्ष की हटाई केवल मौजूदा CLI प्रक्रिया को टोकन उपयोग करने से रोकती है; यह टोकन की किसी प्रति को कहीं और उपयोग होने से नहीं रोकती।

कई CLI अनुमोदन

आप CLI को कई बार मंज़ूरी दे सकते हैं (जैसे हर उस मशीन पर एक बार जहाँ उसका उपयोग करते हैं)। हर अनुमोदन एक अलग API कुंजी ढालता है। खाता → Connected apps उन्हें प्रति-कुंजी मेटाडेट (आख़िरी उपयोग, पहली मंज़ूरी) के साथ सूचीबद्ध करता है।

किसी एक CLI अनुमोदन को रद्द करना दूसरों को प्रभावित नहीं करता।

टोकन सुरक्षा

टोकन CLI की लोकल कॉन्फ़िग डायरेक्टरी में सहेजा जाता है, डिफ़ॉल्ट रूप से बिना एन्क्रिप्शन।
अगर आपकी मशीन समझौता कर ली गई हो, तो टोकन समझौता हो गया। सर्वर-साइड रद्द करें और दोबारा मंज़ूरी दें।
टोकन की डिफ़ॉल्ट रूप से कोई समाप्ति नहीं (दीर्घकालिक)। अल्पकालिक टोकन चाहें तो अपनी रोटेशन अनुसूची के अनुसार रद्द करके दोबारा मंज़ूरी दें।
टोकन HTTPS पर भेजे जाते हैं (HSTS-संरक्षित — अध्याय 17 देखें)।

एंटाइटलमेंट का आगे बहाव

CLI आप के रूप में काम करता है — इसलिए उसे आपका एंटाइटलमेंट टियर मिलता है। अगर आप फ्री टियर पर हैं, तो CLI ट्रांसक्रिप्ट पढ़ते समय फ्री टियर की रिवील सीमा के अधीन है। Sync Pro? CLI को पूरा पढ़ना मिलता है।

रिकॉर्डिंग बनाने जैसे लिखने के काम आपके कोटा में उसी तरह गिनते हैं जैसे सामान्य सेशन गिनते हों।

आम समस्याएँ

"कोड समाप्त हो गया।" कोड अल्पकालिक होते हैं (आम तौर पर 15 मिनट)। ताज़ा कोड पाने के लिए CLI पुनरारंभ करें।

"कोड मंज़ूर हुआ लेकिन CLI ने नोटिस नहीं किया।" CLI हर कुछ सेकंड में टोकन एंडपॉइंट पोल करता है। उसे 10-15 सेकंड दें। अब भी कुछ न हो, तो CLI पुनरारंभ करें — उसका पोलिंग लूप क्रैश हो गया होगा।

"मैंने साइन इन किया और कोड खो दिया।" /link पेज कोड को returnTo में रखता है — साइन इन करें और आप कोड सुरक्षित रखते हुए वापस उतरते हैं। किसी तरह खो गया हो तो ताज़ा कोड के लिए CLI पुनरारंभ करें।

"Approve 'not_entitled' त्रुटि लौटाता है।" खाते की एंटाइटलमेंट में CLI अनुमोदन शामिल नहीं — फिलहाल CLI अनुमोदन Sync Pro माँगता है। अपग्रेड करके दोबारा कोशिश करें।

"मैंने मंज़ूरी दी लेकिन मेरा CLI अब भी 'authorization required' कहता है।" CLI की कॉन्फ़िग डायरेक्टरी में सहेजा टोकन जाँचें (पथ CLI वर्शन के अनुसार अलग)। खाली हो तो CLI ने टोकन छोड़ दिया — पुनरारंभ करके दोबारा मंज़ूरी दें।

क्विक रेफ़रेंस

कार्य	कैसे
CLI कोड मंज़ूर करें	`app.seameet.ai/link` → कोड डालें/जाँचें → Approve
CLI टोकन रद्द करें (सर्वर पक्ष)	खाता → Connected apps → Revoke
CLI टोकन रद्द करें (क्लाइंट पक्ष)	CLI का `logout` कमांड, या CLI कॉन्फ़िग फ़ाइल हटाएँ
सभी अनुमोदन देखें	खाता → Connected apps
कई मशीनों पर मंज़ूरी दें	प्रति मशीन एक बार मंज़ूरी — हर बार अलग टोकन ढलता है

अंतिम अद्यतन: 2026-08-28

← अध्याय 17: खाता और सेटिंग्स