Clickup Mcp Server

  Antigravity (IDE & 2.0)

从 antigravity.google 下载。适用于 Antigravity IDE（基于 VS Code 的 Agent 编辑器）和 Antigravity 2.0（独立的桌面 Agent 编排应用）。两者使用相同的配置文件。

配置路径： ~/.gemini/config/mcp_config.json

提示： 打开 Agent 面板 → ... → 管理 MCP 服务 → 查看原始配置，即可直接打开此文件。或者在提示词面板中输入 /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 Agent 的轻量级终端交互界面（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

单 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

多 Agent 设置（配置档案 + 角色设定）

在同一工作区（或不同工作区）中运行一组专用 Agent。每个 Hermes 配置档案都是独立的 Agent，拥有自己的配置和 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 中为每个 Agent 编写指令（此处以 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.

按配置档案运行任意 Agent 查询（由用户或 Agent 调用）：

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

其他（自定义 Agent 等） 对于大多数其他兼容 MCP 的宿主：

• 服务 URL： https://clickup-mcp.taazkareem.com/mcp
• 身份验证标头： X-License-Key: your-license-key

  OpenClaw（通过 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

专业提示： 使用角色设定在 Agent 的 mcporter.json 中定义多个彼此隔离的配置（例如 Auditor 和 Worker）。

  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. 将 Connection Type 设置为 Streamable HTTP。
3. Auth Type：Multiple Headers Auth。
4. Header：X-License-Key Value：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 进行验证。也可以使用 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"
      }
    }
  }
}