अवलोकन
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 सर्वर (API संचालन निष्पादित करने के लिए) के अलावा, हम डोडो ज्ञान MCP प्रदान करते हैं - एक सेमांटिक सर्च सर्वर जो AI सहायक को डोडो भुगतान दस्तावेज़ और ज्ञान आधार तक त्वरित पहुंच प्रदान करता है।ContextMCP.ai के साथ निर्मित: डोडो ज्ञान MCP को ContextMCP द्वारा संचालित किया जाता है, जो हमारे दस्तावेज़ों में वेक्टर एम्बेडिंग का उपयोग करके तेज़ सेमांटिक सर्च सक्षम करता है।
डोडो ज्ञान MCP क्या है?
डोडो ज्ञान MCP एक दूरस्थ MCP सर्वर है जो प्रदान करता है:- सेमांटिक दस्तावेज़ खोज: प्राकृतिक भाषा प्रश्नों का उपयोग करके प्रासंगिक दस्तावेज़ खोजें
- संदर्भात्मक उत्तर: AI सहायक को डोडो भुगतान के बारे में सटीक, अद्यतन जानकारी मिलती है
- शून्य सेटअप: कोई API कुंजी या स्थानीय स्थापना की आवश्यकता नहीं - बस कनेक्ट करें और प्रश्न पूछना शुरू करें
त्वरित सेटअप
अपने AI क्लाइंट में डोडो ज्ञान MCP से कनेक्ट करें:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
~/.cursor/mcp.json में जोड़ें:Node.js 18 या उच्चतर की आवश्यकता है।
mcp-remote पैकेज दूरस्थ MCP सर्वर से कनेक्शन को संभालता है।दोनों MCP सर्वरों का एक साथ उपयोग करना
AI-सहायता प्राप्त विकास अनुभव के लिए, हम दोनों MCP सर्वरों का उपयोग करने की सिफारिश करते हैं:| सर्वर | उद्देश्य | उपयोग का मामला |
|---|---|---|
| डोडो ज्ञान MCP | दस्तावेज़ खोज | ”मैं वेबहुक को कैसे संभालूं?”, “कौन से भुगतान विधियाँ समर्थित हैं?” |
| डोडो भुगतान MCP | API संचालन | भुगतान बनाना, सदस्यता प्रबंधित करना, रिफंड संभालना |
ज्ञान MCP समस्या निवारण
यदि आप कनेक्शन समस्याओं का सामना करते हैं:- MCP प्रमाणीकरण कैश साफ़ करें:
rm -rf ~/.mcp-auth - अपने क्लाइंट एप्लिकेशन को पुनः प्रारंभ करें
- त्रुटि संदेशों के लिए क्लाइंट लॉग की जांच करें
- Node.js संस्करण सत्यापित करें: Node.js 18+ की आवश्यकता है
ज्ञान MCP सर्वर
डोडो ज्ञान MCP कॉन्फ़िगरेशन पृष्ठ तक पहुँचें
स्थापना
अपने कार्यप्रवाह के लिए सबसे उपयुक्त स्थापना विधि चुनें।दूरस्थ MCP सर्वर (अनुशंसित)
कोई स्थानीय सेटअप या स्थापना के बिना होस्ट किए गए MCP सर्वर तक पहुँचें। यह शुरू करने का सबसे तेज़ तरीका है।1
दूरस्थ सर्वर तक पहुँचें
अपने ब्राउज़र में https://mcp.dodopayments.com पर जाएं।
2
अपने MCP क्लाइंट को कॉन्फ़िगर करें
अपने विशिष्ट क्लाइंट के लिए प्रदान की गई JSON कॉन्फ़िगरेशन की कॉपी करें। कर्सर या क्लॉड डेस्कटॉप के लिए, इसे अपने MCP सेटिंग्स में जोड़ें:
3
प्रमाणित करें और कॉन्फ़िगर करें
OAuth प्रवाह आपको प्रेरित करेगा:
- अपना डोडो भुगतान API कुंजी दर्ज करें
- अपने वातावरण का चयन करें (परीक्षण या लाइव)
- अपने MCP क्लाइंट प्रकार का चयन करें
4
सेटअप पूरा करें
कनेक्शन को अधिकृत करने के लिए लॉगिन और अनुमोदन पर क्लिक करें।
एक बार कनेक्ट होने पर, आपका AI सहायक आपके पक्ष में डोडो भुगतान API के साथ बातचीत कर सकता है।
NPM पैकेज
NPM का उपयोग करके स्थानीय रूप से MCP सर्वर स्थापित और चलाएँ।- NPX (कोई स्थापना नहीं)
- MCP क्लाइंट कॉन्फ़िगरेशन
डॉकर
संगठित तैनाती के लिए कंटेनरयुक्त वातावरण में MCP सर्वर चलाएँ।डॉकर छवियाँ GitHub कंटेनर रजिस्ट्री पर उपलब्ध हैं।
क्लाइंट कॉन्फ़िगरेशन
अपने पसंदीदा AI क्लाइंट में डोडो भुगतान MCP सर्वर को कॉन्फ़िगर करें।- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- अन्य क्लाइंट्स
कर्सर में डोडो भुगतान MCP सर्वर सेट करें ताकि आपके भुगतान डेटा तक संवादात्मक पहुंच सक्षम हो सके।एक-क्लिक स्थापनानीचे दिए गए बटन का उपयोग करके सीधे कर्सर में MCP सर्वर स्थापित करें:[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)क्लिक करने के बाद, कर्सर की
mcp.json में अपने वातावरण चर सेट करें कर्सर सेटिंग्स > उपकरण और MCP > नया MCP सर्वर।मैनुअल कॉन्फ़िगरेशन1
कर्सर सेटिंग्स खोलें
कर्सर सेटिंग्स > विशेषताएँ > मॉडल संदर्भ प्रोटोकॉल पर जाएं या
Cmd/Ctrl + Shift + P दबाएं और “MCP सेटिंग्स” के लिए खोजें।2
कॉन्फ़िगरेशन संपादित करें
mcp_config.json फ़ाइल खोलने के लिए कॉन्फ़िग संपादित करें पर क्लिक करें।3
डोडो भुगतान कॉन्फ़िगरेशन जोड़ें
निम्नलिखित कॉन्फ़िगरेशन में से एक चुनें:दूरस्थ सर्वर (अनुशंसित)स्थानीय NPX
4
सहेजें और पुनः प्रारंभ करें
कॉन्फ़िगरेशन फ़ाइल को सहेजें और कर्सर को पुनः प्रारंभ करें।
अपने डोडो भुगतान डेटा के बारे में AI सहायक से पूछकर कनेक्शन की पुष्टि करें।
वातावरण चर
पर्यावरण चर का उपयोग करके MCP सर्वर के व्यवहार को कॉन्फ़िगर करें।| चर | विवरण | आवश्यक |
|---|---|---|
DODO_PAYMENTS_API_KEY | आपका डोडो भुगतान API कुंजी | हाँ |
DODO_PAYMENTS_WEBHOOK_KEY | आपकी वेबहुक साइनिंग कुंजी | नहीं |
DODO_PAYMENTS_ENVIRONMENT | उत्पादन के लिए live_mode पर सेट करें | नहीं |
दूरस्थ रूप से चलाना
वेब-आधारित क्लाइंट्स या एजेंटिक वर्कफ़्लो के लिए MCP सर्वर को एक दूरस्थ HTTP सर्वर के रूप में तैनात करें।दूरस्थ सर्वर कॉन्फ़िगरेशन
एक बार तैनात होने पर, क्लाइंट सर्वर URL का उपयोग करके कनेक्ट कर सकते हैं:प्राधिकरण हेडर
दूरस्थ सर्वर निम्नलिखित हेडर के माध्यम से प्रमाणीकरण स्वीकार करता है:| हेडर | विवरण |
|---|---|
Authorization | बियरर टोकन प्रमाणीकरण |
x-dodo-payments-api-key | सीधे API कुंजी हेडर |
क्लाइंट क्षमताएँ
विभिन्न MCP क्लाइंट्स के MCP विनिर्देशन के लिए समर्थन के विभिन्न स्तर हैं। सर्वर स्वचालित रूप से इन सीमाओं के चारों ओर काम करने के लिए उपकरण स्कीमा को समायोजित कर सकता है।उपलब्ध क्लाइंट प्रीसेट्स
| क्लाइंट | विवरण |
|---|---|
infer | स्वचालित रूप से क्लाइंट का पता लगाना (डिफ़ॉल्ट) |
cursor | कर्सर संपादक |
claude | क्लॉड AI वेब या डेस्कटॉप |
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 कुंजी उत्पन्न करें और अपने डोडो भुगतान डैशबोर्ड के माध्यम से पुराने को रद्द करें।विकास के लिए परीक्षण कुंजियाँ उपयोग करेंउत्पादन डेटा को प्रभावित करने से बचने के लिए विकास के दौरान हमेशा परीक्षण मोड API कुंजियों का उपयोग करें।
एक्सेस नियंत्रण
एक्सेस नियंत्रण
उत्पादन में उपकरण फ़िल्टरिंग लागू करेंअपने AI सहायक को केवल वही संचालन प्रदर्शित करें जो आवश्यक हैं।दूरस्थ सर्वरों के लिए प्रमाणीकरण लागू करेंजब दूरस्थ रूप से तैनात किया जाए, तो हमेशा
Authorization हेडर या x-dodo-payments-api-key हेडर के माध्यम से प्रमाणीकरण की आवश्यकता करें।API उपयोग की निगरानी करेंअपने डोडो भुगतान डैशबोर्ड के माध्यम से MCP सर्वर की गतिविधि को ट्रैक करें और असामान्य पैटर्न के लिए अलर्ट सेट करें।नेटवर्क सुरक्षा
नेटवर्क सुरक्षा
दूरस्थ सर्वरों के लिए HTTPS का उपयोग करेंहमेशा HTTPS एंडपॉइंट के पीछे दूरस्थ MCP सर्वरों को तैनात करें।रेट लिमिटिंग लागू करेंMCP सर्वर और API स्तरों पर दुरुपयोग से बचाने के लिए दर सीमाएँ लागू करें।नेटवर्क पहुंच को प्रतिबंधित करेंअपने MCP सर्वर से कनेक्ट करने के लिए किन क्लाइंट्स को सीमित करने के लिए फ़ायरवॉल नियम कॉन्फ़िगर करें।
समस्या निवारण
कनेक्शन समस्याएँ
कनेक्शन समस्याएँ
अपनी API कुंजी सत्यापित करेंसुनिश्चित करें कि आपकी API कुंजी सही ढंग से सेट है और आवश्यक अनुमतियाँ हैं।अपने नेटवर्क कनेक्शन की जांच करेंसुनिश्चित करें कि आप डोडो भुगतान API एंडपॉइंट्स तक पहुँच सकते हैं।क्लाइंट लॉग की समीक्षा करेंकनेक्शन समस्याओं का निदान करने के लिए अपने MCP क्लाइंट में विस्तृत लॉगिंग सक्षम करें।
प्रमाणीकरण त्रुटियाँ
प्रमाणीकरण त्रुटियाँ
API कुंजी वातावरण की पुष्टि करेंसुनिश्चित करें कि आप परीक्षण कुंजियों का उपयोग कर रहे हैं परीक्षण एंडपॉइंट्स के साथ और उत्पादन एंडपॉइंट्स के साथ लाइव कुंजियाँ।पर्यावरण चर की जांच करेंसुनिश्चित करें कि
DODO_PAYMENTS_ENVIRONMENT सही ढंग से सेट है (उत्पादन के लिए live_mode)।क्रेडेंशियल्स को फिर से उत्पन्न करेंयदि समस्याएँ बनी रहती हैं, तो अपने डैशबोर्ड के माध्यम से एक नई API कुंजी उत्पन्न करें।उपकरण निष्पादन विफलताएँ
उपकरण निष्पादन विफलताएँ
इनपुट पैरामीटर मान्य करेंसुनिश्चित करें कि AI सहायक प्रत्येक उपकरण के लिए सही स्वरूपित पैरामीटर प्रदान कर रहा है।त्रुटि संदेशों की समीक्षा करेंदेखें कि API से त्रुटि प्रतिक्रिया में क्या गलत हुआ है।API के साथ सीधे परीक्षण करेंसुनिश्चित करें कि संचालन डोडो भुगतान API को सीधे curl या Postman के माध्यम से कॉल करते समय काम करता है।
क्लाइंट संगतता समस्याएँ
क्लाइंट संगतता समस्याएँ
एक अलग क्लाइंट प्रीसेट आज़माएँयदि उपकरण सही ढंग से काम नहीं कर रहे हैं, तो अपने क्लाइंट को स्पष्ट रूप से निर्दिष्ट करने का प्रयास करें:क्षमता समर्थन की जांच करेंकुछ क्लाइंट सभी JSON स्कीमा सुविधाओं का समर्थन नहीं करते हैं। यह समझने के लिए
--describe-capabilities का उपयोग करें कि क्या समर्थित है।