带有超级网关的 ClickUp MCP 服务器

此集成通过 Supergateway 运行 ClickUp MCP 服务器，将其公开为可供 n8n 节点或其他客户端使用的 SSE 端点。

先决条件

• Node.js 18 或更高版本

• Docker 和 Docker Compose（用于容器化部署）

• ClickUp API 密钥和团队 ID

Related MCP server: ClickUp MCP Server

本地开发

使用 Node.js 运行

1. 安装依赖项：

   npm install -g supergateway @taazkareem/clickup-mcp-server

2. 设置环境变量：

   export CLICKUP_API_KEY=pk_94547006_D8DFEXXFDOX7RUOJBBPLM2BSVRFXPZE9 export CLICKUP_TEAM_ID=2357720

3. 运行集成脚本：

   ./run-clickup-mcp.sh

4. 自定义配置（可选）：

   ./run-clickup-mcp.sh --port 9000 --base-url http://example.com --cors "http://localhost:8080,http://localhost:3000"

使用 Docker Compose 运行

1. 根据.env.example创建.env文件：

   cp .env.example .env

2. 使用您的 ClickUp API 密钥和团队 ID 编辑.env文件。

3. 启动容器：

   docker-compose up -d

4. 查看日志：

   docker-compose logs -f

部署到铁路

1. 在 Railway 上创建一个新项目。

2. 连接您的 GitHub 存储库或使用 Railway CLI 进行部署。

3. 在 Railway 中设置以下环境变量：

   • CLICKUP_API_KEY ：您的 ClickUp API 密钥

   • CLICKUP_TEAM_ID ：您的 ClickUp 团队 ID

   • PORT ：8000（或您首选的端口）

   • BASE_URL ：您的 Railway 应用 URL（例如https://your-app-name.up.railway.app ）

   • SSE_PATH ：/sse（或您的首选路径）

   • MESSAGE_PATH ：/message（或您的首选路径）

   • LOG_LEVEL ：信息（或调试以获得更详细的日志记录）

   • DOCUMENT_SUPPORT ：false（或根据需要为 true）

   • CORS_ORIGINS ：*（或以逗号分隔的允许来源列表）

4. 部署应用程序。

与 n8n 一起使用

1. 在 n8n 中，添加一个新的“MCP”节点。

2. 使用以下设置配置节点：

   • 服务器 URL：您的 Railway 应用程序 URL + SSE 路径（例如，https: //your-app-name.up.railway.app/sse ）

   • 消息路径：您的消息路径（例如，/message）

3. 从可用工具中选择所需的 ClickUp 工具。

4. 根据需要配置工具参数。

5. 将节点连接到您的工作流程。

API 端点

• SSE 端点： {BASE_URL}{SSE_PATH} （例如， http://localhost:8000/sse ）

  • 方法：GET

  • 描述：订阅服务器发送的事件

• 消息端点： {BASE_URL}{MESSAGE_PATH} （例如， http://localhost:8000/message ）

  • 方法：POST

  • 描述：发送消息到服务器

  • 内容类型：application/json

  • 正文：JSON-RPC 2.0 格式的消息

• 健康检查端点： {BASE_URL}/healthz （例如， http://localhost:8000/healthz ）

  • 方法：GET

  • 描述：检查服务是否正常运行

  • 响应：如果服务正常，则返回“ok”

故障排除

• 连接问题：确保您的防火墙允许连接到指定的端口。

• 身份验证错误：验证您的 ClickUp API 密钥和团队 ID 是否正确。

• CORS 错误：配置 CORS_ORIGINS 环境变量以包含客户端的来源。