ClickUp MCP 服务器

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

<a href="https://glama.ai/mcp/servers/9a7p2exf6u"><img width="380" height="200" src="https://glama.ai/mcp/servers/9a7p2exf6u/badge" alt="ClickUp Server MCP server" /></a>

快速开始

1. 为桌面版 Claude 配置：

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@mcp/clickup-server"],
      "env": {
        "CLICKUP_CLIENT_ID": "your_client_id",
        "CLICKUP_CLIENT_SECRET": "your_client_secret",
        "CLICKUP_REDIRECT_URI": "http://localhost:3000/oauth/callback"
      }
    }
  }
}

2. 重启桌面版 Claude

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

通过 Smithery 安装

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

npx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude

环境变量

必需的环境变量：

• 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. 安装依赖项：

npm install

3. 在开发模式下启动：

npm run dev

4. 构建用于生产：

npm run build

5. 运行测试：

npm test

安全

• 所有令牌都以静态加密方式存储
• 用于安全身份验证的 OAuth2 流程
• 不记录敏感数据
• 速率限制以防止 API 滥用

故障排除

常见问题

1. 身份验证错误

   • 验证环境变量中的 OAuth 凭据
   • 检查令牌是否过期
   • 确保正确的重定向 URI

2. 速率限制

   • 服务器实现自动速率限制处理
   • 检查日志中的速率限制警告
   • 考虑实施请求批处理

3. 服务器未启动

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

获取日志

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

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

许可证

MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件