首页
学习
活动
专区
圈层
工具
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往
首页
学习
活动
专区
圈层
工具
MCP广场
MCP广场 >详情页
mcp-server-tapd云托管模式2025-05-2154分享
cnb
与 TAPD API 无缝集成,提升开发效率。TAPD 是腾讯敏捷研发管理平台,覆盖需求、计划、研发、测试、发布研发全生命周期。支持用自然语言与 TAPD 对话,实现需求、缺陷、任务、迭代等管理。
By 腾讯 TAPD
2025-05-2154
cnb
详情内容

TAPD MCP Server

TAPD 是腾讯敏捷研发管理平台,覆盖需求、计划、研发、测试、发布研发全生命周期。支持用自然语言与 TAPD 对话,实现需求、缺陷、任务、迭代等管理。

  • 与 TAPD API 无缝集成,提升开发效率

System requirements

  • uv
  • TAPD API Token

Setup Guide

Install uv

brew install uv
# OR
curl -LsSf https://astral.sh/uv/install.sh | sh

Get TAPD API Token

Get API tokens from: https://www.tapd.cn/open_platform/open_api_redirect

  1. 未注册,请前往 注册
  2. 已注册但未授权API,请前往API配置:登录TAPD,点击进入“公司管理-API账号管理”,复制API账号和API密钥
  3. 参数
  • TAPD_API_USER: API账号
  • TAPD_API_PASSWORD: API密钥
  • BOT_URL: 企业微信机器人 webhook 地址,选填,如果需要发送消息到企业微信群才需要填

Configuration and Usage

Claude Desktop Setup

{
  "mcpServers": {
    "mcp-server-tapd": {
      "command": "uvx",
      "args": ["mcp-server-tapd"],
      "env": {
        "TAPD_API_USER": "",
        "TAPD_API_PASSWORD": "",
        "TAPD_API_BASE_URL": "https://api.tapd.cn",
        "TAPD_BASE_URL": "https://www.tapd.cn",
        "BOT_URL": ""
      }
    }
  }
}

Cursor IDE Setup

  1. Open Cursor Settings
  2. Navigate to Features > MCP Servers
  3. Click Add new MCP server

For stdio transport:

