Clickup Mcp Server

  Antigravity (IDE & 2.0)

antigravity.google からダウンロードしてください。Antigravity IDE（VS Code ベースのエージェント型エディター）と、Antigravity 2.0（単体のデスクトップエージェントオーケストレーションアプリ）に対応しています。どちらも同じ設定ファイルを使用します。

設定ファイルのパス： ~/.gemini/config/mcp_config.json

ヒント： エージェントパネルを開き、... → Manage MCP Servers → View raw config を選択すると、このファイルを直接開けます。または、プロンプトパネルで /mcp と入力してください。

オプション A：リモート／Streamable HTTP（推奨）

{
  "mcpServers": {
    "ClickUp": {
      "serverUrl": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": { "X-License-Key": "your-license-key" }
    }
  }
}

オプション B：ローカル／STDIO

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": ["-y", "@taazkareem/clickup-mcp-server@latest"],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "CLICKUP_MCP_LICENSE_KEY": "your-license-key"
      }
    }
  }
}

  Antigravity CLI (agy)

Antigravity エージェント用の軽量なターミナルベースのインターフェース（TUI）です。次のコマンドでインストールできます。

curl -fsSL https://antigravity.google/cli/install.sh | bash

設定ファイルのパス： ~/.gemini/antigravity-cli/mcp_config.json

ヒント： agy を実行し、対話セッション内で /mcp と入力すると、TUI 内からサーバーを管理できます。

オプション A：リモート／Streamable HTTP（推奨）

{
  "mcpServers": {
    "ClickUp": {
      "serverUrl": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": { "X-License-Key": "your-license-key" }
    }
  }
}

オプション B：ローカル／STDIO

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": ["-y", "@taazkareem/clickup-mcp-server@latest"],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "CLICKUP_MCP_LICENSE_KEY": "your-license-key"
      }
    }
  }
}

  Hermes Agent

単一エージェントの設定ファイルのパス： ~/.hermes/config.yaml

オプション A：リモート／Streamable HTTP

hermes mcp add clickup \
  --url https://clickup-mcp.taazkareem.com/mcp \
  --auth oauth && \
hermes config set mcp_servers.clickup.headers.X-License-Key "your-license-key"

オプション B：ローカル／STDIO

hermes mcp add clickup \
  --command npx \
  --args -y @taazkareem/clickup-mcp-server@latest \
  --env CLICKUP_API_KEY="your-api-key" \
        CLICKUP_TEAM_ID="your-team-id" \
        CLICKUP_MCP_LICENSE_KEY="your-license-key"

• 実行方法：hermes

マルチエージェントのセットアップ（プロファイル＋ペルソナ）

同じワークスペース（または別々のワークスペース）で、専門エージェントのチームを実行できます。各 Hermes プロファイルは、独自の設定と SOUL.md の指示を持つ独立したエージェントです。必要に応じて、各プロファイルを対応するペルソナ（X-Persona）に設定します。これにより、各エージェントのコンテキストに含まれる ClickUp ツールの範囲を指定できます。例を含むガイド：

1. プロファイルを作成する

hermes profile create project_manager
hermes profile create task_worker
hermes profile create auditor

任意：--clone を使って既存の config.yaml／.env／SOUL.md をコピーするか、上記のコマンドを再実行してください。

2. 各プロファイルにペルソナを設定します。 プロファイルには MCP 設定が追加されているので、対応するペルソナを追加するだけです。

project_manager config set mcp_servers.clickup.headers.X-Persona "project_manager"
task_worker     config set mcp_servers.clickup.headers.X-Persona "task_worker"
auditor         config set mcp_servers.clickup.headers.X-Persona "auditor"

フィルタリングをさらにカスタマイズする方法については、→ 高度な設定を参照してください。

3. ~/.hermes/profiles/<name>/SOUL.md で各エージェントに指示を設定します（ここでは auditor を例にしています）。

# ClickUp Auditor

You are a read-only project auditor. Observe and report — never change anything.
- Summarize task status, overdue items, and blockers concisely.
- Surface risks and recommend actions, but never execute them.
- If asked to create or modify a task, decline and explain you are read-only.

プロファイルを指定してエージェントのクエリを実行します（ユーザーまたはエージェントから呼び出し）：

project_manager chat -q "Break the Q3 launch into a list with subtasks and owners"
auditor         chat -q "Audit the Sprint board and report what's at risk"

-または-

ユーザーから呼び出す TUI または Gateway を実行します：

project_manager gateway start
auditor         chat

その他（カスタムエージェントなど） その他の MCP 対応ホストでは、以下を使用します。

• サーバー URL： https://clickup-mcp.taazkareem.com/mcp
• 認証ヘッダー： X-License-Key: your-license-key

  OpenClaw (via mcporter)

1. ~/.openclaw/openclaw.json で mcporter を有効にします。

{ "skills": { "allowBundled": ["mcporter"] } }

2. 設定と認証

# Add ClickUp as a remote server
mcporter config add ClickUp https://clickup-mcp.taazkareem.com/mcp --auth oauth --header "X-License-Key=your-license-key"

# Authenticate session
mcporter auth ClickUp

ヒント： ペルソナを使うと、エージェントの mcporter.json で複数の独立した設定（例：監査担当と作業担当）を定義できます。

  Cursor

設定ファイルのパス： <project-root>/.cursor/mcp.json

オプション A：リモート／Streamable HTTP（最も簡単）

