SimplyBoost MCP

npx add-mcp 'https://get-api.simplyboost.io/api/v1/mcp'

यह क्या है

MCP सर्वर https://get-api.simplyboost.io/api/v1/mcp पर उपलब्ध है। यह Streamable HTTP ट्रांसपोर्ट का उपयोग करता है और REST API (Authorization: Bearer sb_live_…) वाला ही API टोकन, वही प्लान (Growth, Pro और Enterprise), वही अनुमतियाँ और वही सीमाएँ इस्तेमाल करता है। हर टूल वही काम करता है जो उससे मेल खाने वाला REST endpoint करता है और उसे उसी scope की ज़रूरत होती है; सहायक को ऐसा टूल दिखता है जिसका वह उपयोग नहीं कर सकता, तो उसे त्रुटि नहीं बल्कि स्पष्ट अस्वीकृति दिखाई देती है।

यह स्टेटलेस है: हर कॉल एक अनुरोध और एक उत्तर है, रखने के लिए कोई सेशन नहीं, इसलिए आप किसी भी मशीन से कनेक्ट कर सकते हैं। सर्वर अपनी ओर से कभी स्ट्रीम शुरू नहीं करता।

क्लाइंट कनेक्ट करें

कनेक्ट करने के दो तरीके हैं। साइन इन करें (OAuth): सर्वर का पता जोड़ें और क्लाइंट के पूछने पर, टीम के मालिक के रूप में SimplyBoost टैब में इसकी मंज़ूरी दें; टीम, अनुमतियाँ और चैटबॉट चुनें। claude.ai और ChatGPT कनेक्टर, Cursor, Codex और Claude Code इसी तरह कनेक्ट होते हैं—कुछ भी पेस्ट करने की ज़रूरत नहीं। टोकन: जिस क्लाइंट को आप हाथ से कॉन्फ़िगर करते हैं या अपनी स्क्रिप्ट के लिए, उसके लिए Settings → API में केवल सहायक की ज़रूरत वाली अनुमतियों वाला टोकन बनाएँ और उसे हेडर के रूप में भेजें।

Claude Code (पूछे जाने पर साइन इन करें)

claude mcp add --transport http simplyboost https://get-api.simplyboost.io/api/v1/mcp

Codex

codex mcp add simplyboost --url https://get-api.simplyboost.io/api/v1/mcp
codex mcp login simplyboost

Cursor, Windsurf, VS Code और mcp.json वाले अन्य क्लाइंट (पूछे जाने पर साइन इन करें)

{
  "mcpServers": {
    "simplyboost": { "url": "https://get-api.simplyboost.io/api/v1/mcp" }
  }
}

साइन इन करने के बजाय टोकन के साथ वही कनेक्शन

{
  "mcpServers": {
    "simplyboost": {
      "url": "https://get-api.simplyboost.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer sb_live_…" }
    }
  }
}

साइन इन करके बनाया गया कनेक्शन 90 दिनों तक चलता है, उसे केवल वही अनुमतियाँ मिलती हैं जिन्हें मालिक ने चुना हुआ छोड़ा है (जब तक चुना न हो, हटाना बंद रहता है), और यह Settings → API → Connected apps में सूचीबद्ध होता है, जहाँ से मालिक इसे कभी भी डिस्कनेक्ट कर सकता है। कनेक्शन को मंज़ूरी केवल टीम का मालिक दे सकता है; टोकन बनाने का भी यही नियम है। मंज़ूरी स्क्रीन पर ऐप का नाम वही होता है जो ऐप ने अपने बारे में बताया है; SimplyBoost इसकी पुष्टि नहीं करता।

क्लाइंट के कॉन्फ़िगरेशन में मौजूद टोकन आपके खाते का पासवर्ड है। इसे अपने कंप्यूटर पर ही रखें, इसकी समाप्ति तय करें और कॉन्फ़िगरेशन फ़ाइल साझा होने पर इसे बदल दें। साइन इन करने से यह समस्या नहीं होती: कोई गोपनीय जानकारी फ़ाइल में नहीं लिखी जाती।

