Overview
The Model Context Protocol (MCP) is an open standard that enables AI applications to securely connect to external data sources and APIs. The Dodo Payments MCP Server provides AI assistants like Claude, Cursor, and other MCP-compatible clients with structured access to your payment infrastructure. Dodo Payments MCP सर्वर कोड मोड वास्तुकला का उपयोग करता है। प्रत्येक API एंडपॉइंट के लिए सैकड़ों व्यक्तिगत टूल्स को उजागर करने के बजाय, कोड मोड AI एजेंट्स को अलग संडबॉक्स वातावरण में Dodo Payments SDK के खिलाफ TypeScript कोड लिखने और निष्पादित करने में सक्षम बनाता है।Key capabilities
- Payment Operations: Create, retrieve, and manage payments and refunds
- Subscription Management: Handle recurring billing, upgrades, and cancellations
- Customer Administration: Manage customer data and portal access
- Product Catalog: Create and update products, pricing, and discounts
- License Management: Activate, validate, and manage software licenses
- Usage-Based Billing: Track and bill for metered usage
How Code Mode Works
Dodo Payments MCP सर्वर आपके AI एजेंट को केवल दो टूल्स प्रदान करता है:- डॉक्स सर्च टूल: Dodo Payments API और SDK के बारे में डॉक्स को क्वेरी करता है ताकि उपलब्ध ऑपरेशंस और पैरामीटर समझे जा सकें।
- कोड निष्पादन टूल: SDK के खिलाफ TypeScript कोड लिखता है जो सुरक्षित संडबॉक्स परिवेश में निष्पादित होता है।
त्वरित सेटअप
अपने AI क्लाइंट में Dodo Payments MCP सर्वर से कनेक्ट करें:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
~/.cursor/mcp.json में जोड़ें:Node.js 18 या उच्चतर की आवश्यकता है। रिमोट सर्वर प्रमाणीकरण के लिए OAuth का उपयोग करता है — पहली कनेक्शन पर आपको अपनी API कुंजी दर्ज करने और अपना वातावरण चुनने के लिए कहा जाएगा।
Dodo Knowledge MCP
Dodo Payments MCP सर्वर (API संचालन निष्पादन के लिए) के अतिरिक्त, हम Dodo Knowledge MCP प्रदान करते हैं—एक सैमान्टिक सर्च सर्वर जो AI सहायकों को Dodo Payments दस्तावेज़ीकरण और ज्ञान आधार तक तुरंत पहुंच देता है।ContextMCP.ai से निर्मित: Dodo Knowledge MCP ContextMCP द्वारा संचालित है, जो हमारे दस्तावेज़ीकरण पर वेक्टर एम्बेडिंग्स का उपयोग करके तेज़ सैमान्टिक खोज सक्षम करता है।
Dodo Knowledge MCP क्या है?
Dodo Knowledge MCP एक रिमोट MCP सर्वर है जो प्रदान करता है:- सैमान्टिक दस्तावेज़ खोज: प्राकृतिक भाषा प्रश्नों का उपयोग करके प्रासंगिक दस्तावेज़ खोजें।
- संदर्भात्मक उत्तर: AI सहायक Dodo Payments के बारे में सटीक, अद्यतित जानकारी प्राप्त करते हैं।
- जीरो सेटअप: कोई API कुंजी या स्थानीय इंस्टॉलेशन आवश्यक नहीं—बस कनेक्ट करें और क्वेरी करना शुरू करें।
त्वरित सेटअप
अपने AI क्लाइंट में Dodo Knowledge MCP से कनेक्ट करें:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
~/.cursor/mcp.json में जोड़ें:Node.js 18 या उच्चतर की आवश्यकता है।
mcp-remote पैकेज रिमोट MCP सर्वर से कनेक्शन को संभालता है।दोनों MCP सर्वरों का एक साथ उपयोग
सबसे अच्छी AI-सहायता प्राप्त विकास अनुभव के लिए, हम दोनों MCP सर्वरों का उपयोग करने की सलाह देते हैं:| Server | Purpose | Use Case |
|---|---|---|
| Dodo Knowledge MCP | दस्तावेज़ खोज | ”मैं वेबहुक को कैसे संभालूँ?”, “कौन से भुगतान तरीक़े समर्थित हैं?” |
| Dodo Payments MCP | API संचालन | भुगतान बनाएं, सब्सक्रिप्शन प्रबंधित करें, रिफंड संभालें |
Knowledge MCP समस्या निवारण
यदि आपको कनेक्शन समस्याएँ होती हैं:- MCP प्रमाणीकरण कैश साफ़ करें:
rm -rf ~/.mcp-auth - अपने क्लाइंट एप्लिकेशन को पुनः प्रारंभ करें
- त्रुटि संदेशों के लिए क्लाइंट लॉग्स जांचें
- Node.js संस्करण सत्यापित करें: Node.js 18+ की आवश्यकता है
Knowledge MCP Server
Dodo Knowledge MCP कॉन्फ़िगरेशन पृष्ठ तक पहुँचें
स्थापना
अपने कार्य प्रवाह के लिए सर्वश्रेष्ठ फिट होने वाली स्थापना विधि चुनें।रिमोट MCP सर्वर (अनुशंसित)
किसी भी स्थानीय सेटअप या इंस्टॉलेशन के बिना होस्ट किए गए MCP सर्वर तक पहुँचें। यह शुरू करने का सबसे तेज़ तरीका है।Access the remote server
अपने ब्राउज़र में https://mcp.dodopayments.com पर नेविगेट करें।
Configure your MCP client
अपनी विशिष्ट क्लाइंट के लिए प्रदान किए गए JSON कॉन्फ़िगरेशन की कॉपी करें। Cursor या Claude Desktop के लिए, इसे अपने MCP सेटिंग्स में जोड़ें:
Authenticate and configure
OAuth फ्लो आपको निम्न कार्य करने के लिए कहेगा:
- अपनी Dodo Payments API कुंजी दर्ज करें
- अपना वातावरण चुनें (टेस्ट या लाइव)
- अपना MCP क्लाइंट प्रकार चुनें
NPM पैकेज
NPM का उपयोग करके MCP सर्वर को स्थानीय रूप से स्थापित और चलाएँ।- NPX (No Installation)
- MCP Client Configuration
Docker
निरंतर परिनियोजन के लिए कंटेनरीकृत परिवेश में MCP सर्वर चलाएँ।Docker इमेज GitHub Container Registry पर उपलब्ध हैं।
क्लाइंट कॉन्फ़िगरेशन
अपने पसंदीदा AI क्लाइंट में Dodo Payments MCP सर्वर को कॉन्फ़िगर करें।- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Other Clients
Cursor में Dodo Payments MCP सर्वर सेट अप करें ताकि आपके भुगतान डेटा तक बातचीतात्मक पहुंच सक्षम हो।वन-क्लिक इंस्टॉलनीचे दिए बटन का उपयोग करके MCP सर्वर को सीधे Cursor में इंस्टॉल करें:[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)क्लिक करने के बाद, Cursor की
mcp.json में अपने पर्यावरण चर सेट करें Cursor Settings > Tools & MCP > New MCP Server के माध्यम से।मैन्युअल कॉन्फ़िगरेशनOpen Cursor settings
Cursor Settings > Features > Model Context Protocol पर नेविगेट करें या
Cmd/Ctrl + Shift + P दबाएँ और “MCP Settings” खोजें।Add Dodo Payments configuration
निम्नलिखित कॉन्फ़िगरेशन में से एक चुनें:रिमोट सर्वर (अनुशंसित)लोकल NPX
पर्यावरण चर
पर्यावरण चर का उपयोग करके MCP सर्वर व्यवहार को कॉन्फ़िगर करें।| Variable | Description | Required |
|---|---|---|
DODO_PAYMENTS_API_KEY | आपकी Dodo Payments API कुंजी | हाँ |
DODO_PAYMENTS_WEBHOOK_KEY | आपका वेबहुक साइनिंग की | नहीं |
DODO_PAYMENTS_ENVIRONMENT | उत्पादन के लिए live_mode पर सेट करें | नहीं |
दूरस्थ रूप से चलाना
वेब-आधारित क्लाइंट्स या एजेंटिक वर्कफ़्लो के लिए MCP सर्वर को रिमोट HTTP सर्वर के रूप में परिनियोजित करें।रिमोट सर्वर कॉन्फ़िगरेशन
एक बार परिनियोजित होने के बाद, क्लाइंट्स सर्वर URL का उपयोग करके कनेक्ट कर सकते हैं:अधिकरण हेडर
रिमोट सर्वर निम्न हेडर्स के माध्यम से प्रमाणीकरण स्वीकार करता है:| Header | Description |
|---|---|
Authorization | बीयरर टोकन प्रमाणीकरण |
x-dodo-payments-api-key | डायरेक्ट API कुंजी हेडर |
सुरक्षा सर्वोत्तम प्रथाएँ
कोड मोड inherent सुरक्षा प्रदान करता है क्योंकि कोड संडबॉक्स वातावरण में निष्पादित होता है और API कुंजियाँ सर्वर-साइड इंजेक्ट की जाती हैं। अपनी क्रेडेंशियल्स की सुरक्षा के लिए निम्न अतिरिक्त सर्वोत्तम प्रथाओं का पालन करें।API Key Management
API Key Management
क्रेडेंशियल्स को वर्शन कंट्रोल में कभी कमिट न करेंAPI कुंजियों को पर्यावरण चर या सुरक्षित सीक्रेट प्रबंधन सिस्टम में स्टोर करें।कुंजियों को नियमित रूप से रोटेट करेंनियमित अंतराल पर नई API कुंजियाँ बनाएँ और अपने Dodo Payments डैशबोर्ड के माध्यम से पुरानी को रद्द करें।विकास के लिए टेस्ट कुंजियों का उपयोग करेंउत्पादन डेटा को प्रभावित करने से बचने के लिए विकास के दौरान हमेशा टेस्ट मोड API कुंजियों का उपयोग करें।
Access Control
Access Control
रिमोट सर्वरों के लिए प्रमाणीकरण लागू करेंजब दूरस्थ रूप से परिनियोजित कर रहे हों, तो हमेशा
Authorization हेडर या x-dodo-payments-api-key हेडर के माध्यम से प्रमाणीकरण आवश्यक करें।API उपयोग की निगरानी करेंअपने Dodo Payments डैशबोर्ड के माध्यम से MCP सर्वर गतिविधि को ट्रैक करें और असामान्य पैटर्न के लिए अलर्ट सेट करें।Network Security
Network Security
रिमोट सर्वरों के लिए HTTPS का उपयोग करेंहमेशा HTTPS एंडपॉइंट्स के पीछे रिमोट MCP सर्वरों को परिनियोजित करें।रेट लिमिटिंग लागू करेंदोनों MCP सर्वर और API स्तर पर दुरुपयोग से बचाव के लिए रेट लिमिट्स लागू करें।नेटवर्क एक्सेस को प्रतिबंधित करेंअपनी MCP सर्वर तक कौन से क्लाइंट्स कनेक्ट कर सकते हैं इसे सीमित करने के लिए फ़ायरवॉल नियम कॉन्फ़िगर करें।
समस्या निवारण
Connection issues
Connection issues
अपनी API कुंजी सत्यापित करेंसुनिश्चित करें कि आपकी API कुंजी सही तरीके से सेट की गई है और उसके पास आवश्यक अनुमतियाँ हैं।अपने नेटवर्क कनेक्शन की जांच करेंसत्यापित करें कि आप Dodo Payments API एंडपॉइंट्स तक पहुँच सकते हैं।क्लाइंट लॉग्स की समीक्षा करेंकनेक्शन समस्याओं का निदान करने के लिए अपने MCP क्लाइंट में विस्तृत लॉगिंग सक्षम करें।
Authentication errors
Authentication errors
API कुंजी वातावरण की पुष्टि करेंसुनिश्चित करें कि आप परीक्षण एंडपॉइंट्स के साथ टेस्ट कुंजियों और उत्पादन एंडपॉइंट्स के साथ लाइव कुंजियों का उपयोग कर रहे हैं।पर्यावरण चर जांचेंसत्यापित करें कि
DODO_PAYMENTS_ENVIRONMENT सही तरीके से सेट है (उत्पादन के लिए live_mode)।क्रेडेंशियल्स को पुनः उत्पन्न करेंयदि समस्याएँ बनी रहती हैं, तो अपने डैशबोर्ड के माध्यम से नई API कुंजी उत्पन्न करें।Tool execution failures
Tool execution failures
इनपुट पैरामीटर की मान्यता करेंसुनिश्चित करें कि AI सहायक प्रत्येक टूल के लिए सही स्वरूपित पैरामीटर प्रदान कर रहा है।त्रुटि संदेशों की समीक्षा करेंजो कुछ भी गलत हुआ है उसके बारे में विशिष्ट मार्गदर्शन के लिए API से त्रुटि प्रतिक्रिया की जांच करें।API के साथ सीधे परीक्षण करेंcurl या Postman के माध्यम से Dodo Payments API को सीधे कॉल करके ऑपरेशन काम करता है यह सत्यापित करें।
क्यों कोड मोड
पारंपरिक MCP कार्यान्वयन अक्सर “टूल प्रोलिफरेशन” से पीड़ित होते हैं, जहाँ हर API एंडपॉइंट को एक अलग टूल के रूप में उजागर किया जाता है। कोड मोड कई कारणों से एक श्रेष्ठ दृष्टिकोण है:LLM टूल्स को कॉल करने की तुलना में कोड लिखने में बेहतर होते हैं
LLM को वास्तविक दुनिया की कोड की लाखों पंक्तियों पर प्रशिक्षित किया गया है, जिससे वे स्वाभाविक रूप से स्क्रिप्ट लिखने में कुशल होते हैं। इसके विपरीत, टूल-कॉलिंग अक्सर सिंथेटिक उदाहरणों पर आधारित होती है।“LLM को टूल कॉलिंग के साथ कार्य करने के लिए कहना ठीक वैसा है जैसे शेक्सपियर को एक महीने तक मंदारिन की कक्षा में बैठाना और फिर उससे उसमें एक नाटक लिखने को कहना।” — Cloudflare
संदर्भ विंडो की बोटलनेक समाप्त करता है
पारंपरिक दृष्टिकोण में, हर टूल परिभाषा बातचीत शुरू होने से पहले टोकन का उपभोग करती है। 50+ टूल को उजागर करना आसानी से 55K–100K+ टोकन खा सकता है। Anthropic ने पाया कि टूल परिभाषाएँ अनुकूलन से पहले 134K टोकन तक का उपभोग कर सकती हैं। कोड मोड के साथ, केवल 2 टूल परिभाषाएँ लोड होती हैं (~1K टोकन)। एजेंट आवश्यक दस्तावेज़ीकरण को ऑन-डिमांड खोजता है। Anthropic का टूल सर्च टूल संदर्भ विंडो का 95% संरक्षित करता है, जिससे ओवरहेड 77K से 8.7K टोकन तक कम हो जाता है।प्रोग्रामेटिक ऑर्केस्ट्रेशन के माध्यम से विलंबता को कम करता है
पारंपरिक टूल-कॉलिंग में प्रत्येक एकल ऑपरेशन के लिए एक पूर्ण मॉडल इन्फ़रेंस राउंड-ट्रिप की आवश्यकता होती है। यदि एक टास्क को 20 API कॉल्स की आवश्यकता होती है, तो वह 20 राउंड-ट्रिप्स होते हैं। कोड मोड में, एजेंट एक स्क्रिप्ट लिखता है जो सभी कॉल्स को निष्पादित करता है और केवल अंतिम परिणाम लौटाता है। Anthropic ने इस प्रोग्रामेटिक दृष्टिकोण का उपयोग करते समय 37% टोकन की कमी और सटीकता में सुधार (ज्ञान पुनर्प्राप्ति 25.6% से 28.5% तक बढ़ी) देखा।डिफ़ॉल्ट रूप से अधिक सुरक्षित
कोड मोड inherent सुरक्षा लाभ प्रदान करता है:- पैरामीटर में कोई API कुंजियाँ नहीं: API कुंजियाँ सर्वर-साइड इंजेक्ट की जाती हैं और कभी भी LLM को भेजे गए टूल पैरामीटर्स में उजागर नहीं होती हैं।
- अलग संडबॉक्स: कोड एक सुरक्षित परिवेश में चलता है जिसका नेटवर्क या होस्ट फ़ाइल सिस्टम तक कोई पहुंच नहीं होती।
- नियंत्रित SDK: केवल अधिकृत SDK मेथड्स एजेंट के लिए उपलब्ध होते हैं।
किसी भी API आकार तक स्केल करता है
जब कोई API बढ़ता है, पारंपरिक MCP प्रदर्शन घट जाता है क्योंकि संदर्भ में अधिक टूल्स लोड करने पड़ते हैं। कोड मोड 2 टूल्स के साथ स्थिर रहता है चाहे API कितना भी बड़ा क्यों न हो। Cloudflare ने सफलतापूर्वक 2,500+ API एंडपॉइंट्स को केवल 2 टूल्स और लगभग 1,000 टोकन की संदर्भ विंडो में समाहित कर दिया।इस वास्तुकला के लाभों के बारे में अधिक विवरण के लिए, Anthropic और Cloudflare के इंजीनियरिंग ब्लॉग्स देखें, और Claude की Programmatic Tool Calling दस्तावेज़ीकरण देखें।