﻿---
title: "安装 ClickUp 插件"
summary: "安装 clickup@openai-curated 并连接 ClickUp，用于任务和文档工作流。可用操作以账号权限和插件提供的工具为准。"
category: skills
level: starter
surfaces: [cli, app]
tags: ["plugins", "ClickUp", "clickup@openai-curated"]
canonical: /tips/clickup-codex-plugin/
---

# 安装 ClickUp 插件

安装 clickup@openai-curated 并连接 ClickUp，用于任务和文档工作流。可用操作以账号权限和插件提供的工具为准。

安装 clickup@openai-curated 并连接 ClickUp，用于任务和文档工作流。可用操作以账号权限和插件提供的工具为准。

这是 ClickUp 做的任务插件，用已同步的 spaces / lists / tasks / docs 回答进度，并在工作区允许时新建或改任务、子任务和列表。产品页是 [ClickUp](https://openai.com/business/plugins/clickup/)。清单 [`plugin.json`](https://github.com/openai/plugins/blob/main/plugins/clickup/.codex-plugin/plugin.json) 的 name 是 `clickup`、version 是 `1.0.3`，所以精选 id 是 `clickup@openai-curated`。现行清单只声明 [`.app.json`](https://github.com/openai/plugins/blob/main/plugins/clickup/.app.json)，没有 `skills` 字段，也没有 `mcpServers` 字段。

CLI：

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

TUI `/plugins` 或桌面 Plugins 搜 ClickUp 再装，效果一样。装完按提示 Connect ClickUp 账号。IDE 扩展没有 `/plugins`，用 CLI 这条。

仓库另有 [`.mcp.json`](https://github.com/openai/plugins/blob/main/plugins/clickup/.mcp.json)，表名是 `clickup`，type 是 http，URL 是 `https://mcp.clickup.com/mcp`（带 `/mcp`）。因为现行 `plugin.json` **没有**挂 `mcpServers`，不要假设 `plugin add` 会自动叠这张 MCP 表。只要 MCP、不要 App 时，才手写 `mcp add clickup --url https://mcp.clickup.com/mcp`。

在支持的 Codex 任务视图里，打开 Sources → Use plugins，再搜已安装的 ClickUp。ChatGPT 里可以用 `@ClickUp`。

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

使用注意事项：

- 操作影响：建任务、改状态、改列表会动真实 ClickUp 工作区。


## 来源

- [OpenAI · ClickUp](https://openai.com/business/plugins/clickup/)
- [openai/plugins · clickup plugin.json](https://github.com/openai/plugins/blob/main/plugins/clickup/.codex-plugin/plugin.json)
- [openai/plugins · clickup .mcp.json](https://github.com/openai/plugins/blob/main/plugins/clickup/.mcp.json)
