MCP — प्रोग्रामेटिक इंटरफ़ेस

REST के अलावा, GetMyBot में MCP (Model Context Protocol) इंटरफ़ेस भी है — यह AI-एजेंट और असिस्टेंट के लिए डिज़ाइन किया गया है जो एंडपॉइंट मैन्युअली कॉल करने के बजाय टूल कॉल करते हैं। REST प्राथमिक इंटरफ़ेस बना रहता है; MCP — एजेंटिक परिदृश्यों के लिए एक सुविधाजनक विकल्प। नीचे दिए गए टूल, रिसोर्स और प्रॉम्प्ट के नाम वही हैं जो सर्वर प्रकाशित करता है।

पता और प्राधिकरण

MCP एंडपॉइंट /mcp (Streamable HTTP ट्रांसपोर्ट, POST मेथड) पर उपलब्ध है। प्राधिकरण — वही पर्सनल टोकन, जो REST के लिए: Authorization: Bearer mbp_… हेडर। अलग टोकन बनाने की ज़रूरत नहीं — एक PAT REST और MCP दोनों के लिए काम करता है। प्रत्येक टूल उसी scope की माँग करता है जो संबंधित REST-एंडपॉइंट के लिए आवश्यक है; * scope वाले टोकन का पूर्ण एक्सेस होता है। यदि scope पर्याप्त नहीं — कॉल अस्वीकार होती है (fail-closed), जैसा REST में होता है।

Claude Code / Cursor से कनेक्शन

GetMyBot को रिमोट MCP-सर्वर के रूप में जोड़ें। कॉन्फ़िगरेशन उदाहरण (mcpServers) — अपना डोमेन और टोकन सब्स्टिट्यूट करें:

{
  "mcpServers": {
    "mybot": {
      "url": "https://your-domain/mcp",
      "headers": {
        "Authorization": "Bearer mbp_YOUR_TOKEN"
      }
    }
  }
}

Claude Code: इस ब्लॉक को प्रोजेक्ट के .mcp.json में रखें या claude mcp add कमांड से सर्वर जोड़ें। Cursor: MCP सेटिंग्स में वही ब्लॉक जोड़ें (Settings → MCP → Add server)। कनेक्शन के बाद क्लाइंट को टूल, रिसोर्स और प्रॉम्प्ट की सूची स्वचालित रूप से मिल जाएगी।

डोमेन के अनुसार टूल

सर्वर 100 टूल प्रकाशित करता है — PAT-एक्सेसिबल REST का पूर्ण कवरेज। नीचे — टूल और आवश्यक scope। नाम verb_noun फ़ॉर्मेट (snake_case) में हैं।

बॉट (bots)

  • list_bots — bots:read
  • get_bot — bots:read
  • validate_bot_token — bots:write
  • connect_bot — bots:write
  • update_bot — bots:write
  • delete_bot — bots:write
  • sync_bot — bots:write
  • change_bot_token — bots:write
  • transfer_bot — bots:write
  • get_bot_settings — settings:read
  • update_bot_settings — settings:write

चैनल और WhatsApp टेम्पलेट (bots)

मल्टीचैनल समर्थन (Telegram + WhatsApp + VK) MCP के ज़रिए भी उपलब्ध है। चैनल और टेम्पलेट साझा scopes bots:read / bots:write द्वारा नियंत्रित होते हैं — चैनल के लिए अलग scope नहीं है।

  • list_channels — bots:read — बॉट के चैनलों की सूची (प्लेटफ़ॉर्म tg/wa/vk, external_id, नाम, enabled, callback_url)।
  • connect_channel — bots:write — WhatsApp या VK चैनल जोड़ना (platform + क्रेडेंशियल्स)।
  • delete_channel — bots:write — चैनल हटाना।
  • list_wa_templates — bots:read — चैनल का WhatsApp टेम्पलेट कैटलॉग (नाम, भाषा, स्थिति, श्रेणी, बॉडी)।
  • sync_wa_templates — bots:write — Meta से टेम्पलेट कैटलॉग फिर से सिंक करना।
  • create_wa_template — bots:write — WhatsApp टेम्पलेट बनाना और उसे Meta को जाँच के लिए भेजना।
  • update_wa_template — bots:write — टेम्पलेट संपादित करना (APPROVED/REJECTED/PAUSED स्थिति में)।
  • delete_wa_template — bots:write — टेम्पलेट हटाना।

