Bugasura

Bugasura MCP 服务

让 AI 助手直接连接到你的测试管理工作区。

Bugasura MCP 服务支持 Claude、VS Code Copilot 和 Cursor 等 AI 工具通过自然语言与你的 Bugasura 项目交互——管理测试用例、跟踪问题、规划冲刺等。

⚠️ 3.3 版重大变更

⚠️ 3.0 版重大变更

身份验证已改为 OAuth 2.0 登录。如果你从 2.x 升级：

⚠️ 2.0 版重大变更

如果你从 1.x 升级，请更新客户端配置：

将客户端指向 /sse 的 1.x 客户端必须迁移到 /mcp——SSE 已移除。

功能

• 📋 测试用例管理 - 创建、更新、删除和搜索测试用例
• 💬 测试用例评论 - 添加、更新、删除和列出测试用例评论，并支持分页和筛选
• 🐛 问题跟踪 - 报告、管理和删除缺陷，并提供丰富的上下文信息
• 💬 问题评论 - 添加、更新、删除和列出问题评论，并支持分页和筛选
• 📝 需求管理 - 创建、整理和管理产品需求，并采用文件夹结构
• 📚 知识库 - 在项目知识库中上传、列出、标星和删除文档，并按需创建文件夹；还可从网站、Coda、Jira、Confluence 或 Figma 导入
• 🏃 迭代规划 - 创建、更新、删除和管理敏捷迭代
• 🏁 测试运行 - 创建一次性或计划（重复）运行，编辑、重新运行或删除运行，选择环境和应用构建版本，并添加测试用例——全部可按名称或 ID 操作
• 🧪 测试数据 - 管理项目的测试数据环境（创建、重命名、复制、删除）、环境变量和 Globals 作用域，以及测试数据文件（上传、读取、下载、删除）、应用构建版本和文件类别——全部可按名称或 ID 操作
• 🤖 Testpert 迭代 - 完整的 AI 驱动测试增强流程：上传规格、回答需求问题、编辑测试计划，并自动生成测试用例
• 👥 团队协作 - 使用姓名或电子邮件分配工作（自动解析为用户 ID）
• 👤 团队成员管理 - 使用团队名称或 ID 添加团队成员、更新角色并移除成员
• 🔍 智能发现 - 无需记住 ID，即可查找项目和团队
• 🤖 交互式工作流 - 为所有操作提供引导式上下文选择

快速开始

1. 拥有 Bugasura 账号

托管服务只需满足这一点。首次使用时，AI 工具会在浏览器中打开 Bugasura 登录页面；批准一次即可完成连接。令牌会自动刷新，有效期为 30 天。

只有在配置本地 STDIO 时才需要 API 密钥，详见 本地开发。

2. 安装 MCP 服务

将服务 URL 添加到你的 AI 工具中。无需请求头或密钥：客户端会从服务发现 OAuth 登录，并引导你完成登录。

{
  "servers": {
    "bugasura": {
      "type": "http",
      "url": "https://mcp.bugasura.io/mcp"
    }
  }
}

claude mcp add --transport http bugasura https://mcp.bugasura.io/mcp

codex mcp add bugasura --url https://mcp.bugasura.io/mcp
codex mcp login bugasura

{
  "mcpServers": {
    "bugasura": {
      "url": "https://mcp.bugasura.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "bugasura": {
      "serverUrl": "https://mcp.bugasura.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "bugasura": {
      "url": "https://mcp.bugasura.io/mcp",
      "type": "streamableHttp"
    }
  }
}

{
  "mcpServers": {
    "bugasura": {
      "type": "streamable-http",
      "url": "https://mcp.bugasura.io/mcp"
    }
  }
}

3. 开始使用

安装完成后，只需用自然语言与 AI 助手交流：

"List all my Bugasura teams and projects"

"Create a test case for login functionality with high severity"

"Create a requirement for user authentication feature"

"Show me all critical bugs in sprint 5"

工作原理

无需 ID

Bugasura MCP 提供交互式上下文选择功能。你无需知道团队 ID、项目 ID 或用户 ID，只需用自然语言描述你的需求。

示例： 无需知道任何 ID 即可创建问题：

You: "Create a bug for the login button not working"

AI: [Calls MCP server]
    "Which team should I use?
     1. Acme Corp (Admin)
     2. Client Project (Member)"

You: "Acme Corp"

