bugAgent MCP Server

ทางการ

เชื่อมต่อ bugAgent กับ AI client ที่รองรับ MCP ได้ทุกตัว จัดการไฟล์ จำแนกประเภท และจัดการบั๊ก คำขอฟีเจอร์ และอื่นๆ ได้โดยตรงจากผู้ช่วยเขียนโค้ด AI ของคุณ ไม่ต้องสลับบริบท ไม่ต้องคัดลอกและวาง — แค่ระบุปัญหา แล้ว bugAgent จะจัดการส่วนที่เหลือ

ดูบน bugagent.com

เอกสาร

MCP v1

การนำทาง

Model Context Protocol

MCP

เชื่อมต่อ bug_Agent_ กับไคลเอนต์ AI ที่รองรับ MCP ได้ทุกตัว

บันทึก จำแนกประเภท และจัดการบั๊ก คำขอฟีเจอร์ และอื่นๆ ได้โดยตรงจากผู้ช่วยเขียนโค้ด AI ของคุณ ไม่ต้องสลับบริบท ไม่ต้องคัดลอกและวาง — แค่อธิบายปัญหา แล้ว bug_Agent_ จะจัดการส่วนที่เหลือให้เอง

Discord Community [email protected]

เริ่มต้นใช้งาน

เซิร์ฟเวอร์ MCP ของ bug_Agent_ ช่วยให้ไคลเอนต์ AI สามารถสร้าง สืบค้น และจัดการรายงานบั๊ก คำขอฟีเจอร์ การปรับปรุง และอื่นๆ ผ่าน Model Context Protocol ได้ โดยทำงานภายในเครื่องและสื่อสารกับ API คลาวด์ของ bug_Agent_

รับคีย์ API ของคุณ

ลงทะเบียนที่ app.bugagent.com และสร้างคีย์ API จากคอนโซล

กำหนดค่าไคลเอนต์ AI ของคุณ

เพิ่ม bug_Agent_ เป็นเซิร์ฟเวอร์ MCP ในการกำหนดค่าของไคลเอนต์ (ดูการตั้งค่าด้านล่าง)

เริ่มบันทึกบั๊ก

อธิบายบั๊กด้วยภาษาธรรมชาติ แล้ว bug_Agent_ จะจำแนกประเภท เพิ่มข้อมูล และจัดเก็บให้โดยอัตโนมัติ

ตัวอย่างสั้นๆ

# 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

การตั้งค่า

ติดตั้ง

ไม่จำเป็นต้องติดตั้งแบบโกลบอล ใช้ npx เพื่อรันเซิร์ฟเวอร์ MCP เมื่อต้องการ:

npx @bugagent/mcp-server

กำหนดค่าคีย์ API ของคุณ

เมื่อคุณเชื่อมต่อครั้งแรก bug_Agent_ จะขอให้คุณป้อนคีย์ API คุณยังสามารถตั้งค่าผ่านตัวแปรสภาพแวดล้อมได้:

export BUGAGENT_API_KEY=ba_live_your_key_here

รับคีย์ API ของคุณจากคอนโซล bug_Agent_

การกำหนดค่าไคลเอนต์ MCP

เพิ่มสิ่งต่อไปนี้ลงในไฟล์กำหนดค่าของไคลเอนต์ MCP ของคุณ:

mcp.json

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

💡

แทนที่ ba_live_your_key_here ด้วยคีย์ API จริงของคุณจากคอนโซล

เชื่อมต่อกับเซิร์ฟเวอร์

เซิร์ฟเวอร์ MCP ของ bug_Agent_ พร้อมใช้งานที่ https://mcp.bugagent.com/mcp ผ่านการขนส่งแบบ Streamable HTTP เชื่อมต่อจากไคลเอนต์ทั้งแปดตัวด้านล่าง — เลือกตัวที่เหมาะกับขั้นตอนการทำงานของคุณ

🔑

รับคีย์ API ของคุณก่อน ลงชื่อเข้าใช้ app.bugagent.com/dashboard/settings/api-keys คลิก Create API Key และคัดลอกค่า (ขึ้นต้นด้วย ba_live_) คุณจะเห็นเพียงครั้งเดียว ดังนั้นให้วางไว้ในที่ปลอดภัย ทุกตัวอย่างด้านล่างใช้คีย์นี้

ตัวเลือก 1 — MCP Inspector (Web UI, แนะนำสำหรับการทดสอบครั้งแรก)

เครื่องมืออย่างเป็นทางการของ Anthropic เปิด UI บนเว็บภายในเครื่องที่คุณสามารถคลิกดูทุกเครื่องมือ กรอกพารามิเตอร์ และดูการตอบสนอง ไม่ต้องกำหนดค่าใดๆ ไม่ต้องใช้ IDE

macOS (Terminal)

Terminal

npx @modelcontextprotocol/inspector

Windows (PowerShell หรือ CMD)

PowerShell

ใน UI ของเบราว์เซอร์ที่เปิดขึ้น:

Transport Type: เลือก Streamable HTTP
URL: https://mcp.bugagent.com/mcp
Connection Type: เลือก Proxy (ค่าเริ่มต้น — Inspector จะพร็อกซีผ่านกระบวนการ Node ภายในเครื่องเพื่อเลี่ยง CORS ของเบราว์เซอร์)
คลิกแท็บ Authentication → เพิ่มส่วนหัวที่กำหนดเอง:
- Header Name: Authorization
- Value: Bearer ba_live_YOUR_KEY_HERE
คลิก Connect คุณจะเห็นเครื่องมือ bug_Agent_ ทั้งหมดกว่า 60 รายการในแผงด้านซ้าย
คลิกเครื่องมือใดๆ (เช่น list_bug_reports) กรอกพารามิเตอร์ คลิก Run Tool การตอบสนองจะแสดงทางด้านขวา

ข้อกำหนดเบื้องต้น: Node.js 18 ขึ้นไป ติดตั้งจาก nodejs.org หากคุณยังไม่มี

ตัวเลือก 2 — Claude Desktop (Mac + Windows)

หากคุณใช้แอป Claude Desktop คุณสามารถเพิ่ม bug_Agent_ เป็นเซิร์ฟเวอร์ MCP แบบถาวรได้ Claude จะมีเครื่องมือ bug_Agent_ ทั้งหมดพร้อมใช้งานในทุกการสนทนา

macOS

เปิด Claude Desktop → แถบเมนู Claude → Settings → Developer → Edit Config การดำเนินการนี้จะเปิด ~/Library/Application Support/Claude/claude_desktop_config.json
เพิ่มรายการ bug_Agent_ ภายใต้ mcpServers:
claude_desktop_config.json

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

บันทึกไฟล์และ ออกจาก Claude Desktop โดยสมบูรณ์ (Cmd+Q ไม่ใช่แค่ปิดหน้าต่าง)
เปิด Claude Desktop ใหม่ ไอคอนค้อนเครื่องมือที่ด้านล่างของช่องป้อนข้อมูลแชทควรแสดงเครื่องมือ bug_Agent_
ลองใช้: พิมพ์ “List my 5 most recent bug reports” — Claude จะเรียก list_bug_reports โดยอัตโนมัติ

Windows

เปิด Claude Desktop → File → Settings → Developer → Edit Config การดำเนินการนี้จะเปิด %APPDATA%\Claude\claude_desktop_config.json (โดยทั่วไปคือ C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json)
เพิ่มบล็อก JSON เดียวกันกับที่แสดงในส่วน macOS
บันทึกไฟล์และ ออกจาก Claude Desktop โดยสมบูรณ์ จากถาดระบบ (คลิกขวาที่ไอคอน Claude → Quit) จากนั้นเปิดใหม่
ไอคอนค้อนเครื่องมือจะแสดงเครื่องมือ bug_Agent_

ตัวเลือก 3 — Claude Code (CLI)

หากคุณใช้ Claude Code จากเทอร์มินัล (เวอร์ชัน CLI ของ Claude) ให้ลงทะเบียนเซิร์ฟเวอร์ bug_Agent_ ด้วยคำสั่งเดียว ทำงานเหมือนกันบน macOS, Linux และ Windows

Terminal / PowerShell

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

จากนั้นรีสตาร์ทเซสชัน Claude Code ของคุณ ตรวจสอบว่าเชื่อมต่อแล้ว:

claude mcp list

คุณควรเห็น bugagent ในรายการพร้อมจุดสีเขียว เริ่มใช้เครื่องมือในการแชทใดๆ: “Show me my exploration usage for this month.”

หากต้องการลบออกในภายหลัง:

claude mcp remove bugagent

ตัวเลือก 4 — OpenAI Codex CLI

หากคุณใช้ OpenAI Codex CLI ให้เพิ่ม bug_Agent_ ลงใน ~/.codex/config.toml เพื่อการลงทะเบียนถาวร หรือส่งการกำหนดค่าแบบอินไลน์สำหรับเซสชันครั้งเดียว

การลงทะเบียนถาวร (เพิ่มในการกำหนดค่า)

~/.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"

อินไลน์ — หนึ่งเซสชัน

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 แก้ไขการเรียกเครื่องมือโดยอัตโนมัติจากพรอมต์ภาษาธรรมชาติของคุณ ลอง: “List my open bugs sorted by severity.”

ตัวเลือก 5 — Cursor (Mac + Windows)

Cursor มีการสนับสนุน MCP ในตัว เพิ่ม bug_Agent_ ครั้งเดียว แล้วผู้ช่วย AI ภายใน Cursor จะสามารถบันทึกบั๊ก แสดงรายงาน รันการสแกน ฯลฯ ได้โดยไม่ต้องออกจากเอดิเตอร์

เปิด Cursor → Settings (Cmd+, บน Mac / Ctrl+, บน Windows) → MCP ในแถบด้านข้างซ้าย
คลิก + Add new MCP server
เลือกประเภทการขนส่ง HTTP
กรอกข้อมูล:
- Name: bugagent
- URL: https://mcp.bugagent.com/mcp
- Header name: Authorization
- Header value: Bearer ba_live_YOUR_KEY_HERE
คลิก Save Cursor จะแสดงตัวบ่งชี้สีเขียวเมื่อเชื่อมต่อแล้ว
เปิดแชทของ Cursor (Cmd+L / Ctrl+L) แล้วพิมพ์ “Create a bug report titled ‘Login broken’ with severity high.” Cursor จะเรียกใช้ create_bug_report

