Dodo Payments MCP Server

Overview

Model Context Protocol（MCP）は、AI アプリケーションが外部データソースや API に接続できるオープン標準です。Dodo Payments MCP Server により、Claude、Cursor、その他の MCP 対応クライアントなどの AI アシスタントから決済インフラにアクセスできます。 Dodo Payments MCP Server は Code Mode アーキテクチャを使用します。すべての API endpoint に対して数百個の個別ツールを公開する代わりに、Code Mode では AI agent が分離されたサンドボックス内で Dodo Payments SDK に対して TypeScript コードを記述・実行できます。

主な機能

Payment Operations — 決済と返金の作成、取得、管理
Subscription Management — 継続課金、アップグレード、キャンセルの処理
Customer Administration — 顧客データと portal access の管理
Product Catalog — 商品、価格、割引の作成と更新
License Management — ソフトウェアライセンスの有効化、検証、管理
Usage-Based Billing — メータリングされた使用量の追跡と請求

How Code Mode Works

Dodo Payments MCP Server は AI agent に 2 つのツールを提供します。

Docs Search Tool — Dodo Payments API と SDK に関するドキュメントを検索し、利用可能な操作とパラメータを把握します。
Code Execution Tool — SDK に対する TypeScript コードを記述し、安全なサンドボックス内で実行します。

このアーキテクチャにより、agent は 1 回の invocation で複雑な複数ステップの操作を実行できます。たとえば、agent は有効なすべてのサブスクリプションを一覧表示し、条件で絞り込み、それぞれに割引を適用できます。すべてを 1 つの script で実行可能です。

Agent は複数の API call を連結し、条件分岐を処理し、LLM に戻る round-trip なしで計算を実行できます。

Quick Setup

Connect to the Dodo Payments MCP Server in your AI client:

Agent Plugin (recommended)
Cursor
Claude Desktop
Windsurf
Claude Code

Dodo Agent Plugin は、Claude Code、Codex CLI、Cursor、VS Code / GitHub Copilot、Kiro、OpenCode 用に、両方の MCP server と 17 個すべての skill を 1 ステップでインストールします（OpenCode では追加の skills.paths 設定が 1 つ必要です）。Gemini CLI には agent-skill primitive がないため、2 つの MCP server のみがインストールされます。agent ごとのインストール command については、AI Coding Agents guide を参照してください。If your agent isn’t in that list, use the tabs below to configure the MCP server directly.

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

Configuration file locations:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

Run in your terminal:

claude mcp add dodopayments -- npx -y mcp-remote@latest https://mcp.dodopayments.com/mcp

Node.js 18 以上が必要です。remote server は認証に OAuth を使用します。初回接続時に API key の入力と environment の選択を求められます。

Dodo Knowledge MCP

Dodo Payments MCP Server（API 操作の実行用）に加えて、AI アシスタントから Dodo Payments のドキュメントに即座にアクセスできる semantic search server、Dodo Knowledge MCP も提供しています。

Built with ContextMCP.ai: Dodo Knowledge MCP is powered by ContextMCP, enabling fast semantic search across our documentation using vector embeddings.

What is Dodo Knowledge MCP?

Dodo Knowledge MCP は semantic documentation search を提供する remote MCP server です。自然言語の query で関連するドキュメントを検索し、Dodo Payments に関する正確で最新の情報を取得できます。API key や local installation は必要ありません。

クイックセットアップ

AI client で Dodo Knowledge MCP に接続します。

Cursor
Claude Desktop
Windsurf
Claude Code

~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}

Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}

設定ファイルの場所:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}

terminal で実行します。

claude mcp add dodo-knowledge -- npx -y mcp-remote@latest https://knowledge.dodopayments.com/mcp

Node.js 18 以上が必要です。mcp-remote package が remote MCP server への接続を処理します。

両方の MCP Server を一緒に使用する

AI 支援開発を最大限に活用するには、両方の MCP server を使用します。

Server	Purpose	Use Case
Dodo Knowledge MCP	ドキュメント検索	「webhook はどのように処理しますか？」「どの payment method に対応していますか？」
Dodo Payments MCP	API 操作	決済の作成、サブスクリプションの管理、返金の処理

{
  "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/mcp"]
    }
  }
}

両方の server を設定すると、agent はドキュメントを検索して機能を理解し、その後 API call を実行して実装できます。すべてを 1 つの conversation 内で行えます。

Knowledge MCP のトラブルシューティング