AI: "Which project?
     1. Mobile App
     2. Web App"

You: "Mobile App"

AI: "Which sprint?
     1. Sprint 5 (IN PROGRESS)
     2. Sprint 6 (SCHEDULED)"

You: "Sprint 5"

AI: ✓ "Created issue #ISSUE-123 in Sprint 5"

系统会自动引导你选择团队 → 项目 → 冲刺。

智能指派对象解析

使用姓名、电子邮件或用户 ID指派工作——系统会自动转换：

"Assign issue 123 to John Doe"

"Add [email protected] and user 789 to issue 456"

"Remove Sarah from issue 321"

问题和测试用例均适用。

发现工具

无需记忆 ID 即可查找资源：

"Find my mobile app project"
→ Searches across ALL teams automatically

"Show me all projects I have access to"
→ Returns complete context in one call

你可以做什么

📋 测试用例

Create an API test case for user authentication with priority P1

List all test cases for the mobile app project

Update test case 123 to mark it as PASS

Assign test case 456 to [email protected]

Delete test case 789

Delete test case with key "TES5"

Delete test case named "Verify login with valid credentials"

💬 测试用例评论

List all comments on test case 123

List comments on test case "Verify login with valid credentials"

List only user comments on test case 456 (exclude system comments)

Get details of comment 789

Add a comment "Test passed on Chrome and Firefox" to test case 123

Add a private comment to test case 456

Update comment 789 with new text

Delete comment 456

📝 需求

Create a requirement titled "User Authentication" with details and priority P1

List all requirements for the mobile app project

Get requirement details for requirement ID 2036

Update requirement 2036 to change severity to HIGH

Assign requirement 456 to [email protected]

Create a folder named "Sprint 1 Features" for organizing requirements

List all requirement folders in a project

Delete requirement 789

Link test cases to requirement 2036

🐛 问题与缺陷

Create a critical bug for login page crash in sprint 5

Show me all open issues assigned to me

Update issue 789 to change status to "Fixed"

Add John and Jane as assignees to issue 123

Delete issue 456

Delete issue with key "ISS09"

Delete issue with summary "Login button not working"

💬 问题评论

List all comments on issue 123

List comments with pagination (start at 10, show 20 results)

List only user comments, exclude system comments

Get details of comment 456

Add a comment "Fixed in latest build" to issue 789

Add a private comment to issue 123

Update comment 456 with new text

Delete comment 789

🏃 冲刺

Create a new sprint called "Sprint 15" for the mobile app

List all sprints for project 456

Update sprint 789 to mark it as COMPLETED

Show sprint details including issue statistics

Delete sprint 321

Delete sprint named "Sprint 15"

🏁 测试运行

List the test runs for the "Login Sprint"

Show me the environments and app builds for this project

Create a test run called "Smoke run" for the "Login Sprint" using the "Staging" environment

Schedule a daily run "Nightly" for the "Login Sprint" at 09:00, ending after 10 runs

Schedule a run every 2 weeks on Monday and Friday at 09:00

Add test cases 12, 15, 18 to the "Smoke run" run

Rename the "Smoke run" run and mark it COMPLETED

Pause the "Nightly" scheduler

Rerun the "Nightly" scheduler

Delete the "Smoke run" run

注意： 报告/测试套件、环境、应用构建、运行和调度器均可通过名称或数字 ID引用——系统会自动解析名称（如果名称不明确，还会给出贴心提示）。

🧪 测试数据

List the test data environments for this project

Create a "Staging" environment and set its baseUrl to https://staging.example.com

Add a variable loginEmail = [email protected] to the Staging environment

Show me everything in the Staging environment

Duplicate Staging as "UAT"

Deactivate the legacyToken variable in Globals

List the App Build files in Production

Upload /home/me/users.csv to the Staging environment as Sample Data Files

Show me what's in users.csv in Staging

Download app-release.apk from Production to /home/me/builds/

Which app builds does this project have?

Add a custom file category "Payment Fixtures"

Delete the "Old QA" environment

注意： 环境、变量和文件可通过名称或数字 ID引用；项目级全局作用域请使用 "Globals"。写入和删除操作必须明确指定作用域，且名称必须完全匹配；只有读取工具支持使用部分名称。删除仍包含自定义变量或文件的环境时，会先要求确认（delete_contents=true）。默认的 baseUrl / apiBaseUrl 变量可以修改值，但不能重命名或删除。

