关于 Teamhood
Teamhood MCP 服务将 AI 助手连接到面向矩阵型组织的 Teamhood 项目管理工具。它支持工作项、依赖关系、工时、容量和团队操作,访问权限由连接者的角色决定。
主要功能
- 01查找、创建、更新和删除工作项
- 02关联有依赖关系的工作项
- 03管理评论和工时记录
- 04查看日程、容量、人员和团队
- 05查看工作项历史和附件
- 06搜索 Teamhood 帮助页面
适用场景
- 01通过 AI 助手更新项目工作项
- 02跟踪依赖关系和记录工时
- 03查看团队容量和工作时间
- 04工作时搜索 Teamhood 帮助
MCP 相关
托管的 MCP 服务通过 Streamable HTTP 提供 Teamhood 项目管理工具,并提供只读端点。助手以连接者的权限执行操作。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.teamhood.com/public/v1/mcpclaude mcp add --transport http com-teamhood-teamhood https://api.teamhood.com/public/v1/mcp{"mcpServers":{"com-teamhood-teamhood":{"type":"http","url":"https://api.teamhood.com/public/v1/mcp"}}}在 Cursor 中打开{"servers":{"com-teamhood-teamhood":{"type":"http","url":"https://api.teamhood.com/public/v1/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-teamhood-teamhood":{"type":"http","url":"https://api.teamhood.com/public/v1/mcp"}}}{"mcpServers":{"com-teamhood-teamhood":{"serverUrl":"https://api.teamhood.com/public/v1/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Teamhood MCP 服务
将 Claude、ChatGPT、Copilot、Cursor、VS Code 或任何其他支持 Model Context Protocol 的助手连接到 Teamhood,这是一款面向矩阵型组织的项目管理工具。助手会以你的身份读取和更新工作内容,并遵守你角色的权限。
该服务由 Teamhood 托管:无需安装或运行任何内容。本仓库包含其在 MCP Registry 中的条目和本指南。完整文档请参阅 help.teamhood.com。
地址
| 地址 | 提供内容 |
|---|---|
https://api.teamhood.com/public/v1/mcp | 所有工具 |
https://api.teamhood.com/public/v1/mcp/readonly | 仅提供读取工具 |
所有组织使用相同的地址:登录后,助手便会确定要在哪个组织中工作。两者都使用 Streamable HTTP 传输方式。
连接助手
| 助手 | 方法 |
|---|---|
| Claude、ChatGPT 等 | 添加自定义连接器或远程 MCP 服务,并填写地址 |
| Claude Code | claude mcp add --transport http teamhood https://api.teamhood.com/public/v1/mcp,然后运行 claude mcp login teamhood |
| Cursor | 在 .cursor/mcp.json 中添加:{"mcpServers": {"teamhood": {"url": "https://api.teamhood.com/public/v1/mcp"}}} |
| VS Code | 在 .vscode/mcp.json 中添加:{"servers": {"teamhood": {"type": "http", "url": "https://api.teamhood.com/public/v1/mcp"}}} |
随后,助手会要求你登录 Teamhood 并授权。分步指南:使用 MCP 连接助手。
登录
- OAuth。 助手会打开 Teamhood 登录页面,你可以为一个组织授权。随时可在 Settings → Integrations → MCP → Connected apps 中断开连接。
- 个人令牌。 如果助手需要请求头,请在 Settings → Personal tokens 下创建令牌,并通过
X-Api-Key请求头或Authorization: Bearer <token>发送。
助手可以执行的操作
- 读取条目类型、字段及每个字段允许的值
- 查找、读取、创建、修改和删除条目,并关联相互依赖的条目
- 读取、发布、编辑和删除评论;读取、记录、更正和删除工时
- 读取条目的历史记录,以及附加到条目的图片和文本文件
- 读取工作时间、休假和计划工时,并列出人员和团队
- 通过获得授权的连接修改条目类型、字段、团队和邀请
- 搜索 Teamhood 的帮助页面
所有工具及其限制:MCP 服务参考。
安全
- 助手以连接该服务的用户身份操作,且只能执行该用户角色权限允许的操作。
- 只读地址绝不会提供任何可修改内容的工具。
- 修改组织设置需要使用你已授权进行此类操作的连接,或个人令牌。
- 删除的条目会移至垃圾箱,可在 30 天内恢复。
- 条目的标题、描述和字段发生更改时,活动记录会以你的姓名显示,并带有 AI 标签。助手发布的评论也会带有相同标签。
更多信息:Teamhood 中 MCP 的工作方式。
Teamhood 技能
能够加载技能的助手可以添加 Teamhood 技能,以获取在 Teamhood 中工作的规则。请参阅将 Teamhood 技能添加到助手。
支持
在 Teamhood 的帮助面板底部选择 Contact us(操作方法)。隐私政策:teamhood.com/privacy-policy。
发布注册表条目
条目文件为 server.json,发布名称为 com.teamhood/teamhood。注册表通过域名顶级域上的 TXT 记录验证 teamhood.com 的所有权:v=MCPv1; k=ed25519; p=<public key>。匹配的私钥是仓库密钥 MCP_PRIVATE_KEY,由 64 个十六进制字符组成。
要更改条目,请编辑 server.json,提高其 version(已发布的版本无法替换),然后运行 Publish to MCP Registry 工作流。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。