मुख्य सामग्री पर जाएं

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 एजेंट को केवल दो टूल्स प्रदान करता है:
  1. डॉक्स सर्च टूल: Dodo Payments API और SDK के बारे में डॉक्स को क्वेरी करता है ताकि उपलब्ध ऑपरेशंस और पैरामीटर समझे जा सकें।
  2. कोड निष्पादन टूल: SDK के खिलाफ TypeScript कोड लिखता है जो सुरक्षित संडबॉक्स परिवेश में निष्पादित होता है।
यह वास्तुकला एजेंट्स को एकल इनवोकेशन में जटिल, बहु-चरण ऑपरेशंस करने की अनुमति देती है। उदाहरण के लिए, एक एजेंट सभी सक्रिय सब्सक्रिप्शन सूचीबद्ध कर सकता है, उन्हें विशिष्ट मानदंडों के आधार पर फ़िल्टर कर सकता है, और प्रत्येक पर छूट लागू कर सकता है—सब एक ही स्क्रिप्ट में।
कोड मोड का उपयोग करके, एजेंट कई API कॉल्स को चेन कर सकते हैं, सशर्त तर्क संभाल सकते हैं, और गणनाएँ कर सकते हैं बिना LLM के साथ कई राउंड-ट्रिप्स की आवश्यकता के।

त्वरित सेटअप

अपने AI क्लाइंट में Dodo Payments MCP सर्वर से कनेक्ट करें:
~/.cursor/mcp.json में जोड़ें:
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
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/mcp.json में जोड़ें:
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}
Node.js 18 या उच्चतर की आवश्यकता है। mcp-remote पैकेज रिमोट MCP सर्वर से कनेक्शन को संभालता है।

दोनों MCP सर्वरों का एक साथ उपयोग

सबसे अच्छी AI-सहायता प्राप्त विकास अनुभव के लिए, हम दोनों MCP सर्वरों का उपयोग करने की सलाह देते हैं:
ServerPurposeUse Case
Dodo Knowledge MCPदस्तावेज़ खोज”मैं वेबहुक को कैसे संभालूँ?”, “कौन से भुगतान तरीक़े समर्थित हैं?”
Dodo Payments MCPAPI संचालनभुगतान बनाएं, सब्सक्रिप्शन प्रबंधित करें, रिफंड संभालें
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    },
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
दोनों सर्वर कॉन्फ़िगर होने पर, आपका AI सहायक पहले दस्तावेज़ खोज सकता है कि किसी फीचर को कैसे लागू किया जाए, फिर वास्तविक API कॉल्स निष्पादित कर सकता है—सब एक ही बातचीत में।

Knowledge MCP समस्या निवारण

यदि आपको कनेक्शन समस्याएँ होती हैं:
  1. MCP प्रमाणीकरण कैश साफ़ करें: rm -rf ~/.mcp-auth
  2. अपने क्लाइंट एप्लिकेशन को पुनः प्रारंभ करें
  3. त्रुटि संदेशों के लिए क्लाइंट लॉग्स जांचें
  4. Node.js संस्करण सत्यापित करें: Node.js 18+ की आवश्यकता है

Knowledge MCP Server

Dodo Knowledge MCP कॉन्फ़िगरेशन पृष्ठ तक पहुँचें

स्थापना

अपने कार्य प्रवाह के लिए सर्वश्रेष्ठ फिट होने वाली स्थापना विधि चुनें।

रिमोट MCP सर्वर (अनुशंसित)

किसी भी स्थानीय सेटअप या इंस्टॉलेशन के बिना होस्ट किए गए MCP सर्वर तक पहुँचें। यह शुरू करने का सबसे तेज़ तरीका है।
1

Access the remote server

अपने ब्राउज़र में https://mcp.dodopayments.com पर नेविगेट करें।
2

Configure your MCP client

