Teamretro MCP 服务器
](https://mseep.ai/app/adepanges-teamretro-mcp-server)
主要特点：
- 使用20多个用于管理团队、用户、操作等的工具，全面覆盖TeamRetro API
- 通过标准化的MCP接口简化AI客户端集成
- 内置分页和过滤支持，可实现高效的数据处理
- 安全的API身份验证处理和环境配置
- 全面的文档和简单的设置选项
无论您是在构建基于人工智能的团队分析、自动化回顾管理还是集成 Teamretro 在您的AI工作流程中，此MCP服务器为您提供了所需的基础。
重要说明
非官方MCP服务器
API官方集成
服务器直接连接到 Teamretro的官方公开API：
- 使用以下记录的端点 Teamretro的API规范
- 保持API的全面合规性和版本跟踪
- 实现所有必需的身份验证方法
- 保留原始API响应而不进行修改
API文件来源
所有API端点和功能都基于 Teamretro的官方文件：
- API帮助文章：https://help.teamretro.com/article/320-teamretro-api
- API规范：https://groupmap.stoplight.io/docs/teamretro/
- 执行严格遵循公共API规范
- TeamRetro API的任何更改都可能影响此MCP服务器的功能
如何使用
NPX（推荐，易于设置）
{
"mcpServers": {
"teamretro-mcp-server": {
"command": "npx",
"args": ["-y", "teamretro-mcp-server"],
"env": {
"TEAMRETRO_AUTH_TYPE": "apiKey",
"TEAMRETRO_API_KEY": "your-api-key"
}
}
}
}通过Smithery安装
通过以下方式自动安装TeamRetro MCP Server for Claude Desktop 铁匠铺:
npx -y @smithery/cli install @adepanges/teamretro-mcp-server --client claude源代码
- 克隆存储库、安装依赖项并构建项目：
git clone https://github.com/adepanges/teamretro-mcp-server.git
cd teamretro-mcp-server
pnpm install
pnpm run build在AI客户端中运行
- 使用以下设置配置AI客户端：
{
"mcpServers": {
"teamretro-mcp-server": {
"command": "node",
"args": ["/path/to/teamretro-mcp-server/dist/index.js"],
"env": {
"TEAMRETRO_AUTH_TYPE": "apiKey",
"TEAMRETRO_API_KEY": "your-api-key"
}
}
}
}与Inspector一起运行
- 通过复制配置环境变量
.env.example到.env并根据您的需要进行修改。 - 使用检查器运行服务器：
pnpm run inspector环境变量示例
基本URL
的基本URL Teamretro API可以使用 TEAMRETRO_BASE_URL 环境变量。默认情况下，它设置为 https://api.teamretro.com.
{
"env": {
"TEAMRETRO_BASE_URL": "https://api.teamretro.com"
}
}API密钥验证
{
"env": {
"TEAMRETRO_AUTH_TYPE": "apiKey",
"TEAMRETRO_API_KEY": "your-api-key"
}
}可用工具
服务器提供以下工具：
用户
list_users：使用偏移量和限制参数来控制返回的结果数量，列出具有分页的用户add_user：通过电子邮件地址添加新用户或更新现有用户的信息，指定可选名称和电子邮件地址update_user：通过提供现有用户的当前电子邮件来更新其详细信息，如姓名和电子邮件地址delete_user：按电子邮件地址删除用户get_user：通过电子邮件地址检索单个用户的详细信息
团队
list_teams：列出TeamRetro中的团队，按标签和ID进行筛选，并使用偏移和限制参数进行分页detail_team：通过单个团队的唯一ID检索其详细信息update_team：通过提供团队ID来更新现有团队的详细信息，如团队名称和相关标签create_team：使用所需名称、可选标签和成员创建新团队delete_team：按ID删除现有团队
团队成员
list_team_members：使用偏移和限制的分页控件检索指定团队ID的团队成员列表get_team_member：通过指定团队中的电子邮件地址获取团队成员update_team_member：通过指定团队中的电子邮件地址更新团队成员的详细信息，如他们的姓名或团队管理员状态remove_team_member：通过电子邮件地址从团队中删除团队成员add_team_member：通过电子邮件地址将新团队成员添加到团队中，并可选择指定团队管理员状态
行动
list_actions：从TeamRetro中检索操作列表，可选择按团队标签和团队ID进行筛选，并对偏移和限制进行分页控制create_action：在TeamRetro中创建一个新操作，其中包含所需的详细信息，如团队ID、标题、截止日期、完成状态和分配的用户get_action：从TeamRetro获取单个动作的唯一IDupdate_action：使用新的详细信息（如标题、截止日期、完成状态、优先级和分配的用户）更新TeamRetro中的现有操作delete_action：按操作ID从TeamRetro中删除现有操作
协议
list_agreements：列出TeamRetro中的协议，可选择按团队标签和团队ID进行筛选，以及分页控制create_agreement：在TeamRetro中通过指定所属团队及其标题创建新协议get_agreement：通过唯一标识符检索单个协议update_agreement：更新现有协议的详细信息，如标题或相关团队delete_agreement：通过指定现有协议的唯一标识符删除该协议
健康检查
list_health_checks：列出TeamRetro中的健康检查，并可选择按健康模型ID、团队标签和团队ID进行筛选，以及分页控件get_health_check：通过具有可选属性的唯一标识符检索单个健康检查delete_health_check：通过指定现有健康检查的唯一标识符删除该检查
健康模型
list_health_models：列出TeamRetro中带有分页控件的健康模型get_health_model：通过其唯一标识符检索单个健康模型
回顾
list_retrospectives：列出TeamRetro中的回顾，按团队标签和ID进行筛选，并使用偏移和限制参数进行分页get_retrospective：通过唯一ID检索单个回顾的详细信息delete_retrospective：按ID删除现有的追溯记录
报告
team_activity_report：从TeamRetro生成团队活动报告，并按团队标签和团队ID进行筛选team_actions_activity_report：从TeamRetro生成团队行动活动报告，并按团队标签和团队ID进行筛选。返回CSV数据，其中包含按年龄范围分组的未完成、已完成和逾期操作计数等操作统计信息retrospective_activity_report：从TeamRetro生成回顾性活动报告，按日期范围、团队标签和团队ID进行筛选。返回CSV数据，其中包含回顾性统计数据，包括参与率、想法数、评论数、行动数和协议数health_check_activity_report：从TeamRetro生成健康检查活动报告，按日期范围、团队标签和团队ID进行筛选。返回包含健康检查统计信息的CSV数据，包括参与率、评论数、操作数和协议数team_health_latest_report：通过TeamRetro为特定的健康模型生成团队健康（最新）报告，并按日期范围、团队标签和团队ID进行过滤。返回包含最新团队健康评分（包括健康维度）的CSV数据team_health_historical_report：通过TeamRetro为特定的健康模型生成团队健康（历史）报告，并按日期范围、团队标签和团队ID进行过滤。返回CSV数据，其中包含历史团队健康评分，包括健康维度users_report：从TeamRetro生成用户报告，按团队标签和团队ID进行过滤。返回包含用户信息的CSV数据，包括帐户角色、团队成员资格和活动统计信息
更新日志
有关更改和更新的详细列表，请参阅 更改日志.md.