ClickUp MCP Server

基本能力

产品定位

ClickUp MCP Server 是一个为 ClickUp 集成实现的 Model Context Protocol 服务器，使 AI 助手能够与 ClickUp 工作区进行交互。

核心功能

• 任务管理：创建和更新 ClickUp 任务
• 团队和列表管理：获取可访问的团队和列表
• 看板管理：在 ClickUp 空间中创建新看板

适用场景

• 需要将 AI 助手与 ClickUp 工作区集成的场景
• 自动化 ClickUp 任务管理的场景

工具列表

• clickup_create_task: 在 ClickUp 列表中创建新任务
• clickup_update_task: 更新现有任务的属性
• clickup_get_teams: 检索所有可访问的团队
• clickup_get_lists: 获取特定文件夹中的所有列表
• clickup_create_board: 在 ClickUp 空间中创建新看板

常见问题解答

1. 认证错误
2. 验证环境变量中的 OAuth 凭据
3. 检查令牌是否过期

4. 确保重定向 URI 正确

5. 速率限制

6. 服务器实现了自动速率限制处理
7. 检查日志中的速率限制警告

8. 考虑实施请求批处理

9. 服务器无法启动

10. 检查环境变量是否设置正确
11. 验证端口 3000 是否可用
12. 检查 Claude for Desktop 日志

使用教程

使用依赖

需要安装 Node.js 和 npm。

安装教程

1. 克隆仓库
2. 安装依赖:

npm install

1. 启动开发模式:

npm run dev

1. 构建生产版本:

npm run build

1. 运行测试:

npm test

调试方式

• 检查 Claude for Desktop 日志:
• Windows: %USERPROFILE%\AppData\Local\Claude\Logs\mcp*.log
• macOS: ~/Library/Logs/Claude/mcp*.log

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。