MCP
VS Code में Mailera इस्तेमाल करें
.vscode/mcp.json में Mailera जोड़ें, ताकि Agent मोड में Copilot Chat आपके मेलबॉक्स ऐक्सेस कर सके। VS Code पहली बार इस्तेमाल करते समय आपकी API key माँगता है और उसे सीक्रेट के रूप में सेव करता है, ताकि वह कॉन्फ़िगरेशन फ़ाइल में न रहे।
VS Code के आधिकारिक दस्तावेज़शुरू करने से पहले
- मुफ़्त वर्कस्पेस बनाएँ और कम से कम एक मेलबॉक्स कनेक्ट करें।
- सेटिंग्स → API key पर जाएँ, API key बनाएँ और अनुमतियाँ चुनें। शुरुआत के लिए read अनुमति काफ़ी है।
- API key बनाते ही उसे कॉपी करें — Mailera पूरी API key सिर्फ़ एक बार दिखाता है।
सेटअप
- अपने वर्कस्पेस में .vscode/mcp.json बनाएँ, या सभी वर्कस्पेस में इस्तेमाल करने के लिए MCP: Open User Configuration चलाएँ।
- नीचे दिया गया कॉन्फ़िगरेशन पेस्ट करें। पहली बार चलाने पर VS Code आपकी Mailera API key माँगता है और उसे सीक्रेट के रूप में सेव करता है।
- Chat को Agent मोड में खोलें और टूल आइकन पर क्लिक करें: सूची में mailera के टूल दिखने चाहिए।
.vscode/mcp.json
{ "inputs": [ { "type": "promptString", "id": "mailera-api-key", "description": "Mailera API key", "password": true } ], "servers": { "mailera": { "type": "http", "url": "https://mailera.app/api/public/v1/mcp", "headers": { "Authorization": "Bearer ${input:mailera-api-key}" } } }}फ़ाइल में कोई API key नहीं है, इसलिए आप इसे कमिट करके पूरी टीम के साथ साझा कर सकते हैं; हर व्यक्ति अपनी API key दर्ज करता है।
कनेक्शन जाँचें
एजेंट से कहें: “मेरे Mailera मेलबॉक्स की सूची दिखाएँ”। एजेंट list_mailboxes को कॉल करके आपके मेलबॉक्स और उनकी सिंक स्थिति दिखाता है। फिर कहें: “noreply@… से आया सबसे नया ईमेल खोजें और OTP निकालें”।
टूल सूची और सुरक्षा मार्गदर्शनआम त्रुटियाँ
- 401 unauthorized
- API key अमान्य है, रद्द कर दी गई है या Bearer गायब है। हेडर ऐसा होना चाहिए: Authorization: Bearer mh_live_…
- send_email या rescue_spam नहीं मिल रहा
- API key में ज़रूरी अनुमतियाँ (send, move) नहीं हैं। Mailera केवल उसकी अनुमतियों से मेल खाने वाले टूल दिखाता है — अपनी ज़रूरत की अनुमतियों के साथ नई API key बनाएँ।
- एजेंट को कोई मेलबॉक्स नहीं मिल रहा
- API key ऐसे समूह तक सीमित है जिसमें कोई मेलबॉक्स नहीं है, या वर्कस्पेस में कोई मेलबॉक्स कनेक्ट नहीं है।
- 429 rate_limited
- इस API key ने प्रति मिनट 300 अनुरोधों की सीमा पार कर दी है। Retry-After में बताए गए सेकंड तक प्रतीक्षा करें, फिर दोबारा कोशिश करें।
VS Code में Mailera इस्तेमाल करें
सेटिंग्स → API key पर जाएँ, API key बनाएँ और अनुमतियाँ चुनें। शुरुआत के लिए read अनुमति काफ़ी है।