接続の問題が発生した場合は、rm -rf ~/.mcp-auth で MCP authentication cache を消去し、client application を再起動してください。client log で error message を確認し、Node.js version（18 以上が必要）を検証します。

Knowledge MCP Server

Dodo Knowledge MCP configuration page にアクセス

インストール

workflow に合ったインストール方法を選択してください。

Remote MCP Server（推奨）

local setup や installation なしで hosted MCP server にアクセスします。

Access the remote server

browser で https://mcp.dodopayments.com に移動します。

Configure your MCP client

使用する client 用に提供された JSON configuration をコピーします。Cursor または Claude Desktop の場合は、MCP settings に追加します。

{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

Authenticate and configure

OAuth flow で次の入力を求められます。

Dodo Payments API key を入力
environment（test または live）を選択
MCP client type を選択

API key は安全に管理してください。開発中は test mode key を使用します。

Complete setup

Login and Approve をクリックして接続を承認します。

接続すると、AI assistant はユーザーに代わって Dodo Payments API とやり取りできます。

NPM Package

MCP server を local で install して実行します。

local server は Deno sandbox で code を実行します。Deno 2.8 以前をインストールし、deno が PATH 上にあることを確認してください。Deno 2.9 以降では sandbox の起動に失敗します。local code execution は macOS と Linux のみで動作します。Windows では remote server を使用するか、WSL2 上で local server を実行してください。

NPX (No Installation)
MCP Client Configuration

# Set your environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."
export DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key"
export DODO_PAYMENTS_ENVIRONMENT="test_mode"

# Run the latest version
npx -y dodopayments-mcp@latest

{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      }
    }
  }
}

@latest を使用すると常に最新 version を取得できます。安定性を重視する場合は、@2.51.0 のように specific version を固定してください。

Docker

MCP server を container で実行します。

# Pull the latest image
docker pull ghcr.io/dodopayments/mcp:latest

# Run the container (-i keeps stdin open for the stdio transport)
docker run -i -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -e DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key" \
  -e DODO_PAYMENTS_ENVIRONMENT="test_mode" \
  ghcr.io/dodopayments/mcp:latest

Docker イメージは GitHub Container Registry で利用できます。

クライアント設定

お好みの AI クライアントで Dodo Payments MCP server を設定します。

Dodo Payments MCP server を Cursor に設定して、決済データに会話形式でアクセスできるようにします。ワンクリックインストール以下のボタンを使用して、MCP server を Cursor に直接インストールします：[ Cursor に追加

](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)クリック後、Cursor Settings > Tools & MCP > New MCP Server から、Cursor の mcp.json に環境変数を設定します。手動設定

Open Cursor settings

Cursor Settings > Tools & MCP に移動するか、Cmd/Ctrl + Shift + P を押して「MCP Settings」を検索します。

Edit configuration

New MCP Server をクリックして mcp.json ファイルを開きます。

Add Dodo Payments configuration

以下のいずれかの設定を選択します：リモートサーバー（推奨）

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

ローカル NPX

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

Save and restart

設定ファイルを保存し、Cursor を再起動します。

AI assistant に Dodo Payments のデータについて質問し、接続を確認します。

Dodo Payments MCP server を Claude Desktop に設定して、決済データに会話形式でアクセスできるようにします。

Locate configuration file

Claude Desktop の設定ファイルを見つけます：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Edit configuration

テキストエディターでファイルを開き、Dodo Payments の設定を追加します：リモートサーバー（推奨）

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

ローカル NPX

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

Restart Claude Desktop

Claude Desktop を閉じて再度開き、変更を反映します。

Claude Desktop に 🔌 アイコンが表示され、MCP server が接続されていることを確認します。

Dodo Payments MCP server を Claude Code CLI に設定します。ターミナルで次のコマンドを実行します：

claude mcp add --transport stdio dodopayments_api \
  --env DODO_PAYMENTS_API_KEY="dodo_test_..." \
  DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key" \
  -- npx -y dodopayments-mcp

設定はホームディレクトリの .claude.json ファイルに保存されます。

Claude Code は shell から環境変数を自動的に取得するため、コマンドの実行前に環境変数を export することもできます。

Dodo Payments MCP server を VS Code に設定します。ワンクリックインストールVS Code を開くクリック後、Command Palette > MCP: Open User Configuration から、VS Code の mcp.json に環境変数を設定します。手動設定

Open MCP configuration

Command Palette（Cmd/Ctrl + Shift + P）を開き、「MCP: Open User Configuration」を検索します。

