腾讯云TAPD MCP Server

你是否曾经希望自己的AI助手能够直接连接你的项目管理工具，自动创建任务、更新缺陷状态、生成迭代报告？今天要介绍的开源项目腾讯云TAPD MCP Server，正是为了实现这个目标而设计的。它由腾讯TAPD团队官方打造，让AI能够通过自然语言与TAPD敏捷研发管理平台对话，覆盖需求、计划、研发、测试、发布的研发全生命周期。

项目基本信息

一、项目介绍

腾讯云TAPD MCP Server是腾讯TAPD团队官方推出的MCP服务器。TAPD（Tencent Agile Product Development）是腾讯敏捷研发管理平台，广泛应用于需求管理、缺陷跟踪、任务分配和迭代规划等场景。这个MCP服务器将TAPD的API能力封装成了标准的MCP工具，让AI能够通过自然语言直接操作TAPD。

通过这个服务器，AI可以：

• 创建、查询、更新需求
• 管理缺陷和任务
• 规划和跟踪迭代
• 获取项目信息
• 发送企业微信通知（通过BOT_URL配置）

这意味着你可以在Cursor、Claude Desktop等AI IDE中，用自然语言完成项目管理操作，而无需在IDE和TAPD网页之间反复切换。

二、核心优势

官方出品，稳定可靠

由腾讯TAPD团队官方开发维护，与TAPD API同步更新，兼容性和稳定性有保障。

自然语言交互

支持用自然语言与TAPD对话。例如：“帮我创建一个高优先级的缺陷”、“查询当前迭代中未完成的任务”。

多种认证方式

支持两种认证方式：

• TAPD Access Token（推荐）：个人令牌，权限可控
• API账号密码：兼容旧版API调用方式

灵活的运行模式

支持两种运行模式：

• stdio模式：与Claude Desktop、Cursor等客户端集成
• Streamable HTTP模式：作为独立服务运行，支持远程访问

企业微信集成

可选配置企业微信机器人webhook，AI可以在执行操作后自动发送通知到企业微信群。

三、适用场景

开发者日常项目管理

在编写代码的同时，通过AI快速创建任务、更新缺陷状态，无需切换到TAPD网页。

AI驱动的自动化工作流

结合其他MCP服务器，实现从需求到代码的自动化流程。例如：AI根据TAPD需求自动生成代码，完成后自动更新任务状态。

团队协作与通知

当重要需求或缺陷状态变更时，AI自动通过企业微信通知相关成员。

项目管理报告生成

AI可以根据TAPD中的数据，自动生成迭代报告、缺陷统计等。

四、安装教程

系统要求

安装步骤

第一步：安装uv包管理工具

# macOS
brew install uv

# Linux/其他
curl -LsSf https://astral.sh/uv/install.sh | sh

第二步：获取TAPD访问凭证（二选一）

方式A：TAPD Access Token（推荐）

1. 登录TAPD网页版
2. 进入“我的设置” -> “个人访问令牌”
3. 点击“创建个人访问令牌”
4. 复制并保存生成的令牌（只显示一次）

方式B：API账号密码

1. 登录TAPD，进入“公司管理” -> “API账号管理”
2. 复制API账号和API密钥

第三步：配置MCP客户端

对于Claude Desktop或Cursor，找到MCP配置文件，添加：

{
  "mcpServers": {
    "mcp-server-tapd": {
      "command": "uvx",
      "args": ["mcp-server-tapd"],
      "env": {
        "TAPD_ACCESS_TOKEN": "你的个人令牌",
        "TAPD_API_BASE_URL": "https://api.tapd.cn",
        "TAPD_BASE_URL": "https://www.tapd.cn"
      }
    }
  }
}

如果使用API账号密码方式：

{
  "env": {
    "TAPD_API_USER": "你的API账号",
    "TAPD_API_PASSWORD": "你的API密钥"
  }
}

第四步：重启客户端

