Sinch Engage / MessageMedia MCP server

Sinch Engage MCP सर्वर

इस रिपॉजिटरी में Sinch Engage (ऑस्ट्रेलिया में Sinch MessageMedia) MCP सर्वर का स्रोत कोड है, जो Sinch Engage API को MCP उपकरणों के रूप में प्रदान करता है।

उपकरण अवलोकन

यहाँ MCP सर्वर में उपलब्ध उपकरणों की सूची दी गई है (सभी फ़ोन नंबर E.164 प्रारूप में देने होंगे, जैसे, ऑस्ट्रेलिया के लिए +61400000000)।

संदेश सेवा

उपकरण	विवरण	श्रेणी	मोड
sendMessage	किसी मोबाइल नंबर पर SMS भेजें	messaging	write

रिपोर्टिंग

उपकरण	विवरण	श्रेणी	मोड
getDetailedMessageReport	निर्दिष्ट तिथि सीमा के लिए भेजे और प्राप्त संदेशों की विस्तृत रिपोर्ट तैयार करता है, जिसमें दिशा, खातों, मेटाडेटा और समूहीकरण के लिए वैकल्पिक फ़िल्टर होते हैं।	reporting	read
getSummaryMessageReport	निर्दिष्ट तिथि सीमा के लिए भेजे और प्राप्त संदेशों की सारांश रिपोर्ट तैयार करता है, जिसमें दिशा, खातों और समूहीकरण के लिए वैकल्पिक फ़िल्टर होते हैं।	reporting	read
getSummaryInsightMessageReport	निर्दिष्ट तिथि सीमा के लिए भेजे और प्राप्त संदेशों की पूर्व-संकलित सारांश रिपोर्ट प्राप्त करता है, जिसमें दिशा, खातों और समूहीकरण के लिए वैकल्पिक फ़िल्टर होते हैं।	reporting	read
getAsyncReportStatus	report_id द्वारा अतुल्यकालिक रिपोर्ट अनुरोध की स्थिति प्राप्त करता है।	reporting	read
getAsyncReportFields	अतुल्यकालिक विस्तृत रिपोर्ट निर्यात के लिए उपलब्ध फ़ील्ड की सूची प्राप्त करता है।	reporting	read
requestAsyncDetailedMessageReport	निर्दिष्ट तिथि सीमा के लिए भेजे और प्राप्त संदेशों की अतुल्यकालिक विस्तृत रिपोर्ट का अनुरोध करता है, जिसमें रिपोर्ट प्रारूप और गंतव्य के लिए वितरण विकल्प होते हैं।	reporting	read

संपर्क

उपकरण	विवरण	श्रेणी	मोड
getContactGroups	खाते से संबद्ध संपर्क समूहों (सूचियों) की पृष्ठांकित सूची प्राप्त करता है।	reporting	read
getContactGroupDetails	group_id द्वारा पहचाने गए किसी विशिष्ट संपर्क समूह (सूची) का विवरण प्राप्त करता है।	reporting	read
getContactWithSearch	समूह, फ़ोन नंबर, नाम और चैनल प्रकार के आधार पर फ़िल्टर करने योग्य संपर्कों की सूची प्राप्त करता है।	reporting	read
createContactGroup	निर्दिष्ट नाम और वैकल्पिक उपनाम के साथ एक नया संपर्क समूह (सूची) बनाता है।	reporting	write
createContact	निर्दिष्ट विवरण के साथ एक नया संपर्क बनाता है।	reporting	write
updateContact	contact_id द्वारा पहचाने गए मौजूदा संपर्क को नए विवरण के साथ अपडेट करता है।	reporting	write
deleteContactGroup	group_id द्वारा पहचाने गए किसी विशिष्ट संपर्क समूह (सूची) को हटाता है।	reporting	delete

आरंभ करना

पूर्वापेक्षाएँ

• Node.js >= 16.0
• एक प्रावधानित Sinch Engage खाता
• Claude Desktop (या कोई अन्य MCP क्लाइंट)। यह README Claude Desktop पर केंद्रित है, लेकिन MCP सर्वर का उपयोग किसी भी MCP क्लाइंट के साथ किया जा सकता है।