Add server configuration

Dodo Payments MCP server を追加します：

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

Reload window

VS Code（Cmd/Ctrl + Shift + P > 「Reload Window」）を再読み込みして MCP server を有効にします。

Dodo Payments MCP server を Cline（VS Code）に設定して、決済データに会話形式でアクセスできるようにします。

Open Cline settings

Cline の設定ファイルを見つけます：

macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Configure MCP server

Dodo Payments MCP server の設定を追加します：

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

Reload VS Code

VS Code ウィンドウ（Cmd/Ctrl + Shift + P > 「Reload Window」）を再読み込みして、MCP server connection を有効にします。

Dodo Payments MCP server を Zed に設定して、決済データに会話形式でアクセスできるようにします。

Open Zed settings

Settings > Assistant > Model Context Protocol に移動します。

Add server configuration

次の設定を追加します：

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

Save and verify

設定を保存します。これで Zed の AI assistant で MCP server を利用できるようになります。

その他の MCP-compatible clients に Dodo Payments MCP server を設定します。リモートサーバー（推奨）

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

ローカル NPX

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}

MCP-compatible clients の完全な一覧と設定方法については、modelcontextprotocol.io/clients をご覧ください。

環境変数

環境変数を使用して MCP server の動作を設定します。

Variable	Description	Required
`DODO_PAYMENTS_API_KEY`	Dodo Payments API key	Yes
`DODO_PAYMENTS_WEBHOOK_KEY`	webhook signing key	No
`DODO_PAYMENTS_ENVIRONMENT`	`live_mode` または `test_mode`。デフォルトは `live_mode`	No

リモート実行

Web-based clients または agentic workflows 向けに、MCP server を remote HTTP server としてデプロイします。

# Start as remote server
npx -y dodopayments-mcp --transport=http

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

リモートサーバー設定

デプロイ後、clients は server URL を使用して接続できます：