🤖 Testpert 冲刺

TestPert 是一项付费的项目级功能，可根据需求文档使用 AI 生成完整的测试计划和测试用例。

常规流程（上传文档）：

Create a TestPert sprint called "Login Feature Sprint"

Upload /path/to/login-spec.pdf to the knowledge base

Start the analysis and answer the requirement questions

Review the test plan focus areas and feature tree

Generate test cases for the sprint

跳过增强流程（基于现有需求）：

Create a TestPert sprint with skip_enrich_requirements=true

Link requirement IDs 101 and 102 to the sprint

Build the test plan from those requirements

📋 项目

List all projects in team 123

Find project by name "Mobile App"

Get detailed information for project 456

Create a new project "E-commerce Web App" in team 123

Update project 789 name to "Mobile Application"

Update project "Mobile App" to change issue prefix to "MOB"

Delete project 321

Delete project "Old Test Project"

👥 团队管理

List all my teams

Find team by name "Acme"

Get detailed information for team 123

Get detailed information for team "Engineering"

Create a new team called "Mobile App Team"

Update team 456 name to "Web Development Team"

Rename team "Mobile Team" to "Mobile App Development"

List all members in team "Acme Corp"

Add [email protected] and [email protected] to team "Engineering"

Invite [email protected] to team 123

Promote user 456 to admin in team "Marketing"

Demote user to regular member in team "Sales"

Remove [email protected] from team "Sales"

Remove user by name "John Doe" from team 123

Show all projects in team 456

可用工具

底层状态驱动器（高级）

• bugasura_testpert_advance - 设置特定状态和／或轮询直到达到目标状态 — 需要直接控制流水线时使用

流程概览：

Normal:  create → upload_kb → generate_sprint_context → [get_kb_validation → resolve_kb_validation]*
         → get_sprint_context → confirm_sprint_context → answer_context_questions
         → (missing reqs) → (risks) → get_testplan → enrich → generate_coverage → generate_testcases

         * only if generate_sprint_context lands on SPRINT_CONTEXT_USER_VALIDATION instead of SPRINT_CONTEXT

Skip:    create (skip_enrich=true) → link_requirements → start_skip_testplan
         → get_testplan → generate_coverage → generate_testcases

注意事项：

• 项目必须启用 TestPert（is_testpert_enabled）。标准冲刺请使用 bugasura_create_sprint。
• 轮询工具（generate_sprint_context、resolve_kb_validation、confirm_sprint_context、start_skip_testplan、enrich_requirements、generate_coverage、generate_testcases）的单次调用有时间限制，且可重复调用 — 如果 AI 阶段仍在运行，请再次调用同一工具以继续检查。
• generate_coverage 会自行驱动增强和测试计划两个阶段（RISKS_IN_REQUIREMENTS → ENRICH_REQUIREMENTS → TEST_PLANING → TEST_COVERAGE），每次调用推进一个阶段 — 只有想让该阶段作为独立步骤显示时，才需要使用 enrich_requirements。
• 状态转换和测试计划更新需要团队管理员 API 密钥。

可用资源

MCP 资源提供对 Bugasura 数据的只读访问。AI 助手可以直接访问这些资源：

高级用法

分页

列表操作默认返回 10 条结果：

Show me the first 20 issues (using max_results=20)

Show me issues 11-20 (using start_at=10, max_results=10)

Show me the first 50 comments on issue 123 (using max_results=50)

Show me comments 21-40 on issue 456 (using start_at=20, max_results=20)

部分更新

只更新要更改的字段 — 其他所有字段都会自动保留：

Update issue 123 to change severity to HIGH
(other fields like status, description, assignees remain unchanged)

Update requirement 2036 to change title only
(severity, priority, assignees, and all other fields are preserved)

工作原理： 所有更新操作（问题、需求、测试用例、冲刺）都会先获取现有记录，然后将你的更改与现有数据合并，再发送到 API。这可确保不会意外清除或重置任何字段。

自定义字段

Create issue with custom fields: {"Environment": "Production", "Build": "1.2.3"}

筛选

List issues for sprint 5 only

Search projects containing "mobile" in the name

List only user comments on issue 123 (exclude system-generated comments)

List comments by a specific user on issue 456 (using creator_id filter)

传输模式

Bugasura MCP 支持两种传输模式：

STDIO（默认）— 本地 MCP 客户端（通过 stdin/stdout 使用子进程）

