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 架构。Code Mode 不会为每个 API endpoint 暴露数百个独立工具，而是让 AI agent 在隔离的沙盒中针对 Dodo Payments SDK 编写并执行 TypeScript 代码。

主要功能

支付操作 — 创建、检索和管理支付与退款
订阅管理 — 处理 recurring billing、升级和取消
客户管理 — 管理客户数据和 portal 访问权限
产品目录 — 创建和更新产品、定价及折扣
许可证管理 — 激活、验证和管理 software licenses
基于用量的计费 — 跟踪用量并按用量计费

How Code Mode Works

Dodo Payments MCP Server 为您的 AI agent 提供两个工具：

Docs Search Tool — 查询有关 Dodo Payments API 和 SDK 的文档，以了解可用的操作和参数。
Code Execution Tool — 编写针对 SDK 的 TypeScript 代码，并在安全的沙盒中执行。

这种架构让 agent 能够在一次调用中执行复杂的多步骤操作。例如，agent 可以列出所有活跃订阅，按条件筛选，然后为每个订阅应用折扣——全部在一个脚本中完成。

Agent 可以串联多个 API 调用、处理条件逻辑并执行计算，而无需往返调用 LLM。

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 以及全部十七个 skill（OpenCode 还需要额外设置 skills.paths）。Gemini CLI 仅获得两个 MCP server，因为它不支持 agent-skill primitive。有关各 agent 的安装命令，请参阅 AI Coding Agents guide。如果您的代理不在该列表中，请使用下面的选项卡直接配置 MCP 服务器。

添加到 ~/.cursor/mcp.json：

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

添加到您的 Claude Desktop 配置：

{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.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": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/mcp"]
    }
  }
}

在终端中运行：

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

需要 Node.js 18 或更高版本。远程 server 使用 OAuth 进行身份验证。首次连接时，系统会提示您输入 API key 并选择环境。

Dodo 知识 MCP

除了用于执行 API 操作的 Dodo Payments MCP Server，我们还提供 Dodo Knowledge MCP——一个 semantic search server，可让 AI 助手即时访问 Dodo Payments 文档。

构建于 ContextMCP.ai: Dodo Knowledge MCP 由 ContextMCP 支持，使用向量嵌入实现快速的文档语义搜索。

什么是 Dodo Knowledge MCP？

Dodo Knowledge MCP 是一个提供 semantic documentation search 的远程 MCP server。使用自然语言查询查找相关文档，获取准确且最新的 Dodo Payments 信息，并且无需 API keys 或本地安装即可连接。

快速设置

在您的 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 负责连接远程 MCP server。

同时使用两个 MCP Server

要获得最佳的 AI 辅助开发体验，请同时使用两个 MCP server：

Server	用途	使用场景
Dodo Knowledge MCP	文档搜索	“如何处理 webhooks？”，“支持哪些支付方式？”
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 调用来实现该功能——全部在一次对话中完成。

Dodo Knowledge MCP 故障排除

如果遇到连接问题，请使用 rm -rf ~/.mcp-auth 清除 MCP authentication cache，重启 client application，检查 client logs 中的错误消息，并确认 Node.js 版本（需要 18+）。

Knowledge MCP Server

访问 Dodo Knowledge MCP 配置页面

安装

选择适合您工作流的安装方式。

远程 MCP Server（推荐）

无需本地设置或安装即可访问托管的 MCP server。

Access the remote server

在浏览器中访问 https://mcp.dodopayments.com。

Configure your MCP client

复制针对您特定 client 提供的 JSON 配置。对于 Cursor 或 Claude Desktop，请将其添加到 MCP settings：

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

Authenticate and configure

OAuth 流程将提示您：

输入您的 Dodo Payments API key
选择您的环境（test 或 live）
选择您的 MCP client type

请妥善保管您的 API key。开发期间请使用 test mode keys。

Complete setup

点击 Login and Approve 以授权连接。

连接后，您的 AI assistant 就可以代表您与 Dodo Payments API 交互。

NPM Package

在本地安装并运行 MCP server。

