ClickUp MCP Server

ClickUp MCP 服务器

用于 ClickUp 集成的模型上下文协议服务器实现，使 AI 助手能够与 ClickUp 工作区进行交互。

快速入门

1. 配置 Claude 桌面版：

2. 重启 Claude 桌面版

就是这样！服务器将在需要时自动下载并启动。

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 ClickUp MCP 服务器：

环境变量

所需的环境变量：

• CLICKUP_CLIENT_ID ：您的 ClickUp OAuth 客户端 ID
• CLICKUP_CLIENT_SECRET ：您的 ClickUp OAuth 客户端密钥
• CLICKUP_REDIRECT_URI ：OAuth 重定向 URI（默认值： http://localhost:3000/oauth/callback ）

可选的环境变量：

• PORT ：服务器端口（默认值：3000）
• LOG_LEVEL ：日志记录级别（默认值：info）

可用工具

任务管理

• clickup_create_task ：在 ClickUp 列表中创建新任务
• clickup_update_task ：更新现有任务的属性

团队和列表管理

• clickup_get_teams ：检索所有可访问的团队
• clickup_get_lists ：获取特定文件夹中的所有列表

董事会管理

• clickup_create_board ：在 ClickUp 空间中创建一个新板

发展

1. 克隆存储库
2. 安装依赖项：

3. 以开发模式启动：

4. 为生产而构建：

5. 运行测试：

安全

• 所有令牌均处于静态加密状态
• 用于安全身份验证的 OAuth2 流程
• 未记录敏感数据
• 限制速率以防止 API 滥用

故障排除

常见问题

1. 身份验证错误
   • 在环境变量中验证您的 OAuth 凭据
   • 检查令牌过期
   • 确保正确的重定向 URI
2. 速率限制
   • 服务器实现自动速率限制处理
   • 检查日志中的速率限制警告
   • 考虑实施请求批处理
3. 服务器未启动
   • 检查环境变量是否正确设置
   • 验证端口 3000 是否可用
   • 检查 Claude 的桌面日志

获取日志

您可以在以下位置找到 Claude for Desktop 日志：

• Windows： %USERPROFILE%\AppData\Local\Claude\Logs\mcp*.log
• macOS： ~/Library/Logs/Claude/mcp*.log

执照

MIT 许可证 - 详情请参阅许可证文件