API क्रेडेंशियल

MCP उपकरणों द्वारा उपयोग किए जाने वाले API का उपयोग करने के लिए, आपको निम्नलिखित क्रेडेंशियल की आवश्यकता होगी:

• SINCH_ENGAGE_API_KEY और SINCH_ENGAGE_API_SECRET Sinch Engage क्रेडेंशियल

MCP सर्वर कॉन्फ़िगरेशन

Sinch Engage MCP सर्वर निष्पादित करने के लिए NPM पैकेज के रूप में उपलब्ध है। यहाँ बताया गया है कि इसे Claude Desktop कॉन्फ़िगरेशन फ़ाइल (claude_desktop_config.json) में कैसे सेट अप करें। पर्यावरण चर में अपने स्वयं के क्रेडेंशियल और क्षेत्र (वर्तमान में समर्थित EU और AU) भरना याद रखें:

{
  "mcpServers": {
    "Sinch Engage": {
      "command": "npx",
      "args": [
        "-y",
        "@sinch-engage/mcp-server"
      ],
      "env": {
        "SINCH_ENGAGE_API_KEY": "<your-key>",
        "SINCH_ENGAGE_API_SECRET": "<your-secret>",
        "SINCH_ENGAGE_REGION": "<region>",
        "MCP_TOOL_CATEGORIES": "reporting, contacts, messaging",
        "MCP_TOOL_MODES": "read, write, delete"
      }
    }
  }
}

MCP सर्वर को स्थानीय रूप से चलाना

विकल्प 1: Claude Desktop के साथ stdio का उपयोग करके MCP सर्वर प्रारंभ करें

MCP सर्वर को स्थानीय रूप से Claude Desktop के साथ चलाने के लिए, आपको रिपॉजिटरी को क्लोन करना होगा और MCP सर्वर का निर्माण करना होगा। यह विकल्प स्थानीय विकास और परीक्षण के लिए उपयोगी है।

चरण 1: रिपॉजिटरी क्लोन करें

git clone https://github.com/messagemedia/sinch-engage-mcp-server.git

चरण 2: निर्भरताएँ स्थापित करें

cd sinch-engage-mcp-server
npm install

चरण 3: Claude Desktop कॉन्फ़िगरेशन सेटअप करें

यहाँ Claude Desktop कॉन्फ़िगरेशन फ़ाइल (claude_desktop_config.json) में MCP सर्वर को कॉन्फ़िगर करने का एक उदाहरण दिया गया है, जहाँ आप अपने Sinch Engage क्रेडेंशियल और क्षेत्र (EU या AU) प्रदान कर सकते हैं:

{
  "mcpServers": {
    "Sinch Engage": {
      "command": "node",
      "args": ["/path/to/sinch-engage-mcp-server/src/index.js"],
      "env": {
        "SINCH_ENGAGE_API_KEY": "<your-key>",
        "SINCH_ENGAGE_API_SECRET": "<your-secret>",
        "SINCH_ENGAGE_REGION": "<region>",
        "MCP_TOOL_CATEGORIES": "reporting, contacts, messaging",
        "MCP_TOOL_MODES": "read, write, delete"
      }
    }
  }
}

चरण 4: (वैकल्पिक) MCP सर्वर में उपलब्ध उपकरणों को फ़िल्टर करें

बहुत अधिक उपकरणों का अर्थ है बड़ा संदर्भ, अधिक टोकन उपयोग और LLM के लिए उपयोग करने के लिए सही उपकरण का चयन करने में अधिक भ्रम।
आप Claude Desktop कॉन्फ़िगरेशन विकल्पों में MCP_TOOL_CATEGORIES प्रदान करके MCP सर्वर में उपलब्ध उपकरणों को फ़िल्टर कर सकते हैं।

यदि आप अनुमति के आधार पर उपकरणों को फ़िल्टर करना चाहते हैं, तो आप MCP_TOOL_MODES का उपयोग केवल उन उपकरणों को चुनने के लिए कर सकते हैं जो डेटा पढ़ सकते हैं, लिख सकते हैं या हटा सकते हैं या उनका कोई भी संयोजन कर सकते हैं।