python server.py --transport stdio

Streamable HTTP（推荐用于远程部署）— 挂载于 /mcp

python server.py --transport streamable-http --port 8000

托管版本位于 https://mcp.bugasura.io/mcp，使用 Streamable HTTP。该服务基于 FastMCP 4 构建，在同一端点上支持两个时期的 MCP 协议：无状态的 2026-07-28 协议，以及较旧的 2025-11-25 initialize 握手。每个连接都会单独协商，因此新旧客户端无需任何设置均可使用。此传输模式需要配置 OAuth 登录（见下一节）；否则服务会拒绝启动。STDIO 除 BUGASURA_API_KEY 外无需其他配置。

部署 OAuth 登录

供服务器运维人员阅读。用户不会看到这些内容。

MCP 服务是一个基于 FastMCP 的 OAuthProxy（core/oauth.py）构建的 OAuth 2.0 入口。MCP 客户端通过动态客户端注册或客户端 ID 元数据文档（CIMD，即客户端用作 client_id 的 URL）标识自身，并通过该入口执行 PKCE。两种方式均受支持；服务自身是 Bugasura 的一个预注册机密客户端，并与 Bugasura API 服务器间交换授权码。Bugasura 的令牌不会到达 MCP 客户端 — 服务会签发自己的短期令牌，并在每次请求时进行交换，通过 POST /v1/oauth/introspect 验证 Bugasura 令牌（缓存 60 s）。

1. 从 Bugasura 获取客户端凭据

服务器以机密 OAuth 客户端 bugasura-mcp 的身份登录 Bugasura。其客户端密钥和回调地址 <MCP_PUBLIC_BASE_URL>/auth/callback 已在 Bugasura 端注册，因此，可自托管实例需要由 Bugasura 团队签发这些凭据（[email protected]）。

Bugasura 的令牌与用户的 API 密钥绑定：在 Bugasura 中重新生成密钥，会使该用户的所有 MCP 会话退出登录。

2. 配置 MCP 服务

将以下内容添加到实例的 dotenv 文件（.env，或由 MCP_ENV_FILE 指定的租户文件）：

CIMD 客户端会通过 https 让服务器获取其元数据文档，同时会阻止私有地址和回环地址。只能通过出口代理访问互联网的租户，可设置 FASTMCP_SSRF_TRUST_PROXY=true 和 HTTPS_PROXY。

本地测试。 Claude Code、Cursor 和 Inspector 可以连接到 http://localhost:8000：设置 MCP_PUBLIC_BASE_URL=http://localhost:8000，并使用 --allow-insecure-http 启动。Claude Desktop 和 claude.ai 则不同：它们的连接器运行在 Anthropic 的服务器上，因此 MCP 服务必须能通过 https 从公共互联网访问。在本地端口前配置隧道，并将其 URL 用作公共基址：

ngrok http 8000                      # note the https://xxxx.ngrok-free.app URL
MCP_PUBLIC_BASE_URL=https://xxxx.ngrok-free.app \
BUGASURA_OAUTH_CLIENT_ID=bugasura-mcp BUGASURA_OAUTH_CLIENT_SECRET=... \
python server.py --transport streamable-http --port 8000 --forwarded-allow-ips '*'

然后将 https://xxxx.ngrok-free.app/mcp 添加为自定义连接器。隧道的回调地址（https://xxxx.ngrok-free.app/auth/callback）必须是 Bugasura API 针对你的客户端 ID 接受的地址。首次通过免费版 ngrok 隧道访问网页时，会显示“Visit Site”过渡页面；点击继续即可。

关于同意页面

默认情况下，用户首次连接时只会看到一个页面：Bugasura 自带的登录和同意页面。FastMCP 代理也有自己的过渡页面，会显示 MCP 客户端及其回调地址；该页面默认关闭（OAUTH_REQUIRE_CONSENT=false），因此整个流程看起来都是 Bugasura 提供的。

