Elastic Email MCP

नोट! ऊपर दिया गया वीडियो API key के साथ authorization का केवल एक तरीका दिखाता है।

MCP server address, https://mcp.elasticemail.com, का उपयोग केवल AI agents को जोड़ने के लिए किया जाता है। यह Elastic Email REST API का address नहीं है और इसे अन्य integrations में API host के रूप में उपयोग नहीं किया जा सकता। API address के लिए, लेख " API Settings " देखें।

MCP को लागू करके, Elastic Email AI agents को सुरक्षा और उचित authentication बनाए रखते हुए आपके email operations तक पहुँचने और उन्हें नियंत्रित करने की अनुमति देता है।

हमारा MCP आपके लिए जो उपलब्ध actions कर सकेगा

• किसी list में contact जोड़ें
• Contacts upload करें और जोड़ें
• एक list बनाएँ
• एक segment बनाएँ
• एक campaign बनाएँ
• Campaigns प्राप्त करें
• एक campaign अपडेट करें
• एक campaign रोकें
• Campaigns की सूची बनाएँ
• Emails भेजें: transactional और bulk दोनों
• Contact, contacts, list से contact प्राप्त करें
• Lists प्राप्त करें
• Templates प्राप्त करें
• Segments प्राप्त करें
• Is ready (health check, connection और readiness check)
• List से contact हटाएँ
• Account से contact हटाएँ

कृपया ध्यान दें कि सूचीबद्ध सभी endpoints Elastic Email के सभी pricing plans के लिए उपलब्ध नहीं हैं। उदाहरण के लिए - campaigns और contacts endpoints Email API plans के लिए उपलब्ध नहीं हैं। ऊपर सूचीबद्ध features पर हमारे उपलब्ध लेखों की पूरी सूची यहाँ है:

https://help.elasticemail.com/en/articles/4984897-contact-lists-and-segments

https://help.elasticemail.com/en/articles/5472509-how-to-send-your-first-campaign

http://help.elasticemail.com/en/articles/2300606-how-to-manage-templates

Setup

हमारे MCP server से जुड़ने के लिए आप MCP का समर्थन करने वाला कोई भी AI Agent उपयोग कर सकते हैं। किसी भी setup के लिए मुख्य आवश्यकता "agent mode" का समर्थन है, जो AI agent को बाहरी services के साथ सुरक्षित रूप से programmatically interact करने की अनुमति देता है।

हमने VS Code और Github Copilot tools का उपयोग करके एक उदाहरण step by step setup तैयार किया है।

• https://github.com आपको Github में एक मुफ़्त account बनाना होगा
• https://code.visualstudio.com/ इस website से VS Code डाउनलोड करें

अगला कदम, आपको अपना Github account VS Code से जोड़ना होगा

• Github Copilot में Visual Studio Code को authorize करें

• अगले चरण में VS Code को चलाने की अनुमति दें

• Chat window प्रदर्शित करने के लिए VS Code के top menu में View → Chat पर जाएँ। Chat दाईं ओर प्रदर्शित होना चाहिए।

• Chat को Agent Mode में स्विच करें

• अब आप authorization के दो उपलब्ध तरीकों में से एक का उपयोग कर सकते हैं:

1. Elastic Email में एक API key बनाएँ। देखने और संशोधित करने के लिए आवश्यक permissions इस प्रकार हैं: Account, Templates, Campaigns, Contacts, Files, Send HTTP। इसके अतिरिक्त, Access Tokens तक कम से कम "view" access आवश्यक है। कृपया याद रखें कि अपनी API Key को अनधिकृत तृतीय पक्षों के साथ **कभी भी** साझा न करें!

2. OAuth authorization method का उपयोग करें। बस अगले निर्देश चरणों का पालन करें और X-Auth-Token वाले headers section को जोड़ना छोड़ दें। जब आप तैयार हों, तो MCP server से connection शुरू करें: configuration file में elasticemail.mcp के ऊपर Start पर क्लिक करें और VS Code को oidc.elasticemail.com के माध्यम से authenticate करने दें।