ทางเลือก: Cursor ยังอ่าน ~/.cursor/mcp.json (Mac) หรือ %USERPROFILE%\.cursor\mcp.json (Windows) เพิ่มรูปแบบ JSON เดียวกันกับที่แสดงในส่วน Claude Desktop

ตัวเลือก 6 — VS Code พร้อมส่วนขยาย Continue (Mac + Windows)

หากคุณต้องการ VS Code ส่วนขยาย Continue รองรับเซิร์ฟเวอร์ MCP โดยกำเนิด

ติดตั้งส่วนขยาย Continue จาก marketplace ของ VS Code
เปิดการกำหนดค่าของ Continue: Command Palette (Cmd+Shift+P / Ctrl+Shift+P) → Continue: Open config.json ไฟล์อยู่ที่:
- macOS: ~/.continue/config.json
- Windows: %USERPROFILE%\.continue\config.json
เพิ่มรายการ 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"  
        }  
      }  
    }  
  ]  
}

บันทึก Continue จะโหลดซ้ำโดยอัตโนมัติและแสดงเครื่องมือ bug_Agent_ ในแถบด้านข้าง
เปิดแผงแชท Continue แล้วลอง: “List my security scans.”

ส่วนขยาย VS Code อื่นๆ ที่รองรับ MCP: Cline, Roo Code และ Windsurf (fork) ทั้งหมดใช้รูปแบบการกำหนดค่า JSON ที่คล้ายกันกับคีย์ mcpServers และการขนส่ง HTTP

ตัวเลือก 7 — โฮสต์ที่รับรู้ OAuth (แสดง Claude.ai web เป็นตัวอย่าง)

โฮสต์ MCP บางตัวตรวจสอบสิทธิ์ผ่าน OAuth 2.0 และขอ client_id และ client_secret แบบคงที่ล่วงหน้า แทนที่จะยอมรับคีย์ API แบบ bearer สำหรับโฮสต์เหล่านั้น คุณต้องสร้างคู่ข้อมูลรับรอง OAuth ที่กำหนดขอบเขตพื้นที่ทำงานจากแดชบอร์ด bug_Agent_ และวางลงในฟอร์มตัวเชื่อมต่อของโฮสต์ ข้อมูลรับรองไม่ขึ้นอยู่กับโฮสต์ MCP — ไคลเอนต์ OAuth ใดๆ ที่รองรับ Authorization Code + PKCE สามารถใช้ได้ คำแนะนำด้านล่างใช้แอปเว็บ Claude.ai เป็นตัวอย่างที่พบบ่อยที่สุด

