ClickUp Serviteur MCP

ClickUp Serviteur MCP

MCP クライアント向けのセルフホスト可能な ClickUp 連携機能 · TypeScript · Cloudflare Workers · デュアル OAuth · MIT License

リリース候補版：v0.3.0-beta.1 — ソース公開ベータ版（2026年11月7日）

公式 MCP Registry： 有効な v0.3.0-beta.1 の登録情報を表示（JSON） · セルフホストと Registry の設定 · Glama メンテナーのメタデータ

ClickUp Serviteur は、ChatGPT やリモート MCP に対応した Claude クライアントなど、MCP 互換の AI クライアントに ClickUp REST 操作を提供するリモートの Model Context Protocol サーバーです。各インストールはそれぞれの管理者が運用し、個別の Cloudflare Worker を使用して、MCP クライアントの ID と個人の ClickUp OAuth 認証情報の両方を検証します。これは独立したコミュニティプロジェクトであり、ClickUp の製品ではなく、ClickUp と提携しているものでもありません。

ソースが公開されていても、稼働中の Worker に誰でもアクセスできるわけではありません。 参照用の企業デプロイは、非公開で認可されたインストールです。見知らぬ人をそのエンドポイントに接続したり、他の運用者の Workspace ID をコピーしたり、共有認証情報を再利用したりしないでください。

Registry の登録情報は検出用のメタデータであり、公開アクセスを提供するものではありません。 各ユーザーは、自身が設定した Worker の HTTPS ホスト名を指定する必要があります。共有の公開 ClickUp サービスはありません。

機能

• ClickUp REST API に基づく実際のツールを提供し、スコープを指定したタスク検索、タスクの作成・割り当て・編集、リスト、フォルダー、タグ、依存関係、タスクリンク、コメント、Custom Fields、タイムエントリー、Docs、Chat に対応します（上流の REST API がサポートする範囲）。
• タスクの説明ではネイティブの Markdown を保存し、Markdown 形式で読み戻せます。Docs と Chat では text/md と text/plain を個別に処理します。ネイティブの構造化リッチタスクコメントは、強調、リンク、リスト／チェックリスト／トグル形式、コード、絵文字、実在が確認された @メンションに対応します。
• テキストベースの対応添付ファイルを対象とする、読み取り範囲を制限した PDF リーダーを備えています。画像／ファイルアップロード用アダプターと、あまり一般的でない一部の API 経路には、まだ受け入れ確認作業が残っています。既知の制限を参照してください。
• 会社の所有者が認証を受けたうえで、対象を特定したタスク、所有者自身のコメント、タグ、リンク、依存関係を削除できます。明示的な確認とスコープ検証が必要です。これは無制限の一括削除ではありません。
• OAuth に紐づく Workspace または List のスコープ、個別ユーザートークン、保存された認証情報の保存時暗号化、API レート制限への対応、厳格なリクエスト検証、不確実な書き込み後の盲目的な再試行を行わない仕組みを備えています。
• Cloudflare Workers の HTTPS ホスティング、GitHub Actions の CI、CodeQL、手動実行の保護されたデプロイに対応しています。

実際に検証済みの内容

2026年11月、保護された企業デプロイを、GitHub の正確なビルド SHA と照合して確認しました。個別に認可された ClickUp 接続を使用し、使い捨てタスクの作成と割り当て、ネイティブ Markdown による説明の保存、保存された書式セグメントを含むリッチコメント、タスクとコメントの正確な読み戻しに成功することを検証しました。API による読み戻しだけでは、エディター専用のすべてのブロックが視覚的に忠実であることの証明にはなりません。 すべてのエンドポイントやサードパーティ製 MCP クライアントで、実環境での受け入れ確認が完了しているわけではありません。

書式互換性マトリックス · リリースノート · プロジェクトの制限事項 · セキュリティ

必要条件

• 開発または GitHub Actions のビルドに Node.js 22.20.0 以降と npm が必要です。
• Workers、専用の OAuth KV 名前空間、必要な SQLite Durable Objects を備えた Cloudflare アカウントが必要です。
• MCP ユーザーの認証には GitHub OAuth 認証情報が必要です。各ユーザーが自身の ClickUp アカウントで認可を受けるには、ClickUp OAuth アプリの認証情報が必要です。
• 特定の ClickUp Workspace／List と、個別に認可されたユーザーが必要です。自身の ID と OAuth クライアントを設定してください。サンプル値は本番環境での認可には使用できません。
• OAuth で保護されたリモートサーバーに接続できる MCP クライアントが必要です。

チェックを実行する

git clone https://github.com/cryogenized-spec/ClickUp-Serviteur-MCP.git
cd ClickUp-Serviteur-MCP
npm ci --ignore-scripts --no-audit --no-fund
python3 scripts/check_repo_policy.py
python3 -m unittest discover -s scripts/tests -p 'test_*.py' -v
npm run format:check
npm run lint
npm run typecheck
npm test
npm run build
node scripts/staging-local-smoke.mjs
npm audit --audit-level=high

