Clickup MCP Server

🚀 ClickUp MCP サーバーインタラクションガイド

ClickUp MCP サーバーは、AI アシスタントに統合サポートを提供するための拡張版 ClickUp 管理コンソールプロトコル (MCP) サーバーです。元の機能を拡張し、依存関係、リンク、タグ、コメント、および新しい ClickUp API ツールを含むタスク関係 API のサポートを追加しています。

🚀 クイックスタート

こんにちは！ClickUp MCP サーバーインタラクションガイドへようこそ！私はあなたの AI アシスタントをサポートするために、この拡張統合を利用して支援を提供する準備ができています。

私は以下の内容を詳細に説明することができます：

• ローカルでサーバーを設定する方法、または Railway にデプロイする手順
• サーバーを Claude や他の AI アシスタントに接続する方法
• タスク関係機能（依存関係、リンク、タグ）を利用する方法
• タスク、リスト、チャットビューでのコメント API の使用方法
• 新しい ClickUp API ツールをサポートするためにサーバーを拡張する方法

プロジェクト管理、製品開発、コンテンツカレンダー、またはその他のワークフローなど、具体的なユースケースに対する解決策が必要な場合は、お知らせください。

私は説明を分かりやすく保ち、特に要求がない限り、過度の技術的な詳細は避けます。

✨ 主な機能

1. タスク関係 API

• 依存関係：タスク間の依存関係を作成および管理します。
• リンク：異なるタスク間に関連付けを作成します。
• タグ：タスクにカスタムタグを追加して分類します。

2. コメント API

• タスクコメント：タスクにコメントを追加、編集、および削除します。
• リストコメント：リスト内の複数のタスクにコメントを投稿します。
• チャットビューコメント：チームチャット画面にコメント機能を統合します。

🔧 技術詳細

1. アーキテクチャの改善

• モジュール化設計：タイプ、サービス、およびツールの処理ロジックを定義することで拡張性を実現します。
• Open/Closed 原則：新しいコードは開閉原則に従い、保守とアップグレードを容易にします。

2. タイプ定義

• タスク関係とコメントの入出力データ形式を定義します。
• 例：

export interface TaskDependency {
  taskId: string;
  dependentTaskId: string;
}

3. サービスの実装

• ClickUp API とのやり取りのロジックを実装します。
• コードの断片例：

public async createTaskDependency(taskId: string, dependentTaskId: string): Promise<void> {
  try {
    const url = `/tasks/${taskId}/dependencies`;
    await this.axiosInstance.post(url, { taskId: dependentTaskId });
  } catch (error) {
    console.error('タスク依存関係の作成に失敗しました:', error);
    throw error;
  }
}

📦 インストール

ローカル開発手順

1. コードリポジトリをクローンします：

git clone https://github.com/v4lheru/clickup-mcp-server.git
cd clickup-mcp-server

2. 依存関係をインストールします：

npm install

3. 環境変数を設定します：

• CLICKUP_API_KEY 環境変数を設定します。

4. サーバーを起動します：

npm run dev

Railway へのデプロイ手順

1. 新しいアプリケーションを作成し、以下のビルドコマンドを設定します：

npm install && npm run build

2. ランタイムコマンドを設定します：

npm start

3. CLICKUP_API_KEY をシークレットとして設定します。

💻 使用例

基本的な使用法

// タスク依存関係を作成する
await clickupMcp.createTaskDependency('task1', 'task2');

// タスクコメントを追加する
await clickupMcp.addTaskComment('task1', 'これは新しいコメントです');

高度な使用法

サーバーの拡張

新しい ClickUp API ツールをサポートするために、サーバーを拡張することができます。

• タイプを定義します：

export interface NewClickupTool {
  id: string;
  name: string;
  description: string;
}

• サービスロジックを実装します。

AI アシスタントへの接続

RPC または HTTP リクエストを介して、あなたの ClickUp アカウントに接続します。

もし何か質問やさらなる支援が必要な場合は、いつでもお知らせください！