अपनी विशिष्ट क्लाइंट के लिए प्रदान किए गए JSON कॉन्फ़िगरेशन की कॉपी करें। Cursor या Claude Desktop के लिए, इसे अपने MCP सेटिंग्स में जोड़ें:
{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
3

Authenticate and configure

OAuth फ्लो आपको निम्न कार्य करने के लिए कहेगा:
  • अपनी Dodo Payments API कुंजी दर्ज करें
  • अपना वातावरण चुनें (टेस्ट या लाइव)
  • अपना MCP क्लाइंट प्रकार चुनें
अपनी API कुंजी सुरक्षित रखें। विकास के दौरान टेस्ट मोड कुंजी का उपयोग करें।
4

Complete setup

कनेक्शन को अधिकृत करने के लिए Login and Approve पर क्लिक करें।
एक बार कनेक्ट होने पर, आपका AI सहायक आपके behalf में Dodo Payments API के साथ इंटरैक्ट कर सकता है।

NPM पैकेज

NPM का उपयोग करके MCP सर्वर को स्थानीय रूप से स्थापित और चलाएँ।
# Set your environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."
export DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key"
export DODO_PAYMENTS_ENVIRONMENT="live_mode"

# Run the latest version
npx -y dodopayments-mcp@latest
@latest का उपयोग करें ताकि हमेशा नवीनतम संस्करण प्राप्त हो, या स्थिरता के लिए @1.0.0 जैसे किसी विशिष्ट संस्करण पर पिन करें।

Docker

निरंतर परिनियोजन के लिए कंटेनरीकृत परिवेश में MCP सर्वर चलाएँ।
# Pull the latest image
docker pull ghcr.io/dodopayments/mcp:latest

# Run the container
docker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -e DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key" \
  -e DODO_PAYMENTS_ENVIRONMENT="live_mode" \
  ghcr.io/dodopayments/mcp:latest
Docker इमेज GitHub Container Registry पर उपलब्ध हैं।

क्लाइंट कॉन्फ़िगरेशन

अपने पसंदीदा AI क्लाइंट में Dodo Payments MCP सर्वर को कॉन्फ़िगर करें।
Cursor में Dodo Payments MCP सर्वर सेट अप करें ताकि आपके भुगतान डेटा तक बातचीतात्मक पहुंच सक्षम हो।वन-क्लिक इंस्टॉलनीचे दिए बटन का उपयोग करके MCP सर्वर को सीधे Cursor में इंस्टॉल करें:[Add to Cursor](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)क्लिक करने के बाद, Cursor की mcp.json में अपने पर्यावरण चर सेट करें Cursor Settings > Tools & MCP > New MCP Server के माध्यम से।मैन्युअल कॉन्फ़िगरेशन
1

Open Cursor settings

Cursor Settings > Features > Model Context Protocol पर नेविगेट करें या Cmd/Ctrl + Shift + P दबाएँ और “MCP Settings” खोजें।
2

Edit configuration

Edit Config पर क्लिक करके mcp_config.json फ़ाइल खोलें।
3

Add Dodo Payments configuration

निम्नलिखित कॉन्फ़िगरेशन में से एक चुनें:रिमोट सर्वर (अनुशंसित)
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
लोकल NPX
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}
4

Save and restart

कॉन्फ़िगरेशन फ़ाइल सहेजें और Cursor को पुनः प्रारंभ करें।
अपने Dodo Payments डेटा के बारे में AI सहायक से पूछकर कनेक्शन सत्यापित करें।

पर्यावरण चर

पर्यावरण चर का उपयोग करके MCP सर्वर व्यवहार को कॉन्फ़िगर करें।
VariableDescriptionRequired
DODO_PAYMENTS_API_KEYआपकी Dodo Payments API कुंजीहाँ
DODO_PAYMENTS_WEBHOOK_KEYआपका वेबहुक साइनिंग कीनहीं
DODO_PAYMENTS_ENVIRONMENTउत्पादन के लिए live_mode पर सेट करेंनहीं

दूरस्थ रूप से चलाना

वेब-आधारित क्लाइंट्स या एजेंटिक वर्कफ़्लो के लिए MCP सर्वर को रिमोट HTTP सर्वर के रूप में परिनियोजित करें।
# Start as remote server
npx -y dodopayments-mcp --transport=http

# Specify a custom port
npx -y dodopayments-mcp --transport=http --port=3000

रिमोट सर्वर कॉन्फ़िगरेशन

