Clickup MCP Server

🚀 ClickUp MCP 服務器

ClickUp MCP 服務器是一個與 ClickUp 集成的 Model Context Protocol 服務器實現，它能讓 AI 助手與 ClickUp 工作區進行交互，為用戶提供更智能、便捷的工作體驗。

🚀 快速開始

配置 Claude 桌面版

首先，您需要對 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"
      }
    }
  }
}

重啟 Claude 桌面版

完成上述配置後，重啟 Claude 桌面版。之後，當有需要時，服務器會自動下載並啟動。

通過 Smithery 安裝

您也可以通過 Smithery 自動安裝 ClickUp MCP Server 用於 Claude 桌面版，使用以下命令：

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 空間中創建新佈告板

🔧 技術細節

開發步驟

克隆倉庫

首先，將項目倉庫克隆到本地。

安裝依賴項

使用以下命令安裝項目所需的依賴項：

npm install

以開發模式啟動

使用以下命令以開發模式啟動項目：

npm run dev

構建生產版本

使用以下命令構建項目的生產版本：

npm run build

運行測試

使用以下命令運行項目的測試：

npm test

安全措施

• 所有令牌均加密存儲，保障數據安全。
• 使用 OAuth2 流程進行安全身份驗證，確保用戶身份的合法性。
• 不記錄敏感數據，保護用戶隱私。
• 實現速率限制以防止 API 濫用，保證服務的穩定性。

📚 詳細文檔

常見問題

身份驗證錯誤

• 驗證環境變量中的 OAuth 憑據是否正確。
• 檢查令牌是否過期。
• 確保重定向 URI 正確。

速率限制

• 服務器實現自動速率限制處理。
• 查看日誌中的速率限制警告。
• 考慮實施請求批量處理。

服務器未啟動

• 檢查環境變量是否正確設置。
• 驗證端口 3000 是否可用。
• 檢查 Claude 桌面版日誌。

獲取日誌

Claude 桌面版的日誌位置如下：

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

📄 許可證

本項目採用 MIT License，詳情請參閱 LICENSE 文件。