Clickup MCP Installer

单击用于Claude Desktop的MCP服务器安装程序

使用模型上下文协议（MCP）服务器将ClickUp与Claude Desktop集成的简单安装脚本。

⚠️ 重要提示：需要单个API令牌

每个用户必须使用他们自己的ClickUp API令牌。 这确保了：

• 适当的访问控制和权限
• 个人使用跟踪
• 更好的安全实践
• 遵守ClickUp的API条款

先决条件

• Node.js （v16或更高版本）- 点击此处下载
• 克劳德桌面 应用
• 您的个人点击API代币 -从ClickUp设置>应用程序获取

快速安装

选项1：自动安装（推荐）

1. 克隆或下载此存储库：

git clone https://github.com/Fig1-ai/clickup-mcp-installer.git
cd clickup-mcp-installer

1. 使用您的个人API令牌运行安装脚本：

# Mac/Linux
./install-clickup-mcp.sh YOUR_PERSONAL_CLICKUP_API_TOKEN

# Windows (Command Prompt)
install-clickup-mcp.bat YOUR_PERSONAL_CLICKUP_API_TOKEN

# Or run without token to be prompted
./install-clickup-mcp.sh

1. 完全重新启动克劳德桌面
2. 检查Claude Desktop中的开发人员部分-ClickUp应显示为已连接

选项2：手动安装

1. 全局安装软件包：

npm install -g @chykalophia/clickup-mcp-server

1. 查找您的Claude配置目录：

- 苹果电脑: ~/Library/Application Support/Claude/ - 视窗: %APPDATA%\Claude\ - Linux: ~/.config/Claude/

1. 创建/编辑 claude_desktop_config.json:

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "@chykalophia/clickup-mcp-server"],
      "env": {
        "CLICKUP_API_TOKEN": "YOUR_PERSONAL_API_TOKEN_HERE"
      }
    }
  }
}

1. 重新启动克劳德桌面

获取您的个人点击API代币

每个用户都需要自己的令牌：

1. 使用您的帐户登录ClickUp
2. 点击您的头像（左下角）
3. 首选 设置
4. 引导到 应用程序 章节
5. 点击 生成 在“个人API代币”下
6. 复制令牌（以开头 pk_)
7. 保护此令牌的安全，不要共享它

Claude Desktop中的可用命令

安装后，您可以使用以下命令：

• “列出我本周要完成的任务”
• “在\[空间/文件夹/列表名称\]中显示我的任务”
• “创建新任务…”
• “更新任务状态…”
• “显示…的任务详细信息”
• “我的首要任务是什么？”

更新您的API代币

如果您需要更新您的个人API令牌：

# Using the update script (created during installation)
~/.clickup-mcp-server/update-token.sh YOUR_NEW_PERSONAL_TOKEN

# Or manually edit the config file
# Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%\Claude\claude_desktop_config.json

故障排除

服务器在Claude Desktop中显示为“失败”

1. 验证您的API令牌是否正确且处于活动状态
2. 确保已安装Node.js： node --version
3. 检查你是否在使用你的个人令牌，而不是别人的
4. 在开发人员部分检查Claude Desktop日志

“无法连接到MCP服务器”错误

1. 验证令牌格式（应以开头 pk_)
2. 确保该令牌是您的个人令牌
3. 完全退出并重新启动Claude Desktop
4. 检查配置文件是否为有效的JSON

命令不起作用或显示错误数据

1. 确保您正在使用您的个人API令牌
2. 检查您在ClickUp中是否有适当的权限
3. 验证您的API令牌尚未过期
4. 确保您有权访问正在查询的工作区

安全最佳实践

• 永远不要分享您的个人API代币 与其他人
• 永远不要提交API令牌 到版本控制
• 每个用户都必须生成自己的令牌
• 将您的令牌存储在安全的密码管理器中
• 定期轮换您的API代币
• 离开组织时撤销令牌

面向IT管理员

要在整个组织中部署：

1. 与您的团队共享此存储库
2. 指导每个用户：

- 生成他们自己的个人ClickUp API令牌 - 使用他们的令牌运行安装脚本 - 确保他们的代币安全

不要使用共享令牌 -这违反了安全最佳实践和ClickUp的服务条款。

支持

• 点击API文档: https://clickup.com/api
• Claude桌面支持: https://support.anthropic.com
• MCP协议: https://modelcontextprotocol.io
• 问题:

许可证

MIT许可证-有关详细信息，请参阅许可证文件

ClickUp MCP服务器由@chykalophia维护。