{
  "mcpServers": {
    "dodopayments_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

Authorization Headers

remote server は、次の headers による認証を受け付けます：

Header	Purpose
`Authorization`	Bearer token authentication
`x-dodo-payments-api-key`	Direct API key header

セキュリティのベストプラクティス

Code Mode は、sandboxed environment でコードを実行し、server-side で API keys を注入することにより、本質的なセキュリティを提供します。credentials を保護するため、以下のベストプラクティスに従ってください。

API Key Management

credentials を version control に commit しないでください。API keys は environment variables または secure secret management systems に保存します：

# 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 keys を定期的に生成し、Dodo Payments dashboard から古い keys を revoke して、keys を定期的に rotation します。本番データへの影響を避けるため、development 中は必ず test mode API keys を使用してください。

Access Control

remote にデプロイする場合は、必ず Authorization header または x-dodo-payments-api-key header による authentication を要求してください。

Network Security

remote MCP servers は必ず HTTPS endpoints の背後にデプロイしてください。MCP server と API の両方のレベルで rate limits を実装し、abuse から保護します。どの clients が MCP server に接続できるかを制限する firewall rules を設定してください。

トラブルシューティング

Connection issues

API key が正しく設定され、必要な permissions を持っていることを確認します：

# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://test.dodopayments.com/payments

Dodo Payments API endpoints にアクセスできることを確認します。接続の問題を診断するには、MCP client で verbose logging を有効にします。

Authentication errors

test endpoints には test keys を、production endpoints には live keys を使用していることを確認します。DODO_PAYMENTS_ENVIRONMENT が正しく設定されていることを確認してください（production では live_mode）。問題が解決しない場合は、dashboard から新しい API key を生成してください。

Tool execution failures

AI assistant が各 tool に対して正しい形式の parameters を提供していることを確認します。API からの error response を確認し、問題の原因に関する具体的な guidance を得ます。curl または Postman を使用して Dodo Payments API を直接呼び出した場合に operation が動作することを確認します。

Code Mode を使用する理由

従来の MCP implementations では、すべての API endpoints が個別の tool として公開される「tool proliferation」が発生します。Code Mode の方が優れている理由は次のとおりです：

LLM は tool を呼び出すよりコードを書く方が得意

LLM は現実世界のコードを何百万行も学習しているため、自然にスクリプトを適切に記述できます。tool-calling は synthetic examples に基づいていることが多くあります。

「LLM に tool calling でタスクを実行させるのは、Shakespeare を Mandarin の長期講座に通わせ、その言語で劇を書かせるようなものです。」— Cloudflare

Context Window の肥大化を解消

従来の approaches では、会話の開始前に各 tool definition が tokens を消費します。50 個以上の tools を公開すると、55K～100K 以上の tokens を消費する可能性があります。Anthropic は、最適化前には tool definitions が最大 134K tokens を消費する可能性があることを発見しました。 Code Mode は 2 つの tool definitions（約 1K tokens）のみを読み込みます。agent は必要に応じて documentation を検索します。Anthropic の Tool Search Tool は context window の 95% を保持し、overhead を 77K tokens から 8.7K tokens に削減しました。

Programmatic Orchestration によるレイテンシの削減

従来の tool-calling では、すべての operation ごとに model inference の完全な round-trip が必要です。タスクに 20 回の API calls が必要な場合、20 回の round-trips が発生します。Code Mode では、agent がすべての calls を実行する 1 つの script を記述し、最終結果のみを返します。 Anthropic は、このアプローチにより tokens が 37% 削減され、accuracy が向上したことを確認しました（knowledge retrieval は 25.6% から 28.5% に向上）。

設計上より安全

Code Mode には、次のような本質的なセキュリティ上の利点があります：

parameters に API keys を含めない — API keys は server-side で注入され、LLM に送信される tool parameters に公開されません。
分離された sandbox — コードは network や host filesystem にアクセスできない secure environment で実行されます。
制御された SDK — authorized SDK methods のみが agent に提供されます。

あらゆる API サイズに対応

API が拡大すると、より多くの tools を読み込む必要があるため、従来の MCP の performance は低下します。Code Mode は API surface area にかかわらず 2 つの tools で一定です。Cloudflare は 2,500 を超える API endpoints を 2 つの tools と約 1,000 tokens の context に集約しました。

詳細については、Anthropic と Cloudflare の engineering blogs、および Claude の Programmatic Tool Calling documentation をご覧ください。

リソース

API Reference

Dodo Payments API documentation の完全版を確認する

MCP Protocol

Model Context Protocol standard の詳細を確認する

GitHub Repository

MCP server の source code を確認して contribute する

NPM Package

NPM から MCP server をインストールする

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Overview

主な機能

How Code Mode Works

Quick Setup

Dodo Knowledge MCP

What is Dodo Knowledge MCP?

クイックセットアップ

両方の MCP Server を一緒に使用する

Knowledge MCP のトラブルシューティング

Knowledge MCP Server

インストール

Remote MCP Server（推奨）

NPM Package

Docker

クライアント設定

環境変数

リモート実行

リモートサーバー設定

Authorization Headers

セキュリティのベストプラクティス

トラブルシューティング

Code Mode を使用する理由

LLM は tool を呼び出すよりコードを書く方が得意

Context Window の肥大化を解消

Programmatic Orchestration によるレイテンシの削減

設計上より安全

あらゆる API サイズに対応

リソース

API Reference

MCP Protocol

GitHub Repository

NPM Package

​Overview

​主な機能

​How Code Mode Works

​Quick Setup

​Dodo Knowledge MCP

​What is Dodo Knowledge MCP?

​クイックセットアップ

​両方の MCP Server を一緒に使用する

​Knowledge MCP のトラブルシューティング

Knowledge MCP Server

​インストール

​Remote MCP Server（推奨）

​NPM Package

​Docker

​クライアント設定

​環境変数

​リモート実行

​リモートサーバー設定

​Authorization Headers

​セキュリティのベストプラクティス

​トラブルシューティング

​Code Mode を使用する理由

​LLM は tool を呼び出すよりコードを書く方が得意

​Context Window の肥大化を解消

​Programmatic Orchestration によるレイテンシの削減

​設計上より安全

​あらゆる API サイズに対応

​リソース

API Reference

MCP Protocol

GitHub Repository

NPM Package

Overview

主な機能

How Code Mode Works

Quick Setup

Dodo Knowledge MCP

What is Dodo Knowledge MCP?

クイックセットアップ

両方の MCP Server を一緒に使用する

Knowledge MCP のトラブルシューティング

インストール

Remote MCP Server（推奨）

NPM Package

Docker

クライアント設定

環境変数

リモート実行

リモートサーバー設定

Authorization Headers

セキュリティのベストプラクティス

トラブルシューティング

Code Mode を使用する理由

LLM は tool を呼び出すよりコードを書く方が得意

Context Window の肥大化を解消

Programmatic Orchestration によるレイテンシの削減

設計上より安全

あらゆる API サイズに対応

リソース