AI导哈

ClickUp集成服务

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

  • by Leanware-io
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 leanware-io/clickup-mcp-server

使用说明

ClickUp MCP集成

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

可用工具

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

任务管理

  • clickup_create_task：在ClickUp工作区中创建新任务
  • clickup_get_task：使用特定任务的ID检索其详细信息
  • clickup_get_task_by_custom_id：使用自定义ID检索任务信息
  • clickup_update_task：按ID更新现有任务
  • clickup_update_task_by_custom_id：按自定义ID更新现有任务
  • get_list_tasks：从具有可选筛选的列表中获取所有任务

文档管理

  • clickup_search_docs：在特定父级中搜索文档
  • clickup_create_doc：在ClickUp中创建新文档
  • clickup_get_doc_pages：从ClickUp文档中获取所有页面
  • clickup_get_page：从ClickUp文档中获取特定页面
  • clickup_create_page：在ClickUp文档中创建新页面
  • clickup_edit_page：编辑ClickUp文档中的现有页面

自定义字段

  • clickup_get_list_custom_fields：获取列表的所有可访问自定义字段
  • clickup_set_custom_field_value：为任务上的自定义字段设置值
  • clickup_set_custom_field_value_by_custom_id：使用任务的自定义ID设置自定义字段值

受托人

  • get_list_assignees：获取列表的所有成员（潜在受让人）

工作区结构

  • get_spaces：获取工作区中的所有空格
  • get_folders：获取空间中的所有文件夹
  • get_lists：获取文件夹中的所有列表
  • create_list：在文件夹中创建新列表

构建

运行：

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. 选择“设置”
  4. 点击左侧边栏中的“应用程序”
  5. 在“API令牌”下，如果您还没有令牌，请单击“生成”
  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。设置临床MCP服务器：

  • 打开VSCode或Jetbrains IDE，然后转到Cline。
  • 转到MCP服务器→ 已安装→ 配置MCP服务器。
  • 将以下内容添加到您的 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桌面MCP服务器：

  • 使用任何编辑器打开Claude Desktop的配置文件。
    • 窗户： C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json
    • 雨衣： ~/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许可证的条款和条件自由使用、修改和分发软件。

相关 MCP