以下机制可确保安全：MCP 客户端会自行注册（DCR），或提供自己的元数据文档（CIMD），因此服务器会在注册时、加载元数据文档时，以及再次访问 /authorize 时强制执行重定向 URI 允许列表（config/config.py 中的 DEFAULT_ALLOWED_REDIRECT_URIS）。只接受回环地址，以及上述客户端的回调地址（Claude Desktop / claude.ai、VS Code，包括 Cline 和 Roo Code、Claude Code、Cursor、Windsurf、Google Antigravity、ChatGPT 连接器，包括 Codex），此外还接受 OAUTH_ALLOWED_REDIRECT_URIS 中的地址；任何注册其他回调地址的客户端都会收到 invalid_redirect_uri（DCR 拒绝会记录为 Rejected client registration；回调地址不在允许列表中的 CIMD 客户端会被拒绝，但不会写入日志，因此新客户端无法登录时，请先检查其回调地址是否在列表中）。如果没有这项检查，恶意客户端就可以注册自己的回调地址并获取用户会话。设置 OAUTH_REQUIRE_CONSENT=true 可重新启用过渡页面，作为第二道防线。

3. 反向代理

应转发整个来源，而不只是 /mcp。FastMCP 会在根路径挂载以下端点：/.well-known/oauth-authorization-server、/.well-known/oauth-protected-resource/mcp、/authorize、/token、/register、/revoke、/auth/callback、/consent，以及 /mcp、/health、/sse 和 /upload/<upload_id>。只有 /mcp 需要令牌；上传链接不可猜测且只能使用一次，其 ID 本身就是凭据。

每个上传请求最多可接受 100 MB。用户可以同时持有 20 个未关闭的链接，并有 500 MB 已上传、等待工具处理的文件；暂存目录整体上限为 5 GB（config/config.py 中的 UPLOAD_MAX_* 常量）。反向代理的请求正文大小限制应至少设为 101 MB（Apache 的 LimitRequestBody、nginx 的 client_max_body_size），代理超时时间也应足够长，以便在慢速连接下上传 100 MB 文件（例如 300 秒）。

4. 检查

curl -s https://mcp.bugasura.io/.well-known/oauth-authorization-server | jq '{issuer, client_id_metadata_document_supported, authorization_response_iss_parameter_supported}'
curl -si -X POST https://mcp.bugasura.io/mcp -H 'content-type: application/json' -d '{}' | grep -i www-authenticate   # 401 + resource_metadata
curl -s https://mcp.bugasura.io/health   # "auth": "oauth"

然后在 Claude Code 中添加 URL（claude mcp add --transport http …，依次选择 /mcp → Authenticate），并确认浏览器跳转到 Bugasura 授权页面后又返回。

本地开发 — 示例客户端配置

在开发服务本身时，如果你想让 AI 客户端将本地克隆作为 stdio 子进程启动，而不是访问托管的 /mcp 端点，请使用以下配置。

将 /path/to/bugasura-mcp-server/ 替换为你自己的克隆仓库的绝对路径，并将 your_api_key_here 替换为你的 Bugasura API 密钥（User Settings → API Key）。 STDIO 是唯一仍使用密钥的传输方式，因为子进程无法跳转到浏览器。切勿提交真实密钥。

VS Code（工作区 .vscode/settings.json）

{
  "settings": {
    "mcp": {
      "inputs": [],
      "servers": {
        "bugasura-local-mcp": {
          "type": "stdio",
          "command": "/path/to/bugasura-mcp-server/.venv/bin/python3",
          "args": [
            "/path/to/bugasura-mcp-server/server.py"
          ],
          "env": {
            "BUGASURA_API_KEY": "your_api_key_here"
          }
        }
      }
    }
  }
}

Claude Desktop（claude_desktop_config.json）

macOS 路径：~/Library/Application Support/Claude/claude_desktop_config.json Windows 路径：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bugasura": {
      "command": "/path/to/bugasura-mcp-server/.venv/bin/python",
      "args": [
        "/path/to/bugasura-mcp-server/server.py"
      ],
      "env": {
        "BUGASURA_API_KEY": "your_api_key_here"
      }
    }
  }
}

编辑配置后，重启客户端（重新加载 VS Code 窗口／退出并重新启动 Claude Desktop），使其加载新的服务。服务日志写入 stderr — 查看客户端的 MCP 服务日志，确认启动时出现 Bugasura MCP Server | API: ... | Transport: stdio。

使用 MCP Inspector 进行测试与调试

MCP Inspector 提供基于 Web 的界面，用于测试和调试 MCP 服务。

快速开始

1. 安装 MCP Inspector（如果尚未安装）：

   npm install -g @modelcontextprotocol/inspector
   

2. 运行 Inspector（STDIO，从 .env 读取 BUGASURA_API_KEY）：

   cd /path/to/bugasura-mcp-server
   source .venv/bin/activate
   npx @modelcontextprotocol/inspector python server.py
   

