ClickUp MCP Server

Supergateway 搭載 ClickUp MCP サーバー

この統合により、ClickUp MCP サーバーが Supergateway を介して実行され、n8n ノードまたはその他のクライアントが使用できる SSE エンドポイントとして公開されます。

前提条件

• Node.js 18以上
• Docker と Docker Compose (コンテナ化されたデプロイメント用)
• ClickUp APIキーとチームID

地域開発

Node.jsで実行する

1. 依存関係をインストールします:
   npm install -g supergateway @taazkareem/clickup-mcp-server
2. 環境変数を設定します。
   export CLICKUP_API_KEY=pk_94547006_D8DFEXXFDOX7RUOJBBPLM2BSVRFXPZE9 export CLICKUP_TEAM_ID=2357720
3. 統合スクリプトを実行します。
   ./run-clickup-mcp.sh
4. 構成をカスタマイズする（オプション）:
   ./run-clickup-mcp.sh --port 9000 --base-url http://example.com --cors "http://localhost:8080,http://localhost:3000"

Docker Composeで実行する

1. .env.exampleに基づいて.envファイルを作成します。
   cp .env.example .env
2. ClickUp API キーとチーム ID を使用して.envファイルを編集します。
3. コンテナを起動します。
   docker-compose up -d
4. ログを表示:
   docker-compose logs -f

鉄道への展開

1. 鉄道に新しいプロジェクトを作成します。
2. GitHub リポジトリを接続するか、Railway CLI を使用してデプロイします。
3. Railway で次の環境変数を設定します。
   • CLICKUP_API_KEY : ClickUp APIキー
   • CLICKUP_TEAM_ID : ClickUpチームID
   • PORT : 8000 (または希望するポート)
   • BASE_URL : 鉄道アプリの URL (例: https://your-app-name.up.railway.app )
   • SSE_PATH : /sse (または任意のパス)
   • MESSAGE_PATH : /message (または任意のパス)
   • LOG_LEVEL : info (またはより詳細なログ記録の場合は debug)
   • DOCUMENT_SUPPORT : false（必要な場合はtrue）
   • CORS_ORIGINS : * (または許可されたオリジンのコンマ区切りリスト)
4. アプリケーションをデプロイします。

n8nでの使用

1. n8n で、新しい「MCP」ノードを追加します。
2. 次の設定でノードを構成します。
   • サーバー URL: 鉄道アプリの URL + SSE パス (例: https://your-app-name.up.railway.app/sse )
   • メッセージパス: メッセージパス (例: /message)
3. 利用可能なツールから目的の ClickUp ツールを選択します。
4. 必要に応じてツールのパラメータを構成します。
5. ノードをワークフローに接続します。

APIエンドポイント

• SSEエンドポイント: {BASE_URL}{SSE_PATH} (例: http://localhost:8000/sse )
  • メソッド: GET
  • 説明: サーバーから送信されたイベントをサブスクライブする
• メッセージエンドポイント: {BASE_URL}{MESSAGE_PATH} (例: http://localhost:8000/message )
  • メソッド: POST
  • 説明: サーバーにメッセージを送信する
  • コンテンツタイプ: application/json
  • 本文: JSON-RPC 2.0形式のメッセージ
• ヘルスチェックエンドポイント: {BASE_URL}/healthz (例: http://localhost:8000/healthz )
  • メソッド: GET
  • 説明: サービスが正しく実行されているかどうかを確認します
  • 応答: サービスが正常であれば「ok」

トラブルシューティング

• 接続の問題: ファイアウォールが指定されたポートへの接続を許可していることを確認してください。
• 認証エラー: ClickUp API キーとチーム ID が正しいことを確認してください。
• CORS エラー: クライアントのオリジンを含めるように CORS_ORIGINS 環境変数を構成します。