TAPD MCP Server

Name: TAPD MCP Server
Author: sun-jingtao

제작자: sun-jingtao버전 1.0.8i★ –i내 컴퓨터에서 실행

레지스트리 이름io.github.sun-jingtao/tapd-mcp-server

설치

개요

제작자가 쓴 설명(영어 원문)

在 Cursor/Copilot 中查询、分析和回填 TAPD bug / 需求

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견i아직 리뷰가 없어요리뷰는 다음 단계에서 계정 기능과 함께 열려요
우리의 기본 점검i1개 중 1개 통과공개된 정보로 점검했으며, 코드는 아직 스캔하지 않았어요
사용 정도i아직 측정 안 함★ –

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

연결 방식: 내 컴퓨터에서 실행
전송 방식: stdio
카테고리: 기타
입력해야 할 값: TAPD_ACCESS_TOKEN

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

기본 점검: 1개 중 1개 통과
내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
직접 입력할 값: TAPD_ACCESS_TOKEN, TAPD_ALLOW_RAW_WRITE

비밀로 표시된 값은 내 계정의 열쇠예요. 절대 다른 사람과 공유하거나 채팅에 붙여 넣지 마세요.

필요한 것

npmNode.js 설치(npx 명령어용)

어떤 앱을 쓰세요?

ClaudeClaude CodeCursorVS CodeChatGPT

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요

{
  "mcpServers": {
    "tapd": {
      "command": "npx",
      "args": [
        "-y",
        "tapd-mcp-server"
      ],
      "env": {
        "TAPD_ACCESS_TOKEN": "your-value",
        "TAPD_ALLOW_RAW_WRITE": "your-value"
      }
    }
  }
}

터미널에서 이 명령어를 실행하세요

claude mcp add tapd --env TAPD_ACCESS_TOKEN=your-value --env TAPD_ALLOW_RAW_WRITE=your-value -- npx -y tapd-mcp-server

실행하기 전에 빈 값을 채워 주세요.

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

