Clickup

🚀 ClickUp MCP 統合

Model Context Protocolサーバーで、ClickUpとシームレスに統合し、大規模言語モデルがClickUpワークスペースのタスクやデータとやり取りできるようにします。

🚀 クイックスタート

この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：フォルダー内のタスクを取得します。

📦 インストール

このプロジェクトをビルドするには、以下のコマンドを実行してください。

# 依存関係のインストール
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サーバーに問題が発生した場合は、以下の手順でトラブルシューティングを行ってください。

1. 認証エラー：

   • APIトークンが正しいことを確認します。
   • APIトークンが操作を実行するための必要な権限を持っていることを確認します。
   • ワークスペースIDが正しいことを確認します。

2. タスクアクセス問題：

   • アクセスしようとしているタスクにアクセス権があることを確認します。
   • タスクIDが正しく、ワークスペース内に存在することを確認します。
   • タスクがアーカイブ状態になっていないことを確認します。

3. 接続問題：

   • Dockerサービスが正常に動作していることを確認します。
   • ネットワーク接続を確認します。
   • 環境変数がMCP構成内で正しく設定されていることを確認します。

📄 ライセンス

このMCPサーバーはMITライセンスに基づいて配布されています。これは、MITライセンスの条項と条件に従うことを条件に、このソフトウェアを自由に使用、変更、配布できることを意味します。