क्लाइंट डेवलपर के लिए: सर्वर MCP प्राधिकरण विनिर्देश का पालन करता है। बिना क्रेडेंशियल वाले अनुरोध का उत्तर 401 होता है, जिसमें WWW-Authenticate हेडर संरक्षित संसाधन के मेटाडेटा (https://get-api.simplyboost.io/.well-known/oauth-protected-resource/api/v1/mcp) का नाम देता है; यह मेटाडेटा प्राधिकरण सर्वर (https://get-api.simplyboost.io/.well-known/oauth-authorization-server) का नाम देता है। क्लाइंट अपना पंजीकरण स्वयं करते हैं (Dynamic Client Registration), PKCE के साथ authorization code flow (केवल S256) का उपयोग करते हैं, संसाधन का नाम दे सकते हैं और रोटेट होने वाले refresh tokens पाते हैं। Access tokens एक घंटे तक चलते हैं और केवल MCP endpoint पर काम करते हैं; REST endpoints के लिए API tokens चाहिए।

टूल

आर्ग्युमेंट और परिणाम REST API (chatbotId, threadId, camelCase फ़ील्ड) वाले ही नाम इस्तेमाल करते हैं, इसलिए endpoint के पेज दोनों का विवरण देते हैं। चैटबॉट की id ढूँढ़ने के लिए list_chatbots से शुरू करें।

टूल	ज़रूरत	काम
get_account	कुछ नहीं	खाता, प्लान और टोकन की अपनी अनुमतियाँ।
get_usage	account:read	इस बिलिंग अवधि में इस्तेमाल किए गए संदेश।
list_chatbots, get_chatbot	chatbots:read	वे चैटबॉट जिन्हें टोकन इस्तेमाल कर सकता है।
send_message	conversations:write	किसी चैटबॉट से वैसे पूछें जैसे कोई विज़िटर पूछेगा; यह प्लान के संदेशों में गिना जाएगा। जारी रखने के लिए threadId भेजें।
list_conversations, get_conversation, list_messages	conversations:read	हर चैनल की बातचीत और उनके संदेश।
take_over_conversation, reply_to_conversation, hand_back_to_chatbot, resolve_conversation	conversations:write	किसी व्यक्ति की तरह बातचीत संभालें: उसे लें, जवाब दें, वापस सौंपें, हल करें या फिर से खोलें।
list_leads, get_lead	leads:read	चैटबॉट द्वारा जुटाए गए लीड।
update_lead	leads:write	किसी लीड का विवरण बदलें या उसे कन्वर्ट हुआ चिह्नित करें।
delete_lead	leads:delete	कोई लीड हटाएँ।
list_knowledge_sources, get_knowledge_source	knowledge:read	चैटबॉट को क्या-क्या पता है, हर स्रोत की स्थिति और टेक्स्ट सहित।
add_text_knowledge, add_website_knowledge, update_knowledge_source, refresh_knowledge_source	knowledge:write	चैटबॉट को टेक्स्ट या वेबसाइट सिखाएँ, स्रोत संपादित करें, वेबसाइट को फिर से पढ़ें।
delete_knowledge_source	knowledge:delete	कोई स्रोत हटाएँ।

फ़ाइल अपलोड और वेबहुक टूल के रूप में उपलब्ध नहीं हैं; इनके लिए REST endpoints इस्तेमाल करें। हटाने वाले टूल को विनाशकारी चिह्नित किया गया है और सर्वर के निर्देश सहायक से कहते हैं कि वह पहले आपसे पूछे।

त्रुटियाँ और सीमाएँ

अस्वीकृत टूल कॉल (अनुमति न होना, ऐसा चैटबॉट जिसे टोकन नहीं देख सकता, अमान्य आर्ग्युमेंट या प्लान की सीमा) का परिणाम त्रुटि के रूप में चिह्नित टूल रिज़ल्ट होता है, जिसमें वही code और संदेश होता है जो REST API देता, ताकि सहायक आपको बता सके कि क्या बदलना है। गुम या अमान्य टोकन का उत्तर 401, API के बिना प्लान या समाप्त हो चुकी सदस्यता का उत्तर 403, और प्रति-टोकन दर सीमा का उत्तर 429 होता है—ठीक REST API की तरह।

जो संदेश JSON-RPC 2.0 नहीं है, उससे JSON-RPC त्रुटि मिलती है। endpoint पर GET और DELETE का उत्तर 405 होता है, क्योंकि कोई सेशन या सर्वर स्ट्रीम नहीं है।