Mcp Server

Dodo Payments TypeScript MCP Server

安装

直接调用

你可以通过 npx 直接运行 MCP Server：

export DODO_PAYMENTS_API_KEY="My Bearer Token"
export DODO_PAYMENTS_WEBHOOK_KEY="My Webhook Key"
export DODO_PAYMENTS_ENVIRONMENT="live_mode"
npx -y dodopayments-mcp@latest

通过 MCP 客户端

modelcontextprotocol.io 上列出了一部分现有客户端。如果你已经有客户端，请查阅其文档以安装 MCP 服务。

对于使用配置 JSON 的客户端，配置可能如下所示：

{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "My Bearer Token",
        "DODO_PAYMENTS_WEBHOOK_KEY": "My Webhook Key",
        "DODO_PAYMENTS_ENVIRONMENT": "live_mode"
      }
    }
  }
}

Cursor

如果你使用 Cursor，可以点击下方按钮安装 MCP 服务。你需要在 Cursor 的 mcp.json 中设置环境变量，该文件可在 Cursor Settings > Tools & MCP > New MCP Server 中找到。

VS Code

如果你使用 MCP，可以点击下方链接安装 MCP 服务。你需要在 VS Code 的 mcp.json 中设置环境变量，该文件可通过 Command Palette > MCP: Open User Configuration 找到。

打开 VS Code

Claude Code

如果你使用 Claude Code，可以在终端中运行下方命令来安装 MCP 服务。你需要在 Claude Code 的 .claude.json 中设置环境变量，该文件位于你的主目录中。

claude mcp add dodopayments_mcp_api --env DODO_PAYMENTS_API_KEY="My Bearer Token" DODO_PAYMENTS_WEBHOOK_KEY="My Webhook Key" -- npx -y dodopayments-mcp

代码模式

此 MCP 服务基于“代码模式”工具方案构建。在此 MCP 服务中，你的 Agent 将针对 TypeScript SDK 编写代码，然后代码会在隔离的沙箱中执行。为此，服务会向你的 Agent 提供两个工具：

• 第一个工具是文档搜索工具，可用于查询有关 API/SDK 的文档。

• 第二个工具是代码工具，Agent 可以在其中针对 TypeScript SDK 编写代码。 代码将在无法访问 Web 或文件系统的沙箱环境中执行。然后，代码返回或打印的任何内容都会作为工具调用的结果返回给 Agent。

通过这种方案，Agent 能够以确定且可重复的方式执行非常复杂的任务。

代码工具的要求

execute 工具会在本地 Deno 沙箱中运行代码，因此必须安装 Deno。服务会按以下顺序查找：

1. PATH 中的 deno 二进制文件。
2. 来自 deno npm package 的 deno 二进制文件，前提是该包安装在与此包相同的 node_modules 目录树中。

如果两者都找不到，execute 工具会返回错误，而所有其他工具（包括文档搜索）仍可正常工作。

说明

使用 npx 启动服务或全局安装服务时，第 2 条不适用，因为此时服务会从自身的缓存目录解析，而不是从你的项目中解析。由于 npx -y dodopayments-mcp 是最常见的运行方式，因此建议将 Deno 安装到 PATH 中。

警告

目前请使用 Deno 2.8 或更早版本。在 Deno 2.9+ 中，沙箱无法启动，因为绑定工作进程的 Unix 套接字开始要求该套接字具有 --allow-net 权限，而工作进程不会授予此权限。请注意，npm install deno 目前会安装受影响的版本。相关问题已在 #330 中跟踪。

重要

本地代码执行仅支持 macOS 和 Linux。Windows 上无法使用，因为沙箱通过 Unix 域套接字与 Deno 子进程通信，而 Deno 在 Windows 上运行时无法监听此类套接字（参见 denoland/deno#18236）。安装 Deno 也无法解决此问题。在 Windows 上，请在 WSL2 下运行服务，或直接调用 REST API 或 dodopayments SDK。

远程运行

使用 --transport=http 启动客户端，会通过 Streamable HTTP 传输将服务作为远程服务启动。--port 设置可指定运行端口，--socket 设置可让服务通过 Unix 套接字运行。

可以通过使用 Bearer 方案的 Authorization 标头提供授权。

此外，也可以通过以下标头提供授权：

标头	对应的客户端选项	安全方案
x-dodo-payments-api-key	bearerToken	API_KEY

假设此服务托管在 http://localhost:3000，配置 JSON 可能如下所示：

{
  "mcpServers": {
    "dodopayments_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer <auth value>"
      }
    }
  }
}