Claude, Cursor, Hermes या किसी भी AI एजेंट को MCP के साथ कनेक्ट करें

Store Console में इन-बिल्ट MCP सर्वर (Model Context Protocol) है। आप जो AI एजेंट पहले से इस्तेमाल कर रहे हैं, जैसे Claude, Cursor, VS Code या Hermes एजेंट, वे आपके स्टोर से कनेक्ट होकर काम कर सकते हैं: आज के ऑर्डर की लिस्ट देखना, ऑर्डर का स्टेटस या उसके प्रोडक्ट्स बदलना, कैश-ऑन-डिलीवरी पेमेंट रिकॉर्ड करना, प्राइस अपडेट करना, स्टॉक एडजस्ट करना, कस्टमर ढूंढना, सेल्स या स्टॉक रिपोर्ट निकालना, और Social Hub पोस्ट प्लान व शेड्यूल करना। एजेंट उन्हीं टूल्स का इस्तेमाल करता है जो एडमिन पैनल के अंदर असिस्टेंट के पास होते हैं और यह कभी भी उस व्यक्ति से ज्यादा काम नहीं करता जिसके पास टोकन की अनुमति है।

एक नज़र में

एरिया	एजेंट क्या कर सकता है	आपकी सहमति मांगता है
ऑर्डर्स और सेल्स	ऑर्डर्स सर्च और फिल्टर करना, लाइन्स और एड्रेस के साथ एक ऑर्डर खोलना, फोन पर ऑर्डर लेना, उसका स्टेटस बदलना, शिप होने से पहले प्रोडक्ट्स एडिट करना, कैश ऑन डिलीवरी या बैंक ट्रांसफर रिकॉर्ड करना, रिफंड शुरू करना, सेल्स और प्रोडक्ट सेल्स रिपोर्ट्स	हर बदलाव; रिफंड के लिए अभी भी 'Refunds' सेक्शन में किसी व्यक्ति की मंजूरी की जरूरत होती है
उत्पाद	प्रोडक्ट्स सर्च करना, एक प्रोडक्ट खोलना, ड्राफ्ट प्रोडक्ट बनाना, नाम, डिस्क्रिप्शन, SEO, ब्रांड और कैटेगरी बदलना, पब्लिश या अनपब्लिश करना, प्राइस और सेल प्राइस सेट करना	हर बदलाव
स्टॉक	हर वेयरहाउस के हिसाब से स्टॉक, लो और आउट-ऑफ-स्टॉक लाइन्स, कारण के साथ यूनिट्स जोड़ना या हटाना	हर एडजस्टमेंट
कस्टमर्स	कस्टमर्स ढूंढना, एड्रेस देखना, स्टेटस के हिसाब से ऑर्डर्स और हालिया ऑर्डर्स देखना, कस्टमर रिपोर्ट	—
प्रोडक्ट रिव्यूज	मॉडरेशन के लिए पेंडिंग या कम रेटिंग वाले रिव्यूज; अप्रूव करें, कारण के साथ रिजेक्ट करें, या पब्लिकली रिप्लाई करें	हर एक्शन
सोशल हब	Facebook, Instagram, WhatsApp, TikTok, YouTube और X के लिए कनेक्शन स्टेटस, कंटेंट कैलेंडर, पोस्ट स्टेटस और रिजल्ट्स, अभी पब्लिश करें या पोस्ट शेड्यूल करें, रीशेड्यूल, कैंसिल या रिट्राई करें, रिपोर्ट्स, अप्रूवल क्यू और कमेंट्स	पब्लिशिंग, शेड्यूलिंग और बदलाव
विज्ञापन और व्हाट्सएप	मेटा विज्ञापन परिणाम, एक नई अभियान की योजना बनाना, बजट को रोकना या बदलना, CRM से कस्टम ऑडियंस; व्हाट्सएप अभियान स्वीकृत टेम्पलेट्स के साथ: ड्राफ्ट, परीक्षण, भेजना, रोकना, फिर से शुरू करना या रद्द करना; टिप्पणियों को छिपाना, हटाना या निजी तौर पर जवाब देना	हर बदलाव; नए अभियान और व्हाट्सएप भेजने के लिए भी स्वीकृति कतार में इंतज़ार करना होता है
डिलीवरी	पार्सल और उनका स्टेटस, कूरियर लिस्ट, कूरियर बुक करें, पार्सल का स्टेटस बदलें	बुकिंग और स्टेटस में बदलाव
मार्केटिंग और CRM	कूपन और सेल कैंपेन बनाएं, लीड्स और डील्स खोजें और जोड़ें	हर बदलाव
कंटेंट और मीडिया	ब्लॉग पोस्ट लिखें, मीडिया लाइब्रेरी में इमेज और वीडियो अपलोड करें	ब्लॉग पोस्ट
सपोर्ट, प्रोजेक्ट्स, सप्लायर्स	टिकट खोजें, खोलें, जवाब दें और रिजॉल्व करें; Momentum टास्क खोजें, बनाएं, मूव करें और असाइन करें; सप्लायर्स खोजें और जोड़ें	हर बदलाव
लोग (People)	अप्रूवल के लिए पेंडिंग लीव रिक्वेस्ट; अप्रूव करें, या उस कारण के साथ रिजेक्ट करें जो एम्प्लॉई को दिखेगा	हर फैसला
रिपोर्ट्स	सेल्स, अकाउंटिंग, बजट, फाइनेंस, मार्केटिंग, परित्यक्त कार्ट (abandoned cart), स्टॉक, HR, पेरोल और सपोर्ट रिपोर्ट्स	—

1. MCP ऑन करें

