官方MCP驱动的工作空间智能中枢

通过官方MCP服务器管理ClickUp任务、文档、时间追踪和团队协作，支持OAuth认证，适合需要AI自动化工作流管理的团队。

基本信息

• 技能名称?ClickUp MCP
• 中文名称?官方MCP驱动的工作空间智能中枢
• 作者?pvoo
• 分类?专业技能
• 版本?1.0.0
• 标签?project-management, task-automation, oauth, clickup, mcp, time-tracking, team-collaboration, official-api

使用方法

使用说明
ClickUp MCP (Official) 综合评估
ClickUp MCP 是由 ClickUp 官方提供的模型上下文协议服务器，允许AI助手通过标准化接口管理 ClickUp 工作空间的完整功能。该工具集成了32个API端点，涵盖任务管理、文档协作、时间追踪、团队聊天和全局搜索等核心工作流。
核心用法
认证方式 ：支持OAuth 2.0授权，但仅限Claude Desktop、Cursor、VS Code、Windsurf、ChatGPT等白名单客户端。非支持客户端可通过Claude Code获取token后转接至mcporter使用。Token有效期约10年，属于长期凭证。
主要功能模块 ：
任务全生命周期 ：创建、更新、查询、添加标签/附件/评论
时间追踪 ：启动/停止计时器、手动录入工时、查询历史记录
工作空间结构 ：获取层级结构(Spaces→Folders→Lists)、创建列表和文件夹
团队协作 ：成员查询、@提及评论、聊天频道消息发送
文档管理 ：创建文档、增删改查页面内容
全局搜索 ：跨任务、文档、仪表板、聊天、文件的全局检索
典型场景 ：自动化任务创建与分配、工时统计报告生成、 sprint 进度监控、文档知识库维护、跨工具工作流编排。
显著优点

1. 官方背书 ：由ClickUp官方开发和维护，API稳定性与兼容性有保障
2. 功能完整 ：覆盖ClickUp核心功能，远超第三方非官方集成
3. 标准化接口 ：基于MCP协议，可与支持MCP的AI客户端无缝集成
4. 长期Token ：OAuth token有效期约10年，减少频繁重新授权的负担
5. 安全设计 ：无删除操作权限，降低误操作风险
   潜在缺点与局限
6. 认证限制严苛 ：必须依赖白名单客户端进行初始OAuth，增加了非标准环境的使用复杂度
7. 功能缺口 ：不支持自定义字段管理、视图(View)操作、删除操作
8. 速率限制 ：与ClickUp API共享限流(~100请求/分钟)，大规模自动化场景可能受限
9. token提取流程繁琐 ：mcporter方案需要手动从Claude Code凭证文件中提取并配置环境变量
10. 无离线能力 ：完全依赖ClickUp云服务，无本地缓存或离线操作模式
    适合人群
    已深度使用ClickUp作为项目管理中枢的团队
    需要将AI助手集成到现有工作流的技术团队
    追求官方稳定性而非功能灵活性的企业用户
    已通过Claude Code/Claude Desktop等工作环境的开发者
    常规风险
    安全风险 ：OAuth token长期有效(10年)，一旦泄露可导致完整工作空间访问权限被滥用。建议严格保管 ~/.clawdbot/.env 文件，避免提交至版本控制。
    操作风险 ：虽无删除权限，但批量创建任务、修改状态、发送聊天消息等操作仍可能造成工作流混乱或信息干扰。
    合规风险 ：工作空间成员数据、任务内容、聊天记录均通过第三方AI服务处理，需评估是否符合企业数据出境和隐私保护要求。
    可用性风险 ：依赖ClickUp官方MCP服务的持续运营，若官方调整策略或下线服务，自动化工作流将中断。