Clickup

🚀 ClickUp MCP 集成

ClickUp MCP 集成提供了一個 Model Context Protocol 服務器，它能與 ClickUp 實現無縫集成，讓大型語言模型可以與 ClickUp 工作區的任務和數據進行交互。

🚀 快速開始

構建

要構建此項目，請執行以下命令：

# 安裝依賴項
npm install

# 運行項目
node index.js

設置

配置

創建一個 config.json 文件並添加以下內容：

{
  "clickup": {
    "token": "your_clickup_api_token",
    "space_id": "your_clickup_space_id"
  }
}

環境變量

設置以下環境變量：

• CLICKUP_TOKEN：ClickUp API 令牌
• CLICKUP_SPACE_ID：ClickUp 工作區 ID

✨ 主要特性

此 MCP 服務器提供了以下工具來與 ClickUp 互動：

任務管理

• clickup_create_task：創建 ClickUp 工作區中的新任務
• clickup_get_task：使用 ID 獲取特定任務的詳細信息
• clickup_get_task_by_custom_id：使用自定義 ID 獲取任務信息
• clickup_update_task：通過其 ID 更新現有任務
• clickup_update_task_by_custom_id：通過自定義 ID 更新現有任務
• get_list_tasks：獲取列表中的所有任務，帶可選過濾

文檔管理

• clickup_search_docs：在特定父級中搜索文檔
• clickup_create_doc：在 ClickUp 中創建新文檔
• clickup_get_doc_pages：獲取 ClickUp 文檔中的所有頁面
• clickup_get_page：從 ClickUp 文檔中獲取特定頁面
• clickup_create_page：在 ClickUp 文檔中創建新頁面
• clickup_edit_page：編輯現有文檔中的頁面

自定義字段

• clickup_get_list_custom_fields：獲取列表中所有可訪問的自定義字段
• clickup_set_custom_field_value：為任務的自定義字段設置值
• clickup_set_custom_field_value_by_custom_id：使用任務的自定義 ID 設置自定義字段值

分配人員

• get_list_assignees：獲取列表中所有成員（潛在分配人員）

工作區結構

• get_spaces：獲取工作區
• get_space_users：獲取工作區中的用戶
• get_folders：獲取文件夾
• get_folder_tasks：獲取文件夾中的任務

🔧 故障排除

如果遇到 MCP 服務器的問題，請按照以下步驟進行故障排除：

1. 身份驗證錯誤：
   • 驗證 API 令牌是否正確
   • 確保 API 令牌具有執行操作所需的權限
   • 檢查工作區 ID 是否正確
2. 任務訪問問題：
   • 確認您是否有權訪問正在嘗試檢索的任務
   • 驗證任務 ID 是否正確且存在於您的工作區中
   • 檢查任務是否可能處於存檔狀態
3. 連接問題：
   • 確保 Docker 服務正常運行
   • 檢查網絡連接
   • 驗證環境變量在 MCP 配置中正確設置

📄 許可證

此 MCP 服務器根據 MIT 許可證分發。這意味著您可以在以下條件下自由使用、修改和分發該軟件：遵守 MIT 許可證的條款和條件。