AI导哈

ClickUp MCP服务器安装器

用于将ClickUp与Claude Desktop集成的MCP服务器安装脚本，提供自动化安装和手动安装选项，支持个人API令牌管理。

  • by Fig1-ai
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 fig1-ai/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/

  2. 创建/编辑 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
  • 问题: GitHub问题

许可证

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

ClickUp MCP服务器由@chykalophia维护。

相关 MCP