{
  "mcpServers": {
    "ClickUp": {
      "url": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": {
        "X-License-Key": "your-license-key"
      }
    }
  }
}

オプション B：ローカル／STDIO

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": ["-y", "@taazkareem/clickup-mcp-server@latest"],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "CLICKUP_MCP_LICENSE_KEY": "your-license-key"
      }
    }
  }
}

  VS Code

設定ファイルのパス：

• グローバル： ~/Library/Application Support/Code/User/mcp.json
• ローカル： <project-root>/.vscode/mcp.json オプション A：リモート／Streamable HTTP（最も簡単）

{
  "mcpServers": {
    "ClickUp": {
      "url": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": {
        "X-License-Key": "your-license-key"
      }
    }
  }
}

オプション B：ローカル／STDIO

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": ["-y", "@taazkareem/clickup-mcp-server@latest"],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "CLICKUP_MCP_LICENSE_KEY": "your-license-key"
      }
    }
  }
}

  Roo Code

設定パス： <project-root>/.roo/mcp.json

オプション A：リモート／Streamable HTTP（最も簡単）

{
  "mcpServers": {
    "ClickUp": {
      "url": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": {
        "X-License-Key": "your-license-key"
      }
    }
  }
}

オプション B：ローカル／STDIO

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": ["-y", "@taazkareem/clickup-mcp-server@latest"],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "CLICKUP_MCP_LICENSE_KEY": "your-license-key"
      }
    }
  }
}

  Claude Desktop

設定パス： ~/Library/Application Support/Claude/claude_desktop_config.json

リモートのセットアップ（mcp-remote アダプターが必要です）：

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://clickup-mcp.taazkareem.com/mcp",
        "--header",
        "X-License-Key: your-license-key"
      ]
    }
  }
}

  Claude Code (CLI)

ターミナルで次のコマンドを実行します：

claude mcp add --transport http ClickUp https://clickup-mcp.taazkareem.com/mcp \
  --header "X-License-Key: your-license-key"

  n8n

オプション A：リモート／Streamable HTTP（推奨）

1. n8n で 「MCP Client」 ノードを追加します。
2. 接続タイプを Streamable HTTP に設定します。
3. 認証タイプ：Multiple Headers Auth。
4. ヘッダー：X-License-Key 値：your-license-key
5. URL：https://clickup-mcp.taazkareem.com/mcp

オプション B：セルフホスト Docker コンテナを起動します：

docker run -d -p 3231:3231 ghcr.io/taazkareem/clickup-mcp-server:latest

n8n で、URL に http://host.docker.internal:3231/mcp を使用します。

  Codex (CLI, Desktop, IDE)

Codex クライアント（CLI、デスクトップアプリ、VS Code 拡張機能）は、設定の単一の情報源を共有します。

設定パス：

• グローバル： ~/.codex/config.toml
• ローカル： <project-root>/.codex/config.toml

オプション A：リモート／Streamable HTTP（最も簡単）

[mcp_servers.ClickUp]
url = "https://clickup-mcp.taazkareem.com/mcp"
http_headers = { "X-License-Key" = "your-license-key" }

オプション B：ローカル／STDIO

[mcp_servers.ClickUp]
command = "npx"
args = ["-y", "@taazkareem/clickup-mcp-server@latest"]
env = {
  CLICKUP_API_KEY = "your-api-key",
  CLICKUP_TEAM_ID = "your-team-id",
  CLICKUP_MCP_LICENSE_KEY = "your-license-key"
}

簡単なヒント：

• Codex CLI： codex mcp list を実行して確認します。ファイルを編集する代わりに、CLI から codex mcp add ... を使用できます。
• VS Code 拡張機能： ⚙ → MCP settings → Open config.toml をクリックします。
• デスクトップアプリ： Settings → Integrations & MCP に移動します。

  ChatGPT (Developer Mode)

注：Developer Mode が有効になっている Business、Enterprise、または Edu ワークスペースが必要です。

1. Developer Mode を有効にする： ワークスペースの管理者に、Workspace Settings → Permissions & Roles → Connected Data で有効にするよう依頼します。
2. MCP に接続する： Settings → Connectors に移動し、Developer Mode をオンにします。
3. カスタムコネクターを追加する：
   • Add connector（または「Create custom connector」）をクリックします。
   • ソースタイプとして MCP を選択します。
4. 設定する：
   • サーバー URL： https://clickup-mcp.taazkareem.com/mcp
   • 認証： HTTP ヘッダー X-License-Key: your-license-key を追加します。
5. 使用する： Developer Mode のチャットを開始し、Add sources から ClickUp コネクターを選択します。

  Augment Code

設定パス： <project-root>/.augment/settings.json

{
  "mcpServers": {
    "ClickUp": {
      "url": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": {
        "X-License-Key": "your-license-key"
      }
    }
  }
}

  Auggie CLI

ターミナルで次のコマンドを実行します：

auggie mcp add ClickUp --url https://clickup-mcp.taazkareem.com/mcp \
  --header "X-License-Key: your-license-key"

  Windsurf

オプション A：リモート／Streamable HTTP（最も簡単）

{
  "mcpServers": {
    "ClickUp": {
      "url": "https://clickup-mcp.taazkareem.com/mcp",
      "headers": {
        "X-License-Key": "your-license-key"
      }
    }
  }
}

オプション B：ローカル／STDIO

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": ["-y", "@taazkareem/clickup-mcp-server@latest"],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "CLICKUP_MCP_LICENSE_KEY": "your-license-key"
      }
    }
  }
}