基本能力
产品定位
ClickUp MCP Server 是一个集成 ClickUp 任务管理与 AI 应用的中间件服务，旨在通过标准化协议实现 AI 代理与 ClickUp 的无缝交互。
核心功能
- 任务管理：创建、更新、删除任务，支持批量操作，支持自然语言设置开始/截止日期，管理子任务、评论和附件。
- 标签管理：创建、更新、删除空间标签，支持自然语言颜色命令，自动生成对比前景色。
- 工作区组织：导航空间、文件夹和列表，创建和管理文件夹，组织列表。
- 集成特性：全局名称或 ID 查找，支持 Markdown 格式，内置速率限制，错误处理和验证。
适用场景
- AI 代理自动化管理 ClickUp 任务。
- 团队协作中通过自然语言指令管理任务和标签。
- 开发者在应用中集成 ClickUp 任务管理功能。
工具列表
| 工具名称 | 描述 |
|----------|------|
| get_workspace_hierarchy | 获取工作区结构 |
| create_task | 创建任务 |
| update_task | 修改任务 |
| get_tasks | 获取列表中的任务 |
| get_task | 获取单个任务详情 |
| create_space_tag | 创建标签 |
| add_tag_to_task | 为任务添加标签 |
| 更多工具 | 详见文档 |
常见问题解答
- 错误处理：提供清晰的错误消息，包括缺少参数、无效 ID、权限问题等。
- 日志级别：通过
LOG_LEVEL环境变量控制日志详细程度。
使用教程
使用依赖
- 获取 ClickUp API 密钥和团队 ID。
- API 密钥：ClickUp Settings
- 团队 ID：从工作区 URL 获取。
安装教程
NPX 安装
bash
npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id
配置文件安装
将以下内容添加到客户端的 MCP 设置 JSON 文件中：
json
{
"mcpServers": {
"ClickUp": {
"command": "npx",
"args": [
"-y",
"@taazkareem/clickup-mcp-server@latest"
],
"env": {
"CLICKUP_API_KEY": "your-api-key",
"CLICKUP_TEAM_ID": "your-team-id"
}
}
}
}
调试方式
- 设置日志级别：
bash
--env LOG_LEVEL=info - 检查错误消息：确保参数正确，权限充足。