name: mcp-server-tapd
type: command
command: uvx mcp-server-tapd --api-user=your_api_user --api-password=your_api_password --api-base-url=https://api.tapd.cn --tapd-base-url=https://www.tapd.cn  --bot-url=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=XXX
通过SSE URL连接服务
Server已在腾讯云托管,可在连接后免费调用和在线进行工具测试~
工具测试
已支持Server下的34个工具,可选择工具进行在线测试
get_stories_or_tasks
获取 TAPD 需求或任务,如果没有 limit 参数,则需要同时调用 get_story_count 工具获取需求数量 TAPD API 文档:https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/story/get_stories.html Args: workspace_id: 项目ID(必填) options: 可选参数字典,支持以下字段: - entity_type: 类型,需求stories或任务tasks(必填) - id: ID - name: 标题,支持模糊匹配,例如:"%搜索词%" - stauts: 状态,支持枚举查询,例如:status=status1|status2|status3 等等... Returns: <str> # 需求或者任务所有字段数据的 json 格式,返回链接给用户,链接要可点击。而且需要返回剩余的需求数量,让用户确定是否需要继续获取剩余的需求 Note: 需求链接格式为 {tapd_base_url}/{workspace_id}/prong/stories/view/{id} Note: 任务链接格式为 {tapd_base_url}/{workspace_id}/prong/tasks/view/{id} Note: 如果没有给limit 参数,则需要提醒用户剩余的数量 Note: 任务的状态status只有三个,open: 未开始,progressing: 进行中,done: 已完成
get_story_or_task_custom_fields
获取 TAPD 需求或任务自定义字段配置 Args: workspace_id: 项目ID(必填) options: 可选参数字典,支持以下字段: - entity_type: 类型,需求stories或任务tasks(必填) Returns: <str> # 需求或者任务所有自定义字段配置数据的 json 格式
get_story_or_task_count
获取 TAPD 需求或者任务的数量 TAPD API 文档:https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/story/get_stories_count.html Args: workspace_id: 项目ID(必填) options: 可选参数字典,支持以下字段: - entity_type: 类型,需求stories或任务tasks(必填) - id: ID - name: 标题 - workitem_type_id: 需求类别ID,支持枚举查询,例如:workitem_type_id=workitem_type_id_1|workitem_type_id_2|workitem_type_id_3 - stauts: 状态,支持枚举查询,例如:status=status1|status2|status3 等等... Returns: <str> # 需求所有字段数据的 json 格式
update_story_or_task
更新 TAPD 需求或任务,任务的状态只有三个,open: 未开始,progressing: 进行中,done: 已完成,如果是流转任务的状态,则 status 的值为 done TAPD API 文档:https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/story/update_story.html Args: workspace_id: 项目ID(必填) options: 可选参数字典,支持以下字段: - entity_type: 类型,需求stories或任务tasks(必填) - id: 需求或任务ID(必填) - name: 标题 - status: 状态 - description: 描述 等等... Returns: <str>, # 需求或者任务所有字段数据的 json 格式 Note: 需求链接格式为 {tapd_base_url}/{workspace_id}/prong/stories/view/{story_id} Note: 任务链接格式为 {tapd_base_url}/{workspace_id}/prong/tasks/view/{id}
create_story_or_task
创建 TAPD 需求 TAPD API 文档:https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/story/add_story.html Args: workspace_id: 项目ID(必填) name: 需求或任务的标题(必填) options: 可选参数字典,支持以下字段: - entity_type: 类型,需求stories或任务tasks(必填) - priority_label: 优先级 - description: 描述,富文本格式 等等... Returns: { "data": <str>, # 需求或任务所有字段数据的 json 格式 "url": <str> # 需求或者任务 url,返回给用户时,链接要可点击 }
get_bug
获取 TAPD 缺陷 TAPD API 文档:https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/bug/get_bugs.html Args: workspace_id: 项目ID(必填) options: 可选参数字典,支持以下字段: - id: ID - title: 标题 - stauts: 状态,支持枚举查询,例如:status=status1|status2|status3 等等... Returns: <str> # 缺陷所有字段数据的 json 格式 Note: 缺陷链接格式为 {tapd_base_url}/{workspace_id}/bugtrace/bugs/view/{id}
get_bug_custom_fields
获取 TAPD 缺陷自定义字段配置 Args: workspace_id: 项目ID(必填) Returns: <str> # 需求所有自定义字段配置数据的 json 格式
get_bug_count
获取 TAPD 缺陷 TAPD API 文档:https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/bug/get_bugs_count.html Args: workspace_id: 项目ID(必填) options: 可选参数字典,支持以下字段: - id: ID - name: 标题 等等... Returns: <str> # 需求所有字段数据的 json 格式
update_bug
更新 TAPD 缺陷 TAPD API 文档:https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/bug/update_bug.html Args: workspace_id: 项目ID(必填) options: 可选参数字典,支持以下字段: - id: 缺陷ID(必填) - title: 标题 - description: 描述 等等... Returns: <str> # 缺陷所有字段数据的 json 格式 Note: 缺陷链接格式为 {tapd_base_url}/{workspace_id}/bugtrace/bugs/view/{id}
create_bug
创建 TAPD 缺陷 TAPD API 文档:https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/bug/add_bug.html Args: workspace_id: 项目ID(必填) title: 缺陷标题(必填) options: 可选参数字典,支持以下字段: - priority_label: 优先级 - description: 描述 等等... Returns: { "data": <str>, # 所有字段数据的 json 格式 "url": <str> # url,返回给用户时,链接要可点击 } Note: 缺陷链接格式为 {tapd_base_url}/{workspace_id}/bugtrace/bugs/view/{id}
create_comments
添加评论 TAPD API 文档:https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/comment/add_comment.html Args: workspace_id: 项目ID(必填) options: 可选参数字典,支持以下字段: - entry_id: 评论所依附的业务对象实体id(必填) - entry_type: 评论类型(取值: bug、 bug_remark (流转缺陷时候的评论)、 stories、 tasks 。)(必填) - author: 评论人(必填) - description: 内容(必填) - root_id: 根评论ID - reply_id: 需求评论回复的ID Returns: <str> # 新建评论的数据
update_comments
更新评论,返回更新评论的数据 Args: workspace_id: 项目ID(必填) options: 可选参数字典,支持以下字段: - id: 评论id(必填) - description: 内容(必填) - change_creator: 变更人(必填) Returns: <str> # 更新后的评论数据
get_comments
获取符合查询条件的所有评论(分页显示,默认一页30条) Args: workspace_id: 项目ID(必填) options: 可选参数字典,支持以下字段: - id: 评论ID(格式如:1159271484001002933) - title: 标题 - description: 内容 - author: 评论人 - entry_type: 评论类型(取值: bug、 bug_remark (流转缺陷时候的评论)、 stories、 tasks 。多个类型间以竖线隔开) - entry_id: 评论所依附的业务对象实体id - created: 创建时间,支持时间查询 - limit: 设置返回数量限制,默认为30 - page: 返回当前数量限制下第N页的数据,默认为1(第一页) - order: 排序规则,规则:字段名 ASC或者DESC,然后 urlencode,如按创建时间逆序:order=created%20desc - fields: 设置获取的字段,多个字段间以','逗号隔开 Returns: <str> # 符合条件的评论数据
get_workflows_all_transitions
获取项目下的工作流流转细则,例如要流转到"实现中",则需要调用这个工具查看当前状态能流转到的状态 Args: workspace_id: 项目ID(必填) options: - system: 系统名。取 bug (缺陷的)或者 story(需求的)(必填) - workitem_type_id: 需求类别ID(必填) Returns: <str> 状态流转细则
get_workflows_status_map
获取工作流状态中英文名对应关系,例如想要获取所有"实现中"的需求/缺陷等,可以调用这个接口先获取状态的英文名,再根据这个英文名作为 status 字段的值去查询 Args: workspace_id: 项目ID(必填) options: - system: 系统名。取 bug (缺陷的)或者 story(需求的)(必填) - workitem_type_id: 需求类别ID(必填) Returns: <str> 状态流转细则
get_workitem_types
获取符合查询条件的所有需求类别(分页显示,默认一页30条) TAPD API 文档:https://open.tapd.cn/document/api-doc/API%E6%96%87%E6%A1%A3/api_reference/story/get_workitem_types.html Args: workspace_id: 项目ID(必填) options: - id: id,支持多ID查询 - name: 需求类别名称 等等... Returns: <str> 项目下所有需求类别字段数据
get_workflows_last_steps
获取工作流结束状态,一次只能获取一个项目的工作流结束状态 Args: workspace_id: 项目ID(必填) options: - system: 系统名。取 bug (缺陷的)或者 story(需求的)(必填) - workitem_type_id: 需求类别id(不传则取项目下所有工作流的结束状态) - type: 节点类型,仅并行工作流需区分。status 状态,step 并行工作流节点。默认只返回结束状态。若需要同时返回结束状态和结束节点,支持数组type[]=status&type[]=step Returns: <str> 工作流结束状态
get_stories_custom_fields_settings
获取需求自定义字段配置,一次只能获取一个项目的配置 Args: workspace_id: 项目ID(必填) Returns: <str> 需求自定义字段配置
get_stories_fields_lable
获取需求所有字段的中英文 Args: workspace_id: 项目ID(必填) Returns: <str>
get_stories_fields_info
获取需求所有字段及候选值,返回符合查询条件的所有需求字段及候选值。 部分字段为静态候选值,建议参考下方 "可选值说明"部分。其余动态字段(如:status(状态)/iteration_id(迭代)/categories(需求分类)),需要通过该接口获取对应的候选值(中英文映射) Args: workspace_id: 项目ID(必填) Returns: <str>
get_workspace_info
根据项目ID(workspace_id)获取项目信息,包含项目ID,项目名称,状态,创建时间,创建人等信息 Args: workspace_id: 项目ID(必填) Returns: <str>
get_iterations
根据项目ID(workspace_id)获取符合查询条件的所有迭代,例如可以通过名称获取迭代 id,然后作为iteration_id字段的值获取到迭代下的需求或缺陷 Args: workspace_id: 项目ID(必填) options: - id: ID - name: 标题 - startdate: 开始时间 - enddate: 结束时间 ... Returns: <str>
update_iteration
更新迭代,返回更新迭代的数据 Args: workspace_id: 项目ID(必填) options: - id: 迭代ID(必填) - current_user: 变更人(必填) - name: 标题 - startdate: 开始时间 - enddate: 结束时间 - creator: 创建人 - status: 状态 ... Returns: <str> # 迭代所有字段数据的 json 格式 Note: 迭代字段说明 status: 迭代状态,open: 开启,done: 已关闭
create_iteration
创建迭代,返回创建迭代的数据 Args: workspace_id: 项目ID(必填) options: - name: 迭代名称(必填) - startdate: 开始时间(必填) - enddate: 结束时间(必填) - creator: 创建人(必填) - status: 状态 ... Returns: <str> # 迭代所有字段数据的 json 格式,需要返回链接给用户,链接要可点击。 Note: 迭代字段说明 status: 迭代状态,open: 开启,done: 已关闭 Note: 迭代链接格式为 {tapd_base_url}/{workspace_id}/prong/iterations/card_view/{id}
get_related_bugs
获取符合查询条件的所有需求关联的缺陷ID Args: workspace_id: 项目ID(必填) options: - story_id: ID(必填),支持多ID查询 Returns: <str>
entity_relations
创建需求与缺陷关联关系 Args: workspace_id: 所属TAPD项目ID(必填) options: - source_type: 关联关系源对象类型(story、bug)(必填) - target_type: 关联关系目标对象类型(story、bug)(必填) - source_id: 关联关系源对象id(必填) - target_id: 关联关系目标对象id(必填) Returns: <str> # 返回关联关系
create_or_update_tcases
新建测试用例,返回新建测试用例的数据 Args: workspace_id(int): 项目ID(必填) options: 可选参数字典,支持以下字段: - id(int): 测试用例 ID - name(str): 用例名称 - category_id: 用例目录 enum('updating','abandon','normal') - status: 前置条件 - precondition: 前置条件 - steps: 用例步骤 - expectation: 预期结果 - type: 用例类型 - priority: 用例等级 - creator: 创建人 - custom_field_*: 自定义字段参数,具体字段名通过接口 获取测试用例自定义字段配置获取 Returns: <str> # 新建测试用例的数据 Note: 测试用例链接格式为 {tapd_base_url}/{workspace_id}/sparrow/tcase/view/{id}
get_tcases
获取测试用例,返回符合查询条件的所有测试用例(分页显示,默认一页30条),默认返回 30 条。可通过传 limit 参数设置,最大取 200。也可以传 page 参数翻页 Args: workspace_id(int): 项目ID(必填) options: 可选参数,支持以下字段: - id(str): ID - name: 用例名称 - steps: 用例步骤 - category_id(int): 用例目录 - created: 创建时间 - modifier: 最后修改人 - modified: 最后修改时间 - creator: 创建人 - status: 用例状态 enum('updating','abandon','normal') - precondition: 前置条件 - expectation: 预期结果 - type: 用例类型 - priority: 用例等级 - is_automated: 是否实现自动化 - automation_type: 自动化测试类型 - automation_platform: 自动化测试平台 - is_serving: 是否上架 - limit: 设置返回数量限制,默认为30 - page: 返回当前数量限制下第N页的数据,默认为1(第一页) - order: 排序规则,规则:字段名 ASC或者DESC,然后 urlencode,如按创建时间逆序:order=created%20desc - fields: 设置获取的字段,多个字段间以','逗号隔开 - custom_field_*: 自定义字段参数,具体字段名通过接口 获取 Returns: <str> # 符合查询条件的测试用例所有字段数据的 json 格式 Note: 测试用例链接格式为 {tapd_base_url}/{workspace_id}/sparrow/tcase/view/{id}
create_wiki
新建Wiki,返回新建Wiki的数据 Args: workspace_id(int): 项目ID(必填) options: 可选参数字典,支持以下字段: - name(str): 标题(必填) - markdown_description: wiki 内容,Markdown 格式 - creator: 创建人(必填) - note: 备注 - parent_wiki_id(str): 父wiki名 Returns: <str> # 新建wiki的数据 Note: wiki链接格式为 {tapd_base_url}/{workspace_id}/markdown_wikis/show/#{id}
update_wiki
更新 TAPD wiki Args: workspace_id: 项目ID(必填) options: 可选参数字典,支持以下字段: - id: wiki ID(必填) - name(str): 标题 - markdown_description: wiki 内容,Markdown 格式 - note: 备注 - parent_wiki_id(str): 父wiki名 Returns: <str> # wiki 所有字段数据的 json 格式 Note: wiki链接格式为 {tapd_base_url}/{workspace_id}/markdown_wikis/show/#{id}
get_wiki
获取 Wiki,返回符合查询条件的所有Wiki(分页显示,默认一页30条) Args: workspace_id(int): 项目ID(必填) options: 可选参数,支持以下字段: - id(int): id - name(str): 标题 - modifier(str): 最后修改人 - creator: 创建人 - note: 备注 - view_count: 浏览量 - created: 创建时间 - modified: 最后修改时间 - limit: 设置返回数量限制,默认为30 - page: 返回当前数量限制下第N页的数据,默认为1(第一页) - order(str): 排序规则,规则:字段名 ASC或者DESC,然后 urlencode,如按创建时间逆序:order=created%20desc - fields: 设置获取的字段,多个字段间以','逗号隔开 Returns: <str> # 符合查询条件的wiki所有字段数据的 json 格式 Note: wiki链接格式为 {tapd_base_url}/{workspace_id}/markdown_wikis/show/#{id}
get_tcases_custom_fields_settings
获取测试用例自定义字段配置 Args: workspace_id: 项目ID(必填) Returns: <str> 测试用例自定义字段配置
get_todo
获取用户的待办 Args: entity_type: 业务对象类型,如需求story、缺陷bug、任务task(必填) user_nick: 用户昵称,如果为空则从环境变量CURRENT_USER_NICK获取 Returns: dict: 待办数据 Raises: ValueError: 当user_nick为空且环境变量CURRENT_USER_NICK也为空时抛出
send_qiwei_message
发送信息到企业微信群 Args: msg: 推送的企业微信的信息,Markdown 格式(必填) Returns: <str>
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档