ใน bug_Agent_: เปิด Settings → Developers → MCP Connectors คลิก Generate connector ตั้งชื่อที่อธิบายโฮสต์ (เช่น “Claude.ai (work)”) วาง redirect URI ที่โฮสต์ MCP ของคุณต้องการ (สำหรับแอปเว็บ Claude.ai คือ https://claude.ai/api/mcp/auth_callback — ตรวจสอบเอกสารตัวเชื่อมต่อของโฮสต์ของคุณสำหรับอื่นๆ) และเลือก Confidential สำหรับวิธีการตรวจสอบสิทธิ์ คัดลอก client_id และ client_secret ที่แสดงครั้งเดียวบนหน้าจอความสำเร็จ
ในการตั้งค่าตัวเชื่อมต่อ / OAuth ของโฮสต์ MCP ของคุณ ให้วาง:
- Server URL: https://mcp.bugagent.com/mcp
- Client ID + Client Secret: จากขั้นตอนที่ 1
- Authorization URL: https://mcp.bugagent.com/authorize
- Token URL: https://mcp.bugagent.com/token
  สำหรับ Claude.ai โดยเฉพาะ: ไปที่ claude.ai/customize/connectors แล้วคลิก Add MCP connector
บันทึก โฮสต์จะเปลี่ยนเส้นทางคุณไปยัง bug_Agent_ เพื่อลงชื่อเข้าใช้ (Google หรืออีเมล/รหัสผ่าน — วิธีการใดก็ตามที่คุณใช้สำหรับแดชบอร์ด) และอนุมัติการยินยอม จากนั้นจึงเสร็จสิ้นการจับมือ OAuth
จัดการและเพิกถอนตัวเชื่อมต่อที่สร้างขึ้นจากหน้าการตั้งค่าเดียวกัน การเพิกถอนมีผลทันที — คำขอถัดไปจากตัวเชื่อมต่อนั้นจะส่งกลับ invalid_client

หมายเหตุ: Claude Code, Cursor, VS Code และ MCP Inspector ไม่จำเป็นต้องใช้ขั้นตอนนี้ — พวกเขาจัดการการลงทะเบียนไคลเอนต์แบบไดนามิก (RFC 7591) โดยอัตโนมัติและตรวจสอบสิทธิ์ผ่านคีย์ API ตามที่แสดงไว้ข้างต้น ฟอร์ม MCP Connectors มีไว้สำหรับโฮสต์ที่ต้องการข้อมูลรับรอง OAuth แบบคงที่เท่านั้น

ตัวเลือก 8 — HTTP โดยตรงด้วย curl (Terminal)

หากคุณต้องการทดสอบเซิร์ฟเวอร์โดยตรงโดยไม่มีไคลเอนต์ใดๆ หรือรวมเข้ากับสคริปต์ คุณสามารถเข้าถึงปลายทาง HTTP ด้วย curl โปรโตคอล MCP คือ JSON-RPC 2.0 ผ่าน 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

การตอบสนองมาถึงในรูปแบบ Server-Sent Events (มาตรฐาน MCP Streamable HTTP) แต่ละส่วนเป็นบรรทัดที่ขึ้นต้นด้วย data: ตามด้วยอ็อบเจกต์ JSON ส่วนหัว Accept: application/json, text/event-stream จำเป็น — เซิร์ฟเวอร์จะปฏิเสธคำขอที่ไม่มีส่วนหัวนี้

ℹ️

การแก้ไขปัญหา 401 Unauthorized: ตรวจสอบว่าคีย์ API ของคุณไม่ได้ถูกเพิกถอนใน Settings → API Keys คีย์ขึ้นต้นด้วย ba_live_ หากยังติดขัด ให้สร้างคีย์ใหม่แล้วลองอีกครั้ง

ลองใช้ — พรอมต์ภาษาอังกฤษล้วน

เมื่อเชื่อมต่อแล้ว คุณไม่จำเป็นต้องรู้ชื่อเครื่องมือหรือพารามิเตอร์ อธิบายสิ่งที่คุณต้องการเป็นภาษาอังกฤษล้วน แล้วผู้ช่วย AI ของคุณจะเรียกเครื่องมือ bug_Agent_ ที่ถูกต้องโดยอัตโนมัติ

รายงานบั๊ก

ถามผู้ช่วย AI ของคุณ

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

การจัดการการทดสอบ

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

ความปลอดภัยและประสิทธิภาพ

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?

ระบบอัตโนมัติ 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 เชิงสำรวจ

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?

การใช้งานและสถิติ

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?

ข้อมูลอ้างอิงด่วน

ตำแหน่งไฟล์กำหนดค่าสำหรับไคลเอนต์ทั้งแปดตัว ไคลเอนต์ทุกตัวเชื่อมต่อกับ https://mcp.bugagent.com/mcp ด้วยส่วนหัว Authorization: Bearer ba_live_YOUR_KEY_HERE ผ่าน Streamable HTTP

ไคลเอนต์ ตำแหน่งการกำหนดค่า / คำสั่ง

MCP Inspector ไม่มีไฟล์ — ป้อน URL + ส่วนหัวการตรวจสอบสิทธิ์ใน UI ของเบราว์เซอร์หลังจาก 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 Settings → MCP UI หรือ ~/.cursor/mcp.json

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

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

HTTP โดยตรง (curl) curl / Invoke-RestMethod — รวม Accept: application/json, text/event-stream

การแก้ไขปัญหา

อาการ วิธีแก้ไข

401 Unauthorized คีย์ผิด หมดอายุ หรือถูกเพิกถอน ตรวจสอบ Settings → API Keys — คีย์ขึ้นต้นด้วย ba_live_ สร้างใหม่หากจำเป็น

ไม่เห็นเครื่องมือในไคลเอนต์ ออกจากไคลเอนต์โดยสมบูรณ์แล้วเปิดใหม่หลังจากแก้ไขการกำหนดค่า ใน Claude Desktop ให้ใช้ Cmd+Q (ไม่ใช่แค่ปิดหน้าต่าง) ใน Cursor ให้ตรวจสอบ Settings → MCP เพื่อหาจุดสีเขียว

Accept header required การเรียก HTTP โดยตรงต้องรวม Accept: application/json, text/event-stream — ข้อกำหนด Streamable HTTP ต้องการส่วนหัวนี้ เซิร์ฟเวอร์ส่งกลับ 406 หากไม่มี

ข้อมูลพื้นที่ทำงานผิด คีย์ API แต่ละตัวมีขอบเขตจำกัดอยู่ที่พื้นที่ทำงานเดียว สร้างคีย์ใหม่จากพื้นที่ทำงานที่คุณต้องการสืบค้นใน Settings → API Keys

เครื่องมือปรากฏขึ้นแต่การเรียกใช้ล้มเหลวอย่างเงียบๆ ยืนยันว่าเซิร์ฟเวอร์สามารถเข้าถึงได้: curl -I https://mcp.bugagent.com/health ควรส่งกลับ 200 หากหมดเวลา ให้ตรวจสอบกฎเครือข่าย/ไฟร์วอลล์

ข้อผิดพลาด CORS ของ MCP Inspector เลือก Proxy (ไม่ใช่ Direct) สำหรับ Connection Type ใน UI ของ Inspector Inspector พร็อกซีผ่านกระบวนการ Node ภายในเครื่องเพื่อเลี่ยงข้อจำกัด CORS ของเบราว์เซอร์

Codex CLI — ไม่รู้จักเครื่องมือ ตรวจสอบว่า ~/.codex/config.toml ใช้ [[mcp_servers]] (วงเล็บคู่ ไวยากรณ์อาร์เรย์) ตรวจสอบว่าเวอร์ชัน Codex CLI ใหม่พอที่จะรองรับ MCP (codex --version)

ฟีเจอร์ MCP

เซิร์ฟเวอร์ MCP ของ bug_Agent_ มีเครื่องมือสำหรับ:

🐛

การจัดการรายงานบั๊ก

create_bug_report — ยื่นรายงานใหม่พร้อมการจัดประเภทอัตโนมัติ 19 ประเภท — บั๊ก, คำขอฟีเจอร์, การปรับปรุง, หนี้ทางเทคนิค และอื่นๆ (ชื่อเรื่อง: 3-500 ตัวอักษร) อาร์เรย์ attachments ที่เป็นทางเลือกยอมรับไฟล์ที่เข้ารหัส base64 สูงสุดไฟล์ละ 400 MB: รูปภาพ, วิดีโอ, เสียง, PDF หรือข้อความ/JSON ใดๆ ตั้งค่า format_description: true เพื่อจัดรูปแบบคำอธิบายใหม่เป็นเทมเพลตที่มีโครงสร้างโดยอัตโนมัติโดยใช้ AI ส่ง time_spent_seconds เพื่อติดตามความพยายามด้าน QA ส่ง priority (urgent / high / normal / low) เพื่อกำหนดความเร่งด่วนในการแก้ไขโดยอิสระจากความรุนแรง การตอบกลับประกอบด้วย project_id, project, short_id, legacy_short_id และ project_short_id
list_bug_reports — แสดงรายการและกรองรายงาน (สูงสุด 100 รายการต่อหน้า) ตัวกรองโปรเจกต์ถูกนำไปใช้ฝั่งเซิร์ฟเวอร์ก่อนการแบ่งหน้า กรองตาม project (UUID, slug, ชื่อที่ตรงกันทุกประการ หรือคำนำหน้าตั๋ว), project_id, project_slug, project_prefix, workspace (UUID, ชื่อที่ตรงกันทุกประการ หรือคำนำหน้าตั๋วของพื้นที่ทำงาน), workspace_id/team_id, type (หนึ่งใน 19 หมวดหมู่แดชบอร์ด), severity (s1-s4 หรือ critical/high/medium/low แบบดั้งเดิม), status (ใช้ค่าที่ตรงกันทุกประการจากแดชบอร์ด: new, awaiting-triage, confirmed, in-progress, blocked, resolved, retesting, closed, reopened — เครื่องหมายขีดกลางมีเจตนา), resolution (fixed / duplicate / works-as-designed / cannot-reproduce / will-not-fix / need-more-info / unresolved), root_cause (แท็ก kebab-case แบบปลายเปิด — ค่าทั่วไป: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch) หรือ reporter_user_id (UUID ของสมาชิกในทีมที่ยื่นรายงาน — เรียก list_team_members ก่อนเพื่อแปลงชื่อเป็น UUID) แต่ละผลลัพธ์ประกอบด้วย reporter_user_id, project_id, project, short_id, legacy_short_id และ project_short_id เพื่อให้เอเจนต์สามารถลิงก์และอัปเดตรายงานที่กำหนดขอบเขตโปรเจกต์ได้อย่างถูกต้อง
pick_next_bug — ส่งคืนบั๊กถัดไปที่ลูปเอเจนต์ควรดำเนินการ ตามลำดับความสำคัญ (S1 → S2 → S3, เก่าที่สุดก่อนในแต่ละกลุ่ม) กำหนดขอบเขตไปยังพื้นที่ทำงานของคุณโดยอัตโนมัติ — ส่งคืนตั๋วจากทุกโปรเจกต์ในทีมของคุณที่มี status new, awaiting-triage หรือ confirmed และความรุนแรง S1-S3. อ่านอย่างเดียว — ไม่ได้อ้างสิทธิ์ตั๋วแบบอะตอมมิก severity ที่เป็นทางเลือก (ระดับเดียว), limit (1-50, ค่าเริ่มต้น 1) ส่งคืนแถวในรูปแบบเดียวกับ list_bug_reports เพื่อความสามารถในการประกอบเครื่องมือ จับคู่กับ claim_bug สำหรับรูปแบบอ่านแล้วอ้างสิทธิ์
claim_bug — เปลี่ยนสถานะบั๊กจาก status new, awaiting-triage หรือ confirmed ไปเป็น status='in-progress' แบบอะตอมมิก, ตั้งค่า assigned_to เป็นผู้ใช้ที่เรียก และประทับตรา claimed_at=NOW() ปราศจาก race condition ระหว่างผู้เรียกพร้อมกันผ่านรูปแบบ UPDATE-WHERE-RETURNING ของ Postgres — หากเอเจนต์สองตัวเรียก claim_bug บน id เดียวกันในเวลาที่ใกล้เคียงกัน จะมีเพียงหนึ่งตัวที่ได้รับ claimed:true พร้อมเนื้อหาบั๊ก และอีกตัวได้รับ claimed:false พร้อมสตริงเหตุผล ตัวเก็บกวาด pg_cron จะปล่อยการอ้างสิทธิ์ที่ค้าง (สถานะ=in-progress + claimed_at > 30 นาที) กลับไปเป็น new โดยอัตโนมัติ ดังนั้นตั๋วของเอเจนต์ที่หยุดทำงานจะกลับเข้าสู่คิวโดยไม่ต้องดำเนินการด้วยตนเอง อินพุต: id (UUID หรือ short ID)
get_bug_report — รับรายละเอียดทั้งหมดของรายงานตาม ID รูปแบบ ID: ยอมรับ UUID (เช่น 1fb72a2c-87c7-...), short ID ที่กำหนดขอบเขตพื้นที่ทำงาน (เช่น WRKID-545) หรือ short ID ที่กำหนดขอบเขตโปรเจกต์ (เช่น WRKID-APP-042) การค้นหาด้วย short ID ถูกกำหนดขอบเขตทีม — การเดา short ID ของพื้นที่ทำงานอื่นจะส่งกลับ 404 ส่งคืน project_id, project, short_id, legacy_short_id, project_short_id, ticket_number, project_ticket_number, qualityScore (จำนวนเต็ม 1–10) และ qualityBreakdown (ออบเจ็กต์ที่มีคะแนน 10 มิติ: reproductionSteps, expectedVsActual, environmentDetails, evidence, rootCauseAnalysis, impactAssessment, contextAndHistory, heuristicsAndOracles, clarityAndStructure, actionability — แต่ละค่า 0.0–1.0)
update_bug_report — อัปเดตฟิลด์ในรายงานที่มีอยู่ ยอมรับ UUID หรือ short ID (WRKID-545) ฟิลด์ที่อัปเดตได้รวมถึง title, description, type (หนึ่งใน 19 หมวดหมู่แดชบอร์ด), severity, priority (urgent / high / normal / low — ความเร่งด่วนในการแก้ไข, เป็นอิสระจากความรุนแรง), status (ตรงกับแดชบอร์ดทุกประการ: new, awaiting-triage, confirmed, in-progress, blocked, resolved, retesting, closed, reopened — เครื่องหมายขีดกลางมีเจตนา), resolution (fixed / duplicate / works-as-designed / cannot-reproduce / will-not-fix / need-more-info / unresolved) และ root_cause (แท็ก kebab-case แบบปลายเปิด — ค่าทั่วไป: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch) แบบแผนของลูปเอเจนต์กำหนดให้ต้องตั้งค่าทั้ง resolution และ root_cause เมื่อใดก็ตามที่ status เปลี่ยนสถานะออกจาก new; แดชบอร์ด, การวิเคราะห์ และคลังข้อมูลการฝึก claude-bot ในอนาคตล้วนขึ้นอยู่กับฟิลด์เหล่านั้น รวมถึง assigned_to (รหัสผู้ใช้จาก list_team_members) และ time_spent_seconds สำหรับการติดตามเวลา การเปลี่ยน assigned_to จะทริกเกอร์การแจ้งเตือนแบบกระดิ่งในแอปและอีเมลแจ้งเตือนไปยังผู้รับมอบหมายใหม่โดยอัตโนมัติ (เคารพการยกเลิกการรับต่อผู้ใช้ในการตั้งค่าบัญชี — ไปป์ไลน์เดียวกับเอนด์พอยต์แดชบอร์ด)
add_comment — เพิ่มความคิดเห็นในรายงานบั๊ก (UUID หรือ short ID, เนื้อหา 1-10000 ตัวอักษร) หากรายงานซิงค์กับ Jira ความคิดเห็นจะถูกพุชไปยังอีสชู Jira ที่ลิงก์ไว้โดยอัตโนมัติ
list_comments — แสดงรายการเธรดความคิดเห็นทั้งหมดของรายงาน, เก่าที่สุดก่อน — แต่ละความคิดเห็นมีชื่อผู้เขียน, parentId (การตอบกลับแบบเธรด) และการประทับเวลา ความคิดเห็นไม่ได้เป็นส่วนหนึ่งของ get_bug_report ดังนั้นนี่คือวิธีที่คุณอ่านการสนทนาของตั๋ว ยอมรับ UUID หรือ short ID
link_bug_reports — สร้างลิงก์เชิงความหมายแบบมีทิศทางระหว่างรายงานบั๊กสองรายการในพื้นที่ทำงานเดียวกัน link_type เป็นหนึ่งใน duplicate-of, parent-of, related-to หรือ depends-on มุมมองผกผัน (duplicated-by / subtask-of / blocks) ถูกสร้างขึ้น ณ เวลาอ่าน — ต้องเก็บเพียงหนึ่งแถวเท่านั้น ทั้ง from_report_id และ to_report_id ยอมรับ UUID หรือ short ID (WRKID-545)
unlink_bug_reports — ลบลิงก์รายงานบั๊กที่สร้างไว้ก่อนหน้านี้ด้วย UUID (link_id, ส่งคืนโดย link_bug_reports หรือ list_bug_report_links)
list_bug_report_links — แสดงรายการลิงก์ที่ผู้ใช้คัดสรรทั้งหมดที่เกี่ยวข้องกับรายงานบั๊ก ส่งคืนแต่ละลิงก์ตามที่อ่านจากมุมมองของรายงานที่ให้มา — เช่น แถว duplicate-of ที่เก็บไว้ซึ่งรายงานนี้เป็นเป้าหมายแสดงผลเป็น duplicated-by; parent-of ซึ่งรายงานนี้เป็นเป้าหมายแสดงผลเป็น subtask-of; depends-on ซึ่งรายงานนี้เป็นเป้าหมายแสดงผลเป็น blocks related-to เป็นแบบสมมาตร เติมเต็มฟิลด์ similar_reports ที่ตรวจพบอัตโนมัติซึ่งส่งคืนโดย get_bug_report
classify_bug — จัดประเภทคำอธิบายเป็นหนึ่งใน 19 ประเภทรายงาน (บั๊ก, ฟีเจอร์, การปรับปรุง ฯลฯ) พร้อมคะแนนความเชื่อมั่น
flush_reports — ลบรายงานเก่าจำนวนมาก (ผู้ดูแลระบบเท่านั้น)

📊

การใช้งาน & การวิเคราะห์

get_usage — ตรวจสอบการใช้งานเทียบกับขีดจำกัดของแผน
get_stats — จำนวนรายวัน, การแจกแจงตามประเภท/ความรุนแรง/สถานะ

📁

การจัดการโปรเจกต์

list_projects — แสดงรายการโปรเจกต์ที่มีอยู่พร้อม id, name, slug, ticket_prefix, คำอธิบาย และสถานะเริ่มต้น ใช้ค่าเหล่านั้นกับ create_bug_report และ list_bug_reports เพื่อกำหนดเป้าหมายโปรเจกต์ที่ถูกต้อง
create_project — สร้างโปรเจกต์ใหม่ (กลายเป็นค่าเริ่มต้นโดยอัตโนมัติหากเป็นโปรเจกต์แรก)
delete_project — ลบโปรเจกต์และข้อมูลที่เกี่ยวข้องทั้งหมดอย่างถาวร (รายงานบั๊ก, ระบบอัตโนมัติ, กรณีทดสอบ, แอปมือถือ, ตารางเวลา, ภาพรวมทางภูมิศาสตร์, บันทึก, รายการเวลา) เฉพาะเจ้าของ/ผู้จัดการ ไม่สามารถลบโปรเจกต์สุดท้ายได้ พื้นที่จัดเก็บข้อมูลถูกปล่อยโดยอัตโนมัติ
export_okf_bundle — ส่งออกความรู้ QA ของโปรเจกต์ — รายงานบั๊ก, กรณีทดสอบ, ระบบอัตโนมัติ และการทดสอบประสิทธิภาพ, ความปลอดภัย และเชิงสำรวจ — เป็นบันเดิลมาร์กดาวน์ OKF/OQA (รูปแบบ Open Query Agent ที่ใช้โดย oqa.ai) ค่าเริ่มต้นเป็นโปรเจกต์ที่ใช้งานอยู่; ส่ง project ที่เป็นทางเลือก (slug หรือชื่อ) เพื่อส่งออกโปรเจกต์อื่น ส่งคืนรายการไฟล์ในบันเดิลพร้อมกับตัวบันเดิลเองเป็น zip ที่เข้ารหัส base64

🔐

การรับรองความถูกต้อง & บัญชี

register_account — สร้างบัญชีใหม่ (รหัสผ่าน: 8-128 ตัวอักษร, จำกัดอัตรา: 5/15นาที)
login — ลงชื่อเข้าใช้และรับโทเค็นการเข้าถึง (จำกัดอัตรา: 5/15นาที)
update_profile — อัปเดตชื่อที่แสดง
change_password — เปลี่ยนรหัสผ่านบัญชี
get_settings / update_settings — จัดการการตั้งค่า

🔑

การจัดการคีย์ API

generate_api_key — สร้างคีย์ API ที่มีชื่อ
list_api_keys — แสดงรายการคีย์ที่ใช้งานอยู่ (เฉพาะคำนำหน้า)
regenerate_api_key — เพิกถอนและแทนที่คีย์
delete_api_key — เพิกถอนคีย์อย่างถาวร

👥

การจัดการทีม

list_team_members — แสดงรายการสมาชิกทั้งหมดในพื้นที่ทำงานของคุณพร้อมบทบาท, สถานะ และแฟล็กบูสเตอร์
invite_team_member — เชิญผู้ใช้ทางอีเมล (ผู้จัดการสามารถเชิญผู้ร่วมให้ข้อมูลและผู้จัดการ; เฉพาะเจ้าของเท่านั้นที่สามารถเชิญผู้ดูแลระบบ) ลิงก์หมดอายุ 5 วัน

🎯

การผสานรวม

sync_to_jira — ซิงค์รายงานไปยัง Jira โดยใช้การเชื่อมต่อที่แชร์ของทีม
push_to_claude — สร้าง (หรือสร้างใหม่) บันทึกนักพัฒนา สำหรับรายงานบั๊ก — สาเหตุหลัก, การแก้ไขที่แนะนำ, ขั้นตอนการตรวจสอบ และการประเมินความเสี่ยง ยอมรับ UUID หรือ short ID (WRKID-545) ใช้คีย์แพลตฟอร์ม — ไม่จำเป็นต้องเชื่อมต่อ Claude ต่อทีม รันเชนแบบปรับตัว: สามขั้นตอน สำหรับบั๊ก s3/medium หรือ s4/low (ร่าง Sonnet → วิจารณ์โดย OpenAI gpt-5 → สังเคราะห์ Sonnet), ห้าขั้นตอน สำหรับกลุ่มความรุนแรงสองอันดับแรก — s1/critical หรือ s2/high — (ร่าง → วิจารณ์ → โต้แย้ง Sonnet → ผู้ตัดสิน Claude Opus ที่อ่านบันทึกการสนทนาทั้งหมดและเขียนบันทึกสุดท้ายด้วยวิจารณญาณอิสระ) การตอบกลับเปิดเผยทุกรอบ: analysis, draft, critique, rebuttal, challenger_model, adjudicator_model และแฟล็ก debated ขั้นตอนใดๆ ที่ล้มเหลวจะถอยกลับไปยังคำตอบที่ดีที่สุดถัดไป ทำงานอัตโนมัติเมื่อสร้างบั๊ก; โดยปกติจะเรียกใช้สำหรับการสร้างใหม่ด้วยตนเองเท่านั้น
analyze_fix_area — สร้าง (หรือสร้างใหม่) บล็อกย่อย "พื้นที่ที่น่าจะแก้ไข" ของบันทึกนักพัฒนา — ผลลัพธ์ Sonnet แบบแคบที่ระบุว่าการแก้ไขน่าจะอยู่ในส่วนใดของโค้ดเบส ยอมรับ UUID หรือ short ID ใช้คีย์ Anthropic ของแพลตฟอร์ม เมื่อทีมมีแถว github_connections และโปรเจกต์มีการแมป github_repo ผลลัพธ์จะอิงจากตัวอย่างไฟล์จริงจากรีโปที่เชื่อมต่อ; มิฉะนั้นจะถอยกลับไปเป็นคำแนะนำทั่วไปพร้อมคำแนะนำให้เชื่อมต่อรีโป ส่งคืนข้อความ likely_fix_area, generated_at, repo_used และแฟล็ก grounded ทำงานอัตโนมัติเมื่อสร้างบั๊ก — โดยปกติเอเจนต์จำเป็นต้องเรียกใช้สำหรับการสร้างใหม่ด้วยตนเองเท่านั้น
upgrade_plan — อัปเกรดการสมัครสมาชิกผ่าน Stripe

⚡

การทดสอบประสิทธิภาพ* `create_performance_test` — สร้างการกำหนดค่าการทดสอบประสิทธิภาพด้วย URL, อุปกรณ์, ผู้ใช้เสมือน, ระยะเวลา, เกณฑ์คะแนน และตัวเลือกการสร้างบั๊กอัตโนมัติ สำหรับ Enterprise เท่านั้น

run_performance_test — เรียกใช้การตรวจสอบหน้าเว็บและการทดสอบโหลดสำหรับการทดสอบประสิทธิภาพเว็บ ส่งคืนรัน ID เพื่อใช้สอบถามผลลัพธ์ การรันโปรไฟล์แอปมือถือเริ่มจากแดชบอร์ด
get_performance_results — รับผลลัพธ์ทั้งหมดรวมถึงคะแนน Lighthouse (ประสิทธิภาพ, การเข้าถึง, แนวปฏิบัติที่ดีที่สุด, SEO), Core Web Vitals (LCP, FID, CLS, FCP, TTFB, INP, TBT, SI) และเมตริกการทดสอบโหลด (VUs, คำขอ, RPS, ความหน่วง p50/p90/p95/p99)
list_performance_tests — แสดงรายการการกำหนดค่าการทดสอบประสิทธิภาพทั้งหมดสำหรับทีมปัจจุบัน
get_performance_usage — ตรวจสอบการใช้งานการทดสอบประสิทธิภาพรายเดือน การทดสอบประสิทธิภาพสำหรับ Enterprise เท่านั้น Free=0, Enterprise=ไม่จำกัด

ตัวอย่างขั้นตอนการทำงาน

get_performance_usage → ตรวจสอบโควต้าที่เหลือ
create_performance_test → กำหนดค่าการทดสอบสำหรับ URL ของคุณ
run_performance_test → เรียกใช้การตรวจสอบ + การทดสอบโหลด
get_performance_results → ตรวจสอบคะแนนและ vitals

🛡

การสแกนความปลอดภัย

create_security_scan — สร้างการกำหนดค่าการสแกนความปลอดภัย การสแกนเว็บใช้ Quick Scanner + Nuclei (เทมเพลตมากกว่า 4,000 รายการ) พร้อมระดับความลึกสามระดับและการสแกนแบบรับรองตัวตนเสริม การสแกนมือถือใช้ MobSF สำหรับการวิเคราะห์ไบนารี APK/IPA การสร้างบั๊กอัตโนมัติที่กำหนดค่าได้พร้อมเกณฑ์ความรุนแรง สำหรับ Enterprise เท่านั้น
run_security_scan — เรียกใช้การสแกนช่องโหว่ การสแกนเว็บต้องมีการยืนยันโดเมน DNS การสแกนมือถือต้องอัปโหลดแอป ส่งคืนรัน ID เพื่อใช้สอบถามผลลัพธ์
get_security_results — รับผลลัพธ์ทั้งหมดรวมถึงคะแนนความปลอดภัย (0-100), การค้นพบที่จัดหมวดหมู่ตามความรุนแรง (วิกฤต, สูง, ปานกลาง, ต่ำ, ข้อมูล) พร้อมการอ้างอิง CWE, การแมป OWASP, หลักฐาน และคำแนะนำในการแก้ไข
list_security_scans — แสดงรายการการกำหนดค่าการสแกนความปลอดภัยทั้งหมดสำหรับทีมปัจจุบันพร้อมคะแนนล่าสุดและป้าย auth/depth
get_security_usage — ตรวจสอบการใช้งานการสแกนความปลอดภัยรายเดือน การสแกนความปลอดภัยสำหรับ Enterprise เท่านั้น Enterprise=ไม่จำกัด
list_security_schedules — แสดงรายการการสแกนความปลอดภัยที่กำหนดเวลาไว้ทั้งหมดสำหรับทีมพร้อม cron, เขตเวลา, สถานะเปิดใช้งาน, การรันครั้งถัดไป และการตั้งค่าการแจ้งเตือน เชื่อมโยงกับการกำหนดค่าการสแกนหลัก (ชื่อ, scan_type, target_url)
create_security_schedule — สร้างกำหนดการที่เกิดซ้ำสำหรับการสแกนความปลอดภัย ต้องใช้ scan_id และ cron_expression หนึ่งกำหนดการต่อการกำหนดค่าการสแกน เสริม timezone, notify_on_fail (none/email/slack/both), notify_email, slack_channel_id ทุกการรันนับรวมในขีดจำกัดรายเดือนของคุณ ผู้ใช้ admin ข้ามขีดจำกัด ความลึกของการสแกนจะอ่านจากการกำหนดค่าการสแกน ณ เวลาที่รันเสมอ
delete_security_schedule — ลบการสแกนความปลอดภัยที่กำหนดเวลาไว้ ไม่ส่งผลต่อการกำหนดค่าการสแกนหลักหรือการรันที่เสร็จสิ้นแล้ว

get_security_usage → ตรวจสอบโควต้าที่เหลือ
create_security_scan → กำหนดค่าการสแกนสำหรับ URL หรือ repo ของคุณ
run_security_scan → เรียกใช้การสแกนช่องโหว่ครั้งเดียว
create_security_schedule → ทำให้การรันที่เกิดซ้ำเป็นอัตโนมัติ (เช่น SAST รายสัปดาห์บน main branch)
get_security_results → ตรวจสอบการค้นพบและการแก้ไข

📖

การตรวจสอบโค้ด

list_code_reviews — แสดงรายการการตรวจสอบโค้ด AI ล่าสุดสำหรับทีม ส่งคืนคะแนนคุณภาพ, จำนวนความรุนแรง, ข้อมูล PR และการประทับเวลา สำหรับ Enterprise เท่านั้น
get_code_review — รับการตรวจสอบโค้ดพร้อมการค้นพบทั้งหมด การค้นพบแต่ละรายการรวมถึงความรุนแรง, หมวดหมู่ (bug/security/performance/style/logic/maintainability), ชื่อเรื่อง, คำอธิบาย, คำแนะนำโค้ด, พาธไฟล์ และหมายเลขบรรทัด
get_code_review_usage — ตรวจสอบการใช้งานการตรวจสอบโค้ด การตรวจสอบโค้ด AI สำหรับ Enterprise เท่านั้น ไม่จำกัดบน Enterprise
get_code_review_analytics — รับการวิเคราะห์การตรวจสอบ: แนวโน้ม, หมวดหมู่/แหล่งที่มาของการค้นพบ, การแจกแจงความรุนแรง, เมตริกความเร็ว, repos/ผู้เขียนยอดนิยม รองรับการย้อนหลัง 7/30/90 วัน

get_code_review_usage → ตรวจสอบการตรวจสอบที่เหลือ
ตรวจสอบ PR ในแดชบอร์ดที่ /dashboard/code-review
list_code_reviews → ดูการตรวจสอบล่าสุด
get_code_review → รับการค้นพบและคำแนะนำ

🔍

Exploratory AI

ตัวค้นหาบั๊กเว็บไซต์อัตโนมัติแบบหลายเอเจนต์พร้อมเอเจนต์คู่ขนานสูงสุด 10 ตัว แต่ละตัวใช้กลยุทธ์การทดสอบที่แตกต่างกัน

list_explorations — แสดงรายการการกำหนดค่า Exploratory AI สำหรับทีม
create_exploration — สร้างการสำรวจใหม่ ยอมรับ agent_count (1–10, สูงสุด 10) เพื่อรันเอเจนต์คู่ขนานหลายตัวด้วยกลยุทธ์เฉพาะ: happy_path, edge_case, security, accessibility, error_path, performance, mobile, data_integrity, navigation, custom
get_exploration — รับการกำหนดค่าการสำรวจพร้อมการตั้งค่าเอเจนต์และการรันล่าสุด
get_exploration_run — รับผลลัพธ์การรันพร้อมความคืบหน้าต่อเอเจนต์, ข้อมูลเฟส, การค้นพบพร้อมการระบุแหล่งที่มาของเอเจนต์ (agent_index, agent_strategy) และบั๊กที่เชื่อมโยง
get_exploration_usage — ตรวจสอบการใช้งานรายเดือน Exploratory AI สำหรับ Enterprise เท่านั้น Enterprise: ไม่จำกัด (10 เอเจนต์)

create_exploration ด้วย agent_count: 5 → กำหนดค่าเอเจนต์คู่ขนาน 5 ตัว
เรียกใช้การรันจากแดชบอร์ดหรือผ่าน POST /api/explorations/run
get_exploration_run → สอบถามความคืบหน้าต่อเอเจนต์และการค้นพบ
ดูการค้นพบที่ขจัดความซ้ำซ้อนพร้อมการระบุแหล่งที่มาของเอเจนต์ในแดชบอร์ด

📝

บันทึก

list_notes — แสดงรายการบันทึกพร้อมการค้นหาคำสำคัญเสริม, ตัวกรองโปรเจกต์, ตัวกรองผู้เขียน และช่วงวันที่ ส่งคืนบันทึกที่ผู้ใช้เป็นเจ้าของหรือบันทึกที่แชร์ภายในทีม
create_note — สร้างบันทึกในหนึ่งใน 5 รูปแบบ: markdown, plain_text, rich_text, checklist, outline ตั้งค่า visibility เป็น private หรือ shared สร้างชื่อเรื่องอัตโนมัติจาก 30 ตัวอักษรแรกหากไม่มีการระบุชื่อเรื่อง เสริม attachments อาร์เรย์ยอมรับไฟล์ที่เข้ารหัส base64 สูงสุด 400 MB ต่อไฟล์: รูปภาพ, วิดีโอ, เสียง, PDF หรือข้อความ/JSON ใดๆ ส่ง time_spent_seconds เพื่อติดตามความพยายาม QA
get_note — รับรายละเอียดบันทึกทั้งหมดรวมถึงเนื้อหาและไฟล์แนบ ต้องใช้ id
update_note — อัปเดตชื่อเรื่อง, เนื้อหา, รูปแบบ, การมองเห็น, โปรเจกต์ หรือ time_spent_seconds ส่งอาร์เรย์ attachments เพื่อผนวกไฟล์ใหม่ (สูงสุด 400 MB ต่อไฟล์) เข้ากับไฟล์แนบที่มีอยู่ของบันทึกโดยไม่ต้องแทนที่ เฉพาะผู้เขียนเท่านั้นที่สามารถอัปเดตได้ ต้องใช้ id
delete_note — ลบบันทึกและไฟล์แนบอย่างถาวร เฉพาะผู้เขียนเท่านั้นที่สามารถลบได้ ต้องใช้ id

create_note → เริ่มบันทึกเซสชันการทดสอบ
update_note → ผนวกข้อสังเกตขณะที่คุณทดสอบ
list_notes → ค้นหาบันทึกที่ผ่านมาด้วยคำสำคัญหรือโปรเจกต์
get_note → ดึงบันทึกทั้งหมดพร้อมไฟล์แนบ

🤖

ระบบอัตโนมัติ

create_automation — สร้างระบบอัตโนมัติใหม่ด้วยสคริปต์ Playwright ที่กำหนดเอง (ไม่จำเป็นต้องบันทึก FAB) ต้องใช้ name เสริม: target_url (ได้มาโดยอัตโนมัติจาก URL page.goto(...) แรกในสคริปต์หากละเว้น), script (Node.js/JavaScript/TypeScript หรือ Python — ภาษาถูกตรวจจับอัตโนมัติ; ค่าเริ่มต้นเป็นตัวยึดตำแหน่ง), status (draft หรือ active, ค่าเริ่มต้น: draft), project_id ส่งคืน id ของระบบอัตโนมัติ ต้องใช้แผนทีม เคล็ดลับ — ทำซ้ำระบบอัตโนมัติ: ใช้ get_automation เพื่อดึงสคริปต์ต้นฉบับ จากนั้นเรียก create_automation ด้วย name ที่ตั้งค่าเป็น "[Copy] Original Name" และส่ง script, target_url และ project_id ต้นฉบับ สำเนาเริ่มต้นในสถานะ draft โดยไม่มีประวัติเวอร์ชัน
list_automations — แสดงรายการสคริปต์อัตโนมัติ Playwright กรองด้วย project_id หรือ status (draft, active, paused) ส่งคืนอาร์เรย์ของระบบอัตโนมัติพร้อมชื่อ, target_url, last_run_status และ run_count
get_automation — รับรายละเอียดระบบอัตโนมัติทั้งหมดรวมถึงสคริปต์ Playwright และการรันล่าสุด ต้องใช้ id ส่งคืนระบบอัตโนมัติพร้อม script สด, สแต็ก script_versions (เก่าที่สุดก่อน, สูงสุด 100 รายการก่อนหน้า, แต่ละ { script, source, timestamp }) และอาร์เรย์ recent_runs ที่แต่ละการรันมี script_version_label/script_version_source ที่ดำเนินการ เรียกใช้ก่อน run_automation หากคุณต้องการเลือกเวอร์ชันประวัติที่เฉพาะเจาะจง
run_automation — เรียกใช้การรันทันทีของการทดสอบ Playwright ต้องใช้ automation_id โหมดเสมือน (ค่าเริ่มต้น): เสริม device สำหรับการจำลองวิวพอร์ต (เช่น desktop, iphone-15) โหมดสด: ตั้งค่า browserstack: true ด้วย bs_browser (chrome, firefox, safari, edge), bs_os (Windows, OS X) และ bs_os_version เพื่อรันบนเบราว์เซอร์เดสก์ท็อปจริง มือถือจริงสด: ตั้งค่า bs_os: "android" (อุปกรณ์: "Samsung Galaxy S25 Ultra", "Google Pixel 10", "OnePlus 13R") หรือ bs_os: "ios" (อุปกรณ์: "iPhone 17 Pro Max", "iPhone 16 Pro Max", "iPhone 15 Pro Max") และส่งชื่ออุปกรณ์ใน bs_os_version สคริปต์ Node.js กำหนดเส้นทางผ่าน browserstack-node-sdk (ครอบคลุมเดสก์ท็อป + Android + iPhone) สคริปต์ Python กำหนดเส้นทางผ่าน browserstack-sdk (pytest-playwright) และครอบคลุมเฉพาะเดสก์ท็อป — ไม่รองรับมือถือจริงผ่าน Python เนื่องจาก browser_type.connect() ของ pytest-playwright ไม่สามารถขับเคลื่อนปลายทางมือถือจริงของ BrowserStack ได้ วิดีโอและบันทึกเครือข่ายถูกจับโดยอัตโนมัติ บันทึกคอนโซลเฉพาะเดสก์ท็อป การเล่นซ้ำเวอร์ชัน: ส่ง version_index เสริม (จำนวนเต็ม, ดัชนีเริ่มต้นที่ 0) เพื่อดำเนินการรายการก่อนหน้าจากประวัติ script_versions ของระบบอัตโนมัติ ค่าเริ่มต้น: เมื่อ version_index ถูกละเว้นหรือเป็น null สคริปต์สดปัจจุบันจะทำงาน — อย่าส่งค่าตัวยึดตำแหน่งเพียงเพื่อ "เลือกปัจจุบัน" ค่าที่อยู่นอกช่วง, ค่าลบ หรือค่าที่ไม่ใช่จำนวนเต็มจะถูกปฏิเสธ บันทึกการรันเก็บสแนปชอตที่แน่นอนที่รัน และรายงานบั๊กใดๆ ที่สร้างอัตโนมัติจากการรันที่ล้มเหลวจะลิงก์ลึกกลับไปยังเวอร์ชันนั้นในตัวแก้ไข
list_automation_runs — แสดงรายการการรันล่าสุดสำหรับระบบอัตโนมัติ ต้องใช้ automation_id ส่งคืนการรันพร้อมสถานะ, duration_ms และ error_message
list_schedules — แสดงรายการการรันอัตโนมัติเว็บที่กำหนดเวลาไว้ทั้งหมดพร้อม cron, เขตเวลา, อุปกรณ์ และการตั้งค่าการแจ้งเตือน
create_schedule — สร้างการรันอัตโนมัติเว็บที่กำหนดเวลาไว้ ต้องใช้ automation_id และ cron_expression รองรับตัวเลือกอุปกรณ์, เขตเวลา, notify_on_fail (email/slack/both) และช่อง Slack BrowserStack Live ในการรันที่กำหนดเวลา: ส่ง browserstack: true ด้วย bs_browser, bs_os และ bs_os_version — เมทริกซ์อุปกรณ์เดียวกับ run_automation (Node = เดสก์ท็อป + Android จริง + iPhone จริง; Python = เดสก์ท็อปเท่านั้น)
delete_schedule — ลบการรันอัตโนมัติเว็บที่กำหนดเวลาไว้
list_mobile_schedules — แสดงรายการการรันอัตโนมัติมือถือที่กำหนดเวลาไว้ทั้งหมดพร้อมอุปกรณ์, cron, เขตเวลา และการแจ้งเตือน
create_mobile_schedule — สร้างการรันอัตโนมัติมือถือที่กำหนดเวลาไว้บนอุปกรณ์จริง ต้องใช้ automation_id, cron_expression และอาร์เรย์ devices
delete_mobile_schedule — ลบการรันอัตโนมัติมือถือที่กำหนดเวลาไว้
optimize_automation_script — ส่งสคริปต์ Playwright ไปยัง Sonnet 4 เพื่อการเพิ่มประสิทธิภาพด้วย AI ใช้รายการตรวจสอบ 12 จุดที่แก้ไขตัวเลือก, กลยุทธ์การรอ, การยืนยัน, การจัดการข้อผิดพลาด, รูปแบบการรับรองความถูกต้อง, ความเข้ากันได้กับมือถือ และโหมดเข้มงวด ต้องใช้ automation_id เวอร์ชันสคริปต์ปัจจุบันจะถูกบันทึกก่อนการเพิ่มประสิทธิภาพ ส่งคืนสคริปต์ที่เพิ่มประสิทธิภาพและสรุปการเปลี่ยนแปลง
undo_automation_script — ย้อนกลับสคริปต์อัตโนมัติเป็นเวอร์ชันก่อนหน้า เก็บรักษาเวอร์ชันก่อนหน้าได้สูงสุด 10 เวอร์ชัน ต้องใช้ automation_id ส่งคืนสคริปต์ที่กู้คืนและจำนวนเวอร์ชันที่เหลือ

create_automation → สร้างการทดสอบด้วยสคริปต์ที่กำหนดเอง
list_automations → เรียกดูการทดสอบที่มีอยู่
get_automation → ตรวจสอบสคริปต์ Playwright
run_automation → เรียกใช้การทดสอบ
list_automation_runs → ตรวจสอบผลลัพธ์และระยะเวลา

⏱️

การติดตามเวลา

list_time_entries — แสดงรายการบันทึกเวลาของทีม กรองตาม period (today, week, month, all), project_id, category และ sort (newest, oldest, most_time, least_time) เฉพาะแผนทีมเท่านั้น
create_time_entry — บันทึกเวลาที่ใช้ในงาน QA ต้องใช้ description, category และ duration_minutes สามารถกำหนด project_id และ entry_date ได้ (ค่าเริ่มต้นเป็นวันนี้) เฉพาะแผนทีมเท่านั้น
update_time_entry — อัปเดตรายการบันทึกเวลาที่มีอยู่ ต้องใช้ id สามารถอัปเดต description, category, duration_minutes, project_id หรือ entry_date ได้ เฉพาะแผนทีมเท่านั้น
delete_time_entry — ลบรายการบันทึกเวลาอย่างถาวร ต้องใช้ id เฉพาะแผนทีมเท่านั้น

create_time_entry → บันทึกการทดสอบถดถอย 45 นาที
list_time_entries → ดูรายการบันทึกเวลาของสัปดาห์นี้
update_time_entry → ปรับระยะเวลาหรือหมวดหมู่
delete_time_entry → ลบรายการที่ไม่ถูกต้อง

☑️

กรณีทดสอบ

การจัดการการทดสอบเต็มรูปแบบด้วยโฟลเดอร์แบบลำดับชั้น ชุดทดสอบซ้อน (ลึกสูงสุด 3 ระดับพร้อมการขยายชุดทดสอบย่อยอัตโนมัติเมื่อรัน) การเรียงลำดับด้วยการลากและวาง การสร้างกรณีทดสอบด้วย AI และแท็บรายงานการวิเคราะห์ที่มีแนวโน้ม KPI การวิเคราะห์ความล้มเหลว สุขภาพของชุดทดสอบ ความครอบคลุม และประสิทธิภาพของผู้ทดสอบ เครื่องมือทั้งหมดเรียก Supabase โดยตรง — ไม่มีการเดินทางไปกลับผ่าน HTTP ความหน่วงเท่ากับแดชบอร์ด

การดำเนินการแบบแฮนด์ฟรี: หน้ารีวิวการรันเป็นแบบภาพสไลด์ที่แสดงครั้งละหนึ่งกรณี มีปุ่มลัด (P ผ่าน · F ไม่ผ่าน · B บล็อก · S ข้าม) และ การควบคุมด้วยเสียง คลิกไมค์ แล้วพูดว่า "ผ่าน" "ไม่ผ่าน" "บล็อก" "ข้าม" "ถัดไป" "ก่อนหน้า" "เพิ่มบันทึก" (ถอดความเป็นข้อความในช่องบันทึก) "บันทึกบันทึก" หรือ "ปิดเสียง" เลื่อนไปยังกรณีที่ยังไม่ได้ทดสอบถัดไปโดยอัตโนมัติเมื่อผลลัพธ์สำเร็จ หยุดอยู่กับที่เมื่อไม่ผ่านเพื่อให้ผู้ทดสอบบันทึกรายละเอียดและสร้างบั๊ก ทำงานได้ใน Chrome, Edge และ Safari

กรณีและโฟลเดอร์

list_test_cases — แสดงรายการกรณีทดสอบพร้อมตัวเลือก search, priority (critical, high, medium, low), type (functional, regression, smoke, integration, performance, security, usability, exploratory), status (active, draft, deprecated) และ sort (newest, oldest, name, priority)
create_test_case — สร้างกรณีทดสอบ มีเทมเพลตสองแบบ: steps (ค่าเริ่มต้น) — ตาราง { action, expected } แบบทีละขั้นตอนผ่านอาร์เรย์ steps; text — คำอธิบายแบบอิสระเดียวผ่าน text_content สามารถส่งทั้งสองฟิลด์ในการเรียกครั้งเดียวได้ (แพลตฟอร์มจัดเก็บแยกกัน ดังนั้นหากผู้ทดสอบเปลี่ยน template_type ในภายหลังจะไม่สูญเสียข้อมูลของอีกฝั่ง) อาร์เรย์ urls ที่เป็นตัวเลือก (สูงสุด 10 URL http/https) แนบลิงก์อ้างอิง ต้องใช้ name ตัวเลือก: description, preconditions, template_type, steps, text_content, urls, priority, type, tags, estimated_time (วินาที) ไฟล์แนบอัปโหลดผ่านปลายทาง POST /api/test-cases/:id/attachments ของแดชบอร์ด (multipart) — ยังไม่เปิดเผยเป็นเครื่องมือ MCP
get_test_case — รับรายละเอียดกรณีทดสอบทั้งหมดรวมถึงขั้นตอนและประวัติการดำเนินการ
list_test_case_folders — แสดงรายการโฟลเดอร์ของทีม (หนึ่งโฟลเดอร์ต่อกรณีผ่าน folder_id; แตกต่างจากชุดทดสอบซึ่งเป็นการจัดกลุ่มแผนการทดสอบแบบกลุ่มต่อกลุ่ม) จำกัดที่ 500; รองรับตัวกรอง project_id และ parent_folder_id (ใช้ "root" สำหรับระดับบนสุดเท่านั้น)
create_test_case_folder — สร้างโฟลเดอร์ (ซ้อนได้สูงสุด 3 ระดับผ่าน parent_folder_id) ใช้ bulk_update_test_cases เพื่อย้ายกรณีเข้าไป
bulk_update_test_cases — ใช้หนึ่งการกระทำกับสูงสุด 500 กรณีพร้อมกัน: set_priority, set_status, set_type, add_tags, remove_tags, add_to_suite, pin, unpin
link_test_case_to_bug — สร้างความสามารถในการติดตามระหว่างกรณีทดสอบและรายงานบั๊ก (verified_by, covers หรือ relates)
list_test_case_links — แสดงรายการลิงก์การติดตามทั้งหมดสำหรับกรณีทดสอบ
list_test_case_review_candidates — แฟล็กการทดสอบที่ตายแล้ว: never_run (90+ วันนับตั้งแต่สร้าง), always_passes (ผ่านติดต่อกัน 5+ ครั้งใน 90 วัน), always_skipped (ข้ามติดต่อกัน 3+ ครั้ง)
mark_test_case_review_flags — บันทึกแฟล็กผู้สมัครเก็บถาวรปัจจุบันลงใน test_cases.review_flag ทำงานอัตโนมัติทุกวันจันทร์ 09:00 UTC ผ่าน pg_cron

การนำเข้า

การนำเข้า Figma (UI แดชบอร์ด + REST): อัปโหลดไฟล์ zip ส่งออกของเฟรม Figma (สูงสุด 100 MB) Claude วิเคราะห์แต่ละหน้าจอและร่างกรณีทดสอบลงในโฟลเดอร์ที่คุณเลือกหรือสร้าง ไปป์ไลน์หลายรอบ (จำแนก → กรณีต่อหน้าจอ → กรณีระดับโฟลว์ข้ามหน้าจอที่มีคำนำหน้าร่วม → วิจารณ์ตนเอง) พร้อมการแคชพรอมต์ การลองใหม่เมื่อ 429 และการแยกข้อผิดพลาดต่อเฟรมเพื่อไม่ให้หนึ่งเฟรมที่เสียหายทำให้ทั้งชุดล้มเหลว กรณีลงเป็น status=active แท็ก ai_generated=true พร้อม source='figma' และ source_frame_name เก็บลิงก์ไปยังเฟรมต้นฉบับ ใช้คีย์ Anthropic ของแพลตฟอร์ม — ไม่จำเป็นต้องเชื่อมต่อ Claude ต่อทีม ปลายทาง: POST /api/test-cases/import/figma/request, POST /api/test-cases/import/figma/start, GET /api/test-cases/import/figma/:id

ชุดทดสอบและการรัน

list_test_suites — แสดงรายการชุดทดสอบพร้อมจำนวนกรณีและสถานะการรันล่าสุด
create_test_suite — สร้างชุดทดสอบ ซ้อนได้สูงสุด 3 ระดับผ่าน parent_suite_id
list_test_runs — แสดงรายการการรันทดสอบพร้อมชื่อชุดทดสอบ ผู้รับผิดชอบ และสรุปผ่าน/ไม่ผ่าน
create_test_run — สแนปช็อตชุดทดสอบเป็นการรันใหม่ การรันชุดทดสอบหลักจะรวมทุกกรณีในทุกชุดทดสอบย่อยที่สืบทอดโดยอัตโนมัติ (กรณีที่เชื่อมโยงกับทั้งสองจะถูกเพิ่มเพียงครั้งเดียว) แต่ละแถว test_run_results บันทึกว่ากรณีมาจากชุดทดสอบย่อยต้นทางใด เพื่อให้หน้าผลลัพธ์สามารถจัดกลุ่มตามต้นทางได้

รายงาน (การวิเคราะห์ระดับ 1 + ระดับ 4)

get_test_reports_overview — KPI หลักสำหรับช่วงเวลา (อัตราการผ่าน การรันที่เสร็จสมบูรณ์ กรณีที่ดำเนินการ) พร้อมส่วนต่างเทียบกับช่วงเวลาก่อนหน้าที่เทียบเท่า ตัวเลขเดียวกับที่แถบ KPI ของแท็บรายงานแสดง
get_test_reports_failures — รายการ "สิ่งที่ต้องแก้ไข" สี่รายการ: failing_cases (ไม่ผ่าน ≥50% ขั้นต่ำ 3 การรัน), flaky_cases (การพลิกผ่าน/ไม่ผ่านมากที่สุด), failing_suites (ไม่ผ่าน ≥30% ขั้นต่ำ 5 การรัน), regressed_cases (ไม่ผ่านล่าสุดที่เคยผ่านก่อนหน้าในช่วงเวลา)

create_test_case_folder → สร้างโครงสร้างโฟลเดอร์ (เช่น Smoke → Auth)
create_test_case → กำหนดกรณี; ย้ายเข้าโฟลเดอร์ด้วย bulk_update_test_cases
create_test_suite → สร้างแผนการทดสอบ (ชุดทดสอบย่อยเป็นตัวเลือก ลึกสูงสุด 3 ระดับ)
create_test_run → สแนปช็อตการรันจากชุดทดสอบหลัก — รวมชุดทดสอบย่อยอัตโนมัติ
get_test_reports_failures → ถาม "สัปดาห์นี้ต้องแก้ไขอะไร" เมื่อการรันเสร็จสิ้น
get_test_reports_overview → ติดตามแนวโน้มอัตราการผ่านสัปดาห์ต่อสัปดาห์

⚡

ตัวเสริมทีม

scale_team — ขยายทีม QA ของคุณทันทีด้วยผู้ทดสอบเสริม บัญชีถูกจัดเตรียมโดยอัตโนมัติพร้อมสิทธิ์ผู้ทดสอบ ระบุ team_size (1–10), location, duration, budget และตัวเลือก product_url, product_types และ tech_levels มีให้ในแผนทีม คุณจะไม่ถูกเรียกเก็บเงินจนกว่าจะได้รับการอนุมัติ

scale_team → จัดเตรียมผู้ทดสอบอาวุโส 5 คนในสหรัฐอเมริกาเป็นเวลา 1 เดือน
list_team_members → ตรวจสอบว่าผู้ทดสอบใหม่ปรากฏในทีมของคุณ
list_reports → ตรวจสอบรายงานที่ยื่นโดยผู้ทดสอบเสริม

📱

การทดสอบมือถือ

upload_mobile_app — อัปโหลดแอป APK (Android) หรือ IPA (iOS) เพื่อทดสอบบนอุปกรณ์จริง ต้องใช้ name, platform (android/ios) และ file_url สำหรับ iOS: อัปโหลด IPA สำหรับการรันบนอุปกรณ์จริง จากนั้นอัปโหลดบิลด์ .app ของซิมูเลเตอร์บนหน้ารายละเอียดแอปเพื่อเปิดใช้งานการบันทึก
update_mobile_app — แทนที่ไบนารีแอปด้วยเวอร์ชันใหม่ ล้าง URL ที่แคชและบิลด์ซิมูเลเตอร์เพื่อให้ระบบอัตโนมัติทั้งหมดใช้เวอร์ชันใหม่ในการรันครั้งถัดไป ต้องใช้ app_id และ file_url ตัวเลือก: version
create_mobile_automation — สร้างสคริปต์ทดสอบ ต้องใช้ name, app_id, script_type (maestro สำหรับ YAML, appium สำหรับ Appium Python, appium_js สำหรับ Appium JavaScript) และ script (เนื้อหาสคริปต์ทดสอบ)
list_mobile_runs — รับผลลัพธ์สำหรับการรันทดสอบมือถือ (สถานะ อุปกรณ์ วิดีโอ เซสชัน BrowserStack และบั๊กที่สร้างอัตโนมัติ) การรันมือถือถูกทริกเกอร์จากแดชบอร์ดหรือตามกำหนดเวลา ตัวกรองตัวเลือก: automation_id, status (queued, running, passed, failed, error, archived), limit การรันที่เก็บถาวรถูกแยกออกจากรายการเริ่มต้น

ตัวอย่างเวิร์กโฟลว์ — Android

upload_mobile_app → อัปโหลด APK ของคุณ
บันทึกการทดสอบในเบราว์เซอร์ → การกระทำถูกจับโดยอัตโนมัติ
ทริกเกอร์การรันบนอุปกรณ์จริง (เช่น Google Pixel 8) จากแดชบอร์ดหรือตามกำหนดเวลา
list_mobile_runs → ตรวจสอบผลลัพธ์พร้อมวิดีโอและบันทึก
ความล้มเหลวสร้างรายงานบั๊กอัตโนมัติพร้อมสแนปช็อตความล้มเหลวและการแจกแจงขั้นตอน

ตัวอย่างเวิร์กโฟลว์ — iOS

upload_mobile_app → อัปโหลด IPA ของคุณ (สำหรับการรันบนอุปกรณ์จริง)
อัปโหลดบิลด์ .app ของซิมูเลเตอร์บนหน้ารายละเอียดแอป (สำหรับการบันทึก)
บันทึกการทดสอบในเบราว์เซอร์ → การกระทำถูกจับจากซิมูเลเตอร์
ทริกเกอร์การรันบนอุปกรณ์จริง (เช่น iPhone 15 Pro ใช้ IPA) จากแดชบอร์ดหรือตามกำหนดเวลา
update_mobile_app → แทนที่ IPA ด้วยเวอร์ชันใหม่เมื่อพร้อม

✅

การปฏิบัติตามกฎระเบียบและหลักฐาน (องค์กร)

collect_compliance_evidence — ทริกเกอร์การรวบรวมหลักฐานอัตโนมัติจากบริการที่เชื่อมต่อ (Cloudflare, GitHub, Sentry, Supabase, Railway) ส่งคืน ID การรัน รวบรวมการตั้งค่า SSL/TLS, สถานะ WAF, การแจ้งเตือน Dependabot, แนวโน้มข้อผิดพลาด, ประวัติการปรับใช้ และอื่นๆ
check_config_drift — ตรวจสอบบริการที่เชื่อมต่อทั้งหมดเพื่อหาการเบี่ยงเบนของการกำหนดค่าความปลอดภัยจากเส้นฐาน (โหมด SSL, เวอร์ชัน TLS, HSTS, กฎ WAF, ส่วนหัวความปลอดภัย)
generate_access_review — สร้างรายงานการตรวจสอบการเข้าถึงรายไตรมาส ตรวจสอบสมาชิกทีม บทบาท สถานะ MFA การใช้คีย์ API และสร้างคำแนะนำ (เช่น เพิกถอนคีย์ที่ไม่ได้ใช้งาน)
get_security_events — สอบถามไทม์ไลน์เหตุการณ์ความปลอดภัยข้ามบริการ กรองตามแหล่งที่มา (cloudflare, sentry, github) และความรุนแรง (critical, high, medium, low, info) เหตุการณ์ถูกเชื่อมโยงอัตโนมัติข้ามบริการ

ความครอบคลุมการปฏิบัติตามกฎระเบียบ

เครื่องมือเหล่านี้ช่วยตอบสนองข้อกำหนดการปฏิบัติตาม 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) และ GDPR (Art. 5, 25, 32, 33)

