Nazruden Clickup MCP Server

🚀 ClickUp MCP サーバー

このプロジェクトは、ClickUpと統合されたMCPプロトコルサーバーの実装です。AIアシスタントがClickUpのワークスペースとやり取りできるようになります。

🚀 クイックスタート

1. Claude for Desktopを設定します。

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@mcp/clickup-server"],
      "env": {
        "CLICKUP_CLIENT_ID": "your_client_id", // あなたのClickUpクライアントIDに置き換えてください
        "CLICKUP_CLIENT_SECRET": "your_client_secret", // あなたのClickUpクライアントシークレットに置き換えてください
        "CLICKUP_REDIRECT_URI": "http://localhost:3000/oauth/callback" // デフォルトのリダイレクトURI
      }
    }
  }
}

2. Claude for Desktopを再起動します。

以上で完了です！サーバーは必要に応じて自動的にダウンロードされ、起動します。

📦 インストール

環境変数の設定

必須環境変数：

• CLICKUP_CLIENT_ID：あなたのClickUp OAuthクライアントID
• CLICKUP_CLIENT_SECRET：あなたのClickUp OAuthクライアントシークレット
• CLICKUP_REDIRECT_URI：OAuthリダイレクトURI（デフォルト：http://localhost:3000/oauth/callback）

オプション環境変数：

• PORT：サーバーのポート（デフォルト：3000）
• LOG_LEVEL：ログレベル（デフォルト：info）

開発環境のセットアップ

1. リポジトリをクローンします。

git clone [仓库地址]

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

npm install

3. 開発モードを起動します。

npm run dev

4. 本番バージョンをビルドします。

npm run build

5. テストを実行します。

npm test

✨ 主な機能

タスク管理

• clickup_create_task：ClickUpのリストに新しいタスクを作成します。
• clickup_update_task：既存のタスクの属性を更新します。

チームとリスト管理

• clickup_get_teams：アクセス可能なすべてのチームを取得します。
• clickup_get_lists：特定のフォルダ内のすべてのリストを取得します。

ボード管理

• clickup_create_board：ClickUpのスペースに新しいボードを作成します。

🔧 技術詳細

セキュリティ対策

• すべてのトークンは暗号化されて保存されます。
• OAuth2フローを使用して安全な認証を実現しています。
• 機微なデータは記録されません。
• APIの乱用を防止するためにレート制限が実装されています。

一般的な問題と解決策

認証エラー

• 環境変数内のOAuth資格情報が正しく設定されていることを確認してください。
• トークンの有効期限を確認してください。
• リダイレクトURIが一致することを確認してください。

レート制限

• サーバーには自動的なレート制限処理が実装されています。
• レート制限に関する警告情報をログで確認してください。
• 制限の影響を減らすために、バッチリクエストを検討してください。

サーバーが起動しない場合

• 環境変数が正しく設定されていることを確認してください。
• ポート3000が使用可能であることを確認してください。
• Claude for Desktopのログを確認してください。

ログの取得

Claude for Desktopのログパスは以下の通りです。

• Windows：%USERPROFILE%\AppData\Local\Claude\Logs\mcp*.log
• macOS：~/Library/Logs/Claude/mcp*.log

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。