Teamhood MCP

Teamhood MCP服务器

一种模型上下文协议（MCP）服务器 团队精神 项目管理。使像Claude这样的人工智能助手能够与Teamhood工作区、董事会、项目等进行交互。

特性

工作区

• list_workspaces -列出所有可访问的工作区
• get_workspace -获取工作区详细信息
• create_workspace -创建新工作区（需要模板）
• update_workspace_member -添加/更新用户角色

板子

• list_boards -列出工作区中的板
• get_board -获取特定的电路板详细信息
• create_board -创建新板（需要模板）
• list_rows -在黑板上列出泳道
• list_statuses -列出板上的状态列
• create_row -创建新泳道

项目（任务/卡片）

• list_items -使用分页搜索/筛选项目
• get_item -获取完整的商品详细信息
• create_item -使用依赖项、标签和自定义字段创建新项目
• update_item -更新项目属性
• delete_item -永久删除项目
• move_item -在板/列/行之间移动项目
• archive_item -存档/取消存档项目（软删除）

附件

• list_attachments -列出项目的附件
• get_attachment -获取附件元数据
• download_attachment -下载附件内容
• upload_attachment -将文件上传到项目
• update_attachment -重命名附件
• delete_attachment -删除附件

时间跟踪

• log_time -记录在项目上花费的时间
• get_time_logs -使用过滤器查询时间日志

模板

• list_workspace_templates -可用的工作空间模板
• list_board_templates -可用的电路板模板

活动和日志

• list_activities -项目变更历史记录（审核日志）
• list_system_logs -按日期范围列出的系统日志

用户

• list_users -列出所有组织用户

安装

npm install
npm run build

配置

选项1：环境变量

export TEAMHOOD_API_KEY="your-api-key"
export TEAMHOOD_BASE_URL="https://api-YOURTENANT.teamhood.com/api/v1"

选项2:SOPS加密秘密

创建 secrets.yaml:

TEAMHOOD_API_KEY: your-api-key
TEAMHOOD_BASE_URL: https://api-YOURTENANT.teamhood.com/api/v1

使用SOPS加密：

sops -e secrets.yaml > secrets.enc.yaml

Claude桌面设置

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "teamhood": {
      "command": "node",
      "args": ["/path/to/teamhood-mcp/dist/index.js"],
      "env": {
        "TEAMHOOD_API_KEY": "your-api-key",
        "TEAMHOOD_BASE_URL": "https://api-YOURTENANT.teamhood.com/api/v1"
      }
    }
  }
}

API费率限制

Teamhood API限制为每分钟100个请求。

许可证

麻省理工学院