Clickup MCP Server

🚀 ClickUp MCP サーバ

ClickUp と統合された Model Context Protocol サーバの実装で、AI アシスタントが ClickUp ワークスペースとやり取りできるようになります。

🚀 クイックスタート

手動設定によるセットアップ

1. Claude デスクトップ版を設定します：

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@mcp/clickup-server"],
      "env": {
        "CLICKUP_CLIENT_ID": "your_client_id",
        "CLICKUP_CLIENT_SECRET": "your_client_secret",
        "CLICKUP_REDIRECT_URI": "http://localhost:3000/oauth/callback"
      }
    }
  }
}

2. Claude デスクトップ版を再起動します。

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

Smithery を使用したインストール

Smithery を通じて、Claude デスクトップ版用の ClickUp MCP Server を自動的にインストールするには、以下のコマンドを実行します：

npx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude

📦 インストール

環境変数

必要な環境変数は以下の通りです：

• 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）

✨ 主な機能

タスク管理

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

チームとリスト管理

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

ボード管理

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

📚 ドキュメント

開発手順

1. リポジトリをクローンします。
2. 依存関係をインストールします：

npm install

3. 開発モードで起動します：

npm run dev

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

npm run build

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

npm test

セキュリティ

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

よくある質問

一般的な問題と解決策

1. 認証エラー
   • 環境変数に設定された OAuth 資格情報が正しいことを確認します。
   • トークンが期限切れになっていないことを確認します。
   • リダイレクト URI が正しいことを確認します。
2. レート制限
   • サーバは自動的にレート制限を処理します。
   • ログ内のレート制限警告を確認します。
   • リクエストのバッチ処理を検討してください。
3. サーバが起動しない場合
   • 環境変数が正しく設定されていることを確認します。
   • ポート 3000 が使用可能であることを確認します。
   • Claude デスクトップ版のログを確認します。

ログの取得

Claude デスクトップ版のログの場所は以下の通りです：

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

📄 ライセンス

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