{
  "mcpServers": {
    "tapd": {
      "command": "npx",
      "args": [
        "-y",
        "tapd-mcp-server"
      ],
      "env": {
        "TAPD_ACCESS_TOKEN": "your-value",
        "TAPD_ALLOW_RAW_WRITE": "your-value"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

{
  "servers": {
    "tapd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "tapd-mcp-server"
      ],
      "env": {
        "TAPD_ACCESS_TOKEN": "your-value",
        "TAPD_ALLOW_RAW_WRITE": "your-value"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

TAPD_ACCESS_TOKEN 비밀 필수 env
TAPD 个人访问令牌
TAPD_ALLOW_RAW_WRITE env
是否允许 tapd_call_api 通用透传工具发起 POST 写操作，设为 true 开启；默认关闭，仅拦截透传写入，不影响专用写工具

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 8일 점검

✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 sun-jingtao 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
… 아직 점검 안 함
계속 관리되고 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
… 아직 점검 안 함
라이선스 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
– 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
– 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
… 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

기타 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 18360개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 18360개 중 15%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 18360개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

TAPD MCP Server, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: TAPD_ACCESS_TOKEN

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(1.0.8)은 4개월 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, Tool Guardian

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Spec Driven Development

제작자: formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

내 컴퓨터에서 실행★ 440MIT14개월 전 업데이트

설치

Remote Desktop Commander

제작자: desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

클라우드에서 실행★ 211그저께 업데이트

설치

Tool Guardian

제작자: LuminariSoftwares

Too many MCP servers eating your context? A router that loads each tool's schema only when needed.

내 컴퓨터에서 실행오늘 업데이트

설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

TAPD MCP Server

把 TAPD 装进你的 IDE 对话框 —— 查需求、评 PRD、修 Bug、回填提测，一句话直达，全程不切窗口。

✨ 核心亮点

🔌 一键安装 —— 一段 npx 配置即用，无需 clone 仓库或装依赖，团队复制即接入。
🐞 Bug / 需求一条龙 —— 查询、读详情、分析定位、回填状态 / 评论 / 处理人，缺陷与需求全流程都在对话里完成（写操作均需你确认）。
🗂️ 跨项目自动聚合 —— 一人负责多个项目？列表查询自动聚合你参与的全部项目，每条结果标注归属，无需逐个切换。
🤖 内置工作流 Prompt —— PRD 研发评估、提测报告、Bug 修复回填三套开箱即用，编排现有工具、读着你的代码给结论。
👥 团队视角 —— 一句话让 Agent 跨成员、跨项目统计全组 bug / 需求（总数、未关闭、超 24h 未关闭、按成员拆分），组长盯进度直接可用（见下方「团队 Bug 统计」示例）。

🚀 快速开始

在 MCP 配置文件中添加以下内容，例如 .cursor/mcp.json 或 .vscode/mcp.json：

"mcpServers": { "TAPD MCP": { "command": "npx", "args": ["-y", "tapd-mcp-server"], "env": { "TAPD_ACCESS_TOKEN": "你的访问令牌" } } } }

变量	说明
`TAPD_ACCESS_TOKEN`	必填。TAPD 个人访问令牌，获取路径：TAPD 个人设置 → 个人访问令牌。请只放在本机 MCP 配置里，不要提交到代码仓库
`TAPD_ALLOW_RAW_WRITE`	可选，默认关闭。设为 `true` 后才允许 `tapd_call_api` 发起 POST 写操作（每次调用仍需你在对话中确认），详见下文「通用透传」
`TAPD_MCP_SENTRY_DSN`	可选。默认已启用错误上报（详见下文「错误上报与隐私」）；设为空字符串可关闭，或填自己的 DSN 覆盖默认上报目标

错误上报与隐私

本工具默认通过 Sentry 上报未捕获的运行时错误（崩溃堆栈、Node 版本、包版本），帮助维护者发现和修复问题。已做脱敏处理：

✅ 上报：错误堆栈、HTTP 请求的域名与路径、响应状态码
❌ 不上报：TAPD_ACCESS_TOKEN（走请求头，不进任何上报字段）、URL 查询参数（workspace_id、检索关键词等业务数据）、console 日志内容
正常的工具调用与查询结果不会触发任何上报

如需完全关闭，在 MCP 配置的 env 中设置 TAPD_MCP_SENTRY_DSN 为空字符串即可：

"env": { "TAPD_MCP_SENTRY_DSN": "" }

💡 使用示例

1. 团队 Bug 统计

统计我们组每个成员名下的 bug 数量，重点关注今日新增、超 24h 未修复、bug 存留超 72h，图表展示

Agent 会先用 tapd_search_users 确认各成员 nick，再用 tapd_list_bugs（跨项目聚合）逐个统计，汇总出全组视图：每人的未关闭、今日新增、超 24h / 72h、挂起等数量，并可按成员拆分明细。配合客户端的可视化能力（如 Cursor Canvas），还能直接生成下面这样的看板，组长盯进度一目了然。

这是一个由 Agent 编排多个 MCP 工具完成的使用场景，并非单个内置工具；统计维度与可视化形式由你的指令和客户端能力决定。

2. 查询我名下的需求和 Bug

列出我名下待处理的需求和 bug

Agent 跨项目聚合查询你负责的需求与缺陷，返回带内嵌超链接的 Markdown 表格——名称即链接、点击直达 TAPD，并标注每条所属项目。可继续按状态、创建时间、关联需求等过滤，或指定某个项目 ID 只查该项目。

3. 批量判断服务端归因并追加处理人

分析我名下待处理的 bug，哪些更像是服务端原因，并在处理人里添加服务端同学亚勇

Agent 会先查询 bug 详情，再根据现象、接口返回、复现步骤等信息判断疑似服务端问题。更新处理人前会先用 tapd_search_users 确认成员身份，最后经你确认后再写回 TAPD。

4. Bug 批量修复并回填

帮我修复 123456、123457，结合代码定位并给出修改方案

Agent 跨项目定位各 bug、拉取完整上下文（描述、复现、评论、附件、图片），结合当前代码库给出问题定位与修改建议（改码需你确认）；修复后用内置 Prompt tapd_bug_fix_writeback 生成回填草稿，确认后把状态改为已解决并写入评论，不会主动更新处理人。

5. 需求宣讲前研发评估

使用 tapd_prd_analysis 分析需求 123456，生成需求宣讲前研发评估报告

支持 MCP Prompts 的客户端会自动获得 tapd_prd_analysis。Agent 获取需求详情，按需查询需求变更、关联测试用例和关联 bug，再阅读当前代码库定位相关路由、页面、组件、接口、状态管理、数据模型、权限、埋点和配置，结合代码现状给出研发视角的判断（结论先行、不复述 PRD，写操作均需你确认）。

报告按固定模板输出，便于宣讲前快速过审：

结论 —— 需求目标、改动范围、最大风险、必须确认；
技术判断 —— 相关代码、实现方案、接口 / 数据 / 权限；
风险与依赖 —— 主要风险、外部依赖、漏洞 / 异常场景；
测试建议 —— 验收路径、边界 / 回归；
待确认问题 —— 最多 3 条，不确定项标注「需要确认」，不臆测、不凑数。

6. 提测准入判断并生成提测文档

使用 tapd_test_doc 生成提测文档，测试环境是 https://example.com/checkout.html

支持 MCP Prompts 的客户端会自动获得 tapd_test_doc，只读代码、不改 TAPD，分两阶段：

提测准入判断 —— 自动对照需求的 PRD 用例、验收要点和未关闭缺陷，判断本次改动是否达标。
生成提测文档 —— 达标或你确认后，把代码改动翻译成「本次提测」与「测试重点」，写入项目根目录 提测文档.md。

两种典型结果：

准入通过 —— 直接生成提测文档，含 测试环境 / 本次提测 / 测试重点 / 已知问题 四段。
准入不达标 —— 逐条列出差距，请你三选一：A 继续提测并记为已知问题 / B 继续提测忽略风险 / C 终止提测；未决策前不生成文档。

🧰 能力总览

工具（18）

🛡️ 创建、回填、上传等写操作工具均内置二次确认：执行前需要你在对话中明确同意，防止 AI 未经授权修改 TAPD 数据；tapd_call_api 的 POST 写操作另需环境变量 TAPD_ALLOW_RAW_WRITE=true 开启。详见下文「安全确认」。

需求（Story）

工具	作用
`tapd_list_stories`	查询需求列表，支持跨项目聚合与多字段过滤
`tapd_get_stories`	获取需求完整详情（描述、评论、附件、内嵌媒体）
`tapd_create_story`	创建需求，支持处理人、优先级、迭代、父需求、标签、排期、工时、自定义字段等
`tapd_writeback_story`	回填需求评论 / 描述 / 状态 / 处理人，及标题、优先级、迭代、工时、标签等标准字段和自定义字段
`tapd_list_story_changes`	查询需求变更历史
`tapd_list_story_test_cases`	查询需求关联的测试用例

缺陷（Bug）

工具	作用
`tapd_list_bugs`	查询缺陷列表，支持跨项目聚合与多字段过滤
`tapd_get_bugs`	获取缺陷完整详情（描述、复现、评论、附件、内嵌媒体）
`tapd_create_bug`	创建缺陷，支持处理人、优先级、严重程度、版本、迭代、排期、各类人员、工时、自定义字段等
`tapd_writeback`	回填缺陷评论 / 标题 / 描述 / 状态 / 处理人，及优先级、版本、迭代、工时、标签等标准字段和自定义字段
`tapd_list_bug_changes`	查询缺陷变更历史

缺陷多媒体

工具	作用
`tapd_upload_bug_attachment`	上传缺陷附件（png/mp4 等，≤250MB）
`tapd_upload_bug_image`	上传描述内嵌图，返回 html_code（≤5MB）
`tapd_append_bug_description_image`	上传图片并自动追加到缺陷描述（先读后写，避免覆盖）

项目 / 迭代 / 成员

工具	作用
`tapd_list_workspaces`	查询你参与的项目（workspace）
`tapd_list_iterations`	查询项目迭代，支持按名称、状态、起止时间、创建人、自定义字段等过滤并自定义排序
`tapd_search_users`	搜索 TAPD 成员，确认 nick，避免重名误写

通用透传

工具	作用
`tapd_call_api`	直接调用任意 TAPD OpenAPI 接口（任务、工时、测试计划、模块/版本配置、Wiki、看板等），兜底专用工具未覆盖的场景；path 以官方文档为准。POST 写操作默认禁用，需设置环境变量 `TAPD_ALLOW_RAW_WRITE=true` 且每次调用显式确认

工作流 Prompt（3）

随 MCP Server 一起分发，支持 MCP Prompts 的客户端会自动获得。只编排现有工具、不新增写入能力：

Prompt	作用
`tapd_prd_analysis`	需求宣讲前的简洁研发评估：读需求 + 关联用例 + 关联缺陷 + 你的代码库，输出研发视角判断
`tapd_bug_fix_writeback`	Bug 修复后生成回填草稿，确认后改状态为已解决并写入评论
`tapd_test_doc`	先做提测准入判断（对照 PRD 关联用例评估是否达标），再生成提测文档

🛡️ 安全确认

查询类操作不会修改 TAPD 数据。
创建、回填评论、更新状态、更新处理人等写操作，都需要你在对话中明确确认。
更新处理人前，Agent 会先搜索并确认 TAPD 成员，避免根据中文名或重名信息误写。
处理人更新支持追加和替换。你说“添加、加上、补上”时会倾向追加；你说“改为、替换为、转给”时会倾向替换。

🎁 彩蛋玩法

定时巡检，模拟 AI 研发助理

每 2 小时检查需求 123456 下是否有新增未解决 bug；发现后读取 bug 详情和当前代码，判断原因、生成修复方案，并在我确认后修改代码和回填处理结果

配合支持定时任务的 Agent，可以把 TAPD MCP 变成一个轻量的 AI 研发助理：定时发现新缺陷、自动理解上下文、定位影响范围，并生成修复建议和回填草稿。

它也可以巡检工作空间里的新需求，自动完成研发评估，必要时进入创建分支和开发流程。巡检与分析自动执行，改代码、提交、回填 TAPD 等写操作仍由你确认。

TAPD MCP Server

개요

PopNx MCP의 세 기둥

할 수 있는 일

설치

설치하기 전에

직접 입력할 값

할 수 있는 일

기본 점검i

제작자와 저장소 일치

계속 관리되고 있음

라이선스 있음

엔드포인트 응답

OAuth로 로그인

도구 설명에 숨겨진 지시 없음

기타 카테고리의 다른 서버와 비교i

자주 묻는 질문

대안

Spec Driven Development

Remote Desktop Commander

Tool Guardian

제작자의 README

✨ 核心亮点

🚀 快速开始

错误上报与隐私

💡 使用示例

1. 团队 Bug 统计

2. 查询我名下的需求和 Bug

3. 批量判断服务端归因并追加处理人

4. Bug 批量修复并回填

5. 需求宣讲前研发评估

6. 提测准入判断并生成提测文档

🧰 能力总览

工具（18）

工作流 Prompt（3）

🛡️ 安全确认

🎁 彩蛋玩法

定时巡检，模拟 AI 研发助理