ไคลเอนต์ที่เข้ากันได้

bug_Agent_ ทำงานกับไคลเอนต์ใดๆ ที่รองรับ Model Context Protocol นี่คือคู่มือการตั้งค่าสำหรับไคลเอนต์ยอดนิยม:

🤖

Claude Desktop

เปิด Settings → Developer → Edit Config จากนั้นเพิ่ม:

claude_desktop_config.json

รีสตาร์ท Claude Desktop หลังจากบันทึก

✳️

Cursor

เปิด Settings → MCP Servers → Add Server หรือแก้ไข .cursor/mcp.json ในรูทโปรเจกต์ของคุณ:

.cursor/mcp.json

🌊

Windsurf

เปิด Settings → MCP → Add Server หรือแก้ไขไฟล์การกำหนดค่า MCP ของคุณ:

mcp_config.json

💻

Claude Code (CLI)

เพิ่ม bug_Agent_ โดยตรงจากเทอร์มินัล:

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

ตั้งค่าคีย์ API ของคุณด้วย export BUGAGENT_API_KEY=ba_live_... ก่อนเปิดใช้งาน

🔧

ไคลเอนต์ MCP อื่นๆ

ไคลเอนต์ใดๆ ที่รองรับการขนส่ง MCP stdio ทำงานกับ bug_Agent_ ได้ ใช้การกำหนดค่ามาตรฐาน:

