ClickUp MCP 集成

一个提供与 ClickUp 无缝集成的 Model Context Protocol 服务器，允许大型语言模型与您的 ClickUp 工作区任务和数据进行交互。

可用工具

此 MCP 服务器提供了以下用于与 ClickUp 交互的工具：

clickup_create_task

在您的 ClickUp 工作区中创建新任务。

• 必需输入：
  • name (字符串)：任务名称
  • list_id (字符串)：将在其中创建任务的 ClickUp 列表 ID
• 可选输入：
  • markdown_description (字符串)：以 markdown 格式编写的任务描述
  • priority (数字)：任务优先级 (1=紧急, 2=高, 3=正常, 4=低)
  • due_date (数字)：到期日期（毫秒为单位的 Unix 时间戳）
  • tags (字符串数组)：要添加到任务中的标签名称
  • time_estimate (数字)：估计时间（毫秒）
• 返回：新创建的任务详情

clickup_get_task

使用任务 ID 检索特定任务的详细信息。

• 必需输入：
  • task_id (字符串)：ClickUp 任务 ID
• 返回：完整的任务详情，包括描述、状态、分配人员和元数据

clickup_get_task_by_custom_id

使用自定义 ID 检索任务信息。

• 必需输入：
  • custom_id (字符串)：任务的自定义 ID
• 返回：完整的任务详情，包括描述、状态、分配人员和元数据

构建

运行：

npm i
npm run build
npm run inspector

Docker 构建：

docker buildx build -t {your-docker-repository} --platform linux/amd64,linux/arm64 .
docker push {your-docker-repository}

设置

1. 获取您的 ClickUp API 令牌：

1. 登录到您的 ClickUp 账户 app.clickup.com
2. 通过点击左下角的个人资料图片导航到您的用户设置
3. 选择 "Settings"（设置）
4. 在左侧边栏中点击 "Apps"（应用程序）
5. 在 "API Token" 下，如果您还没有令牌，请点击 "Generate"（生成）
6. 复制生成的 API 令牌，以便在 MCP 服务器配置中使用

2. 查找您的工作区 ID：

1. 在您的网络浏览器中打开 ClickUp
2. 当您位于工作区时查看 URL
3. 工作区 ID 是 URL 中的数字值: https://app.clickup.com/{workspace_id}/home
4. 复制该数字，以便在 MCP 服务器配置中使用

3. 安装 Docker: https://docs.docker.com/engine/install/

4a. 设置 Cline MCP 服务器：

• 打开 VSCode 或 Jetbrains IDE 并进入 Cline。
• 前往 MCP Servers → Installed → Configure MCP Servers。
• 将以下内容添加到您的 cline_mcp_settings.json 文件中的 mcpServers 键内：

"clickup": {
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "CLICKUP_API_TOKEN",
    "-e",
    "CLICKUP_WORKSPACE_ID",
    "your-docker-repository"
  ],
  "env": {
    "CLICKUP_API_TOKEN": "your-api-token",
    "CLICKUP_WORKSPACE_ID": "your-workspace-id"
  }
}

4b. 设置 Claude Desktop MCP 服务器：

• 使用任何编辑器打开 Claude Desktop 的配置文件。
  • Windows: C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json
  • Mac: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• 将以下内容添加到您的 claude_desktop_config.json 文件中的 mcpServers 键内：

"clickup": {
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "CLICKUP_API_TOKEN",
    "-e",
    "CLICKUP_WORKSPACE_ID",
    "your-docker-repository"
  ],
  "env": {
    "CLICKUP_API_TOKEN": "your-api-token",
    "CLICKUP_WORKSPACE_ID": "your-workspace-id"
  }
}

• 保存配置文件
• 重启 Claude Desktop 以应用更改

故障排除

如果你遇到MCP服务器的问题：

1. 认证错误：

   • 确认你的API令牌是正确的
   • 确保API令牌具有你尝试执行的操作所需的权限
   • 检查你的工作区ID是否正确

2. 任务访问问题：

   • 确认你有权访问你试图检索的任务
   • 核实任务ID是否正确，并且存在于你的工作区中
   • 检查这些任务是否可能处于归档状态

3. 连接问题：

   • 确保你的Docker服务正常运行
   • 检查你的网络连接
   • 验证在MCP配置中的环境变量设置是否正确

许可证

此MCP服务器根据MIT许可证授权。这意味着你可以自由使用、修改和分发该软件，但需遵守MIT许可证的条款和条件。