MCP
Cursor में Mailera इस्तेमाल करें
Cursor की mcp.json फ़ाइल में Mailera जोड़ें। Cursor का एजेंट आपके कोड लिखने के दौरान ईमेल पढ़ सकता है, साइनअप टेस्ट में OTP कोड पा सकता है और ईमेल का जवाब दे सकता है।
Cursor के आधिकारिक दस्तावेज़शुरू करने से पहले
- मुफ़्त वर्कस्पेस बनाएँ और कम से कम एक मेलबॉक्स कनेक्ट करें।
- सेटिंग्स → API key पर जाएँ, API key बनाएँ और अनुमतियाँ चुनें। शुरुआत के लिए read अनुमति काफ़ी है।
- API key बनाते ही उसे कॉपी करें — Mailera पूरी API key सिर्फ़ एक बार दिखाता है।
सेटअप
- ~/.cursor/mcp.json बनाएँ (सभी प्रोजेक्ट के लिए) या अपने प्रोजेक्ट फ़ोल्डर में .cursor/mcp.json बनाएँ (सिर्फ़ उस प्रोजेक्ट के लिए)।
- नीचे दिया गया कॉन्फ़िगरेशन पेस्ट करें और अपनी API key डालें। अगर फ़ाइल में पहले से mcpServers है, तो सिर्फ़ mailera ब्लॉक जोड़ें।
- Cursor की सेटिंग्स में MCP सेक्शन खोलें: mailera चालू होना चाहिए और उसके टूल की सूची दिखनी चाहिए।
mh_live_xxx की जगह अपनी API key डालें।
~/.cursor/mcp.json
{ "mcpServers": { "mailera": { "url": "https://mailera.app/api/public/v1/mcp", "headers": { "Authorization": "Bearer mh_live_xxx" } } }}असली API key वाली .cursor/mcp.json को git में कमिट न करें। व्यक्तिगत 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 में बताए गए सेकंड तक प्रतीक्षा करें, फिर दोबारा कोशिश करें।
Cursor में Mailera इस्तेमाल करें
सेटिंग्स → API key पर जाएँ, API key बनाएँ और अनुमतियाँ चुनें। शुरुआत के लिए read अनुमति काफ़ी है।