คำสั่ง: npx
อาร์กิวเมนต์: ["-y", "@bugagent/mcp-server"]
ตัวแปรสภาพแวดล้อม: BUGAGENT_API_KEY

CLI

เริ่มต้นใช้งาน CLI

CLI ของ bug_Agent_ ให้คุณควบคุมรายงานบั๊ก คำขอฟีเจอร์ โปรเจกต์ และการผสานรวมได้อย่างเต็มที่จากเทอร์มินัลของคุณ ใช้เพื่อ:

ทำให้เวิร์กโฟลว์อัตโนมัติ — ผสานรวมการรายงานบั๊กเข้ากับไปป์ไลน์ CI/CD, สคริปต์ และงานครอน
การดำเนินการแบบกลุ่ม — แสดงรายการ กรอง และจัดการรายงานโดยไม่ต้องออกจากเทอร์มินัล
เอาต์พุตที่เป็นมิตรกับไปป์ — รูปแบบ JSON, YAML และ raw สำหรับการประกอบกับ jq, yq และเครื่องมืออื่นๆ
การวนซ้ำที่รวดเร็ว — ไม่ต้องใช้เบราว์เซอร์ — สร้างและอัปเดตรายงานในไม่กี่วินาที

การติดตั้ง

npm install -g @bugagent/cli

