ClaudeとClickUpを連携する方法
ClickUpコネクタでタスク作成・更新・時間計測・チャット送信をClaudeから自然言語で操作する手順を、個人アカウントとTeam/Enterprise、Claude Codeでの扱いに分けて解説します。
ClickUpコネクタをClaudeに繋ぐと、タスクの作成・更新・優先度変更・時間計測・チャット送信を自然言語の指示で実行できます。ディレクトリ上の分類は「Read & write」で、検索や参照だけでなく書き込み操作も含みます。この記事では、個人アカウントとTeam/Enterpriseそれぞれの有効化手順、Claude Codeでの2通りの使い方、実務でつまずきやすい点を扱います。
ClickUpコネクタとは — できることと対応する製品面
ClickUpコネクタはClickUp社が開発し、Claudeの公式Connectorsディレクトリに公開している連携機能です。AIエージェントとClickUpワークスペースの間でリアルタイムにやり取りできる点が特徴で、公式ページはこれを「secure, real-time interaction」と説明しています。
対応する製品面は、Connectorsの一般的な仕組みとしてclaude.ai・Claudeデスクトップアプリ・Claude Code・Claude APIなどが挙げられています。Coworkでの利用を検討する場合は、CoworkのConnectors一覧で対応状況を先に確認したほうが確実です。
公式ページが挙げる使い方の例は次の6パターンです。
- ワークスペースメンバーの一覧取得: 「List all people in the workspace」
- タスクの作成・整理: 「Create a task 'Add logout button' in Web App → Sprint Backlog」
- タスク詳細の更新: 「Add 'High' priority to 'Add logout button' task」
- 時間計測の自動開始: 「Start tracking time on the current task I'm working on」
- ドキュメント管理: 「Create a new document page for our Q1 planning notes」
- チームメッセージの送信: 「Send a message in the Engineering chat channel about the deployment schedule」
いずれもClickUpの画面を開かず、チャット欄への1文でそのまま実行できる操作です。タスク作成の例が「Web App → Sprint Backlog」のようにSpace名とList名を矢印でつないでいる点は、後述する落とし穴とも関係します。
接続を有効にしたあとは、会話のたびに「ClickUpを使って」と名指しする必要はありません。指示の内容がClickUpの操作に合致すると判断されれば、Claudeが自動で会話に呼び出します。複数のコネクタを接続している場合にどれが選ばれるかの判断基準は、Claudeが連携アプリを提案してくる仕組みと制御方法で扱っています。
Claudeの設定からClickUp連携を有効にする手順
有効化する主体は、個人アカウントかTeam・Enterpriseプランかで変わります。
個人アカウント(Free/Pro/Max)での有効化手順
- チャット下部の「+」ボタン(または「/」)から「Connectors」→「Manage connectors」を開くか、「Customize」→「Connectors」の設定画面を開く
- 一覧またはカテゴリ(Productivity)からClickUpを探し、connectorをクリックして説明と対応する操作範囲を確認する
- 「Connect」をクリックし、ClickUpアカウントへのサインインと権限の許可を進める
- 接続後は会話内の「Connectors」トグルで、その会話ごとにオン・オフを切り替えられる
/mcpClaude Code側では、claude.aiアカウントでログインしているセッションに限り、この/mcpパネルにclaude.ai経由で読み込まれたClickUpコネクタが表示されます。表示の仕組みは次の見出しで扱います。
Team/Enterpriseプランでの有効化手順
- OwnerまたはPrimary Ownerが「Organization settings」→「Connectors」を開く
- ページ下部の「Browse connectors」をクリックし、一覧からClickUpを選ぶ
- 「Add to your team」をクリックして組織に追加する
- 各メンバーは、個人アカウントと同じ手順で自分のClickUpアカウントにサインインする
組織側の有効化は、あくまで「使える状態にする」ところまでです。各メンバーの認証は自動では済まず、全員が個別にサインインする必要があります。
書き込み操作を組織単位で制限したい場合は、「Customize」→「Connectors」でClickUpを選びます。権限カテゴリごとに「Always allow(常に許可)」「Needs approval(要承認)」「Blocked(拒否)」のいずれかを設定でき、この制限は組織全体に効きます。タスクの作成・優先度変更は許可し、削除系の操作だけ承認制にする、といった組み合わせが可能です。
Claude CodeでClickUpを使う2つの方法
Claude Codeのターミナル・VS Code・JetBrains・Agent SDKセッションは、claude.aiに接続済みのコネクタを自動で取得する仕組みを持ちます。ディレクトリ掲載のコネクタはClaude Codeと同じMCPの基盤を使うため、この自動取得に頼らずclaude mcp addで直接追加することもできます。
claude mcp add --transport http clickup https://mcp.clickup.com/mcp追加後は/mcpを実行し、認証が必要な場合はその場でサインインを済ませます。claude mcp listの表示が「✔ Connected」になれば接続完了です。
自動取得と直接追加のどちらが有効かは、実行環境によっても変わります。ターミナル・VS Code・JetBrains・Agent SDKのセッションはClaude Code自身がclaude.aiからコネクタを取得しますが、Claude Codeクラウドセッションではホスト側が組織設定に沿ってコネクタを渡す方式になり、デスクトップアプリのローカル・SSHセッションではアプリがプロセス内でコネクタを直接登録します。同じClickUpコネクタでも、どの経路で読み込まれているかによって効く設定(disableClaudeAiConnectorsか組織のツール制御か)が変わるため、想定と違う挙動が出たら実行環境から確認するのが早道です。
2つの方法は認証の起点が違います。
| 方法 | 起点 | 向くケース |
|---|---|---|
| claude.ai経由の自動取得 | 起点claude.aiアカウントでのログイン | 向くケースすでにclaude.ai側でClickUpを接続済みで、追加設定を増やしたくない場合 |
claude mcp addで直接追加 | 起点Claude Code単体のOAuth認証 | 向くケースANTHROPIC_API_KEYやAmazon Bedrock・Google Cloud経由の認証で、claude.aiアカウントにログインしていない場合 |
APIキー認証やAmazon BedrockやGoogle Cloud経由でClaude Codeを使っている場合、claude.ai側のコネクタは読み込まれません。現在の認証方式は/statusで確認できます。この場合でも、ClickUpの公式MCPサーバーURL(https://mcp.clickup.com/mcp)を直接指定すれば、claude.aiアカウントを介さずに接続できます。
リポジトリ単位でclaude.aiコネクタの読み込み自体を止めたい場合は、プロジェクトの設定ファイルに次の1行を足します。
{
"disableClaudeAiConnectors": true
}接続済みのConnectorsが増えると、毎回すべてを読み込む「Auto」モードは応答のオーバーヘッドが増えます。読み込み方の切り替え方はClaudeのツールアクセス設定 — Connectorsの読み込みを3モードで管理するにまとめています。
落とし穴リスト
- Space名とList名を省略する: 「Add logout button」のような指示だけでは、同名に近いタスクが複数のListにまたがる環境で取り違えが起きます。公式の例のように「Web App → Sprint Backlog」とSpace→Listの階層まで指定すると確実です
- 時間計測の対象タスクを曖昧にする: 「現在作業中のタスク」で計測を開始する指示は、ClickUp側で複数タスクを並行して開いている場合にどれを指すか特定できないことがあります。タスク名まで含めて指示すると安定します
- ワークスペース外の情報を期待する: Claudeが取得できるのは、接続したClickUpアカウントが実際にアクセス権を持つ範囲だけです。権限のないSpaceやプライベートタスクは、Claude経由でも見えるようにはなりません
- 書き込み系操作を承認制にせず本番ワークスペースへ適用する: 優先度変更やステータス更新はワンステップで実行されるため、重要なワークスペースでは「Customize」→「Connectors」の権限設定で要承認に切り替えておくと、意図しない変更を防げます
まとめ
ClickUpコネクタの有効化自体は、個人アカウントなら数クリックで完結します。Team・EnterpriseはOwnerによる組織側の有効化が前提で、各メンバーは自分でサインインする必要があります。Claude Codeでは、claude.aiアカウントでログインしていれば自動でコネクタが読み込まれますが、APIキー認証やクラウド経由の環境ではclaude mcp add --transport http clickup https://mcp.clickup.com/mcpで直接追加する方法があります。タスク指示ではSpace・List名まで具体的に伝えることが、取り違えを防ぐ一番の近道です。Connectors全体の仕組みはClaude Connectorsとは — 種類・一覧と追加方法、他の自動化ツールとの使い分けはClaudeのZapier・Make・MCP比較、デスクトップとWebでの挙動の違いはClaudeコネクタはデスクトップ接続とWeb接続をどう使い分けるかで扱っています。