MCP के ज़रिए एक AI एजेंट (Claude) कनेक्ट करें
Claude जैसे किसी AI एजेंट को नेटिव MCP सर्वर के ज़रिए अपने CRM से कनेक्ट करें। एजेंट आपकी API key का उपयोग करते हुए सुरक्षित रूप से रिकॉर्ड्स (लीड्स, कॉन्टैक्ट्स, अवसर) पढ़ता और बनाता है।
MCP (Model Context Protocol) वह स्टैंडर्ड है जो किसी AI एजेंट को बाहरी सिस्टम्स से बात करने देता है। Sellio एक नेटिव MCP सर्वर के साथ आता है: एजेंट (उदाहरण के लिए Claude, जो Claude Desktop या किसी भी MCP क्लाइंट में चल रहा हो) को सर्वर URL पर पॉइंट करें और वह आपके CRM में रिकॉर्ड्स क्वेरी और बना सकता है। यह ऐसे प्रॉस्पेक्टिंग एजेंट के लिए आदर्श है जो लीड्स और कॉन्टैक्ट्स अपने-आप बनाता है। सब कुछ API key के टेनेंट के संदर्भ में चलता है और CRM के वैलिडेशन्स व अनुमतियों (RBAC) का पालन करता है।
पूर्वापेक्षाएं
- एक MCP क्लाइंट (Claude Desktop, या कोई भी ऐप/एजेंट जो HTTP पर MCP बोलता हो)।
- Sellio में, Settings → API & developers के तहत API key जनरेट करने के लिए एडमिनिस्ट्रेटर एक्सेस।
1) एक API key जनरेट करें
- Settings → API & developers खोलें (साइडबार शॉर्टकट से भी पहुंचा जा सकता है)।
- एक नई API key बनाएं और वैल्यू कॉपी करें (यह sk_ से शुरू होती है और केवल एक बार दिखाई जाती है, इसलिए इसे पासवर्ड की तरह मानें)।
- वही key REST API और MCP दोनों के लिए काम करती है।
2) एजेंट को MCP सर्वर पर पॉइंट करें
MCP सर्वर URL है https://YOUR-CRM/api/mcp और ऑथेंटिकेशन REST जैसा ही है: Authorization: Bearer sk_... header।
Claude Desktop में (और mcp-remote ब्रिज उपयोग करने वाले क्लाइंट्स में), इसे अपनी MCP servers config फाइल में जोड़ें:
Example: { "mcpServers": { "sellio-crm": { "command": "npx", "args": ["-y", "mcp-remote", "https://YOUR-CRM/api/mcp", "--header", "Authorization: Bearer sk_live_..."] } } }
💡 जो क्लाइंट्स पहले से ही remote HTTP MCP सर्वर्स को सीधे सपोर्ट करते हैं, वे mcp-remote ब्रिज के बिना ऊपर दिए URL को Authorization: Bearer header के साथ उपयोग कर सकते हैं।
3) एजेंट को मिलने वाले टूल्स
- list_objects: उपलब्ध ऑब्जेक्ट खोजता है (leads, संपर्क, कंपनियां, opportunities और कस्टम ऑब्जेक्ट)।
- describe_object: किसी ऑब्जेक्ट के फ़ील्ड पता लगाता है: apiName, लेबल, प्रकार, क्या यह आवश्यक है, select द्वारा स्वीकार किए गए विकल्प, और lookup का लक्ष्य ऑब्जेक्ट। बनाने या अपडेट करने से पहले इसे कॉल करें।
- list_records: किसी ऑब्जेक्ट के रिकॉर्ड सूचीबद्ध और खोजता है (खोज, फ़ील्ड फ़िल्टर, क्रम, पेजिनेशन)।
- get_record: id से एक रिकॉर्ड लाता है।
- create_record: एक रिकॉर्ड बनाता है (उदाहरण के लिए एक नया प्रॉस्पेक्टिंग लीड)।
- update_record: किसी मौजूदा रिकॉर्ड के फ़ील्ड अपडेट करता है।
- delete_record: किसी रिकॉर्ड को ट्रैश में ले जाता है (पूर्ववत करने योग्य)। यह तभी काम करता है जब API कुंजी में delete scope सक्षम हो, जो डिफ़ॉल्ट रूप से बंद रहता है।
- bulk_create_records: एक ही कॉल में 500 तक रिकॉर्ड बनाता है, हर आइटम के लिए सफलता या विफलता रिपोर्ट करते हुए।
- bulk_update_records: एक ही कॉल में id के आधार पर 500 तक रिकॉर्ड अपडेट करता है, हर आइटम के लिए सफलता या विफलता रिपोर्ट करते हुए।
- export_records: किसी ऑब्जेक्ट के रिकॉर्ड को स्थिर कॉलम वाली सपाट तालिका पंक्तियों के रूप में लौटाता है, वृद्धिशील सिंक के लिए updated_since और created_since के साथ। BI और automation टूल के लिए बनाया गया।
- list_activities: किसी रिकॉर्ड की गतिविधियां (उसकी timeline) या वर्कस्पेस की सबसे हाल की गतिविधियां सूचीबद्ध करता है।
- create_activity: करने के लिए एक कार्य दर्ज करता है, या पहले से हो चुकी कॉल, ईमेल, मीटिंग या नोट दर्ज करता है।
- update_activity: किसी गतिविधि को पूरा करता है, फिर से खोलता है, फिर से शेड्यूल करता है, फिर से सौंपता है, या उसका परिणाम दर्ज करता है।
- delete_activity: किसी गतिविधि को हटाता है। इसके लिए delete scope आवश्यक है।
- list_attachments: किसी रिकॉर्ड से जुड़ी फ़ाइलें सूचीबद्ध करता है।
- get_attachment: किसी अटैचमेंट का मेटाडेटा और एक साइन किया गया डाउनलोड लिंक लौटाता है जो 5 मिनट में समाप्त हो जाता है।
- create_attachment_upload_url: अपलोड का चरण 1: एक साइन की गई URL लौटाता है जहां फ़ाइल के बाइट्स PUT के साथ भेजे जाते हैं (अधिकतम 25 MB)।
- register_attachment: अपलोड का चरण 2: अपलोड की गई फ़ाइल को रिकॉर्ड पर पंजीकृत करता है ताकि वह timeline में दिखाई दे।
- delete_attachment: किसी अटैचमेंट और उसकी फ़ाइल को हटाता है। यह अपरिवर्तनीय है, इसलिए इसके लिए delete scope आवश्यक है।
- list_inventory: प्रति उत्पाद स्टॉक शेष, आरक्षित और उपलब्ध मात्रा, किसी एक उत्पाद के लिए, या केवल न्यूनतम से कम स्टॉक वाले उत्पादों के लिए।
- list_line_items: किसी opportunity की उत्पाद पंक्तियां (मात्रा, कीमत, छूट, कर) और पुनर्गणना की गई कुल राशि।
- add_line_item: किसी opportunity में एक उत्पाद पंक्ति जोड़ता है। कुल और opportunity की राशि उसी इंजन से फिर से गणना की जाती है जो स्क्रीन उपयोग करती है।
- update_line_item: किसी उत्पाद पंक्ति की मात्रा, कीमत, छूट, कर, अवधि या विवरण बदलता है।
- delete_line_item: किसी opportunity से एक उत्पाद पंक्ति हटाता है।
- send_marketing_email: कॉन्फ़िगर किए गए प्रोवाइडर के माध्यम से एक मार्केटिंग ईमेल भेजता है (to, subject, html), जिसमें unsubscribe फ़ुटर स्वचालित रूप से जोड़ा जाता है।
💡 अनुशंसित एजेंट फ्लो: list_objects → describe_object (फील्ड्स और क्या ज़रूरी है यह जानने के लिए) → create_record/update_record। आप REST पर भी फील्ड्स खोज सकते हैं: GET /api/v1/objects/{object}।
💡 Delete करना उपलब्ध है, पर लॉक किया हुआ है: delete_record, delete_activity और delete_attachment तभी काम करते हैं जब API कुंजी में delete scope सक्षम हो, जो डिफ़ॉल्ट रूप से बंद रहता है। बाकी सभी टूल कुंजी के read-only फ़्लैग और उसके object scope का पालन करते हैं, बिल्कुल REST API की तरह।
पूरा REST API और MCP रेफरेंस (एंडपॉइंट्स, पैरामीटर्स, एरर फॉर्मेट, रेट लिमिट और फील्ड डिस्कवरी): यहां Help Center में "Developer reference: REST API and MCP" आर्टिकल देखें।
कैसे टेस्ट करें
- एजेंट को कनेक्ट करें और कुछ ऐसा पूछें "मेरे CRM ऑब्जेक्ट्स सूचीबद्ध करो", और उसे list_objects कॉल करके सूची लौटानी चाहिए।
- पूछें "Ana Souza नाम की एक लीड बनाओ, ईमेल ana@acme.com के साथ", और एजेंट create_record कॉल करके नए रिकॉर्ड की id लौटाता है।
- CRM में पुष्टि करें कि रिकॉर्ड ऑब्जेक्ट की सूची में दिखाई देता है।
समस्या निवारण
- 401 Unauthorized: API key गायब है/गलत है। Settings → API & developers के तहत एक नई key जनरेट करें और एजेंट को Authorization: Bearer sk_... के साथ फिर से कॉन्फ़िगर करें।
- एजेंट को सर्वर नहीं दिखता: URL https://YOUR-CRM/api/mcp की पुष्टि करें, और Claude Desktop में यह कि mcpServers ब्लॉक config फाइल में है और ऐप को रीस्टार्ट किया गया था।
- कोई एक्शन अस्वीकृत हुआ: MCP, CRM की अनुमतियों (RBAC) और वैलिडेशन्स का पालन करता है, और एरर मैसेज बताता है क्यों (ज़रूरी फील्ड, अनुमति नहीं, प्लान लिमिट, आदि)।
- मुझे सिर्फ अपना डेटा दिखता है: सही है। हर API key उसके मालिक टेनेंट तक सीमित है, इसलिए एजेंट कभी किसी दूसरी कंपनी का डेटा नहीं देखता।