---
title: "安装 Cloudflare 插件"
summary: "安装 cloudflare@openai-curated，包含开发技能和 cloudflare-api MCP。部署、DNS 和账号资源变更前确认目标。"
category: skills
level: starter
surfaces: [cli, app]
tags: ["plugins", "Cloudflare", "cloudflare@openai-curated", "MCP"]
canonical: /tips/cloudflare-openai-curated-plugin/
---

# 安装 Cloudflare 插件

安装 cloudflare@openai-curated，包含开发技能和 cloudflare-api MCP。部署、DNS 和账号资源变更前确认目标。

安装 cloudflare@openai-curated，包含开发技能和 cloudflare-api MCP。部署、DNS 和账号资源变更前确认目标。

这是把 Workers、Wrangler 和 Cloudflare API 接到 Codex。清单 [`plugin.json`](https://github.com/openai/plugins/blob/main/plugins/cloudflare/.codex-plugin/plugin.json) 的 name 是 `cloudflare`、version 是 `0.1.2`，所以精选 id 是 `cloudflare@openai-curated`。现行清单声明 `skills` 和 `mcpServers`，没有 `apps`。仓库根有 [`.mcp.json`](https://github.com/openai/plugins/blob/main/plugins/cloudflare/.mcp.json)，没有 `.app.json`。

CLI：

```bash
codex plugin add cloudflare@openai-curated
codex plugin list
```

不要写成 `plugin add cloudflare@cloudflare`：那是已收录的 `cloudflare-skills-plugin`，走 `marketplace add cloudflare/skills`。TUI `/plugins` 或桌面 Plugins 搜 Cloudflare 时，两份清单都可能叫 Cloudflare，以 `codex plugin list` 的 id 为准。IDE 扩展没有 `/plugins`，用 CLI 这条。

技能随这份精选包走，目录名是 `agents-sdk`、`building-ai-agent-on-cloudflare`、`building-mcp-server-on-cloudflare`、`cloudflare`、`durable-objects`、`sandbox-sdk`、`web-perf`、`workers-best-practices`、`wrangler`。斜杠命令是 `/cloudflare:build-agent` 和 `/cloudflare:build-mcp`。不要把厂商仓 cloudflare/skills 或官方 Codex 页里尚未打进这份精选包的 `cloudflare-email-service`、`cloudflare-one`、`nextjs-on-cloudflare`、`sandbox-next`、`turnstile-spin` 当成已装技能。不要 `npx skills add` 当 Codex 安装器，也不要手拷到 `~/.codex/skills`。openai/plugins 这份 README 仍写 npx skills / Clone Copy，那是纯技能回退，**不是** `plugin add cloudflare@openai-curated`。

现行 `plugin.json` **有**挂 `mcpServers`，`plugin add` 会登记 [`.mcp.json`](https://github.com/openai/plugins/blob/main/plugins/cloudflare/.mcp.json) 里的表：表名是 `cloudflare-api`，type 是 `http`，URL 是 `https://mcp.cloudflare.com/mcp`（**有** `/mcp` 后缀）。第一次连 MCP 走 OAuth。插件已经登记时，不要再手写 `mcp add cloudflare --url https://mcp.cloudflare.com/mcp` 叠一张：那张用户层表名是 `cloudflare`，精选包表名是 `cloudflare-api`。只要手写 MCP、不要技能包时，才走已收录的 `mcp-cloudflare-remote`。

0.154 起先看**当前会话**的 `/plugins` 和 `/mcp`；没有再新开。`codex plugin list` 里应看到 `cloudflare@openai-curated`。网页 Cloud 不读 `~/.codex/config.toml`。Cloud 用 Plugins 搜 Cloudflare，再核 id。

使用注意事项：

- 操作影响：部署 Worker、改 DNS、写账号资源会动真实项目。


## 来源

- [openai/plugins · cloudflare plugin.json](https://github.com/openai/plugins/blob/main/plugins/cloudflare/.codex-plugin/plugin.json)
- [openai/plugins · cloudflare .mcp.json](https://github.com/openai/plugins/blob/main/plugins/cloudflare/.mcp.json)
- [openai/plugins · wrangler SKILL.md](https://github.com/openai/plugins/blob/main/plugins/cloudflare/skills/wrangler/SKILL.md)