ตรวจสอบการติดตั้ง:

bugagent --version

การตรวจสอบสิทธิ์

ตั้งค่า API key ของคุณเป็นตัวแปรสภาพแวดล้อม:

หรือส่งโดยตรงด้วยแฟล็ก --api-key:

bugagent reports list --api-key ba_live_your_key_here

🔑

รับ API key ของคุณจากคอนโซล bug_Agent_ คีย์จะขึ้นต้นด้วย ba_live_

สำหรับการตรวจสอบสิทธิ์แบบถาวร ให้เพิ่มคำสั่ง export ลงในโปรไฟล์เชลล์ของคุณ (~/.bashrc, ~/.zshrc ฯลฯ)

การใช้งาน

คำสั่งมีรูปแบบดังนี้:

bugagent <resource> <action> [flags]

ทรัพยากรยังสามารถใช้ไวยากรณ์โคลอนสำหรับทรัพยากรย่อยได้:

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

ใช้ --help กับคำสั่งใดๆ เพื่อดูรายละเอียด:

bugagent reports --help
bugagent reports create --help

ตัวอย่างเซสชัน

เทอร์มินัล

# 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

คุณสมบัติ CLI

CLI มีคำสั่งสำหรับ:

reports สร้าง แสดงรายการ รับข้อมูล อัปเดต และล้างรายงานข้อบกพร่อง

