bugAgent MCP Server

MCP v1

Điều hướng

Model Context Protocol

MCP

Kết nối bug_Agent_ với bất kỳ client AI tương thích MCP nào.

Nộp, phân loại và quản lý lỗi, yêu cầu tính năng, v.v. trực tiếp từ trợ lý lập trình AI của bạn. Không cần chuyển đổi ngữ cảnh, không cần sao chép-dán — chỉ cần mô tả vấn đề và bug_Agent_ sẽ lo phần còn lại.

Cộng đồng Discord [email protected]

Bắt đầu

Máy chủ MCP bug_Agent_ cho phép các client AI tạo, truy vấn và quản lý báo cáo lỗi, yêu cầu tính năng, cải tiến, v.v. thông qua Model Context Protocol. Nó chạy cục bộ và giao tiếp với API đám mây của bug_Agent_.

1

Lấy khóa API của bạn

Đăng ký tại app.bugagent.com và tạo khóa API từ bảng điều khiển.

2

Cấu hình client AI của bạn

Thêm bug_Agent_ làm máy chủ MCP trong cấu hình client của bạn (xem phần thiết lập bên dưới).

3

Bắt đầu nộp lỗi

Mô tả lỗi bằng ngôn ngữ tự nhiên và bug_Agent_ sẽ tự động phân loại, làm giàu và lưu trữ.

Ví dụ nhanh

# Create a bug report
"File a bug: Login button is unresponsive on iOS Safari.
Steps: tap login, nothing happens. Expected: navigate to
dashboard. Severity: high."

# bugAgent auto-classifies as UI bug, severity high

# File a feature request
"Feature request: Add dark mode toggle to the
settings page. Users have asked for this in surveys."

# Auto-classified as feature-request, severity medium

Thiết lập

Cài đặt

Không cần cài đặt toàn cục. Sử dụng npx để chạy máy chủ MCP theo yêu cầu:

npx @bugagent/mcp-server

Cấu hình khóa API của bạn

Khi bạn kết nối lần đầu, bug_Agent_ sẽ nhắc bạn nhập khóa API. Bạn cũng có thể đặt nó qua biến môi trường:

export BUGAGENT_API_KEY=ba_live_your_key_here

Lấy khóa API của bạn từ bảng điều khiển bug_Agent_.

Cấu hình Client MCP

Thêm phần sau vào tệp cấu hình của client MCP:

mcp.json

{
  "mcpServers": {
    "bugagent": {
      "command": "npx",
      "args": ["-y", "@bugagent/mcp-server"],
      "env": {
        "BUGAGENT_API_KEY": "ba_live_your_key_here"
      }
    }
  }
}

💡

Thay thế ba_live_your_key_here bằng khóa API thực tế của bạn từ bảng điều khiển.

Kết nối đến Máy chủ

Máy chủ MCP bug_Agent_ hoạt động tại https://mcp.bugagent.com/mcp qua truyền tải HTTP có thể truyền phát (Streamable HTTP). Kết nối từ bất kỳ client nào trong số tám client bên dưới — chọn cái phù hợp với quy trình làm việc của bạn.

🔑

Lấy khóa API của bạn trước. Đăng nhập vào app.bugagent.com/dashboard/settings/api-keys, nhấp Tạo Khóa API, và sao chép giá trị (bắt đầu bằng ba_live_). Bạn sẽ chỉ thấy nó một lần, vì vậy hãy dán nó vào nơi an toàn. Mọi ví dụ bên dưới đều sử dụng khóa này.

Tùy chọn 1 — MCP Inspector (Giao diện Web, khuyên dùng cho lần thử đầu tiên)

Công cụ chính thức của Anthropic. Khởi chạy giao diện web cục bộ nơi bạn có thể nhấp qua từng công cụ, điền tham số và xem phản hồi. Không cần cấu hình, không yêu cầu IDE.

macOS (Terminal)

Terminal

npx @modelcontextprotocol/inspector

Windows (PowerShell hoặc CMD)

PowerShell

Trong giao diện trình duyệt mở ra:

1. Loại Truyền tải (Transport Type): chọn Streamable HTTP
2. URL: https://mcp.bugagent.com/mcp
3. Loại Kết nối (Connection Type): chọn Proxy (mặc định — Inspector ủy quyền qua một tiến trình Node cục bộ để vượt qua CORS của trình duyệt)
4. Nhấp tab Xác thực (Authentication) → thêm tiêu đề tùy chỉnh:
   • Tên Tiêu đề (Header Name): Authorization
   • Giá trị (Value): Bearer ba_live_YOUR_KEY_HERE
5. Nhấp Kết nối (Connect). Bạn sẽ thấy tất cả hơn 60 công cụ bug_Agent_ ở bảng điều khiển bên trái.
6. Nhấp vào bất kỳ công cụ nào (ví dụ: list_bug_reports), điền tham số, nhấp Chạy Công cụ (Run Tool). Phản hồi hiển thị ở bên phải.

Điều kiện tiên quyết: Node.js 18 trở lên. Cài đặt từ nodejs.org nếu bạn chưa có.

Tùy chọn 2 — Claude Desktop (Mac + Windows)

Nếu bạn sử dụng ứng dụng Claude Desktop, bạn có thể thêm bug_Agent_ làm máy chủ MCP vĩnh viễn. Claude sau đó sẽ có sẵn tất cả các công cụ bug_Agent_ trong mọi cuộc trò chuyện.

macOS

1. Mở Claude Desktop → thanh menu Claude → Cài đặt (Settings) → Nhà phát triển (Developer) → Chỉnh sửa Cấu hình (Edit Config). Thao tác này mở ~/Library/Application Support/Claude/claude_desktop_config.json.
2. Thêm mục bug_Agent_ vào mcpServers: claude_desktop_config.json

{  
  "mcpServers": {  
    "bugagent": {  
      "type": "http",  
      "url": "https://mcp.bugagent.com/mcp",  
      "headers": {  
        "Authorization": "Bearer ba_live_YOUR_KEY_HERE"  
      }  
    }  
  }  
}  

3. Lưu tệp và thoát hoàn toàn Claude Desktop (Cmd+Q, không chỉ đóng cửa sổ).
4. Khởi chạy lại Claude Desktop. Biểu tượng búa công cụ ở cuối ô nhập chat bây giờ sẽ hiển thị các công cụ bug_Agent_.
5. Hãy thử: gõ “Liệt kê 5 báo cáo lỗi gần đây nhất của tôi” — Claude sẽ tự động gọi list_bug_reports.

Windows

1. Mở Claude Desktop → Tệp (File) → Cài đặt (Settings) → Nhà phát triển (Developer) → Chỉnh sửa Cấu hình (Edit Config). Thao tác này mở %APPDATA%\Claude\claude_desktop_config.json (thường là C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json).
2. Thêm cùng khối JSON được hiển thị trong phần macOS.
3. Lưu tệp và thoát hoàn toàn Claude Desktop từ khay hệ thống (nhấp chuột phải vào biểu tượng Claude → Thoát (Quit)), sau đó khởi chạy lại.
4. Biểu tượng búa công cụ sẽ hiển thị các công cụ bug_Agent_.

Tùy chọn 3 — Claude Code (CLI)

Nếu bạn sử dụng Claude Code từ terminal của mình (phiên bản CLI của Claude), hãy đăng ký máy chủ bug_Agent_ bằng một lệnh. Hoạt động giống hệt trên macOS, Linux và Windows.

Terminal / PowerShell

claude mcp add --transport http bugagent https://mcp.bugagent.com/mcp \
  --header "Authorization: Bearer ba_live_YOUR_KEY_HERE"

Sau đó khởi động lại phiên Claude Code của bạn. Xác minh nó đã được kết nối:

claude mcp list

Bạn sẽ thấy bugagent trong danh sách với một chấm xanh. Bắt đầu sử dụng các công cụ trong bất kỳ cuộc trò chuyện nào: “Cho tôi xem mức sử dụng khám phá của tôi trong tháng này.”

Để xóa nó sau này:

claude mcp remove bugagent

Tùy chọn 4 — OpenAI Codex CLI

Nếu bạn sử dụng OpenAI Codex CLI, hãy thêm bug_Agent_ vào ~/.codex/config.toml để đăng ký vĩnh viễn, hoặc truyền cấu hình nội tuyến cho phiên một lần.

Đăng ký vĩnh viễn (thêm vào cấu hình)

~/.codex/config.toml

[[mcp_servers]]
name = "bugagent"
type = "http"
url  = "https://mcp.bugagent.com/mcp"

[mcp_servers.headers]
Authorization = "Bearer ba_live_YOUR_KEY_HERE"

Nội tuyến — một phiên

Terminal

codex \
  --mcp-server '{"name":"bugagent","type":"http","url":"https://mcp.bugagent.com/mcp","headers":{"Authorization":"Bearer ba_live_YOUR_KEY_HERE"}}' \
  "list the last 5 bug reports"

Codex tự động giải quyết các lệnh gọi công cụ từ lời nhắc ngôn ngữ tự nhiên của bạn. Hãy thử: “Liệt kê các lỗi đang mở của tôi được sắp xếp theo mức độ nghiêm trọng.”