ルートパッケージは意図的に private: true に設定されています。このベータ版は GitHub でオープンソースとして公開されており、npm パッケージとして公開されているわけではありません。テストスイートが成功しても、クラウドシークレットの設定や ClickUp の認可が確認されたことにはなりません。

独自のインスタンスをデプロイする

管理対象のデプロイ方法は、ステージングと分離された会社環境です。これらはレビュー済みの main から手動で実行されます。認証なしの ClickUp ゲートウェイを公開するものではありません。

1. ソースをフォークするか、自分が管理するリポジトリを作成します。OAuth クライアントを 2 つ別々に設定します（MCP 接続用の GitHub と、上流の個人アカウント用の ClickUp）。HTTPS リダイレクト先のオリジンを正確に登録してください。ステージング環境と会社環境では、異なる認証情報とストアを使用します。
2. Cloudflare OAuth KV と Worker／Durable Object のバインディングを作成します。GITHUB_CLIENT_SECRET、CLICKUP_CLIENT_SECRET、CLICKUP_STATE_KEY、CLICKUP_TOKEN_KEY は、Cloudflare シークレットまたは適切に保護されたデプロイシークレットとしてのみ保存し、Git で追跡されるファイルには絶対に保存しないでください。キーのエンコード要件については、OAuth の設定を確認してください。
3. リポジトリの staging 環境変数 STAGING_OAUTH_KV_ID を設定し、認可する GitHub ID だけを含む、カンマ区切りの明示的な許可リスト STAGING_WORKSPACE_GITHUB_IDS を設定します。公開ベータ版では、元のリポジトリ所有者の GitHub ID がデフォルトで使われることはなくなりました。
4. 独自の Worker ホスト名を選び、OAuth コールバック、公開オリジン、ClickUp Workspace／List のバインディング、スタッフのマッピングを設定します。デプロイと権限およびWorkspace のターゲット設定を参照してください。参照用の会社環境ジェネレーターは、COMPANY_OAUTH_KV_ID、COMPANY_WORKSPACE_ID、COMPANY_LIST_ID、COMPANY_GITHUB_OWNER_ID、COMPANY_CLICKUP_USER_ID、COMPANY_PUBLIC_ORIGIN を検証します。専用のオーナー専用 Worker を対象としています。テナンシーモデルを完全に分離する必要がある場合は、適宜変更してください。
5. 対応する GitHub Actions の手動デプロイを実行し、MCP クライアントを独自の Worker HTTPS エンドポイントに接続して、両方の OAuth 認可を完了します。service_info と get_clickup_connection_status を呼び出し、デプロイ済みビルドと Workspace への排他的アクセスを確認してください。
6. まず読み取りを試し、次に承認済みの使い捨てタスクに対して書き込みと読み戻しを行います。レコードを作成する前に、クリーンアップの手順を計画してください。タスク名だけを認可の根拠にしてはいけません。

移行に関する警告： このリリースでは、従来のステージング Worker 名と、汎用の wrangler.jsonc プロジェクト名が変更されています。既存のステージング URL、OAuth コールバック、保存済み Worker 状態、カスタムクライアントコネクターは、自動的には移行されません。エンドポイントを切り替える前に、新しいオリジンと Cloudflare リソースを再設定し、古いインフラストラクチャは別途廃止してください。保護された会社環境の Worker 名は変更されていません。

既知の制限事項

• ClickUp の公開タスクコメント API では、ネイティブの表セルや水平線ブロックは文書化されていません。通常のパイプ記号を使った表や --- は、そのまま表示されることがあります。本物のタスク説明の Markdown 表か、ラベル／値のコメントによる代替方法を使用してください。
• Docs の Markdown では、エディター専用の表、トグル、色、その他のネイティブコンポーネントが失われることがあります。チャットメッセージと Docs のクリーンアップ対応は、まだ完全ではありません。
• 汎用的なロールバックエンジンはありません。削除は取り消せない操作です。所有権、Workspace の範囲、明示的な同意が引き続き重要です。一部の上流機能は ClickUp のプラン設定や API の提供状況に左右されます。
• 古い docs/ 内の記録の多くは、現在の手順ではなく、過去のエンジニアリング上の証拠です。README と公開リリースガイドは、アーカイブされたメモにある古い運用上の記述より優先されます。
• ソースは公開されていますが、接続先の非公開 Worker、顧客データ、スタッフアカウント、API キーは公開されていません。

プロジェクトとコミュニティ

バグ報告や機能の提案：GitHub Issues。コントリビューションについては、CONTRIBUTING.mdをご覧ください。セキュリティ上の問題は、SECURITY.mdの説明に従って非公開で報告してください。リリースの変更内容については、CHANGELOG.mdをご覧ください。

ライセンス： MIT。ClickUpは各権利者の商標です。このプロジェクトは、ClickUpによる推奨を主張するものではありません。