1. जाएं Intelligence → MCP और AI agents.
2. On the Connect टैब पर, Allow AI agents to connect को चालू करने के लिए कहें।को ऑन करें। यह केवल एक एडमिनिस्ट्रेटर ही कर सकता है।
3. एक टोकन प्रति मिनट कितनी रिक्वेस्ट भेज सकता है, यह चुनें (डिफ़ॉल्ट रूप से 60) और सेव करें।

जब MCP बंद होता है, तो हर एजेंट रिक्वेस्ट रिजेक्ट कर दी जाती है, भले ही टोकन सही हो।

2. अपना एक्सेस टोकन बनाएं

1. खोलें Access tokens करें और टोकन बनाएँ.
2. दबाएं। इसे एक नाम दें, उदाहरण के लिए "Marketing team — Claude"।
3. चुनें कि यह क्या एक्सेस कर सकता है: सभी एरिया के लिए या एक-एक करके, No access, Read only या Read and change.
4. एक्सपायरी चुनें और दबाएं टोकन बनाएँ.
5. टोकन को तुरंत कॉपी करें। यह scmcp_ से शुरू होता है और केवल एक बार दिखाया जाता है, साथ ही आपके एजेंट के लिए एक रेडी सेटअप भी होता है (टोकन स्क्रीन पर छिपा होता है; कॉपी करने पर असली टोकन आपके क्लिपबोर्ड पर आ जाता है)।

एक टोकन उसी व्यक्ति की तरह काम करता है जिसने इसे बनाया है। मार्केटिंग टीम के लिए, एक ऐसे यूजर के रूप में साइन इन करें जिसके पास Social Media Manager रोल हो और वहाँ Social Hub स्कोप के साथ टोकन बनाएँ: इसके बाद एजेंट पोस्ट प्लान और शेड्यूल कर सकता है और Social Hub रिपोर्ट्स पढ़ सकता है, लेकिन ऑर्डर्स, कस्टमर्स या प्राइसेस नहीं देख सकता।

3. अपने एजेंट को कनेक्ट करें

सर्वर एड्रेस https://your-store.com/mcpहै। टोकन को Authorization हेडर में Bearer YOUR_TOKENके रूप में भेजें। Connect टैब नीचे दिए गए हर सेटअप को आपके अपने एड्रेस के साथ दिखाता है।

Claude Code

claude mcp add --transport http store_console https://your-store.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

Cursor (.cursor/mcp.json)

{ "mcpServers": { "store_console": { "url": "https://your-store.com/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }

Claude Desktop (claude_desktop_config.json, Node.js की आवश्यकता है)

{
  "mcpServers": {
    "store_console": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-store.com/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer YOUR_TOKEN" }
    }
  }
}

Hermes एजेंट (~/.hermes/config.yaml)

mcp_servers:
  store_console:
    url: "https://your-store.com/mcp"
    headers:
      Authorization: "Bearer YOUR_TOKEN"

कोई अन्य MCP क्लाइंट

{ "mcpServers": { "store_console": { "type": "http", "url": "https://your-store.com/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }

फिर अपने एजेंट से कुछ सरल पूछें, जैसे "show today's orders", यह चेक करने के लिए कि यह काम कर रहा है या नहीं।

4. बदलावों को सुरक्षित कैसे रखा जाता है

• आपकी अनुमतियाँ, हर बार। हर टूल चलने से पहले टोकन ओनर की भूमिका (role) की जाँच करता है। जिन टूल्स का उपयोग भूमिका नहीं कर सकती, वे दिखाए ही नहीं जाते।
• बदलाव आपकी सहमति का इंतज़ार करते हैं। जब एजेंट किसी ऑर्डर, कीमत, स्टॉक या पोस्ट में बदलाव करना चाहता है, तो स्टोर पहले एक संक्षिप्त सारांश (summary) के साथ जवाब देता है और कुछ भी सेव नहीं करता। एजेंट आपको वह सारांश दिखाता है, और आपके सहमत होने के बाद ही बदलाव होता है।
• हर रिक्वेस्ट लॉग की जाती है। द एक्टिविटी लॉग टैब, और MCP के अंतर्गत मुख्य एक्टिविटी लॉग, यह दिखाते हैं कि किसने, किस टोकन ने, कौन सा टूल इस्तेमाल किया, उसका परिणाम क्या रहा और उसमें कितना समय लगा। सीक्रेट्स को कभी भी लॉग में स्टोर नहीं किया जाता।
• रिवोक (Revoke) या डिलीट करें। रिवोक करने से टोकन तुरंत रुक जाता है; डिलीट करने से वह लिस्ट से भी हट जाता है।
• सीमाएँ और ऑफ स्विच। हर टोकन की प्रति-मिनट सीमा होती है। किसी भी समय टोकन को रिवोक करें, या पूरे स्टोर के लिए MCP को बंद कर दें।
• कुछ काम अंदर ही रहते हैं। शेड्यूल्ड टास्क को चलाना, बनाना या डिलीट करना बाहरी एजेंटों के लिए कभी उपलब्ध नहीं होता।

सवाल

एजेंट कहता है कि टोकन गायब है या गलत है। जाँचें कि हेडर में Authorization: Bearer scmcp_…लिखा है, कि टोकन की समय-सीमा समाप्त नहीं हुई है और उसे रिवोक नहीं किया गया है।

कोई टूल जो मुझे चाहिए था, वह गायब है। आपकी भूमिका में वह एरिया शामिल नहीं है, या टोकन के स्कोप्स (scopes) में वह नहीं है। यह देखने के लिए कि आपकी भूमिका क्या उपयोग कर सकती है, टूल्स टैब खोलें।

एजेंट कहता है कि MCP बंद है। किसी एडमिनिस्ट्रेटर से Allow AI agents to connect को चालू करने के लिए कहें।.