Tùy chọn 5 — Cursor (Mac + Windows)

Cursor có hỗ trợ MCP tích hợp. Thêm bug_Agent_ một lần và trợ lý AI bên trong Cursor có thể nộp lỗi, liệt kê báo cáo, chạy quét, v.v. mà không cần rời khỏi trình soạn thảo của bạn.

1. Mở Cursor → Cài đặt (Settings) (Cmd+, trên Mac / Ctrl+, trên Windows) → MCP ở thanh bên trái.
2. Nhấp + Thêm máy chủ MCP mới (+ Add new MCP server).
3. Chọn loại truyền tải HTTP.
4. Điền vào:
   • Tên (Name): bugagent
   • URL: https://mcp.bugagent.com/mcp
   • Tên tiêu đề (Header name): Authorization
   • Giá trị tiêu đề (Header value): Bearer ba_live_YOUR_KEY_HERE
5. Nhấp Lưu (Save). Cursor hiển thị chỉ báo màu xanh khi được kết nối.
6. Mở chat của Cursor (Cmd+L / Ctrl+L) và gõ “Tạo một báo cáo lỗi có tiêu đề 'Đăng nhập bị hỏng' với mức độ nghiêm trọng cao.” Cursor sẽ gọi create_bug_report.

Thay thế: Cursor cũng đọc ~/.cursor/mcp.json (Mac) hoặc %USERPROFILE%\.cursor\mcp.json (Windows). Thêm cùng định dạng JSON được hiển thị trong phần Claude Desktop.

Tùy chọn 6 — VS Code với tiện ích mở rộng Continue (Mac + Windows)

Nếu bạn thích VS Code, tiện ích mở rộng Continue hỗ trợ máy chủ MCP một cách tự nhiên.

1. Cài đặt tiện ích mở rộng Continue từ chợ VS Code.
2. Mở cấu hình của Continue: Bảng Lệnh (Command Palette) (Cmd+Shift+P / Ctrl+Shift+P) → Continue: Mở config.json (Open config.json). Tệp nằm ở:
   • macOS: ~/.continue/config.json
   • Windows: %USERPROFILE%\.continue\config.json
3. Thêm một mục mcpServers: ~/.continue/config.json

{  
  "mcpServers": [  
    {  
      "name": "bugagent",  
      "type": "streamable-http",  
      "url": "https://mcp.bugagent.com/mcp",  
      "requestOptions": {  
        "headers": {  
          "Authorization": "Bearer ba_live_YOUR_KEY_HERE"  
        }  
      }  
    }  
  ]  
}  

4. Lưu. Continue sẽ tự động tải lại và hiển thị các công cụ bug_Agent_ ở thanh bên.
5. Mở bảng chat Continue và thử: “Liệt kê các lần quét bảo mật của tôi.”

Các tiện ích mở rộng hỗ trợ MCP khác của VS Code: Cline, Roo Code và Windsurf (fork) đều tuân theo các mẫu cấu hình JSON tương tự với khóa mcpServers và truyền tải HTTP.

Tùy chọn 7 — Máy chủ nhận biết OAuth (Claude.ai web được hiển thị làm ví dụ)

Một số máy chủ MCP xác thực qua OAuth 2.0 và yêu cầu client_id và client_secret tĩnh trước thay vì chấp nhận khóa API bearer. Đối với những máy chủ đó, bạn tạo một cặp thông tin xác thực OAuth trong phạm vi không gian làm việc từ bảng điều khiển bug_Agent_ và dán nó vào biểu mẫu kết nối của máy chủ. Thông tin xác thực không phụ thuộc vào máy chủ MCP — bất kỳ client OAuth nào hỗ trợ Authorization Code + PKCE đều có thể sử dụng chúng. Hướng dẫn bên dưới sử dụng ứng dụng web Claude.ai làm ví dụ phổ biến nhất.

1. Trong bug_Agent_: mở Cài đặt (Settings) → Nhà phát triển (Developers) → Trình kết nối MCP (MCP Connectors). Nhấp Tạo trình kết nối (Generate connector), đặt tên mô tả máy chủ (ví dụ: “Claude.ai (công việc)”), dán URI chuyển hướng mà máy chủ MCP của bạn yêu cầu (đối với ứng dụng web Claude.ai đó là https://claude.ai/api/mcp/auth_callback — kiểm tra tài liệu trình kết nối của máy chủ cho những cái khác), và chọn Bảo mật (Confidential) cho phương thức xác thực. Sao chép client_id và client_secret được hiển thị một lần trên màn hình thành công.
2. Trong cài đặt trình kết nối / OAuth của máy chủ MCP, dán:
   • URL Máy chủ (Server URL): https://mcp.bugagent.com/mcp
   • Client ID + Client Secret: từ bước 1
   • URL Ủy quyền (Authorization URL): https://mcp.bugagent.com/authorize
   • URL Token (Token URL): https://mcp.bugagent.com/token Đối với Claude.ai cụ thể: truy cập claude.ai/customize/connectors và nhấp Thêm trình kết nối MCP (Add MCP connector).
3. Lưu. Máy chủ chuyển hướng bạn đến bug_Agent_ để đăng nhập (Google hoặc email/mật khẩu — bất kỳ phương thức nào bạn sử dụng cho bảng điều khiển) và phê duyệt sự đồng ý, sau đó hoàn tất quá trình bắt tay OAuth.
4. Quản lý và thu hồi các trình kết nối đã tạo từ cùng trang Cài đặt. Việc thu hồi có hiệu lực ngay lập tức — yêu cầu tiếp theo từ trình kết nối đó trả về invalid_client.

Lưu ý: Claude Code, Cursor, VS Code và MCP Inspector không cần quy trình này — chúng tự động xử lý đăng ký client động (RFC 7591) và xác thực qua khóa API như được hiển thị ở trên. Biểu mẫu Trình kết nối MCP chỉ dành cho các máy chủ yêu cầu thông tin xác thực OAuth tĩnh.

Tùy chọn 8 — HTTP Trực tiếp với curl (Terminal)

Nếu bạn muốn kiểm tra máy chủ trực tiếp mà không cần bất kỳ client nào, hoặc tích hợp nó vào một tập lệnh, bạn có thể truy cập điểm cuối HTTP với curl. Giao thức MCP là JSON-RPC 2.0 qua HTTP có thể truyền phát (Streamable HTTP).

macOS / Linux

Terminal

# Set your API key as a variable
export BUGAGENT_API_KEY="ba_live_YOUR_KEY_HERE"

# 1. List all available tools
curl -N -s https://mcp.bugagent.com/mcp \
  -H "Authorization: Bearer $BUGAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# 2. Call a tool — list 5 reports from a specific project
curl -N -s https://mcp.bugagent.com/mcp \
  -H "Authorization: Bearer $BUGAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc":"2.0",
    "id":2,
    "method":"tools/call",
    "params":{
      "name":"list_bug_reports",
      "arguments":{"project":"bugagent","limit":5}
    }
  }'

Windows (PowerShell)

PowerShell

# Set your API key
$env:BUGAGENT_API_KEY = "ba_live_YOUR_KEY_HERE"

# Use Invoke-RestMethod (PowerShell's curl equivalent)
$headers = @{
  "Authorization" = "Bearer $env:BUGAGENT_API_KEY"
  "Content-Type" = "application/json"
  "Accept" = "application/json, text/event-stream"
}

# 1. List all tools
$body = '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Invoke-RestMethod -Uri "https://mcp.bugagent.com/mcp" `
  -Method Post -Headers $headers -Body $body