本地 server 会在 Deno sandbox 中运行您的代码。安装 Deno 2.8 或更早版本，并确保 deno 位于 PATH 上；Deno 2.9 及更高版本会导致 sandbox 无法启动。本地代码执行仅支持 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 始终获取最新版本，或固定到特定版本（例如 @2.51.0）以确保稳定性。

Docker

在 container 中运行 MCP server。

# 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 服务器。

在 Cursor 中设置 Dodo Payments MCP 服务器，以便通过对话访问你的支付数据。一键安装使用下方按钮直接在 Cursor 中安装 MCP 服务器：[ 添加到 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 助手有关你的 Dodo Payments 数据的问题，以验证连接。

在 Claude Desktop 中设置 Dodo Payments MCP 服务器，以便通过对话访问你的支付数据。

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 服务器已连接。

在 Claude Code CLI 中设置 Dodo Payments MCP 服务器。在终端中运行以下命令：

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 中读取环境变量，因此你也可以在运行命令前导出这些变量。

在 VS Code 中设置 Dodo Payments MCP 服务器。一键安装打开 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 服务器：

{
  "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 服务器。

在 Cline（VS Code）中设置 Dodo Payments MCP 服务器，以便通过对话访问你的支付数据。

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 服务器配置：

{
  "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 服务器连接。

在 Zed 中设置 Dodo Payments MCP 服务器，以便通过对话访问你的支付数据。

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

保存配置。现在，MCP 服务器应该已在 Zed 的 AI 助手中可用。

在其他兼容 MCP 的客户端中设置 Dodo Payments MCP 服务器。远程服务器（推荐）

{
  "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"
      }
    }
  }
}

访问 modelcontextprotocol.io/clients，查看兼容 MCP 的客户端及其配置方法的完整列表。

环境变量

使用环境变量配置 MCP 服务器行为。

变量	描述	必填
`DODO_PAYMENTS_API_KEY`	你的 Dodo Payments API 密钥	是
`DODO_PAYMENTS_WEBHOOK_KEY`	你的 webhook 签名密钥	否
`DODO_PAYMENTS_ENVIRONMENT`	`live_mode` 或 `test_mode`；默认为 `live_mode`	否

远程运行

将 MCP 服务器部署为远程 HTTP 服务器，以供基于 Web 的客户端或代理工作流使用。

# 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"
      }
    }
  }
}

Authorization Headers

远程服务器接受通过以下标头进行的身份验证：

标头	用途
`Authorization`	Bearer token 身份验证
`x-dodo-payments-api-key`	直接 API 密钥标头

安全最佳实践

Code Mode 通过在沙盒环境中执行代码并在服务器端注入 API 密钥，提供了内置安全性。请遵循以下最佳实践来保护你的凭据。

API Key Management

切勿将凭据提交到版本控制系统。请将 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 密钥，以避免影响生产数据。

Access Control

进行远程部署时，始终要求通过 Authorization 标头或 x-dodo-payments-api-key 标头进行身份验证。

Network Security

始终将远程 MCP 服务器部署在 HTTPS 端点之后。通过在 MCP 服务器和 API 层面实施速率限制来防止滥用。配置防火墙规则，限制可连接到 MCP 服务器的客户端。

故障排除

Connection issues

确认你的 API 密钥已正确设置，并且拥有必要的权限：

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

检查是否可以访问 Dodo Payments API 端点。在 MCP 客户端中启用详细日志，以诊断连接问题。

Authentication errors

确保使用测试密钥访问测试端点，并使用正式密钥访问生产端点。确认 DODO_PAYMENTS_ENVIRONMENT 设置正确（生产环境应设置为 live_mode）。如果问题仍然存在，请通过控制面板生成新的 API 密钥。

Tool execution failures

确保 AI 助手为每个工具提供格式正确的参数。检查 API 返回的错误响应，了解具体问题。通过 curl 或 Postman 直接调用 Dodo Payments API，确认该操作是否正常。

为什么选择 Code Mode

传统 MCP 实现存在“工具泛滥”问题，即每个 API 端点都作为独立工具公开。Code Mode 在以下几个方面更具优势：

LLM 更擅长编写代码，而不是调用工具

LLM 使用数百万行真实世界的代码进行训练，因此天然擅长编写脚本。工具调用通常基于合成示例。

