ClickUp MCP 集成

模型上下文协议服务器可与 ClickUp 无缝集成，允许大型语言模型与您的 ClickUp 工作区任务和数据进行交互。

可用工具

该 MCP 服务器提供以下与 ClickUp 交互的工具：

clickup_create_task

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

• 所需输入：
  • name （字符串）：任务名称
  • list_id (string)：将创建任务的 ClickUp 列表 ID
• 可选输入：
  • markdown_description (string): 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
• 返回：完整的任务详细信息，包括描述、状态、受让人和元数据

建造

跑步：

Docker 构建：

设置

1.获取您的 ClickUp API 令牌：

1. 登录您的 ClickUp 帐户，网址为app.clickup.com
2. 点击左下角的个人资料图片，导航至用户设置
3. 选择“设置”
4. 点击左侧边栏中的“应用程序”
5. 如果您还没有令牌，请点击“API 令牌”下的“生成”
6. 复制生成的 API 令牌以用于 MCP 服务器配置

2. 查找您的工作区 ID：

1. 在 Web 浏览器中打开 ClickUp
2. 在工作区时查看 URL
3. 工作区 ID 是 URL 中的数字值： https://app.clickup.com/{workspace_id}/home workspace_id}/home
4. 复制此号码以用于 MCP 服务器配置

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

4a. 设置 Cline MCP 服务器：

• 打开 VSCode 或 Jetbrains IDE 并转到 Cline。
• 转到 MCP 服务器 → 已安装 → 配置 MCP 服务器。
• 将以下内容添加到cline_mcp_settings.json的mcpServers键内：

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键内：

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

故障排除

如果您遇到 MCP 服务器问题：

1. 身份验证错误：
   • 验证您的 API 令牌是否正确
   • 确保 API 令牌具有执行您尝试的操作所需的权限
   • 检查你的工作区ID是否正确
2. 任务访问问题：
   • 确认您有权访问您尝试检索的任务
   • 验证任务 ID 是否正确并且存在于您的工作区中
   • 检查任务是否处于存档状态
3. 连接问题：
   • 确保您的 Docker 服务正常运行
   • 检查网络连接
   • 验证 MCP 配置中的环境变量是否正确设置

执照

此 MCP 服务器遵循 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。