保存配置文件后，重启Claude Desktop或Cursor。

五、使用示例

配置完成后，你就可以在MCP客户端中使用自然语言来操作TAPD了。

示例1：创建需求

用户指令：“在TAPD中创建一个需求，标题是‘优化登录页面性能’，优先级为高，处理人是我”

AI会调用相应的工具，创建需求并返回需求ID。

示例2：查询缺陷

用户指令：“查询当前迭代中所有未关闭的缺陷，按优先级排序”

AI会查询TAPD并返回缺陷列表。

示例3：更新任务状态

用户指令：“把任务#123456的状态改为‘已完成’”

AI会更新指定任务的状态。

示例4：获取迭代信息

用户指令：“当前迭代还有多少未完成的任务？”

AI会查询当前迭代的统计数据并返回。

示例5：发送企业微信通知

如果配置了BOT_URL，你可以这样使用：

用户指令：“当有新的高优先级缺陷创建时，发送通知到企业微信群”

AI会在检测到新缺陷时自动发送通知。

示例6：Streamable HTTP模式

如果需要远程访问，可以启动HTTP服务：

# 克隆项目
git clone https://cnb.cool/tapd_mcp/mcp-server-tapd.git
cd mcp-server-tapd/src/mcp_server_tapd

# 创建虚拟环境并安装依赖
uv venv && source .venv/bin/activate
uv pip install requests markdown mcp mcp_server_tapd

# 启动服务（使用Access Token）
python server.py --mode=streamable-http --host="0.0.0.0" --port=8000 --path="/mcp" --access-token="你的令牌"

# 或使用API账号密码
python server.py --mode=streamable-http --host="0.0.0.0" --port=8000 --path="/mcp" --api-user="账号" --api-password="密码"

然后在客户端配置：

{
  "mcpServers": {
    "tapd_mcp_http": {
      "url": "http://localhost:8000/mcp/"
    }
  }
}

六、常见问题

问题1：提示“TAPD_ACCESS_TOKEN环境变量未设置”

解决方案：请检查MCP配置中的env部分，确保TAPD_ACCESS_TOKEN正确设置。如果使用API账号密码方式，请确保设置了TAPD_API_USER和TAPD_API_PASSWORD。

问题2：认证失败，提示“Invalid credentials”

解决方案：

• 确认令牌或API账号密码正确
• 检查令牌是否有访问相应项目的权限
• 如果使用API账号，确保该账号在TAPD公司管理中被正确授权

问题3：无法连接到TAPD API

解决方案：

• 检查网络是否可以访问https://api.tapd.cn
• 如果使用公司内网，可能需要配置代理
• 确认TAPD_API_BASE_URL和TAPD_BASE_URL配置正确

问题4：企业微信通知不发送

解决方案：

• 确认BOT_URL配置正确
• 检查机器人webhook是否有效
• 确认服务器可以访问企业微信API

问题5：Streamable HTTP模式下无法连接

解决方案：

• 确认服务已正常启动，端口未被占用
• 检查防火墙是否允许该端口
• 在客户端配置中使用正确的URL路径（如/mcp/）

七、总结

腾讯云TAPD MCP Server是MCP生态中第一个由专业项目管理平台官方推出的服务器。它将TAPD强大的敏捷研发管理能力，通过MCP协议开放给AI助手，实现了“用自然语言管理项目”的愿景。

这个项目的最大价值在于：

1. 官方支持：由TAPD团队维护，可靠性高
2. 无缝集成：直接在AI IDE中管理项目，无需切换上下文
3. 灵活部署：支持stdio和HTTP两种模式，适应不同场景
4. 企业级功能：支持企业微信通知，适合团队协作

如果你所在的团队使用TAPD进行项目管理，并且你也在使用AI编程工具，那么腾讯云TAPD MCP Server将极大地提升你的工作效率。 让AI帮你处理繁琐的项目管理事务，你只需专注于真正的开发工作。