---
title: "安装 Dodo Payments 插件"
summary: "安装 dodopayments@dodopayments 后，通过 OAuth 登录 API 服务。文档服务 dodo-knowledge 无需认证。"
category: skills
level: starter
surfaces: [cli, app, ide]
tags: ["Dodo", "插件", "MCP", "Billing"]
canonical: /tips/dodo-payments-codex-plugin/
---

# 安装 Dodo Payments 插件

安装 dodopayments@dodopayments 后，通过 OAuth 登录 API 服务。文档服务 dodo-knowledge 无需认证。

Dodo Payments 官方插件先 marketplace add dodopayments/dodo-agent-plugin，再装 dodopayments。这是 Dodo Payments 的官方 Codex 专节，不是 Polar、Stripe、RevenueCat。插件把十七个技能和两台 HTTP MCP 打成一包。清单名和插件名都是 `dodopayments`：

```bash
codex plugin marketplace add dodopayments/dodo-agent-plugin
codex plugin add dodopayments@dodopayments
```

`codex plugin list` 应看到 `dodopayments@dodopayments` 为 installed, enabled。以后刷新：`codex plugin marketplace upgrade dodopayments`。旧文档曾写「Codex 没有 plugin add，只能进 TUI `/plugins`」。现行 CLI 有 `plugin add`；从来没有 `codex plugin install`。桌面先在终端加 marketplace，再 Plugins 把源切到 Dodo Payments 点加号。0.154 起可先检查当前会话；未显示插件时再新开会话。IDE 扩展没有 `/plugins`，用 CLI 加完再到 TUI 或桌面去装。

规范 `mcp.json` 是 Streamable HTTP，两台表名不要改：

- `dodo-knowledge` → `https://knowledge.dodopayments.com/mcp`。文档语义检索，**不要** API key，也**不要** `mcp login`。
- `dodopayments-api` → `https://mcp.dodopayments.com/mcp`。交互走 OAuth：

```bash
codex mcp login dodopayments-api
```

装完插件就**不要**再 `mcp add` 重复配置。生成的 `.mcp.json` 和 `.codex-plugin/plugin.json` 指向 `npx mcp-remote`，那是 Claude / VS Code 兼容层。Codex 自己走 HTTP。若 `codex mcp get dodopayments-api` 看到 command 是 `npx`，不要把那份 stdio 抄进用户 `config.toml`；改用手写 `--url`，并先去掉插件那套。

没有插件、只要 MCP 时才手写：

```bash
codex mcp add dodo-knowledge --url https://knowledge.dodopayments.com/mcp
codex mcp add dodopayments-api --url https://mcp.dodopayments.com/mcp
codex mcp login dodopayments-api
```

```toml
[mcp_servers.dodo-knowledge]
url = "https://knowledge.dodopayments.com/mcp"
enabled = true

[mcp_servers.dodopayments-api]
url = "https://mcp.dodopayments.com/mcp"
enabled = true
```

API 服务是 Code Mode：文档检索 + 沙箱里跑 TypeScript，按需执行 API 操作。能建支付、改订阅、退款，保留操作审批。无头 / CI 才考虑本机 `npx dodopayments-mcp` 加 `DODO_PAYMENTS_API_KEY`，不要和已经 login 的 OAuth 写在重复的服务配置。密钥前缀是 `dodo_test_` / `dodo_live_`，不要写进 `http_headers`、`args` 或提示词。

仓库根的 `AGENTS.md` 可以写「查文档走 dodo-knowledge、改账走 dodopayments-api、webhook 要验签、密钥只放环境变量」；按你们栈改，不要整段粘贴官方示例。网页 Cloud 不读取 `~/.codex/config.toml`。用 `codex mcp get dodopayments-api` 看传输是 streamable_http。

## 来源

- [Dodo Payments · Build with AI coding agents](https://docs.dodopayments.com/developer-resources/build-with-ai-coding-agents)
- [Dodo Payments · MCP server](https://docs.dodopayments.com/developer-resources/mcp-server)
- [Dodo Payments · Agent skills](https://docs.dodopayments.com/developer-resources/agent-skills)
- [dodopayments/dodo-agent-plugin](https://github.com/dodopayments/dodo-agent-plugin)
- [dodopayments/skills](https://github.com/dodopayments/skills)