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 環境変数を構成します。