एक बार परिनियोजित होने के बाद, क्लाइंट्स सर्वर URL का उपयोग करके कनेक्ट कर सकते हैं:
{
  "mcpServers": {
    "dodopayments_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

अधिकरण हेडर

रिमोट सर्वर निम्न हेडर्स के माध्यम से प्रमाणीकरण स्वीकार करता है:
HeaderDescription
Authorizationबीयरर टोकन प्रमाणीकरण
x-dodo-payments-api-keyडायरेक्ट API कुंजी हेडर

सुरक्षा सर्वोत्तम प्रथाएँ

कोड मोड inherent सुरक्षा प्रदान करता है क्योंकि कोड संडबॉक्स वातावरण में निष्पादित होता है और API कुंजियाँ सर्वर-साइड इंजेक्ट की जाती हैं। अपनी क्रेडेंशियल्स की सुरक्षा के लिए निम्न अतिरिक्त सर्वोत्तम प्रथाओं का पालन करें।
क्रेडेंशियल्स को वर्शन कंट्रोल में कभी कमिट न करेंAPI कुंजियों को पर्यावरण चर या सुरक्षित सीक्रेट प्रबंधन सिस्टम में स्टोर करें।
# Use environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Use a .env file (add to .gitignore)
echo "DODO_PAYMENTS_API_KEY=dodo_test_..." > .env
कुंजियों को नियमित रूप से रोटेट करेंनियमित अंतराल पर नई API कुंजियाँ बनाएँ और अपने Dodo Payments डैशबोर्ड के माध्यम से पुरानी को रद्द करें।विकास के लिए टेस्ट कुंजियों का उपयोग करेंउत्पादन डेटा को प्रभावित करने से बचने के लिए विकास के दौरान हमेशा टेस्ट मोड API कुंजियों का उपयोग करें।
रिमोट सर्वरों के लिए प्रमाणीकरण लागू करेंजब दूरस्थ रूप से परिनियोजित कर रहे हों, तो हमेशा Authorization हेडर या x-dodo-payments-api-key हेडर के माध्यम से प्रमाणीकरण आवश्यक करें।API उपयोग की निगरानी करेंअपने Dodo Payments डैशबोर्ड के माध्यम से MCP सर्वर गतिविधि को ट्रैक करें और असामान्य पैटर्न के लिए अलर्ट सेट करें।
रिमोट सर्वरों के लिए HTTPS का उपयोग करेंहमेशा HTTPS एंडपॉइंट्स के पीछे रिमोट MCP सर्वरों को परिनियोजित करें।रेट लिमिटिंग लागू करेंदोनों MCP सर्वर और API स्तर पर दुरुपयोग से बचाव के लिए रेट लिमिट्स लागू करें।नेटवर्क एक्सेस को प्रतिबंधित करेंअपनी MCP सर्वर तक कौन से क्लाइंट्स कनेक्ट कर सकते हैं इसे सीमित करने के लिए फ़ायरवॉल नियम कॉन्फ़िगर करें।

समस्या निवारण

अपनी API कुंजी सत्यापित करेंसुनिश्चित करें कि आपकी API कुंजी सही तरीके से सेट की गई है और उसके पास आवश्यक अनुमतियाँ हैं।
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://test.dodopayments.com/payments
अपने नेटवर्क कनेक्शन की जांच करेंसत्यापित करें कि आप Dodo Payments API एंडपॉइंट्स तक पहुँच सकते हैं।क्लाइंट लॉग्स की समीक्षा करेंकनेक्शन समस्याओं का निदान करने के लिए अपने MCP क्लाइंट में विस्तृत लॉगिंग सक्षम करें।
API कुंजी वातावरण की पुष्टि करेंसुनिश्चित करें कि आप परीक्षण एंडपॉइंट्स के साथ टेस्ट कुंजियों और उत्पादन एंडपॉइंट्स के साथ लाइव कुंजियों का उपयोग कर रहे हैं।पर्यावरण चर जांचेंसत्यापित करें कि DODO_PAYMENTS_ENVIRONMENT सही तरीके से सेट है (उत्पादन के लिए live_mode)।क्रेडेंशियल्स को पुनः उत्पन्न करेंयदि समस्याएँ बनी रहती हैं, तो अपने डैशबोर्ड के माध्यम से नई API कुंजी उत्पन्न करें।
इनपुट पैरामीटर की मान्यता करेंसुनिश्चित करें कि 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 दस्तावेज़ीकरण देखें।

संसाधन