projects สร้าง แสดงรายการ อัปเดต และลบโปรเจกต์

keys สร้าง แสดงรายการ สร้างใหม่ และเพิกถอน API key

jira เชื่อมต่อ ซิงค์รายงาน และกำหนดการตั้งค่า Jira

usage ตรวจสอบการใช้งานปัจจุบันเทียบกับขีดจำกัดของแผน

stats ดูการวิเคราะห์และรายละเอียด

profile ดูและอัปเดตโปรไฟล์และการตั้งค่าของคุณ

auth เข้าสู่ระบบ ลงทะเบียน และจัดการข้อมูลประจำตัว

แฟล็กส่วนกลาง

แฟล็ก คำอธิบาย

--api-key <key> แทนที่ API key สำหรับคำสั่งนี้

--format <fmt> รูปแบบผลลัพธ์: json, yaml, pretty, raw

--debug แสดงรายละเอียดคำขอ/การตอบกลับสำหรับการแก้ไขปัญหา

--help แสดงวิธีใช้สำหรับคำสั่งใดๆ

--version พิมพ์เวอร์ชันของ CLI

รูปแบบผลลัพธ์

CLI รองรับรูปแบบผลลัพธ์หลายรูปแบบสำหรับกรณีการใช้งานที่แตกต่างกัน:

