Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
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 सर्वर से कनेक्ट करें:- Agent Plugin (recommended)
- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Dodo Agent Plugin Claude Code, Codex CLI, Cursor, और OpenCode के लिए एक कदम में MCP सर्वर और सभी आठ स्किल्स इंस्टॉल करता है। AI Coding Agents guide में प्रति-एजेंट इंस्टॉल कमांड देखें।यदि आपका एजेंट उस सूची में नहीं है, तो नीचे दिए गए टैब का उपयोग करके MCP सर्वर को सीधे कॉन्फ़िगर करें।
Node.js 18 या उच्चतर की आवश्यकता है। रिमोट सर्वर OAuth का उपयोग करके प्रमाणीकरण करता है — पहली बार कनेक्शन पर आपको अपनी API कुंजी दर्ज करने और अपने वातावरण का चयन करने के लिए कहा जाएगा।
Dodo Knowledge MCP
Dodo Payments MCP Server (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
Add to
~/.cursor/mcp.json:Node.js 18 या उच्चतर की आवश्यकता है।
mcp-remote पैकेज रिमोट MCP सर्वर से कनेक्शन को संभालता है।दोनों MCP सर्वरों का एक साथ उपयोग करना
सर्वोत्तम AI-सहायता प्राप्त विकास अनुभव के लिए, हम दोनों MCP सर्वरों का उपयोग करने की अनुशंसा करते हैं:| सर्वर | उद्देश्य | उपयोग का मामला |
|---|---|---|
| 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 पैकेज
MCP सर्वर को स्थानीय रूप से NPM का उपयोग करके इंस्टॉल और चलाएँ।- 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
Dodo Payments MCP सर्वर को Cursor में सेट करें ताकि आपके भुगतानों के डेटा तक संवादात्मक पहुँच मिल सके।एक-क्लिक इंस्टॉलCursor में सीधे MCP सर्वर को इंस्टॉल करने के लिए नीचे दिए गए बटन का उपयोग करें:[
](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 सर्वर व्यवहार को कॉन्फ़िगर करें।| वेरिएबल | वर्णन | आवश्यक |
|---|---|---|
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 कुंजी हैडर |
सुरक्षा सर्वोत्तम प्रथाएँ
कोड मोड इनहेरेंट सुरक्षा प्रदान करता है जो एक सैंडबॉक्स वातावरण में कोड चलाकर और सर्वर-साइड 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 का उपयोग करेंहमेशा रिमोट MCP सर्वरों को HTTPS एंडपॉइंट्स के पीछे तैनात करें।रेट लिमिटिंग लागू करेंदुरुपयोग से सुरक्षा के लिए 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 के साथ सीधे परीक्षण करेंसुनिश्चित करें कि ऑपरेशन सीधे Dodo Payments API को curl या Postman के माध्यम से कॉल करते समय काम करता है।
कोड मोड क्यों
पारंपरिक MCP कार्यान्वयन अक्सर “उपकरण प्रसार” से पीड़ित होते हैं, जहां प्रत्येक API समाप्ति बिंदु को एक अलग उपकरण के रूप में उजागर किया जाता है। कोड मोड कई कारणों से श्रेष्ठ दृष्टिकोण है:LLMs औजारों को बुलाने की तुलना में कोड लिखने में बेहतर हैं
LLMs को लाखों वास्तविक दुनिया के कोड लाइनों पर प्रशिक्षित किया गया है, जिससे वे स्वभाव से स्क्रिप्ट लिखने में निपुण हैं। इसके विपरीत, औजार बुलाने को अक्सर सिंथेटिक उदाहरणों के आधार पर किया जाता है।“एक LLM को टूल कॉलिंग के साथ कार्य संरचना देने की कोशिश शेक्सपियर को एक महीने की मंडारिन क्लास में भेज कर उससे उसी भाषा में नाटक लिखवाना जैसा है।” — Cloudflare
संदर्भ विंडो ब्लोट को समाप्त करता है
पारंपरिक दृष्टिकोण में, प्रत्येक औजार परिभाषा बातचीत शुरू होने से पहले टोकन का उपभोग करती है। 50+ उपकरणों को उजागर करने से आसानी से 55K–100K+ टोकन खा सकते हैं। Anthropic ने पाया कि औजार परिभाषाएँ अनुकूलन से पहले 134K तक टोकन का उपभोग कर सकती हैं। कोड मोड के साथ, केवल 2 टूल परिभाषाएँ लोड की जाती हैं (~1K टोकन्स)। एजेंट दस्तावेज़ीकरण को आवश्यकता होने पर मांग पर खोजता है। Anthropic के टूल सर्च टूल ने संदर्भ विंडो के 95% को संरक्षित किया, ओवरहेड को 77K से 8.7K टोकन्स तक घटाकर।प्रोग्रामेटिक ऑर्केस्ट्रेशन के माध्यम से विलंबता को कम करता है
पारंपरिक टूल-कॉलिंग के लिए हर एक ऑपरेशन के लिए एक पूर्ण मॉडल इंफेरेंस राउंड-ट्रिप की आवश्यकता होती है। यदि एक कार्य में 20 API कॉल की आवश्यकता होती है, तो यह 20 राउंड-ट्रिप्स हैं। कोड मोड में, एजेंट एक स्क्रिप्ट लिखता है जो सभी कॉल निष्पादित करता है और केवल अंतिम परिणाम लौटाता है। अनथ्रोपिक ने इस प्रोग्रामेटिक दृष्टिकोण का उपयोग करके टोकनों में 37% की कमी देखी और सटीकता में सुधार (ज्ञान पुनः प्राप्ति 25.6% से 28.5% तक सुधरी)।डिज़ाइन द्वारा अधिक सुरक्षित
कोड मोड इनहेरेंट सुरक्षा लाभ प्रदान करता है:- पैरामीटर में कोई API कुंजी नहीं: API कुंजियों को सर्वर-साइड इंजेक्ट किया जाता है और कभी भी LLM को भेजे गए टूल पैरामीटर में उजागर नहीं किया जाता है।
- अलग सैंडबॉक्स: कोड एक सुरक्षित पर्यावरण में चलता है जिसका नेटवर्क या होस्ट फ़ाइल सिस्टम तक कोई पहुँच नहीं है।
- नियंत्रित SDK: एजेंट को केवल अधिकृत SDK के तरीके उपलब्ध हैं।
किसी भी API आकार तक स्केल करता है
जैसे-जैसे API बढ़ता है, पारंपरिक MCP प्रदर्शन में गिरावट आती है क्योंकि संदर्भ में अधिक उपकरणों को लोड करना पड़ता है। कोड मोड का स्तर 2 टूल्स के साथ लगातार बना रहता है जिससे कोई फर्क नहीं पड़ता API की सतह क्षेत्र कितना बड़ा है। Cloudflare ने सफलतापूर्वक 2,500 से अधिक API एंडपॉइंट्स को सिर्फ 2 टूल्स और लगभग 1,000 टोकन्स के संदर्भ में संकुचित किया।इस आर्किटेक्चर के लाभों के बारे में अधिक विवरण के लिए, Anthropic और Cloudflare के इंजीनियरिंग ब्लॉग्स और Claude के Programmatic Tool Calling दस्तावेज़ देखें।
संसाधन
API Reference
पूरी Dodo Payments API दस्तावेज़ीकरण का अन्वेषण करें
MCP Protocol
मॉडल संदर्भ प्रोटोकॉल मानक के बारे में अधिक जानें
GitHub Repository
MCP सर्वर स्रोत कोड देखें और योगदान करें
NPM Package
NPM से MCP सर्वर इंस्टॉल करें