Telegram चैनल connect_bot के ज़रिए जोड़े जाते हैं, connect_channel के ज़रिए नहीं — बाद वाला केवल wa और vk संभालता है। टेम्पलेट श्रेणियाँ: MARKETING / UTILITY / AUTHENTICATION। create_wa_template ड्राफ़्ट को तुरंत Meta को जाँच के लिए भेज देता है; स्थिति अतुल्यकालिक रूप से बदलती है — उसे list_wa_templates के ज़रिए फिर से पढ़ें (ज़रूरत हो तो कैटलॉग को sync_wa_templates से ताज़ा करें)।

टेम्पलेट का मीडिया हेडर (छवि/वीडियो/दस्तावेज़) MCP के ज़रिए अपलोड करना अभी समर्थित नहीं है — वेब UI या REST POST /api/bots/{botID}/channels/{channelID}/templates/media का उपयोग करें।

रिएक्शन (reactions)

  • list_reactions — reactions:read
  • get_reaction — reactions:read
  • create_reaction — reactions:write
  • update_reaction — reactions:write
  • delete_reaction — reactions:write
  • import_reactions — reactions:write
  • test_formula — reactions:write
  • reorder_reaction — reactions:write
  • get_reaction_links — reactions:read
  • list_reaction_folders — reactions:read
  • create_reaction_folder — reactions:write
  • update_reaction_folder — reactions:write
  • delete_reaction_folder — reactions:write
  • add_reaction_to_folder — reactions:write
  • remove_reaction_from_folder — reactions:write
  • add_reactions_to_folder — reactions:write

import_reactions के माध्यम से आयात रिएक्शन बनाता है, लेकिन मीडिया छोड़ देता है: MCP-कॉन्टेक्स्ट में फ़ाइलों के लिए premium-जाँच और Telegram-रिसीवर नहीं है। यदि SamBot बंडल में चित्र/वीडियो/दस्तावेज़ हैं — पूर्ण-कार्यात्मक REST-आयात (POST /api/bots/{botID}/reactions/import) का उपयोग करें, यह मीडिया भी ट्रांसफर करता है।

ब्रॉडकास्ट (broadcasts)

  • start_broadcast — broadcasts:write (वैकल्पिक paid, वैकल्पिक लेबल द्वारा सेगमेंट)
  • get_broadcast — broadcasts:write
  • pause_broadcast — broadcasts:write
  • resume_broadcast — broadcasts:write
  • cancel_broadcast — broadcasts:write

लेबल (labels)

  • list_labels — labels:read
  • create_label — labels:write
  • delete_label — labels:write
  • set_label_favorite — labels:write

संग्रह और रिकॉर्ड (collections)

  • list_collections — collections:read
  • create_collection — collections:write
  • update_collection — collections:write
  • delete_collection — collections:write
  • list_records — collections:read
  • create_record — collections:write
  • update_record — collections:write
  • delete_record — collections:write

परिदृश्य (flows)

  • list_flows — flows:read
  • get_flow — flows:read
  • create_flow — flows:write
  • update_flow — flows:write
  • delete_flow — flows:write

इंटीग्रेशन, कनेक्शन, क्रेडेंशियल (integrations)

  • list_integrations — integrations:read
  • get_integration_sheets — integrations:read
  • get_integration_status — integrations:read
  • create_integration — integrations:write
  • update_integration — integrations:write
  • delete_integration — integrations:write
  • rotate_integration_token — integrations:write
  • list_connections — integrations:read
  • create_connection — integrations:write
  • test_connection — integrations:write
  • update_connection — integrations:write
  • delete_connection — integrations:write
  • list_credentials — integrations:read
  • create_credential — integrations:write
  • update_credential — integrations:write
  • delete_credential — integrations:write