`json`

JSON ที่เครื่องอ่านได้ เหมาะสำหรับการส่งต่อไปยัง jq หรือเครื่องมืออื่นๆ

`yaml`

ผลลัพธ์ YAML ที่เป็นมิตรต่อมนุษย์สำหรับไฟล์กำหนดค่าและความสามารถในการอ่าน

`pretty`

ค่าเริ่มต้น ผลลัพธ์ที่มีสีและจัดรูปแบบซึ่งออกแบบมาสำหรับเทอร์มินัล

`raw`

ผลลัพธ์ที่ไม่ได้จัดรูปแบบ มีประโยชน์สำหรับการเขียนสคริปต์และระบบอัตโนมัติ

การกรองด้วย --transform

ใช้ --transform กับไวยากรณ์ GJSON เพื่อสอบถามและกรองข้อมูลผลลัพธ์:

# 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"

ทักษะ AI

CLI ยังพร้อมใช้งานในรูปแบบ AgentSkill ซึ่งช่วยให้ผู้ช่วยเขียนโค้ด AI สามารถใช้ bug_Agent_ ในนามของคุณได้

✨

AgentSkill คืออะไร?

AgentSkills ช่วยให้ผู้ช่วยเขียนโค้ด AI (Claude Code, Cursor ฯลฯ) เรียกใช้เครื่องมือ CLI ตามบริบทได้ ทักษะ bug_Agent_ ช่วยให้ผู้ช่วย AI ของคุณสามารถยื่นข้อบกพร่อง ตรวจสอบสถานะโปรเจกต์ และซิงค์กับ Jira ได้ โดยที่คุณไม่ต้องพิมพ์คำสั่งเอง

ติดตั้งทักษะ

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

เมื่อติดตั้งแล้ว ผู้ช่วย AI ที่รับรู้บริบทจะสามารถใช้คำสั่ง bug_Agent_ ได้อย่างเป็นธรรมชาติ พร้อมด้วยความรู้ทั้งหมดเกี่ยวกับผลิตภัณฑ์ แนวทางการทดสอบ และเอกสารที่อัปโหลดของคุณ:

พร้อมท์ผู้ช่วย 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."

ทักษะจะแปลภาษาธรรมชาติเป็นคำสั่ง CLI ที่เหมาะสมและดำเนินการ

🎬

การเล่นเซสชันซ้ำ + ผู้ช่วย AI: เมื่อเปิดใช้งานการเล่นเซสชันซ้ำ (แผน Team) ผู้ช่วย AI สามารถอ้างอิงเซสชันผู้ใช้ที่บันทึกไว้ ได้แก่ การคลิก การนำทาง ข้อผิดพลาด และความล้มเหลวของเครือข่ายจาก 60 วินาทีล่าสุด เพื่อร่างรายงานข้อบกพร่องที่สมบูรณ์และแม่นยำยิ่งขึ้นโดยอัตโนมัติ พร้อมบริบทการทำซ้ำทั้งหมด

ขอความช่วยเหลือ

ต้องการความช่วยเหลือ? เราพร้อมให้ความช่วยเหลือ

ชุมชน Discord

เข้าร่วม Discord ของเราเพื่อรับการสนับสนุนแบบเรียลไทม์และการสนทนาในชุมชน

การสนับสนุนทางอีเมล

[email protected] — โดยปกติเราจะตอบกลับภายใน 24 ชั่วโมง