अवलोकन
Model Context Protocol (MCP) एक ओपन स्टैंडर्ड है जो AI अनुप्रयोगों को सुरक्षित रूप से बाहरी डेटा स्रोतों और APIs से कनेक्ट करने की अनुमति देता है। Dodo Payments MCP सर्वर AI सहायकों जैसे Claude, Cursor, और अन्य MCP-संगत क्लाइंट्स को आपके भुगतान बुनियादी ढांचे तक संरचित पहुंच प्रदान करता है। Dodo Payments MCP सर्वर Stainless के साथ बनाया गया है और Code Mode आर्किटेक्चर का उपयोग करता है, जो AI एजेंटों को Dodo Payments SDK के खिलाफ TypeScript कोड लिखने और निष्पादित करने की अनुमति देता है, एक अलग सैंडबॉक्स वातावरण में।प्रमुख क्षमताएँ
- भुगतान संचालन: भुगतान और रिफंड बनाना, पुनः प्राप्त करना और प्रबंधित करना
- सदस्यता प्रबंधन: आवर्ती बिलिंग, अपग्रेड और रद्दीकरण को संभालना
- ग्राहक प्रशासन: ग्राहक डेटा और पोर्टल पहुंच का प्रबंधन करना
- उत्पाद कैटलॉग: उत्पादों, मूल्य निर्धारण और छूट को बनाना और अपडेट करना
- लाइसेंस प्रबंधन: सॉफ़्टवेयर लाइसेंस को सक्रिय, मान्य और प्रबंधित करना
- उपयोग-आधारित बिलिंग: मीटर किए गए उपयोग के लिए ट्रैक और बिल करना
कोड मोड कैसे काम करता है
Dodo Payments MCP सर्वर कोड मोड का उपयोग करता है, जो आपके AI एजेंट को दो शक्तिशाली उपकरण प्रदान करता है:- Docs खोज उपकरण: Dodo Payments API और SDK के बारे में दस्तावेज़ों को क्वेरी करें ताकि उपलब्ध संचालन और पैरामीटर को समझा जा सके
- कोड निष्पादन उपकरण: SDK के खिलाफ TypeScript कोड लिखें जो एक सुरक्षित सैंडबॉक्स वातावरण में निष्पादित होता है, बिना वेब या फ़ाइल प्रणाली की पहुंच के
स्थापना
उस स्थापना विधि का चयन करें जो आपके कार्यप्रवाह के लिए सबसे उपयुक्त हो।दूरस्थ MCP सर्वर (अनुशंसित)
स्थानीय सेटअप या स्थापना के बिना होस्ट किए गए MCP सर्वर तक पहुंचें। यह शुरू करने का सबसे तेज़ तरीका है।1
दूरस्थ सर्वर तक पहुंचें
अपने ब्राउज़र में https://mcp.dodopayments.com पर जाएं।
2
अपने MCP क्लाइंट को कॉन्फ़िगर करें
अपने विशिष्ट क्लाइंट के लिए प्रदान की गई JSON कॉन्फ़िगरेशन को कॉपी करें। Cursor या Claude Desktop के लिए, इसे अपने MCP सेटिंग्स में जोड़ें:
3
प्रमाणित और कॉन्फ़िगर करें
OAuth प्रवाह आपको संकेत देगा:
- अपना Dodo Payments API कुंजी दर्ज करें
- अपने वातावरण का चयन करें (परीक्षण या लाइव)
- अपने MCP क्लाइंट प्रकार का चयन करें
4
सेटअप पूरा करें
कनेक्शन को अधिकृत करने के लिए लॉगिन और अनुमोदन पर क्लिक करें।
एक बार कनेक्ट होने पर, आपका AI सहायक आपके पक्ष में Dodo Payments API के साथ बातचीत कर सकता है।
NPM पैकेज
NPM का उपयोग करके स्थानीय रूप से MCP सर्वर स्थापित और चलाएँ।- NPX (कोई स्थापना नहीं)
- MCP क्लाइंट कॉन्फ़िगरेशन
डॉकर
संगत तैनाती के लिए कंटेनरयुक्त वातावरण में MCP सर्वर चलाएँ।Docker छवियाँ GitHub कंटेनर रजिस्ट्री पर उपलब्ध हैं।
क्लाइंट कॉन्फ़िगरेशन
अपने पसंदीदा AI क्लाइंट में Dodo Payments MCP सर्वर को कॉन्फ़िगर करें।- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- अन्य क्लाइंट्स
Dodo Payments MCP सर्वर को Cursor में सेट करें ताकि आपके भुगतान डेटा तक संवादात्मक पहुंच सक्षम हो सके।एक-क्लिक स्थापनानीचे दिए गए बटन का उपयोग करके MCP सर्वर को सीधे Cursor में स्थापित करें:[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)क्लिक करने के बाद, Cursor की
mcp.json में अपने वातावरण चर सेट करें। Cursor सेटिंग्स > उपकरण और MCP > नया MCP सर्वर।मैनुअल कॉन्फ़िगरेशन1
Cursor सेटिंग्स खोलें
Cursor सेटिंग्स > विशेषताएँ > Model Context Protocol पर जाएं या
Cmd/Ctrl + Shift + P दबाएं और “MCP सेटिंग्स” के लिए खोजें।2
कॉन्फ़िगरेशन संपादित करें
mcp_config.json फ़ाइल खोलने के लिए कॉन्फ़िग संपादित करें पर क्लिक करें।3
Dodo Payments कॉन्फ़िगरेशन जोड़ें
निम्नलिखित कॉन्फ़िगरेशन में से एक चुनें:दूरस्थ सर्वर (अनुशंसित)स्थानीय NPX
4
सहेजें और पुनः प्रारंभ करें
कॉन्फ़िगरेशन फ़ाइल को सहेजें और Cursor को पुनः प्रारंभ करें।
अपने Dodo Payments डेटा के बारे में AI सहायक से पूछकर कनेक्शन की पुष्टि करें।
वातावरण चर
पर्यावरण चर का उपयोग करके MCP सर्वर के व्यवहार को कॉन्फ़िगर करें।| चर | विवरण | आवश्यक |
|---|---|---|
DODO_PAYMENTS_API_KEY | आपकी Dodo Payments API कुंजी | हाँ |
DODO_PAYMENTS_WEBHOOK_KEY | आपकी वेबहुक साइनिंग कुंजी | नहीं |
DODO_PAYMENTS_ENVIRONMENT | उत्पादन के लिए live_mode पर सेट करें | नहीं |
दूरस्थ रूप से चलाना
वेब-आधारित क्लाइंट्स या एजेंटिक कार्यप्रवाहों के लिए MCP सर्वर को एक दूरस्थ HTTP सर्वर के रूप में तैनात करें।दूरस्थ सर्वर कॉन्फ़िगरेशन
एक बार तैनात होने पर, क्लाइंट सर्वर URL का उपयोग करके कनेक्ट कर सकते हैं:प्राधिकरण हेडर
दूरस्थ सर्वर निम्नलिखित हेडर के माध्यम से प्रमाणीकरण स्वीकार करता है:| हेडर | विवरण |
|---|---|
Authorization | बियरर टोकन प्रमाणीकरण |
x-dodo-payments-api-key | सीधे API कुंजी हेडर |
क्लाइंट क्षमताएँ
विभिन्न MCP क्लाइंट्स के MCP विनिर्देशन के लिए विभिन्न स्तरों का समर्थन होता है। सर्वर स्वचालित रूप से इन सीमाओं के चारों ओर काम करने के लिए उपकरण स्कीमा को समायोजित कर सकता है।उपलब्ध क्लाइंट प्रीसेट्स
| क्लाइंट | विवरण |
|---|---|
infer | ऑटो-डिटेक्ट क्लाइंट (डिफ़ॉल्ट) |
cursor | Cursor संपादक |
claude | Claude AI वेब या डेस्कटॉप |
claude-code | Claude Code CLI |
openai-agents | OpenAI एजेंट प्लेटफ़ॉर्म |
मैनुअल क्षमता कॉन्फ़िगरेशन
उपरोक्त सूचीबद्ध क्लाइंट्स के लिए, क्षमताओं को मैन्युअल रूप से कॉन्फ़िगर करें:top-level-unions- शीर्ष-स्तरीय संघ प्रकारों के लिए समर्थनvalid-json- सही JSON स्ट्रिंग तर्क पार्सिंगrefs- स्कीमाओं में $ref प्वाइंटर्स के लिए समर्थनunions- संघ प्रकारों (anyOf) के लिए समर्थनformats- प्रारूप मान्यताओं के लिए समर्थनtool-name-length=N- अधिकतम उपकरण नाम लंबाई
उपकरण फ़िल्टरिंग
अपने AI सहायक के लिए प्रदर्शन को अनुकूलित करने और सुरक्षा बनाए रखने के लिए कौन से API संचालन प्रदर्शित किए जाते हैं, इसे नियंत्रित करें।संचालन प्रकार द्वारा फ़िल्टर करें
पढ़ने के लिए केवल या लिखने के संचालन तक पहुंच को प्रतिबंधित करें।संसाधन द्वारा फ़िल्टर करें
विशिष्ट API संसाधनों के लिए उपकरणों को सीमित करें।विशिष्ट उपकरणों को शामिल या बाहर करें
कौन से व्यक्तिगत उपकरण उपलब्ध हैं, इसे ठीक से ट्यून करें।फ़िल्टर संयोजित करें
सटीक नियंत्रण के लिए एक साथ कई फ़िल्टर लागू करें।URL क्वेरी पैरामीटर फ़िल्टरिंग (दूरस्थ सर्वर)
दूरस्थ सर्वर का उपयोग करते समय, URL क्वेरी पैरामीटर के माध्यम से फ़िल्टर लागू करें:गतिशील उपकरण मोड
बड़े APIs के लिए, सभी उपकरणों को एक साथ लोड करना AI के संदर्भ विंडो को अभिभूत कर सकता है। गतिशील उपकरण मोड एक अधिक कुशल विकल्प प्रदान करता है।list_api_endpoints- वैकल्पिक फ़िल्टरिंग के साथ उपलब्ध विधियों का पता लगाता हैget_api_endpoint_schema- एक विशिष्ट विधि के लिए विस्तृत स्कीमा प्राप्त करता हैinvoke_api_endpoint- उचित पैरामीटर के साथ किसी भी विधि को निष्पादित करता है
50 से अधिक विधियों वाले APIs के लिए गतिशील उपकरण स्वचालित रूप से सक्षम होते हैं। सभी उपकरणों को शामिल करने के लिए
--tools=all के साथ ओवरराइड करें।उन्नत उपयोग
प्रोग्रामेटिक एकीकरण
कस्टम MCP सर्वर बनाएं या मौजूदा को प्रोग्रामेटिक रूप से बढ़ाएं।कस्टम उपकरण विकास
अपने उपकरणों और व्यावसायिक तर्क के साथ MCP सर्वर का विस्तार करें।सुरक्षा सर्वोत्तम प्रथाएँ
अपनी API क्रेडेंशियल्स की सुरक्षा करें और सुरक्षित एकीकरण बनाए रखें।API कुंजी प्रबंधन
API कुंजी प्रबंधन
कभी भी क्रेडेंशियल्स को संस्करण नियंत्रण में न डालेंAPI कुंजी को वातावरण चर या सुरक्षित सीक्रेट प्रबंधन प्रणालियों में स्टोर करें।नियमित रूप से कुंजी बदलेंनियमित रूप से नई API कुंजी उत्पन्न करें और अपनी Dodo Payments डैशबोर्ड के माध्यम से पुरानी को रद्द करें।विकास के लिए परीक्षण कुंजी का उपयोग करेंउत्पादन डेटा को प्रभावित करने से बचने के लिए विकास के दौरान हमेशा परीक्षण मोड API कुंजी का उपयोग करें।
एक्सेस नियंत्रण
एक्सेस नियंत्रण
उत्पादन में उपकरण फ़िल्टरिंग लागू करेंकेवल वही संचालन प्रदर्शित करें जो आपके AI सहायक को आवश्यक हैं।दूरस्थ सर्वरों के लिए प्रमाणीकरण लागू करेंजब दूरस्थ रूप से तैनात किया जाए, तो हमेशा
Authorization हेडर या x-dodo-payments-api-key हेडर के माध्यम से प्रमाणीकरण की आवश्यकता करें।API उपयोग की निगरानी करेंअपनी Dodo Payments डैशबोर्ड के माध्यम से MCP सर्वर गतिविधि को ट्रैक करें और असामान्य पैटर्न के लिए अलर्ट सेट करें।नेटवर्क सुरक्षा
नेटवर्क सुरक्षा
दूरस्थ सर्वरों के लिए HTTPS का उपयोग करेंहमेशा HTTPS एंडपॉइंट के पीछे दूरस्थ MCP सर्वरों को तैनात करें।रेट लिमिटिंग लागू करेंMCP सर्वर और API स्तरों पर रेट सीमाएँ लागू करके दुरुपयोग से सुरक्षा करें।नेटवर्क पहुंच को प्रतिबंधित करेंअपने MCP सर्वर से कनेक्ट करने के लिए क्लाइंट्स को सीमित करने के लिए फ़ायरवॉल नियम कॉन्फ़िगर करें।
समस्या निवारण
कनेक्शन समस्याएँ
कनेक्शन समस्याएँ
अपनी API कुंजी की पुष्टि करेंसुनिश्चित करें कि आपकी API कुंजी सही ढंग से सेट है और आवश्यक अनुमतियाँ हैं।अपनी नेटवर्क कनेक्शन की जांच करेंसुनिश्चित करें कि आप Dodo Payments API एंडपॉइंट्स तक पहुँच सकते हैं।क्लाइंट लॉग की समीक्षा करेंकनेक्शन समस्याओं का निदान करने के लिए अपने MCP क्लाइंट में विस्तृत लॉगिंग सक्षम करें।
प्रमाणीकरण त्रुटियाँ
प्रमाणीकरण त्रुटियाँ
API कुंजी वातावरण की पुष्टि करेंसुनिश्चित करें कि आप परीक्षण कुंजी परीक्षण एंडपॉइंट्स के साथ और लाइव कुंजी उत्पादन एंडपॉइंट्स के साथ उपयोग कर रहे हैं।पर्यावरण चर की जांच करेंसुनिश्चित करें कि
DODO_PAYMENTS_ENVIRONMENT सही ढंग से सेट है (उत्पादन के लिए live_mode)।क्रेडेंशियल्स को फिर से उत्पन्न करेंयदि समस्याएँ बनी रहती हैं, तो अपने डैशबोर्ड के माध्यम से एक नई API कुंजी उत्पन्न करें।उपकरण निष्पादन विफलताएँ
उपकरण निष्पादन विफलताएँ
इनपुट पैरामीटर मान्य करेंसुनिश्चित करें कि AI सहायक प्रत्येक उपकरण के लिए सही स्वरूपित पैरामीटर प्रदान कर रहा है।त्रुटि संदेशों की समीक्षा करेंदेखें कि API से त्रुटि प्रतिक्रिया में क्या गलत हुआ है, इसके लिए विशिष्ट मार्गदर्शन।API के साथ सीधे परीक्षण करेंसुनिश्चित करें कि Dodo Payments API को सीधे curl या Postman के माध्यम से कॉल करने पर संचालन काम करता है।
क्लाइंट संगतता समस्याएँ
क्लाइंट संगतता समस्याएँ
एक अलग क्लाइंट प्रीसेट आज़माएँयदि उपकरण सही ढंग से काम नहीं कर रहे हैं, तो अपने क्लाइंट को स्पष्ट रूप से निर्दिष्ट करने का प्रयास करें:क्षमता समर्थन की जांच करेंकुछ क्लाइंट सभी JSON स्कीमा सुविधाओं का समर्थन नहीं करते हैं। यह समझने के लिए
--describe-capabilities का उपयोग करें कि क्या समर्थित है।