आपको login page पर redirect किया जाएगा। सफल login के बाद आपको स्वचालित रूप से VS Code पर वापस redirect किया जाएगा। यदि ऐसा नहीं होता है, तो page पर प्रदर्शित निर्देश का पालन करें:

• VS Code top bar में search function का उपयोग करके खोजें: Show and run commands
• उपलब्ध options को कम करने के लिए आप search field में "MCP" लिख सकते हैं और " MCP: Open user configuration" चुनें।
• नीचे दिए गए configuration text को paste करें (यदि आपके पास पहले से कोई servers हैं तो केवल elasticemail.mcp data पर्याप्त होगा)
• Headers section का उपयोग अपनी API key के साथ केवल तब करें जब आप authorization के लिए key method का उपयोग करना चाहते हैं। यदि आप OAuth method का उपयोग कर रहे हैं तो इसे हटा दें।

{
    "servers": {
        "elasticemail.mcp": {
            "url": "https://mcp.elasticemail.com",
            "headers": {
                "X-Auth-Token": "your_api_key"
            }
        }
    }
}

कृपया ध्यान दें कि यहाँ सबसे महत्वपूर्ण चरण है अपनी वास्तविक API Key को ऊपर बताई गई permissions के साथ दर्ज करना। साथ ही कृपया सुनिश्चित करें कि इस field को संशोधित करने के बाद आगे बढ़ने से पहले आपने changes को save किया है। Changes save किए बिना integration को "start" करने का option प्रदर्शित नहीं होगा।

• अब आप MCP server से connection शुरू कर सकते हैं: configuration file में elasticemail.mcp के ऊपर Start पर क्लिक करें।

अब से आप chat window के अंदर Elastic Email MCP server द्वारा प्रदान किए गए actions का उपयोग कर सकते हैं। ये actions इस लेख की शुरुआत में बताए गए थे।

आप यह सुनिश्चित करने के लिए अपना पहला command आज़मा सकते हैं कि integration काम करता है। उदाहरण के रूप में आप "Is MCP working" prompt दर्ज कर सकते हैं और यदि सब कुछ ठीक से काम कर रहा है तो आपको reply में एक confirmation मिलनी चाहिए।

Elastic Email के अंत में इस प्रकार का integration कैसे काम करता है, इसकी अधिक समझ के लिए, हमारे API Documentation को भी देखें:

https://elasticemail.com/developers/api-documentation/rest-api

सुझाव

1. AI agents कुछ पिछले instructions को याद रखने और उन्हें दोबारा आज़माने में अटक सकते हैं। ऐसी समस्याओं को हल करने के लिए नया chat session शुरू करना उपयोगी होता है। साथ ही आप Agent को tools दोबारा fetch करने का निर्देश दे सकते हैं और बता सकते हैं कि server पर changes हुए हैं ताकि यह सुनिश्चित हो कि वह वास्तव में नया data दोबारा fetch करे।
2. Prompt जितना अधिक सटीक होगा, आप LLM के लिए interpretation के लिए उतनी ही कम गुंजाइश छोड़ेंगे, जिससे hallucination से जुड़ी समस्याएँ कम होंगी।
3. Requests भेजने से पहले उनकी समीक्षा करना उपयोगी होता है, क्योंकि आप देख सकते हैं कि LLM ने आपके request को API calls में कैसे अनुवादित किया, जिसमें संभावित असंगतियाँ हो सकती हैं।

अन्य AI agents में MCP को जोड़ना

ऊपर दिया गया setup VS Code और GitHub Copilot का उपयोग करता है, लेकिन वही server address किसी भी AI agent के साथ काम करता है जो MCP का समर्थन करता है और agent mode में चल सकता है। Claude पर आधारित step by step उदाहरण के लिए, देखें How to connect the Elastic Email MCP server to Claude.