3. 打开浏览器 — Inspector 会自动在 http://localhost:5173 打开

若要尝试 OAuth 登录，请使用 HTTP 模式启动服务，并设置 MCP_PUBLIC_BASE_URL=http://localhost:8000 以及客户端 ID／密钥，同时添加 --allow-insecure-http；然后在 Inspector 中选择 Streamable HTTP，URL 填写 http://localhost:8000/mcp，再选择 Authentication → OAuth 2.0 → Quick OAuth Flow。你将先进入服务的授权页面，再进入 Bugasura 的登录和授权页面，最后返回并看到已列出的工具。

可以执行的操作

• ✅ 查看所有工具及其参数和文档
• ✅ 交互式测试工具 — 调用任意工具并查看实际响应
• ✅ 调试工作流 — 测试创建 → 更新 → 删除流程
• ✅ 验证参数 — 确保格式和类型正确
• ✅ 测试基于名称的操作 — 尝试通过问题键（ISS09）、测试用例键（TES5）或名称删除
• ✅ 测试团队解析 — 在管理团队成员时使用团队名称，而非 ID

测试示例

按键删除问题：

Tool: bugasura_delete_issue
Parameters: {
  "issue_identifier": "ISS09"
}

注意：STDIO 模式从环境中读取 BUGASURA_API_KEY；工具没有 api_key 参数。

交互式选择冲刺：

Tool: bugasura_create_issue
Parameters: {
  "summary": "Test issue"
}
// Returns selection prompt for team → project → sprint

使用团队名称管理团队成员：

Tool: bugasura_add_team_members
Parameters: {
  "team_name": "Engineering",
  "email_list": "[email protected], [email protected]"
}
// Resolves team name and sends invitations

使用智能解析移除用户：

Tool: bugasura_delete_team_user
Parameters: {
  "team_id": 123,
  "user_identifier": "[email protected]"
}
// Resolves user by email and removes from team

详细说明请参阅 MCP_INSPECTOR_GUIDE.md

重要说明

身份验证

托管服务（HTTP） — 使用 OAuth 2.0 登录。MCP 客户端会从服务发现登录方式，在浏览器中打开 Bugasura 的登录和授权页面一次，然后保存一个可静默刷新的令牌（访问令牌有效期为 1 小时，刷新令牌有效期为 30 天）。客户端配置中不会存储任何内容，助手也不会看到凭据。若要让客户端退出登录，请在客户端中断开连接。

本地 STDIO — 服务作为客户端的子进程运行，无法跳转到浏览器，因此会从 env 块中读取 BUGASURA_API_KEY（Bugasura → User Settings → API Key）。如果未设置，工具会返回 status: 'api_key_required' 并附上说明；助手不会要求你在聊天中粘贴密钥。

交互模式

如果未提供 team_id 或 project_id，系统会自动进入交互模式，引导你进行选择。此模式适用于：

• 所有冲刺操作
• 所有问题操作
• 所有测试用例操作

智能分配对象

分配工作时，可以使用：

• 姓名："John Doe"（部分匹配，不区分大小写）
• 电子邮件："[email protected]"（精确匹配，不区分大小写）
• 用户 ID："123"（直接匹配）
• 混合使用："John, [email protected], 789"（以逗号分隔）

系统会自动将姓名／电子邮件解析为用户 ID。

智能团队解析

团队成员管理工具支持灵活地识别团队：

• 团队 ID：team_id=123（直接使用数字 ID）
• 团队名称：team_name="Acme Corp"（部分匹配，不区分大小写）

以下工具可以使用任一参数：

• bugasura_add_team_members - 邀请用户加入团队
• bugasura_update_team_member - 更改成员角色
• bugasura_delete_team_user - 移除团队成员

示例：

add_team_members(team_name="Engineering", email_list="[email protected]")
update_team_member(team_id=123, user_id=456, is_admin=1)
delete_team_user(team_name="Sales", user_identifier="[email protected]")

注意：如果环境中已配置 BUGASURA_API_KEY，则可以省略 api_key。

数据要求

冲刺：

• 冲刺名称必须为 5-250 个字符
• 问题必须分配到冲刺
• 更新时，问题必须已分配到冲刺

需求：

• 需求必须归入文件夹
• 所有需求操作都必须提供文件夹 ID
• 需求可以采用父子层级结构（最多 2 层：父级不能再有父级）