“让 LLM 通过工具调用执行任务，就像让莎士比亚参加一个为期一个月的普通话课程，然后要求他用普通话写一部戏剧。” — Cloudflare

消除上下文窗口膨胀

在传统方法中，每个工具定义都会在对话开始前消耗 token。公开 50 多个工具可能消耗 55K–100K+ token。Anthropic 发现，在优化前，工具定义最多可能消耗 134K token。 Code Mode 只加载 2 个工具定义（约 1K token）。代理会按需搜索文档。Anthropic 的 Tool Search Tool 保留了 95% 的上下文窗口，将开销从 77K token 降至 8.7K token。

通过程序化编排降低延迟

传统工具调用要求每个操作都完成一次完整的模型推理往返。如果任务需要调用 20 次 API，就需要 20 次往返。在 Code Mode 中，代理编写一个脚本来执行所有调用，并仅返回最终结果。 Anthropic 观察到，采用这种方法后 token 减少了 37%，准确率也有所提升（知识检索准确率从 25.6% 提高到 28.5%）。

设计上更加安全

Code Mode 提供了内置的安全优势：

参数中不包含 API 密钥 — API 密钥在服务器端注入，永远不会暴露在发送给 LLM 的工具参数中。
隔离的沙盒 — 代码在安全环境中运行，无法访问网络或主机文件系统。
受控的 SDK — 代理只能使用经过授权的 SDK 方法。

可扩展到任意规模的 API

随着 API 增长，传统 MCP 的性能会因必须加载更多工具而下降。无论 API 的规模如何，Code Mode 始终只使用 2 个工具。Cloudflare 将超过 2,500 个 API 端点整合为 2 个工具和约 1,000 个上下文 token。

如需了解更多详情，请参阅 Anthropic 和 Cloudflare 的工程博客，以及 Claude 的 Programmatic Tool Calling 文档。

资源

API Reference

探索完整的 Dodo Payments API 文档

MCP Protocol

详细了解 Model Context Protocol 标准

GitHub Repository

查看 MCP 服务器源代码并参与贡献

NPM Package

从 NPM 安装 MCP 服务器

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Overview

主要功能

How Code Mode Works

Quick Setup

Dodo 知识 MCP

什么是 Dodo Knowledge MCP？

快速设置

同时使用两个 MCP Server

Dodo Knowledge MCP 故障排除

Knowledge MCP Server

安装

远程 MCP Server（推荐）

NPM Package

Docker

客户端配置

环境变量

远程运行

远程服务器配置

Authorization Headers

安全最佳实践

故障排除

为什么选择 Code Mode

LLM 更擅长编写代码，而不是调用工具

消除上下文窗口膨胀

通过程序化编排降低延迟

设计上更加安全

可扩展到任意规模的 API

资源

API Reference

MCP Protocol

GitHub Repository

NPM Package

​Overview

​主要功能

​How Code Mode Works

​Quick Setup

​Dodo 知识 MCP

​什么是 Dodo Knowledge MCP？

​快速设置

​同时使用两个 MCP Server

​Dodo Knowledge MCP 故障排除

Knowledge MCP Server

​安装

​远程 MCP Server（推荐）

​NPM Package

​Docker

​客户端配置

​环境变量

​远程运行

​远程服务器配置

​Authorization Headers

​安全最佳实践

​故障排除

​为什么选择 Code Mode

​LLM 更擅长编写代码，而不是调用工具

​消除上下文窗口膨胀

​通过程序化编排降低延迟

​设计上更加安全

​可扩展到任意规模的 API

​资源

API Reference

MCP Protocol

GitHub Repository

NPM Package

Overview

主要功能

How Code Mode Works

Quick Setup

Dodo 知识 MCP

什么是 Dodo Knowledge MCP？

快速设置

同时使用两个 MCP Server

Dodo Knowledge MCP 故障排除

安装

远程 MCP Server（推荐）

NPM Package

Docker

客户端配置

环境变量

远程运行

远程服务器配置

Authorization Headers

安全最佳实践

故障排除

为什么选择 Code Mode

LLM 更擅长编写代码，而不是调用工具

消除上下文窗口膨胀

通过程序化编排降低延迟

设计上更加安全

可扩展到任意规模的 API

资源