मीडिया (media)

  • upload_media — media:write
  • get_media — media:write

टेम्प्लेट (templates)

  • list_templates — templates:read
  • delete_template — templates:write
  • create_template_from_bot — templates:write
  • apply_template — templates:write

सब्सक्राइबर, चैट, डायलॉग — पठन (subscribers)

  • list_subscribers — subscribers:read (offset/limit पेजिनेशन, लेबल फ़िल्टर)
  • list_chats — subscribers:read
  • list_dialogs — subscribers:read
  • read_dialog — subscribers:read
  • send_dialog_message — subscribers:write
  • send_dialog_reaction — subscribers:write
  • transcribe_dialog_message — subscribers:write

आँकड़े और एनालिटिक्स (stats)

  • get_stats — stats:read
  • get_stats_summary — stats:read
  • get_stats_recent — stats:read
  • get_stats_log — stats:read
  • get_reaction_health — stats:read
  • get_analytics — stats:read
  • get_analytics_chats — stats:read
  • get_funnel — stats:read

बिलिंग — पठन (billing)

  • get_balance — billing:read
  • list_tariffs — billing:read
  • get_transactions — billing:read

संदेश भेजना

  • send_message — broadcasts:write — बॉट की ओर से संदेश भेजना; बैलेंस खर्च टोकन ओनर के अनुसार स्वचालित रूप से दर्ज होता है।

रिसोर्स

टूल के अलावा सर्वर रिसोर्स भी देता है — उन्हें पढ़कर संरचना का अनुमान लगाने की ज़रूरत नहीं पड़ती:

  • mybot://openapi.yaml — पूर्ण OpenAPI-स्पेक (वही जो /openapi.yaml पर मिलती है)।
  • mybot://reference — कॉम्पैक्ट गाइड: scope के साथ टूल की सूची और कन्वेंशन (बेस एड्रेस, पेजिनेशन, त्रुटि फ़ॉर्मेट, सीमाएँ)।
  • mybot://schemas/reaction, mybot://schemas/trigger, mybot://schemas/action, mybot://schemas/flow, mybot://schemas/collection — कॉन्फ़िग की JSON-स्कीमा। रिएक्शन (ट्रिगर, शर्तें, चैट, कार्य), परिदृश्य और संग्रह के सही जनरेशन के लिए सबसे मूल्यवान।
  • mybot://bots — आपके बॉट की डायनामिक सूची (टूल कॉल के बिना त्वरित कॉन्टेक्स्ट)।

प्रॉम्प्ट

तैयार परिदृश्य (MCP-क्लाइंट पर slash-कमांड):

  • setup_autoresponder — ऑटो-रिस्पॉन्डर बॉट असेम्बल करना (आर्गुमेंट: बॉट, विषय/प्रश्नों का सेट)।
  • segment_broadcast — लेबल सेगमेंट द्वारा ब्रॉडकास्ट (आर्गुमेंट: बॉट, लेबल, रिएक्शन/टेक्स्ट)।
  • diagnose_reaction — यह समझना कि रिएक्शन क्यों सक्रिय नहीं होती (रिएक्शन, reaction-health और क्रम पढ़ता है)।
  • import_from_sambot — SamBot बंडल आयात करना और परिणाम जाँचना।
  • weekly_report — किसी अवधि के लिए बॉट के आँकड़े/एनालिटिक्स का सारांश।

MCP कब चुनें, REST कब

  • इंटीग्रेशन, सिंक्रोनाइज़ेशन, स्क्रिप्ट या अपना पैनल लिख रहे हैं — REST लें।
  • GetMyBot को AI-असिस्टेंट या एजेंट से जोड़ रहे हैं जो MCP सपोर्ट करता है — /mcp लें।

दोनों इंटरफ़ेस एक ही टोकन पर काम करते हैं और ओनर के उन्हीं अधिकारों का पालन करते हैं। यदि टास्क के लिए कोई टूल नहीं मिला — संबंधित REST-एंडपॉइंट हमेशा इंटरेक्टिव गाइड में उपलब्ध है।

आगे क्या