SMLLR REST API और MCP Server: अपने खुद के सिस्टम या एक AI एजेंट से QR एनालिटिक्स क्वेरी करें
SMLLR का रीड-ओनली REST API और इसका ऑफिशियल @smllr/mcp-server पैकेज आपको स्कैन, कैंपेन, और क्लाइंट एनालिटिक्स को अपने खुद के डैशबोर्ड, BI टूल, या Claude जैसे एक AI एजेंट में खींचने देता है — यहां है बिल्कुल क्या हर एक करता है और नहीं करता।
छोटा जवाब
SMLLR का REST API (Premium प्लान) एक रीड-ओनली रिपोर्टिंग API है — सात एंडपॉइंट जो अकाउंट समरी, QR कोड, कैंपेन, और क्लाइंट कवर करते हैं — स्कैन एनालिटिक्स को आपके अपने सिस्टम में खींचने के लिए: एक BI डैशबोर्ड, एक डेटा वेयरहाउस, या कस्टम इंटरनल टूलिंग। @smllr/mcp-server उसी API को एक MCP (Model Context Protocol) सर्वर के तौर पर रैप करता है, ताकि Claude या कोई भी दूसरा MCP-कम्पैटिबल AI एजेंट सीधे उसी डेटा को क्वेरी कर सके, सादी बातचीत में, वही API की और वही Premium-प्लान ज़रूरत इस्तेमाल करते हुए।
REST API असल में क्या कवर करता है
सात एंडपॉइंट, सभी GET, सभी रीड-ओनली: एक अकाउंट-वाइड समरी, QR कोड की एक पेजिनेटेड लिस्ट, एक QR कोड के लिए पूरा एनालिटिक्स, कैंपेन की एक पेजिनेटेड लिस्ट, एक कैंपेन के लिए पूरा एनालिटिक्स, क्लाइंट (एजेंसी अकाउंट) की एक पेजिनेटेड लिस्ट, और एक क्लाइंट के लिए पूरा एनालिटिक्स। Settings → API से एक API की के साथ ऑथेंटिकेट करें, एक x-api-key हेडर के तौर पर या Authorization हेडर में एक Bearer टोकन के तौर पर भेजा गया — प्रति अकाउंट एक सिंगल स्टैटिक की, कोई प्रति-रिक्वेस्ट OAuth फ्लो नहीं। रेट लिमिट प्रति की प्रति मिनट 60 रिक्वेस्ट है, एक फ्लैट लिमिट जो ज़्यादा इस्तेमाल पर नहीं बढ़ती।
यह जानबूझकर क्या नहीं करता
इसके बारे में सीधा होना उचित है, क्योंकि ये वे दो चीज़ें हैं जो डेवलपर सबसे ज़्यादा मांगते हैं: एक QR कोड की डेस्टिनेशन URL बनाने या अपडेट करने के लिए कोई एंडपॉइंट नहीं है — QR क्रिएशन और एडिटिंग डैशबोर्ड-ओनली रहते हैं। और API कभी Lead Hub कॉन्टैक्ट डेटा वापस नहीं करता — किसी भी एंडपॉइंट के तहत कोई स्कैनर नाम, ईमेल, फोन नंबर, या सहमति रिकॉर्ड नहीं। यह जो वापस करता है वह सिर्फ एग्रीगेटेड स्कैन, कैंपेन, और क्लाइंट एनालिटिक्स है, वही अनुशासन जो SMLLR के Webhooks और Slack इंटीग्रेशन फॉलो करते हैं।
MCP Server: वही डेटा, डैशबोर्ड के बजाय एक AI एजेंट के लिए
@smllr/mcp-server एक छोटा, ऑफिशियल npm पैकेज है जो उन्हीं सात रीड-ओनली क्षमताओं को MCP टूल के तौर पर एक्सपोज़ करता है — get_summary, list_qr_codes, get_qr_code, list_campaigns, get_campaign, list_clients, और get_client — ताकि Claude जैसा एक MCP-कम्पैटिबल AI एजेंट उन्हें सीधे बातचीत के हिस्से के तौर पर कॉल कर सके, आपके मैनुअली REST API क्वेरी करने और नतीजे पेस्ट करने के बजाय। यह एक रैपर है, कोई अलग प्रोडक्ट नहीं: वही API की, वही Premium-प्लान ज़रूरत, वही 60-रिक्वेस्ट-प्रति-मिनट लिमिट, वही रीड-ओनली स्कोप, किसी भी Lead Hub डेटा की वही अनुपस्थिति। इसे इंस्टॉल करना एक कमांड है: Claude Code के लिए claude mcp add smllr --env SMLLR_API_KEY=smllr_live_your_key_here -- npx -y @smllr/mcp-server, या Claude Desktop के लिए claude_desktop_config.json में समकक्ष mcpServers ब्लॉक।
यह असल में कहां इस्तेमाल होता है
एक मार्केटिंग टीम /summary और /campaigns एंडपॉइंट को एक मौजूदा BI टूल में पाइप करती है (एक Metabase या Looker डैशबोर्ड जो पहले से दूसरे चैनल के लिए इस्तेमाल होता है) ताकि QR परफॉर्मेंस दूसरे मार्केटिंग मेट्रिक्स के साथ बैठे, सिर्फ SMLLR के अपने डैशबोर्ड के अंदर रहने के बजाय। कई क्लाइंट मैनेज करने वाली एक एजेंसी /clients और /client/:id को एक इंटरनल रिपोर्टिंग लेयर में खींचती है जो नंबरों को उनके अपने ब्रांडेड क्लाइंट-फेसिंग रिपोर्ट में रीफॉर्मेट करती है। खास तौर पर MCP server के साथ, कोई सीधे Claude से पूछ सकता है "पिछले हफ्ते मेरे किस QR कैंपेन में सबसे ज़्यादा स्कैन हुए" या "इस क्लाइंट की स्कैन ट्रेंड का सारांश दो" और लाइव SMLLR डेटा से लिया गया एक जवाब पा सकता है, बिना डैशबोर्ड खोले या पहले REST API के खिलाफ एक स्क्रिप्ट लिखे।
REST API बनाम Webhooks: पुल बनाम पुश
REST API और MCP server दोनों पुल-आधारित हैं — आप (या आपका AI एजेंट) पूछते हैं, और SMLLR उस पल जो भी सच है उसके साथ जवाब देता है। अगर आपको असल में जो चाहिए वह है समय-समय पर चेक करने के बजाय उसी पल रिएक्ट करना जब कुछ होता है, तो वह एक अलग फीचर है: Webhooks (Pro प्लान और उससे ऊपर) एक स्कैन या QR इवेंट होते ही एक साइन्ड पेलोड आपके अपने एंडपॉइंट, Slack, या Zapier पर पुश करता है। दोनों कॉम्प्लीमेंट्री हैं, प्रतिस्पर्धी नहीं — एक शेड्यूल्ड रिपोर्ट के लिए पोलिंग करना और एक रियल-टाइम इवेंट पर रिएक्ट करना अलग काम हैं, और SMLLR के पास हर एक के लिए एक डेडिकेटेड टूल है।
इसकी कीमत क्या है
REST API और MCP server दोनों को SMLLR के Premium प्लान (₹14,999/महीना) और Settings → API से जेनरेट की गई एक API की चाहिए — MCP server के लिए खुद कोई अलग चार्ज नहीं है क्योंकि यह उसी API और उसी की के ऊपर एक पतला रैपर है।
अक्सर पूछे जाने वाले सवाल
API एक्सेस के लिए मुझे किस प्लान की ज़रूरत है?
Premium प्लान (₹14,999/महीना) REST API और MCP server दोनों के लिए — वे वही ज़रूरत और वही API की शेयर करते हैं।
क्या मैं API के ज़रिए QR कोड बना या एडिट कर सकता हूं?
नहीं। API रीड-ओनली रिपोर्टिंग है — QR क्रिएशन और डेस्टिनेशन एडिट सिर्फ SMLLR डैशबोर्ड के ज़रिए होते हैं।
क्या API या MCP server कभी लीड/कॉन्टैक्ट डेटा वापस करता है?
नहीं। हर एंडपॉइंट सिर्फ एग्रीगेटेड स्कैन, कैंपेन, और क्लाइंट एनालिटिक्स वापस करता है — Lead Hub से कभी एक स्कैनर का नाम, ईमेल, फोन नंबर, या सहमति रिकॉर्ड नहीं।
रेट लिमिट क्या है?
प्रति API की प्रति मिनट 60 रिक्वेस्ट, आपके अकाउंट या नेटवर्क में शेयर्ड होने के बजाय प्रति की ट्रैक की गई — एक फ्लैट लिमिट जो ज़्यादा इस्तेमाल पर नहीं बढ़ती।
क्या MCP server REST API से एक अलग प्रोडक्ट है?
नहीं — यह एक ऑफिशियल npm पैकेज है (@smllr/mcp-server) जो उन्हीं सात रीड-ओनली एंडपॉइंट को MCP टूल के तौर पर रैप करता है, वही API की और प्लान ज़रूरत इस्तेमाल करते हुए।
कौन से AI एजेंट MCP server के साथ काम करते हैं?
कोई भी MCP-कम्पैटिबल क्लाइंट — Claude Code और Claude Desktop डॉक्युमेंटेड सेटअप हैं, और वही पैकेज किसी भी दूसरे टूल के साथ काम करता है जो Model Context Protocol बोलता है।
मैं कैसे ऑथेंटिकेट करूं?
Settings → API से एक सिंगल स्टैटिक API की, एक x-api-key हेडर के तौर पर या Authorization हेडर में एक Bearer टोकन के तौर पर भेजी गई।
मुझे API या Webhooks इस्तेमाल करना चाहिए?
REST API और MCP server पुल-आधारित हैं — शेड्यूल्ड रिपोर्टिंग या ऐड-हॉक क्वेरी के लिए अच्छे। Webhooks पुश-आधारित हैं — एक इवेंट होते ही उस पर रिएक्ट करने के लिए अच्छे। ज़्यादातर सेटअप जिन्हें दोनों चाहिए हर एक को उसके अपने काम के लिए इस्तेमाल करते हैं, एक चुनने के बजाय।