# 2. Call list_bug_reports for a specific project
$body = @{
  jsonrpc = "2.0"
  id = 2
  method = "tools/call"
  params = @{
    name = "list_bug_reports"
    arguments = @{ project = "bugagent"; limit = 5 }
  }
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Uri "https://mcp.bugagent.com/mcp" `
  -Method Post -Headers $headers -Body $body

Phản hồi đến dưới dạng Sự kiện do Máy chủ Gửi (Server-Sent Events) (tiêu chuẩn HTTP có thể truyền phát MCP). Mỗi đoạn là một dòng có tiền tố data: theo sau là một đối tượng JSON. Tiêu đề Accept: application/json, text/event-stream là bắt buộc — máy chủ từ chối các yêu cầu không có nó.

ℹ️

Khắc phục sự cố 401 Unauthorized: Kiểm tra xem khóa API của bạn chưa bị thu hồi trong Cài đặt → Khóa API. Các khóa bắt đầu bằng ba_live_. Nếu bạn vẫn gặp khó khăn, hãy tạo lại khóa và thử lại.

Hãy Thử — Lời Nhắc Bằng Tiếng Anh Đơn Giản

Sau khi kết nối, bạn không cần biết tên công cụ hay tham số. Mô tả những gì bạn muốn bằng tiếng Anh đơn giản và trợ lý AI của bạn sẽ tự động gọi đúng công cụ bug_Agent_.

Báo cáo Lỗi

Hỏi trợ lý AI của bạn

List my 5 most recent bug reports
Show all open critical bugs in the Auth project
Create a bug titled "Login broken on Safari" with severity s2
Update TEST-451 status to in-progress and assign it to me
Add a comment to TEST-451: "root cause confirmed — null check missing in auth middleware"
Show me everything filed this week, grouped by severity

Quản lý Kiểm thử

Create a test suite called "Smoke Tests" with cases for login, checkout, and account settings
Run the Regression suite and list all failures
Show failing test cases from the last 7 days
Which test cases have never been run in the past 90 days?
Get a pass-rate trend for this month vs last month

Bảo mật & Hiệu suất

Run a security scan on https://app.example.com
Get this month's security scan results — show only high and critical findings
Create a performance test for the landing page and check Lighthouse scores
What are the Core Web Vitals for our checkout flow?

Tự động hóa Playwright

Create a Playwright script that logs in and verifies the dashboard loads
Run the checkout automation on iPhone 15 Pro on a real device
Optimize the login automation script
Show runs for the checkout automation — any failures?
Schedule the smoke test suite to run every weekday at 6 AM UTC

AI Khám phá

Run an exploratory AI session on https://app.example.com with 5 parallel agents
Get the latest exploration run results — list any bugs that were filed
What testing strategies did the agents use and which found the most issues?

Sử dụng & Thống kê

Check my plan usage for this month
Show team bug stats for this week broken down by severity and type
List all team members and their roles
How many security scans do I have left this month?

Tham khảo Nhanh

Vị trí tệp cấu hình cho tất cả tám client. Mọi client kết nối đến https://mcp.bugagent.com/mcp với tiêu đề Authorization: Bearer ba_live_YOUR_KEY_HERE qua HTTP có thể truyền phát (Streamable HTTP).

Client Vị trí cấu hình / lệnh

MCP Inspector Không có tệp — nhập URL + tiêu đề xác thực trong giao diện trình duyệt sau npx @modelcontextprotocol/inspector

Claude Desktop — macOS ~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop — Windows %APPDATA%\Claude\claude_desktop_config.json

Claude Code (CLI) claude mcp add --transport http bugagent https://mcp.bugagent.com/mcp --header "Authorization: Bearer ba_live_..."

Codex CLI ~/.codex/config.toml

Cursor — macOS Cài đặt → Giao diện MCP, hoặc ~/.cursor/mcp.json

Cursor — Windows %USERPROFILE%\.cursor\mcp.json

VS Code + Continue ~/.continue/config.json (macOS) / %USERPROFILE%\.continue\config.json (Windows)

HTTP Trực tiếp (curl) curl / Invoke-RestMethod — bao gồm Accept: application/json, text/event-stream

Khắc phục sự cố

Triệu chứng Cách khắc phục

401 Unauthorized Khóa sai, hết hạn hoặc bị thu hồi. Kiểm tra Cài đặt → Khóa API — các khóa bắt đầu bằng ba_live_. Tạo lại nếu cần.

Công cụ không hiển thị trong client Thoát hoàn toàn và khởi chạy lại client sau khi chỉnh sửa cấu hình. Trong Claude Desktop, Cmd+Q (không chỉ đóng cửa sổ). Trong Cursor, kiểm tra Cài đặt → MCP để thấy chấm xanh.

Accept header required Các cuộc gọi HTTP trực tiếp phải bao gồm Accept: application/json, text/event-stream — đặc tả HTTP có thể truyền phát yêu cầu nó. Máy chủ trả về 406 nếu không có nó.

Dữ liệu sai không gian làm việc Mỗi khóa API được giới hạn trong một không gian làm việc. Tạo khóa mới từ không gian làm việc bạn muốn truy vấn trong Cài đặt → Khóa API.

Công cụ xuất hiện nhưng cuộc gọi thất bại âm thầm Xác nhận máy chủ có thể truy cập được: curl -I https://mcp.bugagent.com/health sẽ trả về 200. Nếu hết thời gian chờ, hãy kiểm tra các quy tắc mạng/tường lửa.

Lỗi CORS của MCP Inspector Chọn Proxy (không phải Direct) cho Loại Kết nối trong giao diện Inspector. Inspector ủy quyền qua một tiến trình Node cục bộ để vượt qua các hạn chế CORS của trình duyệt.

Codex CLI — không nhận dạng được công cụ Xác minh ~/.codex/config.toml sử dụng [[mcp_servers]] (dấu ngoặc kép, cú pháp mảng). Kiểm tra phiên bản Codex CLI đủ mới để hỗ trợ MCP (codex --version).

Tính năng MCP

Máy chủ MCP bug_Agent_ cung cấp các công cụ cho:

🐛

Quản lý Báo cáo Lỗi

• create_bug_report — Tạo báo cáo mới với tự động phân loại vào 19 loại — lỗi, yêu cầu tính năng, cải tiến, nợ kỹ thuật, và nhiều loại khác (tiêu đề: 3-500 ký tự). Mảng attachments tùy chọn chấp nhận tệp mã hóa base64 lên đến 400 MB mỗi tệp: bất kỳ ảnh, video, âm thanh, PDF, hoặc văn bản/JSON. Đặt format_description: true để tự động định dạng lại mô tả thành mẫu có cấu trúc bằng AI. Truyền time_spent_seconds để theo dõi nỗ lực QA. Truyền priority (urgent / high / normal / low) để đặt mức độ khẩn cấp sửa lỗi độc lập với mức độ nghiêm trọng. Phản hồi bao gồm project_id, project, short_id, legacy_short_id, và project_short_id.
• list_bug_reports — Liệt kê và lọc báo cáo (tối đa 100 mỗi trang). Bộ lọc dự án được áp dụng phía máy chủ trước khi phân trang. Lọc theo project (UUID, slug, tên chính xác, hoặc tiền tố ticket), project_id, project_slug, project_prefix, workspace (UUID, tên chính xác, hoặc tiền tố ticket workspace), workspace_id/team_id, type (một trong 19 danh mục bảng điều khiển), severity (s1-s4 hoặc critical/high/medium/low cũ), status (sử dụng giá trị chính xác của bảng điều khiển: new, awaiting-triage, confirmed, in-progress, blocked, resolved, retesting, closed, reopened — dấu gạch ngang là có chủ ý), resolution (fixed / duplicate / works-as-designed / cannot-reproduce / will-not-fix / need-more-info / unresolved), root_cause (thẻ kebab-case mở — giá trị phổ biến: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch), hoặc reporter_user_id (UUID của thành viên nhóm đã tạo báo cáo — gọi list_team_members trước để phân giải tên thành UUID). Mỗi kết quả bao gồm reporter_user_id, project_id, project, short_id, legacy_short_id, và project_short_id để các agent có thể liên kết và cập nhật báo cáo đúng phạm vi dự án.
• pick_next_bug — Trả về (các) lỗi tiếp theo mà vòng lặp agent nên xử lý, theo thứ tự ưu tiên (S1 → S2 → S3, cũ nhất trước trong mỗi nhóm). Tự động giới hạn trong workspace của bạn — trả về ticket trên tất cả dự án trong nhóm với status new, awaiting-triage, hoặc confirmed và mức độ nghiêm trọng S1-S3. Chỉ đọc — không tự động nhận ticket. Tùy chọn severity (một mức duy nhất), limit (1-50, mặc định 1). Trả về các hàng có cùng hình dạng như list_bug_reports để dễ kết hợp công cụ. Kết hợp với claim_bug cho mẫu đọc-rồi-nhận.
• claim_bug — Chuyển đổi nguyên tử một lỗi từ status new, awaiting-triage, hoặc confirmed sang status='in-progress', đặt assigned_to thành người dùng đang gọi, và đóng dấu claimed_at=NOW(). Không xung đột giữa các caller đồng thời qua mẫu UPDATE-WHERE-RETURNING của Postgres — nếu hai agent gọi claim_bug trên cùng một id gần như đồng thời, chính xác một agent nhận được claimed:true với nội dung lỗi và agent kia nhận được claimed:false với chuỗi lý do. Trình dọn dẹp pg_cron tự động giải phóng các claim cũ (status=in-progress + claimed_at > 30 phút) trở lại new, vì vậy ticket của agent bị sập sẽ vào lại hàng đợi mà không cần can thiệp thủ công. Đầu vào: id (UUID hoặc ID ngắn).
• get_bug_report — Lấy chi tiết đầy đủ của báo cáo theo ID. Định dạng ID: chấp nhận UUID (ví dụ: 1fb72a2c-87c7-...), ID ngắn phạm vi workspace (ví dụ: WRKID-545), hoặc ID ngắn phạm vi dự án (ví dụ: WRKID-APP-042). Tra cứu ID ngắn được giới hạn trong nhóm — đoán ID ngắn của workspace khác sẽ trả về 404. Trả về project_id, project, short_id, legacy_short_id, project_short_id, ticket_number, project_ticket_number, qualityScore (số nguyên 1–10), và qualityBreakdown (đối tượng với 10 điểm số chiều: reproductionSteps, expectedVsActual, environmentDetails, evidence, rootCauseAnalysis, impactAssessment, contextAndHistory, heuristicsAndOracles, clarityAndStructure, actionability — mỗi chiều 0.0–1.0).
• update_bug_report — Cập nhật các trường trên báo cáo hiện có. Chấp nhận UUID hoặc ID ngắn (WRKID-545). Các trường có thể cập nhật bao gồm title, description, type (bất kỳ trong 19 danh mục bảng điều khiển), severity, priority (urgent / high / normal / low — mức độ khẩn cấp sửa lỗi, độc lập với mức độ nghiêm trọng), status (khớp chính xác bảng điều khiển: new, awaiting-triage, confirmed, in-progress, blocked, resolved, retesting, closed, reopened — dấu gạch ngang là có chủ ý), resolution (fixed / duplicate / works-as-designed / cannot-reproduce / will-not-fix / need-more-info / unresolved), và root_cause (thẻ kebab-case mở — giá trị phổ biến: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch). Quy ước vòng lặp agent yêu cầu cả resolution và root_cause phải được đặt bất cứ khi nào status chuyển ra khỏi new; bảng điều khiển, phân tích, và kho ngữ liệu huấn luyện claude-bot trong tương lai đều phụ thuộc vào các trường đó. Cũng bao gồm assigned_to (ID người dùng từ list_team_members) và time_spent_seconds để theo dõi thời gian. Thay đổi assigned_to tự động kích hoạt thông báo chuông trong ứng dụng VÀ email lịch sự đến người được gán mới (tôn trọng tùy chọn từ chối của từng người dùng trong Cài đặt Tài khoản — cùng pipeline với các endpoint bảng điều khiển).
• add_comment — Thêm bình luận vào báo cáo lỗi (UUID hoặc ID ngắn, nội dung 1-10000 ký tự). Nếu báo cáo được đồng bộ với Jira, bình luận sẽ tự động được đẩy lên issue Jira liên kết.
• list_comments — Liệt kê toàn bộ chuỗi bình luận của báo cáo, cũ nhất trước — mỗi bình luận có tên tác giả, parentId (trả lời theo luồng), và dấu thời gian. Bình luận không thuộc get_bug_report, vì vậy đây là cách bạn đọc thảo luận của ticket. Chấp nhận UUID hoặc ID ngắn.
• link_bug_reports — Tạo liên kết ngữ nghĩa có hướng giữa hai báo cáo lỗi trong cùng workspace. link_type là một trong duplicate-of, parent-of, related-to, hoặc depends-on. Các góc nhìn ngược (duplicated-by / subtask-of / blocks) được suy ra tại thời điểm đọc — chỉ cần lưu một hàng. Cả from_report_id và to_report_id chấp nhận UUID hoặc ID ngắn (WRKID-545).
• unlink_bug_reports — Xóa liên kết báo cáo lỗi đã tạo trước đó bằng UUID của nó (link_id, được trả về bởi link_bug_reports hoặc list_bug_report_links).
• list_bug_report_links — Liệt kê mọi liên kết do người dùng quản lý liên quan đến một báo cáo lỗi. Trả về mỗi liên kết như nó được đọc từ góc nhìn của báo cáo được cung cấp — ví dụ: một hàng duplicate-of được lưu mà báo cáo này là mục tiêu hiển thị là duplicated-by; parent-of mà báo cáo này là mục tiêu hiển thị là subtask-of; depends-on mà báo cáo này là mục tiêu hiển thị là blocks. related-to là đối xứng. Bổ sung cho trường similar_reports tự động phát hiện được trả về bởi get_bug_report.
• classify_bug — Phân loại mô tả vào một trong 19 loại báo cáo (lỗi, tính năng, cải tiến, v.v.) với điểm tin cậy
• flush_reports — Xóa hàng loạt báo cáo cũ (chỉ admin)

📊

Sử dụng & Phân tích

• get_usage — Kiểm tra mức sử dụng so với giới hạn gói
• get_stats — Số liệu hàng ngày, phân tích loại/mức độ nghiêm trọng/trạng thái

📁

Quản lý Dự án

• list_projects — Liệt kê các dự án có sẵn với id, name, slug, ticket_prefix, mô tả, và trạng thái mặc định. Sử dụng các giá trị đó với create_bug_report và list_bug_reports để nhắm mục tiêu đúng dự án.
• create_project — Tạo dự án mới (tự động trở thành mặc định nếu là dự án đầu tiên)
• delete_project — Xóa vĩnh viễn một dự án và tất cả dữ liệu liên quan (báo cáo lỗi, tự động hóa, ca kiểm thử, ứng dụng di động, lịch trình, ảnh chụp địa lý, ghi chú, mục thời gian). Chỉ chủ sở hữu/quản lý. Không thể xóa dự án cuối cùng. Dung lượng lưu trữ được giải phóng tự động
• export_okf_bundle — Xuất kiến thức QA của dự án — báo cáo lỗi, ca kiểm thử, tự động hóa, và kiểm thử hiệu năng, bảo mật, khám phá — dưới dạng gói markdown OKF/OQA (định dạng Open Query Agent được sử dụng bởi oqa.ai). Mặc định là dự án đang hoạt động; truyền project tùy chọn (slug hoặc tên) để xuất dự án khác. Trả về danh sách tệp trong gói cùng chính gói đó dưới dạng zip mã hóa base64

🔐

Xác thực & Tài khoản

• register_account — Tạo tài khoản mới (mật khẩu: 8-128 ký tự, giới hạn tốc độ: 5/15phút)
• login — Đăng nhập và nhận token truy cập (giới hạn tốc độ: 5/15phút)
• update_profile — Cập nhật tên hiển thị
• change_password — Thay đổi mật khẩu tài khoản
• get_settings / update_settings — Quản lý tùy chọn

🔑

Quản lý Khóa API

• generate_api_key — Tạo khóa API có tên
• list_api_keys — Liệt kê khóa đang hoạt động (chỉ tiền tố)
• regenerate_api_key — Thu hồi và thay thế khóa
• delete_api_key — Thu hồi vĩnh viễn khóa

👥

Quản lý Nhóm

• list_team_members — Liệt kê tất cả thành viên trong workspace với vai trò, trạng thái, và cờ booster
• invite_team_member — Mời người dùng qua email (quản lý có thể mời cộng tác viên và quản lý; chỉ chủ sở hữu mới có thể mời quản trị viên). Liên kết hết hạn sau 5 ngày

🎯

Tích hợp

• sync_to_jira — Đồng bộ báo cáo lên Jira sử dụng kết nối chung của nhóm
• push_to_claude — Tạo (hoặc tạo lại) Ghi chú Nhà phát triển cho báo cáo lỗi — nguyên nhân gốc, đề xuất sửa lỗi, các bước xác minh, và đánh giá rủi ro. Chấp nhận UUID hoặc ID ngắn (WRKID-545). Sử dụng khóa nền tảng — không cần kết nối Claude riêng cho từng nhóm. Chạy chuỗi thích ứng: ba bước trên lỗi s3/medium hoặc s4/low (bản nháp Sonnet → phê bình OpenAI gpt-5 → tổng hợp Sonnet), năm bước trên hai nhóm mức độ nghiêm trọng cao nhất — s1/critical hoặc s2/high — (bản nháp → phê bình → phản biện Sonnet → trọng tài Claude Opus đọc toàn bộ bản ghi và viết ghi chú cuối cùng với phán đoán độc lập). Phản hồi hiển thị mọi vòng: analysis, draft, critique, rebuttal, challenger_model, adjudicator_model, và cờ debated. Bất kỳ bước nào thất bại sẽ chuyển sang câu trả lời tốt nhất tiếp theo. Tự động kích hoạt khi tạo lỗi; thường chỉ được gọi để tạo lại thủ công.
• analyze_fix_area — Tạo (hoặc tạo lại) khối phụ "Khu vực Sửa lỗi Có khả năng" của Ghi chú Nhà phát triển — đầu ra Sonnet hẹp chỉ ra vị trí trong codebase nơi sửa lỗi có khả năng nhất. Chấp nhận UUID hoặc ID ngắn. Sử dụng khóa Anthropic nền tảng. Khi nhóm có hàng github_connections và dự án có github_repo được ánh xạ, đầu ra dựa trên các đoạn tệp thực từ repo được kết nối; nếu không thì quay lại hướng dẫn chung với gợi ý kết nối repo. Trả về văn bản likely_fix_area, generated_at, repo_used, và cờ grounded. Tự động kích hoạt khi tạo lỗi — agent thường chỉ cần gọi để tạo lại thủ công.
• upgrade_plan — Nâng cấp đăng ký qua Stripe

⚡

Kiểm thử Hiệu năng* create_performance_test — Tạo cấu hình kiểm thử hiệu năng với URL, thiết bị, người dùng ảo, thời lượng, ngưỡng điểm số và tùy chọn bật/tắt tự động tạo lỗi. Chỉ dành cho Enterprise

• run_performance_test — Kích hoạt kiểm tra trang và kiểm thử tải cho một bài kiểm thử hiệu năng web. Trả về ID lần chạy để truy vấn kết quả. Các lần chạy phân tích ứng dụng di động được kích hoạt từ bảng điều khiển
• get_performance_results — Nhận kết quả đầy đủ bao gồm điểm Lighthouse (Hiệu năng, Khả năng tiếp cận, Thực hành tốt nhất, SEO), Chỉ số Core Web Vitals (LCP, FID, CLS, FCP, TTFB, INP, TBT, SI) và các chỉ số kiểm thử tải (VU, yêu cầu, RPS, độ trễ p50/p90/p95/p99)
• list_performance_tests — Liệt kê tất cả cấu hình kiểm thử hiệu năng cho nhóm hiện tại
• get_performance_usage — Kiểm tra mức sử dụng kiểm thử hiệu năng hàng tháng. Kiểm thử hiệu năng chỉ dành cho Enterprise. Free=0, Enterprise=không giới hạn

Quy trình làm việc ví dụ

1. get_performance_usage → kiểm tra hạn ngạch còn lại
2. create_performance_test → cấu hình bài kiểm thử cho URL của bạn
3. run_performance_test → kích hoạt kiểm tra + kiểm thử tải
4. get_performance_results → xem lại điểm số và các chỉ số quan trọng

🛡

Quét bảo mật

• create_security_scan — Tạo cấu hình quét bảo mật. Quét web sử dụng Quick Scanner + Nuclei (hơn 4.000 mẫu) với ba mức độ sâu và tùy chọn quét có xác thực. Quét di động sử dụng MobSF để phân tích nhị phân APK/IPA. Có thể cấu hình tự động tạo lỗi với ngưỡng mức độ nghiêm trọng. Chỉ dành cho Enterprise
• run_security_scan — Kích hoạt quét lỗ hổng bảo mật. Quét web yêu cầu xác minh tên miền DNS. Quét di động yêu cầu ứng dụng đã tải lên. Trả về ID lần chạy để truy vấn kết quả
• get_security_results — Nhận kết quả đầy đủ bao gồm điểm bảo mật (0-100), các phát hiện được phân loại theo mức độ nghiêm trọng (Nghiêm trọng, Cao, Trung bình, Thấp, Thông tin) với tham chiếu CWE, ánh xạ OWASP, bằng chứng và hướng dẫn khắc phục
• list_security_scans — Liệt kê tất cả cấu hình quét bảo mật cho nhóm hiện tại với điểm số cuối cùng và huy hiệu xác thực/độ sâu
• get_security_usage — Kiểm tra mức sử dụng quét bảo mật hàng tháng. Quét bảo mật chỉ dành cho Enterprise. Enterprise=không giới hạn
• list_security_schedules — Liệt kê tất cả các lần quét bảo mật đã lên lịch cho nhóm với cron, múi giờ, trạng thái bật, lần chạy tiếp theo và cài đặt thông báo. Kết hợp với cấu hình quét cha (tên, scan_type, target_url)
• create_security_schedule — Tạo lịch định kỳ cho một lần quét bảo mật. Yêu cầu scan_id và cron_expression. Mỗi cấu hình quét chỉ có một lịch. Tùy chọn timezone, notify_on_fail (không/email/slack/cả hai), notify_email, slack_channel_id. Mỗi lần chạy đều tính vào giới hạn hàng tháng của bạn; người dùng quản trị viên bỏ qua giới hạn. Độ sâu quét luôn được đọc từ cấu hình quét tại thời điểm chạy
• delete_security_schedule — Xóa lịch quét bảo mật. Không ảnh hưởng đến cấu hình quét cha hoặc các lần chạy đã hoàn thành

1. get_security_usage → kiểm tra hạn ngạch còn lại
2. create_security_scan → cấu hình quét cho URL hoặc kho lưu trữ của bạn
3. run_security_scan → kích hoạt quét lỗ hổng một lần
4. create_security_schedule → tự động hóa các lần chạy định kỳ (ví dụ: SAST hàng tuần trên nhánh chính)
5. get_security_results → xem lại các phát hiện và biện pháp khắc phục

📖

Đánh giá mã

• list_code_reviews — Liệt kê các đánh giá mã AI gần đây cho nhóm. Trả về điểm chất lượng, số lượng theo mức độ nghiêm trọng, thông tin PR và dấu thời gian. Chỉ dành cho Enterprise
• get_code_review — Nhận đánh giá mã với tất cả các phát hiện. Mỗi phát hiện bao gồm mức độ nghiêm trọng, danh mục (lỗi/bảo mật/hiệu năng/phong cách/logic/khả năng bảo trì), tiêu đề, mô tả, đề xuất mã, đường dẫn tệp và số dòng
• get_code_review_usage — Kiểm tra mức sử dụng đánh giá mã. Đánh giá mã AI chỉ dành cho Enterprise; không giới hạn trên Enterprise
• get_code_review_analytics — Nhận phân tích đánh giá: xu hướng, danh mục/nguồn phát hiện, phân tích mức độ nghiêm trọng, chỉ số tốc độ, kho lưu trữ/tác giả hàng đầu. Hỗ trợ xem lại 7/30/90 ngày

1. get_code_review_usage → kiểm tra số lần đánh giá còn lại
2. Đánh giá PR trong bảng điều khiển tại /dashboard/code-review
3. list_code_reviews → xem các đánh giá gần đây
4. get_code_review → nhận phát hiện và đề xuất

🔍

AI Khám phá

Trình tìm lỗi trang web tự động đa tác nhân với tối đa 10 tác nhân song song, mỗi tác nhân sử dụng một chiến lược kiểm thử khác nhau.

• list_explorations — Liệt kê cấu hình AI Khám phá cho nhóm
• create_exploration — Tạo một cuộc khám phá mới. Chấp nhận agent_count (1–10, tối đa 10) để chạy nhiều tác nhân song song với các chiến lược duy nhất: happy_path, edge_case, security, accessibility, error_path, performance, mobile, data_integrity, navigation, custom
• get_exploration — Nhận cấu hình khám phá với cài đặt tác nhân và các lần chạy gần đây
• get_exploration_run — Nhận kết quả chạy với tiến trình từng tác nhân, dữ liệu pha, phát hiện có ghi nhận tác nhân (agent_index, agent_strategy) và các lỗi được liên kết
• get_exploration_usage — Kiểm tra mức sử dụng hàng tháng. AI Khám phá chỉ dành cho Enterprise; Enterprise: không giới hạn (10 tác nhân)

1. create_exploration với agent_count: 5 → cấu hình 5 tác nhân song song
2. Kích hoạt chạy từ bảng điều khiển hoặc qua POST /api/explorations/run
3. get_exploration_run → truy vấn tiến trình và phát hiện từng tác nhân
4. Xem các phát hiện đã loại bỏ trùng lặp có ghi nhận tác nhân trong bảng điều khiển

📝

Ghi chú

• list_notes — Liệt kê ghi chú với tùy chọn tìm kiếm từ khóa, bộ lọc dự án, bộ lọc tác giả và phạm vi ngày. Trả về ghi chú mà người dùng sở hữu hoặc ghi chú được chia sẻ trong nhóm.
• create_note — Tạo ghi chú ở một trong 5 định dạng: markdown, plain_text, rich_text, checklist, outline. Đặt visibility thành private hoặc shared. Tự động tạo tiêu đề từ 30 ký tự đầu tiên nếu không có tiêu đề. Mảng attachments tùy chọn chấp nhận tệp mã hóa base64 lên đến 400 MB mỗi tệp: bất kỳ hình ảnh, video, âm thanh, PDF hoặc văn bản/JSON. Truyền time_spent_seconds để theo dõi nỗ lực QA.
• get_note — Nhận chi tiết ghi chú đầy đủ bao gồm nội dung và tệp đính kèm. Yêu cầu id.
• update_note — Cập nhật tiêu đề, nội dung, định dạng, khả năng hiển thị, dự án hoặc time_spent_seconds. Truyền mảng attachments để thêm tệp mới (tối đa 400 MB mỗi tệp) vào tệp đính kèm hiện có của ghi chú mà không thay thế chúng. Chỉ tác giả mới có thể cập nhật. Yêu cầu id.
• delete_note — Xóa vĩnh viễn ghi chú và tệp đính kèm của nó. Chỉ tác giả mới có thể xóa. Yêu cầu id.

1. create_note → bắt đầu ghi chú phiên kiểm thử
2. update_note → thêm quan sát khi bạn kiểm thử
3. list_notes → tìm kiếm ghi chú cũ theo từ khóa hoặc dự án
4. get_note → truy xuất ghi chú đầy đủ với tệp đính kèm

🤖

Tự động hóa

• create_automation — Tạo tự động hóa mới với tập lệnh Playwright tùy chỉnh (không cần ghi FAB). Yêu cầu name. Tùy chọn: target_url (tự động lấy từ URL page.goto(...) đầu tiên trong tập lệnh nếu bỏ qua), script (Node.js/JavaScript/TypeScript hoặc Python — ngôn ngữ được tự động phát hiện; mặc định là trình giữ chỗ), status (draft hoặc active, mặc định: draft), project_id. Trả về id tự động hóa. Yêu cầu gói Team. Mẹo — Nhân bản tự động hóa: sử dụng get_automation để lấy tập lệnh gốc, sau đó gọi create_automation với name được đặt thành "[Copy] Original Name" và truyền script, target_url và project_id gốc. Bản sao bắt đầu ở trạng thái draft không có lịch sử phiên bản.
• list_automations — Liệt kê các tập lệnh tự động hóa Playwright. Lọc theo project_id hoặc status (draft, active, paused). Trả về mảng tự động hóa với tên, target_url, last_run_status và run_count.
• get_automation — Nhận chi tiết tự động hóa đầy đủ bao gồm tập lệnh Playwright và các lần chạy gần đây. Yêu cầu id. Trả về tự động hóa với script trực tiếp, ngăn xếp script_versions (cũ nhất trước, tối đa 100 mục trước đó, mỗi mục { script, source, timestamp }) và mảng recent_runs trong đó mỗi lần chạy mang script_version_label/script_version_source đã thực thi. Gọi hàm này trước run_automation nếu bạn cần chọn một phiên bản lịch sử cụ thể.
• run_automation — Kích hoạt chạy ngay lập tức một bài kiểm thử Playwright. Yêu cầu automation_id. Chế độ ảo (mặc định): device tùy chọn để mô phỏng khung nhìn (ví dụ: desktop, iphone-15). Chế độ trực tiếp: đặt browserstack: true với bs_browser (chrome, firefox, safari, edge), bs_os (Windows, OS X) và bs_os_version để chạy trên trình duyệt máy tính thực. Di động thực trực tiếp: đặt bs_os: "android" (thiết bị: "Samsung Galaxy S25 Ultra", "Google Pixel 10", "OnePlus 13R") hoặc bs_os: "ios" (thiết bị: "iPhone 17 Pro Max", "iPhone 16 Pro Max", "iPhone 15 Pro Max") và truyền tên thiết bị trong bs_os_version. Tập lệnh Node.js định tuyến qua browserstack-node-sdk (bao gồm máy tính + Android + iPhone). Tập lệnh Python định tuyến qua browserstack-sdk (pytest-playwright) và chỉ bao gồm máy tính — di động thực qua Python không được hỗ trợ vì browser_type.connect() của pytest-playwright không thể điều khiển các điểm cuối di động thực của BrowserStack. Video và nhật ký mạng được ghi tự động; nhật ký bảng điều khiển chỉ dành cho máy tính. Phát lại phiên bản: truyền version_index tùy chọn (số nguyên, chỉ mục 0) để thực thi một mục trước đó từ lịch sử script_versions của tự động hóa. Mặc định: khi version_index bị bỏ qua hoặc null, tập lệnh trực tiếp hiện tại sẽ chạy — không truyền giá trị giữ chỗ chỉ để "chọn hiện tại". Giá trị ngoài phạm vi, âm hoặc không phải số nguyên sẽ bị từ chối. Bản ghi chạy lưu trữ ảnh chụp chính xác đã chạy và mọi báo cáo lỗi được tự động tạo từ lần chạy thất bại sẽ liên kết sâu trở lại phiên bản đó trong trình chỉnh sửa.
• list_automation_runs — Liệt kê các lần chạy gần đây cho một tự động hóa. Yêu cầu automation_id. Trả về các lần chạy với trạng thái, duration_ms và error_message.
• list_schedules — Liệt kê tất cả các lần chạy tự động hóa web đã lên lịch với cron, múi giờ, thiết bị và cài đặt thông báo
• create_schedule — Tạo lịch chạy tự động hóa web. Yêu cầu automation_id và cron_expression. Hỗ trợ thiết bị, múi giờ, notify_on_fail (email/slack/cả hai) và tùy chọn kênh Slack. BrowserStack Live trên các lần chạy đã lên lịch: truyền browserstack: true với bs_browser, bs_os và bs_os_version — cùng ma trận thiết bị như run_automation (Node = máy tính + Android thực + iPhone thực; Python = chỉ máy tính).
• delete_schedule — Xóa lịch chạy tự động hóa web
• list_mobile_schedules — Liệt kê tất cả các lần chạy tự động hóa di động đã lên lịch với thiết bị, cron, múi giờ và thông báo
• create_mobile_schedule — Tạo lịch chạy tự động hóa di động trên thiết bị thực. Yêu cầu automation_id, cron_expression và mảng devices
• delete_mobile_schedule — Xóa lịch chạy tự động hóa di động
• optimize_automation_script — Gửi tập lệnh Playwright đến Sonnet 4 để tối ưu hóa bằng AI. Áp dụng danh sách kiểm tra 12 điểm sửa các bộ chọn, chiến lược chờ, xác nhận, xử lý lỗi, mẫu xác thực, khả năng tương thích di động và chế độ nghiêm ngặt. Yêu cầu automation_id. Phiên bản tập lệnh hiện tại được lưu trước khi tối ưu hóa. Trả về tập lệnh đã tối ưu và tóm tắt thay đổi.
• undo_automation_script — Hoàn nguyên tập lệnh tự động hóa về phiên bản trước đó. Tối đa 10 phiên bản trước được giữ lại. Yêu cầu automation_id. Trả về tập lệnh đã khôi phục và số phiên bản còn lại.

1. create_automation → tạo bài kiểm thử với tập lệnh tùy chỉnh
2. list_automations → duyệt các bài kiểm thử có sẵn
3. get_automation → kiểm tra tập lệnh Playwright
4. run_automation → kích hoạt bài kiểm thử
5. list_automation_runs → kiểm tra kết quả và thời lượng

⏱️

Theo dõi thời gian

• list_time_entries — Liệt kê các mục thời gian cho nhóm. Lọc theo period (today, week, month, all), project_id, category, và sort (newest, oldest, most_time, least_time). Chỉ dành cho gói Team.
• create_time_entry — Ghi nhận thời gian cho các tác vụ QA. Yêu cầu description, category, và duration_minutes. Tùy chọn đặt project_id và entry_date (mặc định là hôm nay). Chỉ dành cho gói Team.
• update_time_entry — Cập nhật một mục thời gian hiện có. Yêu cầu id. Có thể cập nhật description, category, duration_minutes, project_id, hoặc entry_date. Chỉ dành cho gói Team.
• delete_time_entry — Xóa vĩnh viễn một mục thời gian. Yêu cầu id. Chỉ dành cho gói Team.

1. create_time_entry → ghi nhận 45 phút kiểm thử hồi quy
2. list_time_entries → xem các mục thời gian của tuần này
3. update_time_entry → điều chỉnh thời lượng hoặc danh mục
4. delete_time_entry → xóa một mục không chính xác

☑️

Các Trường Hợp Kiểm Thử

Quản lý kiểm thử đầy đủ với các thư mục phân cấp, bộ kiểm thử lồng nhau (tối đa 3 cấp với tự động mở rộng bộ kiểm thử con khi chạy), sắp xếp lại bằng kéo thả, tạo trường hợp kiểm thử có hỗ trợ AI, và tab Báo cáo phân tích với xu hướng KPI, phân tích lỗi, tình trạng bộ kiểm thử, độ phủ, và năng suất của kiểm thử viên. Tất cả công cụ gọi trực tiếp Supabase — không có vòng lặp HTTP, cùng độ trễ như bảng điều khiển.

Thực thi rảnh tay: trang xem xét chạy kiểm thử là một băng chuyền với mỗi lần hiển thị một trường hợp, phím tắt (P Đạt · F Lỗi · B Chặn · S Bỏ qua), và điều khiển bằng giọng nói. Nhấp vào mic, sau đó nói "Đạt", "Lỗi", "Chặn", "Bỏ qua", "Tiếp theo", "Trước đó", "Thêm ghi chú" (chép lại vào trường ghi chú), "Lưu ghi chú", hoặc "Tắt giọng nói". Tự động chuyển đến trường hợp chưa kiểm thử tiếp theo khi có kết quả thành công; dừng lại ở Lỗi để kiểm thử viên có thể đọc chi tiết và tạo lỗi. Hoạt động trên Chrome, Edge, và Safari.

Các Trường Hợp & Thư Mục

• list_test_cases — Liệt kê các trường hợp kiểm thử với tùy chọn search, priority (critical, high, medium, low), type (functional, regression, smoke, integration, performance, security, usability, exploratory), status (active, draft, deprecated), và sort (newest, oldest, name, priority).
• create_test_case — Tạo một trường hợp kiểm thử. Hai biến thể mẫu: steps (mặc định) — lưới { action, expected } từng bước thông qua mảng steps; text — mô tả dạng tự do đơn thông qua text_content. Cả hai trường có thể được gửi trong cùng một lệnh gọi (nền tảng lưu trữ chúng độc lập để kiểm thử viên chuyển đổi template_type sau này không mất dữ liệu của bên nào). Mảng urls tùy chọn (tối đa 10 URL http/https) đính kèm các liên kết tham khảo. Yêu cầu name. Tùy chọn: description, preconditions, template_type, steps, text_content, urls, priority, type, tags, estimated_time (giây). Tệp đính kèm được tải lên qua điểm cuối POST /api/test-cases/:id/attachments của bảng điều khiển (đa phần) — chưa được hiển thị dưới dạng công cụ MCP.
• get_test_case — Lấy chi tiết đầy đủ của trường hợp kiểm thử bao gồm các bước và lịch sử thực thi.
• list_test_case_folders — Liệt kê các thư mục của nhóm (mỗi trường hợp một thư mục qua folder_id; khác biệt với các bộ kiểm thử, là các nhóm kế hoạch kiểm thử nhiều-nhiều). Giới hạn 500; tôn trọng bộ lọc project_id và parent_folder_id (sử dụng "root" cho chỉ cấp cao nhất).
• create_test_case_folder — Tạo một thư mục (lồng tối đa 3 cấp qua parent_folder_id). Sử dụng bulk_update_test_cases để di chuyển các trường hợp vào đó.
• bulk_update_test_cases — Áp dụng một hành động cho tối đa 500 trường hợp cùng lúc: set_priority, set_status, set_type, add_tags, remove_tags, add_to_suite, pin, unpin.
• link_test_case_to_bug — Thiết lập khả năng truy xuất giữa một trường hợp kiểm thử và một báo cáo lỗi (verified_by, covers, hoặc relates).
• list_test_case_links — Liệt kê tất cả các liên kết truy xuất cho một trường hợp kiểm thử.
• list_test_case_review_candidates — Cờ kiểm thử chết: never_run (90+ ngày kể từ khi tạo), always_passes (5+ lần đạt liên tiếp trong 90 ngày), always_skipped (3+ lần bỏ qua liên tiếp).
• mark_test_case_review_flags — Lưu trữ các cờ ứng viên lưu trữ hiện tại vào test_cases.review_flag. Tự động chạy mỗi Thứ Hai 09:00 UTC qua pg_cron.

Nhập

• Nhập từ Figma (UI bảng điều khiển + REST): tải lên bản xuất zip của các khung Figma (tối đa 100 MB), Claude phân tích từng màn hình và phác thảo các trường hợp kiểm thử vào một thư mục bạn chọn hoặc tạo mới. Quy trình đa lượt (phân loại → trường hợp từng màn hình → trường hợp cấp luồng qua các màn hình có tiền tố chung → tự phê bình) với bộ nhớ đệm lời nhắc, thử lại 429, và cách ly lỗi từng khung để một khung lỗi không làm hỏng cả lô. Các trường hợp được tạo dưới dạng status=active, gắn thẻ ai_generated=true, với source='figma' và source_frame_name giữ liên kết đến khung gốc. Sử dụng khóa Anthropic của nền tảng — không cần kết nối Claude cho từng nhóm. Điểm cuối: POST /api/test-cases/import/figma/request, POST /api/test-cases/import/figma/start, GET /api/test-cases/import/figma/:id.

Bộ Kiểm Thử & Lần Chạy

• list_test_suites — Liệt kê các bộ kiểm thử với số lượng trường hợp và trạng thái lần chạy cuối.
• create_test_suite — Tạo một bộ kiểm thử. Lồng tối đa 3 cấp qua parent_suite_id.
• list_test_runs — Liệt kê các lần chạy kiểm thử với tên bộ, người được giao, và tóm tắt đạt/lỗi.
• create_test_run — Chụp nhanh một bộ kiểm thử thành một lần chạy mới. Chạy bộ kiểm thử cha tự động bao gồm mọi trường hợp trong mọi bộ kiểm thử con cháu (một trường hợp được liên kết với cả hai chỉ được thêm một lần). Mỗi hàng test_run_results ghi lại bộ kiểm thử con gốc mà trường hợp đến từ đó, để các trang kết quả có thể nhóm theo nguồn gốc.

Báo cáo (Phân tích Cấp 1 + Cấp 4)

• get_test_reports_overview — Các KPI tiêu đề cho một khoảng thời gian (tỷ lệ đạt, số lần chạy hoàn thành, số trường hợp đã thực thi) với chênh lệch so với khoảng thời gian tương đương trước đó. Cùng các con số mà dải KPI của tab Báo cáo hiển thị.
• get_test_reports_failures — Bốn danh sách "cần sửa gì?": failing_cases (≥50% lỗi, tối thiểu 3 lần chạy), flaky_cases (nhiều lần lật đạt/lỗi nhất), failing_suites (≥30% lỗi, tối thiểu 5 lần chạy), regressed_cases (lỗi gần đây nhất với một lần đạt trước đó trong khoảng thời gian).

1. create_test_case_folder → tạo cây thư mục (ví dụ: Smoke → Auth)
2. create_test_case → định nghĩa các trường hợp; di chuyển chúng vào thư mục với bulk_update_test_cases
3. create_test_suite → xây dựng kế hoạch kiểm thử (bộ kiểm thử con tùy chọn, tối đa 3 cấp sâu)
4. create_test_run → chụp nhanh một lần chạy từ bộ kiểm thử cha — tự động bao gồm các bộ kiểm thử con
5. get_test_reports_failures → hỏi "cần sửa gì tuần này?" khi lần chạy hoàn thành
6. get_test_reports_overview → theo dõi xu hướng tỷ lệ đạt qua từng tuần

⚡

Tăng Cường Nhóm

• scale_team — Mở rộng ngay lập tức nhóm QA của bạn với các kiểm thử viên tăng cường. Tài khoản được cấp phát tự động với quyền truy cập kiểm thử viên. Chỉ định team_size (1–10), location, duration, budget, và tùy chọn product_url, product_types, và tech_levels. Có sẵn trên gói Team. Bạn sẽ không bị tính phí cho đến khi được phê duyệt.

1. scale_team → cấp phát 5 kiểm thử viên cao cấp ở Mỹ trong 1 tháng
2. list_team_members → xác minh kiểm thử viên mới xuất hiện trong nhóm của bạn
3. list_reports → xem xét báo cáo do kiểm thử viên tăng cường nộp

📱

Kiểm Thử Di Động

• upload_mobile_app — Tải lên ứng dụng APK (Android) hoặc IPA (iOS) để kiểm thử trên thiết bị thực. Yêu cầu name, platform (android/ios), và file_url. Đối với iOS: tải lên IPA cho các lần chạy trên thiết bị thực, sau đó tải lên bản dựng .app giả lập trên trang chi tiết ứng dụng để kích hoạt ghi hình.
• update_mobile_app — Thay thế nhị phân ứng dụng bằng phiên bản mới. Xóa các URL đã lưu trong bộ nhớ đệm và bản dựng giả lập để tất cả tự động hóa sử dụng phiên bản mới trong lần chạy tiếp theo. Yêu cầu app_id và file_url. Tùy chọn: version.
• create_mobile_automation — Tạo một kịch bản kiểm thử. Yêu cầu name, app_id, script_type (maestro cho YAML, appium cho Appium Python, appium_js cho Appium JavaScript), và script (nội dung kịch bản kiểm thử).
• list_mobile_runs — Lấy kết quả cho các lần chạy kiểm thử di động (trạng thái, thiết bị, video, phiên BrowserStack, và bất kỳ lỗi tự động tạo nào). Các lần chạy di động được kích hoạt từ bảng điều khiển hoặc theo lịch trình. Bộ lọc tùy chọn: automation_id, status (queued, running, passed, failed, error, archived), limit. Các lần chạy đã lưu trữ bị loại khỏi danh sách mặc định.

Ví Dụ Quy Trình — Android

1. upload_mobile_app → tải lên APK của bạn
2. Ghi lại kiểm thử trong trình duyệt → các hành động được ghi tự động
3. Kích hoạt lần chạy trên thiết bị thực (ví dụ: Google Pixel 8) từ bảng điều khiển hoặc lịch trình
4. list_mobile_runs → kiểm tra kết quả với video và nhật ký
5. Các lỗi tự động tạo báo cáo lỗi với ảnh chụp lỗi và phân tích từng bước

Ví Dụ Quy Trình — iOS

1. upload_mobile_app → tải lên IPA của bạn (cho các lần chạy trên thiết bị thực)
2. Tải lên bản dựng .app giả lập trên trang chi tiết ứng dụng (để ghi hình)
3. Ghi lại kiểm thử trong trình duyệt → các hành động được ghi từ giả lập
4. Kích hoạt lần chạy trên thiết bị thực (ví dụ: iPhone 15 Pro, sử dụng IPA) từ bảng điều khiển hoặc lịch trình
5. update_mobile_app → thay thế IPA bằng phiên bản mới khi sẵn sàng

✅

Tuân Thủ & Bằng Chứng (Doanh Nghiệp)

• collect_compliance_evidence — Kích hoạt thu thập bằng chứng tự động từ các dịch vụ được kết nối (Cloudflare, GitHub, Sentry, Supabase, Railway). Trả về ID lần chạy. Thu thập cài đặt SSL/TLS, trạng thái WAF, cảnh báo Dependabot, xu hướng lỗi, lịch sử triển khai, và nhiều hơn nữa.
• check_config_drift — Kiểm tra tất cả các dịch vụ được kết nối để phát hiện sai lệch cấu hình bảo mật so với đường cơ sở (chế độ SSL, phiên bản TLS, HSTS, quy tắc WAF, tiêu đề bảo mật).
• generate_access_review — Tạo báo cáo xem xét truy cập hàng quý. Kiểm tra thành viên nhóm, vai trò, trạng thái MFA, sử dụng khóa API, và tạo khuyến nghị (ví dụ: thu hồi khóa không hoạt động).
• get_security_events — Truy vấn dòng thời gian sự kiện bảo mật liên dịch vụ. Lọc theo nguồn (cloudflare, sentry, github) và mức độ nghiêm trọng (critical, high, medium, low, info). Các sự kiện được tự động tương quan giữa các dịch vụ.

Phạm Vi Tuân Thủ

Các công cụ này hỗ trợ các yêu cầu tuân thủ SOC2 (CC4.1, CC6.1, CC7.2, CC8.1), ISO 27001 (A.5.18, A.8.8, A.8.9, A.8.15-16, A.8.29), và GDPR (Điều 5, 25, 32, 33).

Các Ứng Dụng Khách Tương Thích

bug_Agent_ hoạt động với bất kỳ ứng dụng khách nào hỗ trợ Giao Thức Ngữ Cảnh Mô Hình. Dưới đây là hướng dẫn thiết lập cho các ứng dụng khách phổ biến:

🤖

Claude Desktop

Mở Cài đặt → Nhà phát triển → Chỉnh sửa Cấu hình, sau đó thêm:

claude_desktop_config.json

Khởi động lại Claude Desktop sau khi lưu.

✳️

Cursor

Mở Cài đặt → Máy chủ MCP → Thêm Máy chủ, hoặc chỉnh sửa .cursor/mcp.json trong thư mục gốc dự án của bạn:

.cursor/mcp.json

🌊

Windsurf

Mở Cài đặt → MCP → Thêm Máy chủ, hoặc chỉnh sửa tệp cấu hình MCP của bạn:

mcp_config.json

💻

Claude Code (CLI)

Thêm bug_Agent_ trực tiếp từ terminal:

claude mcp add bugagent -- npx -y @bugagent/mcp-server

Đặt khóa API của bạn với export BUGAGENT_API_KEY=ba_live_... trước khi khởi chạy.

🔧

Các Ứng Dụng Khách MCP Khác

Bất kỳ ứng dụng khách nào hỗ trợ truyền tải MCP stdio đều hoạt động với bug_Agent_. Sử dụng cấu hình tiêu chuẩn:

• Lệnh: npx
• Đối số: ["-y", "@bugagent/mcp-server"]
• Biến môi trường: BUGAGENT_API_KEY

CLI

Bắt Đầu với CLI

CLI bug_Agent_ cung cấp cho bạn toàn quyền kiểm soát các báo cáo lỗi, yêu cầu tính năng, dự án, và tích hợp từ terminal của bạn. Sử dụng nó để:

• Tự động hóa quy trình — Tích hợp báo cáo lỗi vào pipeline CI/CD, kịch bản, và công việc cron
• Thao tác hàng loạt — Liệt kê, lọc, và quản lý báo cáo mà không cần rời khỏi terminal
• Đầu ra thân thiện với pipe — Định dạng JSON, YAML, và raw để kết hợp với jq, yq, và các công cụ khác
• Lặp nhanh — Không cần trình duyệt — tạo và cập nhật báo cáo trong vài giây

Cài Đặt

npm install -g @bugagent/cli

Xác minh cài đặt:

bugagent --version

Xác thực

Đặt khóa API của bạn dưới dạng biến môi trường:

Hoặc truyền trực tiếp với cờ --api-key:

bugagent reports list --api-key ba_live_your_key_here

🔑

Lấy khóa API của bạn từ bảng điều khiển bug_Agent_. Khóa bắt đầu bằng ba_live_.

Để xác thực lâu dài, hãy thêm lệnh export vào hồ sơ shell của bạn (~/.bashrc, ~/.zshrc, v.v.).

Cách sử dụng

Các lệnh tuân theo mẫu:

bugagent <resource> <action> [flags]

Tài nguyên cũng có thể sử dụng cú pháp dấu hai chấm cho tài nguyên con:

bugagent reports comments add --report-id WRKID-545 --body "Reproduced on v2.1"

Sử dụng --help trên bất kỳ lệnh nào để biết chi tiết:

bugagent reports --help
bugagent reports create --help

Phiên ví dụ

Terminal

# List your projects
bugagent projects list

# Create a bug report in your default project
bugagent reports create \
  --title "Checkout 500 on discount code" \
  --description "Applying SAVE20 returns HTTP 500" \
  --severity critical \
  --type logic

# View recent reports
bugagent reports list --limit 5 --format pretty

# Get full details on a report (use the short ID or UUID)
bugagent reports get WRKID-545

# Sync a report to Jira
bugagent jira sync --report-id WRKID-545

# Check your usage
bugagent usage get --format json

Tính năng CLI

CLI cung cấp các lệnh cho:

reports Tạo, liệt kê, lấy, cập nhật và xóa báo cáo lỗi

projects Tạo, liệt kê, cập nhật và xóa dự án

keys Tạo, liệt kê, tạo lại và thu hồi khóa API

jira Kết nối, đồng bộ báo cáo và cấu hình cài đặt Jira

usage Kiểm tra mức sử dụng hiện tại so với giới hạn gói

stats Xem phân tích và chi tiết

profile Xem và cập nhật hồ sơ và cài đặt của bạn

auth Đăng nhập, đăng ký và quản lý thông tin xác thực

Cờ toàn cục

Cờ Mô tả

--api-key <key> Ghi đè khóa API cho lệnh này

--format <fmt> Định dạng đầu ra: json, yaml, pretty, raw

--debug Hiển thị chi tiết yêu cầu/phản hồi để khắc phục sự cố

--help Hiển thị trợ giúp cho bất kỳ lệnh nào

--version In phiên bản CLI

Định dạng đầu ra

CLI hỗ trợ nhiều định dạng đầu ra cho các trường hợp sử dụng khác nhau:

json

JSON có thể đọc bằng máy. Lý tưởng để chuyển đến jq hoặc các công cụ khác.

yaml

Đầu ra YAML thân thiện với con người cho tệp cấu hình và khả năng đọc.

pretty

Mặc định. Đầu ra được tô màu, định dạng dành cho terminal.

raw

Đầu ra không định dạng. Hữu ích cho việc viết kịch bản và tự động hóa.

Lọc với --transform

Sử dụng --transform với cú pháp GJSON để truy vấn và lọc dữ liệu đầu ra:

# Default pretty output
bugagent reports list

# JSON for piping to other tools
bugagent reports list --format json

# YAML
bugagent reports list --format yaml

# Raw (no formatting)
bugagent reports get rpt_abc123 --format raw

# Filter with GJSON syntax
bugagent reports list --format json \
  --transform "items.#(severity==critical).title"

Kỹ năng AI

CLI cũng có sẵn dưới dạng AgentSkill, cho phép các trợ lý lập trình AI sử dụng bug_Agent_ thay mặt bạn.

✨

AgentSkill là gì?

AgentSkills cho phép các trợ lý lập trình AI (Claude Code, Cursor, v.v.) gọi các công cụ CLI theo ngữ cảnh. Kỹ năng bug_Agent_ cung cấp cho trợ lý AI của bạn khả năng gửi lỗi, kiểm tra trạng thái dự án và đồng bộ với Jira — tất cả mà không cần bạn phải gõ lệnh.

Cài đặt Kỹ năng

claude skills install bugagent --from @bugagent/mcp-server

Sau khi cài đặt, Trợ lý AI nhận biết ngữ cảnh có thể sử dụng các lệnh bug_Agent_ một cách tự nhiên — với kiến thức đầy đủ về sản phẩm, hướng dẫn kiểm thử và tài liệu đã tải lên của bạn:

Lời nhắc Trợ lý AI

"File a critical bug: the payment webhook is returning
a 403 after the latest deploy. It affects all Stripe
events. Assign it to the payments project."

Kỹ năng này dịch ngôn ngữ tự nhiên thành các lệnh CLI phù hợp và thực thi chúng.

🎬

Phát lại Phiên + Trợ lý AI: Khi Phát lại Phiên được bật (gói Team), Trợ lý AI có thể tham chiếu phiên người dùng đã ghi lại — các cú nhấp chuột, điều hướng, lỗi và lỗi mạng trong 60 giây qua — để tự động soạn thảo các báo cáo lỗi phong phú hơn, chính xác hơn với ngữ cảnh tái tạo đầy đủ.

Nhận Trợ giúp

Cần hỗ trợ? Chúng tôi sẵn sàng giúp đỡ.

Cộng đồng Discord

Tham gia Discord của chúng tôi để được hỗ trợ thời gian thực và thảo luận cộng đồng.

Hỗ trợ qua Email

[email protected] — Chúng tôi thường phản hồi trong vòng 24 giờ.