对话示例

入门

"What teams and projects do I have access to?"
→ Returns all your teams and projects

"Find my authentication project"
→ Searches across all teams and returns matches

测试管理

"Create a test case for password reset with severity HIGH and priority P1"
→ Guides you through team/project selection, then creates test case

"List all test cases in my mobile app project"
→ Returns paginated test case list

"Update test case 456 to mark it as PASS and assign to [email protected]"
→ Updates test case and resolves email to user ID

Bug 跟踪

"Show me all critical bugs in sprint 5"
→ Lists critical severity issues filtered by sprint

"Create a bug: Login button crashes on iOS 17"
→ Guides through team/project/sprint selection, creates issue

"Assign issue 789 to Jane and mark it as In Progress"
→ Updates assignee and status

问题评论

"List all comments on issue 123"
→ Returns all comments with user details and timestamps

"Show me the next 10 comments starting from comment 11"
→ Uses pagination (start_at=10, max_results=10)

"List only user comments, exclude system-generated ones"
→ Uses get_user_comments_only=True to filter out system comments

"Add a comment 'Fixed in version 2.1.0' to issue 456"
→ Guides through team/project/issue selection, creates public comment

"Add a private comment about internal notes to issue 789"
→ Creates comment with is_public_comment=0

"Update comment 321 to fix a typo"
→ Guides through interactive selection if comment details not provided

"Delete comment 456"
→ Shows deletion warning, removes comment permanently

冲刺规划

"Create a 2-week sprint called 'Sprint 16' starting next Monday"
→ Guides through project selection, creates sprint with dates

"Show me sprint statistics for sprint 5"
→ Returns issue counts, completion rates, etc.

"Mark sprint 12 as COMPLETED"
→ Updates sprint status

需求管理

"Create a requirement titled 'User Authentication' with details 'Implement OAuth 2.0' and priority P1"
→ Guides through team/project selection, prompts for folder selection, creates requirement

"List all requirements in my mobile app project"
→ Returns all requirements with their hierarchy and test case counts

"Link test cases 123 and 456 to requirement 2036"
→ Creates traceability between requirements and test cases

"Update requirement 2036 to change severity to HIGH and assign to [email protected]"
→ Updates requirement fields while preserving all other data

Testpert 冲刺生成

"Create a TestPert sprint called 'Checkout Flow Sprint'"
→ Confirms options (testing type, depth, skip enrich), then creates the sprint

"Upload /docs/checkout-spec.pdf and /docs/api-contract.md to the knowledge base"
→ Uploads both files, moves sprint to KNOWLEDGE_BASE stage

"Start the analysis"
→ Kicks off requirement analysis, then automatically shows the AI's contextual questions

"Answer: Q1: Users must be able to pay by card or wallet. Q2: Guest checkout is required."
→ Saves answers and advances to the missing requirements stage

"Approve all missing requirements and proceed"
→ Approves rows, advances through risks to the test plan

"Set Authentication focus to EXHAUSTIVE and Performance to MINIMAL"
→ Edits focus-area levels in the test plan

"Generate the test cases"
→ Runs enrichment + coverage + test case generation; returns sprint link when done

"Create a TestPert sprint with skip enrich, link requirements 101 and 102, then build the test plan"
→ Creates sprint (skip_enrich=true), links requirements, starts test plan generation

团队成员管理

"Add [email protected] and [email protected] to the Engineering team"
→ Resolves team by name, sends email invitations to new members

"List all members of team Acme Corp"
→ Returns team members with names, emails, user IDs, and roles

"Promote user 456 to admin in the Marketing team"
→ Updates team member role from member to admin

"Remove [email protected] from the Sales team"
→ Resolves user by email, removes from team and unassigns all their issues

"Make Sarah an admin in team 123"
→ Resolves user by name, promotes to admin role

隐私政策

服务端会以你自己的账户，将请求转发到 Bugasura API。它会加密保存你会话的 OAuth 令牌，在内存中缓存团队／项目列表数分钟，并记录运行日志；它本身没有数据库。数据的收集、使用、存储、共享和保留均受 Bugasura 隐私政策 和 服务条款约束。如有疑问，请联系：[email protected]。

支持

• 🌐 网站
• 📧 [email protected]
• 📚 文档
• 🐞 报告问题
• 🔒 隐私政策
• 📄 服务条款

许可证

MIT