bugAgent

ทางการ

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

ดูบน bugagent.com

คุณทำอะไรได้บ้างด้วย bugAgent MCP?

อธิบายบั๊กด้วยภาษาอังกฤษธรรมดา แล้ว bugAgent จะทำการบันทึก จัดหมวดหมู่ และจัดการให้คุณ

บันทึกและจัดหมวดหมู่บั๊กอัตโนมัติ — ขอให้ผู้ช่วยของคุณบันทึกบั๊กหรือคำขอฟีเจอร์ด้วยภาษาธรรมชาติ create_bug_report จะจัดหมวดหมู่อัตโนมัติใน 19 ประเภท
แสดงรายการและกรองรายงาน — ขอรายการบั๊กล่าสุดหรือบั๊กวิกฤตในโปรเจกต์ list_bug_reports จะกรองตามโปรเจกต์ ความรุนแรง สถานะ และอื่นๆ
รับงานและจัดการคิว — ให้เอเจนต์ของคุณเลือกบั๊กที่มีลำดับความสำคัญถัดไปด้วย pick_next_bug และรับงานแบบอะตอมมิกผ่าน claim_bug
รันการสแกนความปลอดภัย — เรียกใช้การสแกนช่องโหว่บน URL ด้วย run_security_scan และตรวจสอบผลลัพธ์ผ่าน get_security_results
สร้างบันทึกสำหรับนักพัฒนา — ขอการวิเคราะห์สาเหตุต้นตอและแนวทางแก้ไขที่สร้างโดย AI ผ่าน push_to_claude สำหรับรายงานบั๊กใดๆ

เอกสาร

MCP v1

การนำทาง

Model Context Protocol

MCP

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

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

Discord Community support@bugagent.com

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

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

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

สร้างบัญชีฟรี; เจ้าของเวิร์กสเปซใหม่จะถูกนำไปยังหน้าตั้งค่าคีย์ API โดยตรง ผู้ใช้เดิมสามารถสร้างคีย์ได้จาก Settings → Developers → API Keys

กำหนดค่าไคลเอนต์ 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 จริงของคุณจากคอนโซล

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

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

สำหรับการกำหนดค่าขนาดเล็กที่พร้อมคัดลอก คำแนะนำคีย์แบบจำกัดขอบเขต และพรอมต์เริ่มต้นที่ปลอดภัย ใช้ MCP quickstart สาธารณะ

🔑

รับคีย์ API ก่อน เข้าสู่ระบบที่ Settings → Developers คลิก Create API Key และคัดลอกค่า (ขึ้นต้นด้วย ba_live_) คุณจะเห็นได้เพียงครั้งเดียว ดังนั้นควรวางไว้ที่ปลอดภัย ตัวอย่างทั้งหมดด้านล่างใช้คีย์นี้

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

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

macOS (เทอร์มินัล)

เทอร์มินัล

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 ที่กำหนดเอง:
- Header Name: Authorization
- Value: Bearer ba_live_YOUR_KEY_HERE
คลิก Connect คุณจะเห็นเครื่องมือ bug_Agent_ ทั้งหมดกว่า 110 รายการในแผงด้านซ้าย
คลิกเครื่องมือใดก็ได้ (เช่น 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

เทอร์มินัล / 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"

อินไลน์ — เซสชันเดียว

เทอร์มินัล

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 จากตลาด 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."

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

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

โฮสต์ 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
จัดการและเพิกถอนตัวเชื่อมต่อที่สร้างจากหน้า Settings เดียวกัน การเพิกถอนทำได้ทันที — คำขอถัดไปจากตัวเชื่อมต่อนั้นจะคืนค่า invalid_client

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

ตัวเลือก 8 — HTTP โดยตรงด้วย curl (เทอร์มินัล)

หากคุณต้องการทดสอบเซิร์ฟเวอร์โดยตรงโดยไม่ต้องใช้ไคลเอนต์ หรือรวมเข้ากับสคริปต์ คุณสามารถเรียกปลายทาง HTTP ด้วย curl โปรโตคอล MCP เป็น JSON-RPC 2.0 ผ่าน Streamable HTTP

macOS / Linux

เทอร์มินัล

# 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 → Developers คีย์ขึ้นต้นด้วย 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
Use Hermes to execute the curated "Checkout smoke" suite and report every result to bugAgent
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)

Direct HTTP (curl) curl / Invoke-RestMethod — รวม Accept: application/json, text/event-stream

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

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

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

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

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

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

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

MCP Inspector เกิดข้อผิดพลาด CORS เลือก 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 หรือ text/JSON ตั้งค่า format_description: true เพื่อจัดรูปแบบคำอธิบายใหม่เป็นเทมเพลตที่มีโครงสร้างโดยอัตโนมัติด้วย AI ส่ง time_spent_seconds เพื่อติดตามความพยายามด้าน QA ส่ง priority (urgent / high / normal / low) เพื่อกำหนดความเร่งด่วนในการแก้ไขโดยอิสระจากระดับความรุนแรง ส่ง is_epic: true เพื่อสร้าง Epic หรือ parent_epic_id (UUID/รหัสย่อ) เพื่อสร้างรายการย่อยในโปรเจกต์ที่ได้รับอนุญาตเดียวกัน การตอบกลับประกอบด้วยฟิลด์ลำดับชั้นรวมถึง 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, is_epic, type, severity, status, resolution, root_cause หรือ reporter_user_id แต่ละผลลัพธ์ประกอบด้วยตัวระบุบุคคล/โปรเจกต์ที่จำกัดขอบเขตตามเทนแนนต์ รวมถึง is_epic, parent_epic_id, parent_epic และ epic_progress ที่มีขอบเขตจำกัด เครื่องมืออ่านรายงานไม่เปิดเผยที่อยู่อีเมลของสมาชิก
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() ปราศจากสภาวะแข่งขันระหว่างผู้เรียกพร้อมกันผ่านรูปแบบ UPDATE-WHERE-RETURNING ของ Postgres — หากเอเจนต์สองตัวเรียก claim_bug บน id เดียวกันในช่วงเวลาใกล้เคียงกัน ตัวหนึ่งจะได้รับ claimed:true พร้อมเนื้อหาบั๊ก และอีกตัวจะได้รับ claimed:false พร้อมสตริงเหตุผล การตอบกลับที่สำเร็จประกอบด้วย reporter_user_id, reporter_name, assigned_to และ assignee_name ตัวเก็บกวาด pg_cron ปล่อยการอ้างสิทธิ์ที่ค้างอยู่ (สถานะ=in-progress + claimed_at อายุมากกว่า 30 นาที) กลับไปยัง new โดยอัตโนมัติ ดังนั้นตั๋วของเอเจนต์ที่หยุดทำงานจะกลับเข้าคิวโดยไม่ต้องดำเนินการด้วยตนเอง ข้อมูลนำเข้า: id (UUID หรือรหัสย่อ)
get_bug_report — รับรายละเอียดทั้งหมดของรายงานโดย UUID หรือรหัสย่อของเวิร์กสเปซ/โปรเจกต์ คืนฟิลด์บุคคล/โปรเจกต์/คุณภาพมาตรฐานรวมถึง is_epic, ข้อมูลประจำตัวของรายการหลัก, ความคืบหน้ารวม และหน้าแรกของรายการย่อยที่มีขอบเขตจำกัดสำหรับ Epic
list_epic_children — แบ่งหน้ารายงานย่อยของ Epic ด้วย id, limit (1–100) และ offset คืน children, total, has_more และ epic_progress ที่รวมค่าด้วย SQL โดยไม่ต้องโหลดรายงานย่อยทุกรายการ
update_bug_report — อัปเดตฟิลด์รายงานมาตรฐานรวมถึง is_epic และ parent_epic_id ส่ง parent_epic_id: null เพื่อถอดออก; การเปลี่ยนรายการหลัก/ถอดออกเป็นแบบอะตอมิกและต้องได้รับอนุญาตในเวิร์กสเปซและโปรเจกต์เดียวกัน การเลื่อนขั้นเป็น Epic จะถอดรายการหลักเดิมออก ในขณะที่ Epic ที่มีรายการย่อยไม่สามารถลดขั้นได้ กฎการแจ้งเตือนสถานะ/การแก้ไข/สาเหตุต้นตอและการมอบหมายที่มีอยู่ยังคงมีผล
add_comment — เพิ่มความคิดเห็นในรายงานบั๊ก (UUID หรือรหัสย่อ, เนื้อหา 1-10000 ตัวอักษร) หากรายงานถูกซิงก์กับ Jira ความคิดเห็นจะถูกส่งไปยัง issue ของ Jira ที่เชื่อมโยงโดยอัตโนมัติ
list_comments — แสดงเธรดความคิดเห็นทั้งหมดของรายงาน เรียงจากเก่าที่สุดก่อน — แต่ละความคิดเห็นพร้อมชื่อผู้เขียน, parentId (คำตอบแบบเธรด) และการประทับเวลา ความคิดเห็นไม่เป็นส่วนหนึ่งของ get_bug_report ดังนั้นนี่คือวิธีอ่านการสนทนาของตั๋ว รับ UUID หรือรหัสย่อ
link_bug_reports — สร้างลิงก์เชิงความหมายแบบมีทิศทางระหว่างรายงานสองรายการในโปรเจกต์ที่ได้รับอนุญาตเดียวกัน สำหรับ parent-of รายงานต้นทางต้องเป็น Epic และรายงานปลายทางเป็นรายการย่อยมาตรฐาน ควรใช้ parent_epic_id ในการสร้าง/อัปเดตสำหรับการกำหนด Epic
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; testing-blocked-by ที่รายงานนี้เป็นเป้าหมายจะแสดงเป็น blocks-testing related-to เป็นแบบสมมาตร เสริมฟิลด์ similar_reports ที่ตรวจจับอัตโนมัติซึ่งคืนโดย get_bug_report
classify_bug — จัดหมวดหมู่คำอธิบายเป็นหนึ่งใน 19 ประเภทรายงาน (บั๊ก ฟีเจอร์ การปรับปรุง ฯลฯ) พร้อมคะแนนความเชื่อมั่น
flush_reports — ลบรายงานเก่าจำนวนมาก (เฉพาะผู้ดูแลระบบ)

📊

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

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

📁

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

list_projects — แสดงโปรเจกต์ที่พร้อมใช้งานพร้อม id, name, slug, ticket_prefix, คำอธิบาย และสถานะเริ่มต้น ใช้ค่าเหล่านั้นกับ create_bug_report และ list_bug_reports เพื่อกำหนดเป้าหมายโปรเจกต์ที่ถูกต้อง
create_project — สร้างโปรเจกต์ใหม่ (จะกลายเป็นค่าเริ่มต้นโดยอัตโนมัติหากเป็นโปรเจกต์แรก)
delete_project — ลบโปรเจกต์และข้อมูลที่เกี่ยวข้องทั้งหมดอย่างถาวร (รายงานบั๊ก, ระบบอัตโนมัติ, กรณีทดสอบ, แอปมือถือ, ตารางเวลา, geo snaps, บันทึกย่อ, รายการเวลา) เฉพาะเจ้าของ/ผู้จัดการ ไม่สามารถลบโปรเจกต์สุดท้ายได้ พื้นที่จัดเก็บจะถูกปลดปล่อยโดยอัตโนมัติ
export_okf_bundle — ส่งออกความรู้ด้าน QA ของโปรเจกต์ — รายงานบั๊ก, กรณีทดสอบ, ระบบอัตโนมัติ และการทดสอบประสิทธิภาพ, ความปลอดภัย และการสำรวจ — เป็นชุด markdown 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 — แสดงสมาชิกทั้งหมดของเวิร์กสเปซของคุณพร้อมบทบาท สถานะ และแฟล็ก booster
invite_team_member — เชิญผู้ใช้ทางอีเมล (ผู้จัดการสามารถเชิญผู้มีส่วนร่วมและผู้จัดการ; เฉพาะเจ้าของเท่านั้นที่สามารถเชิญผู้ดูแลระบบ) ลิงก์หมดอายุใน 5 วัน

🎯

การผสานรวม

sync_to_jira — ซิงก์รายงานไปยัง Jira โดยใช้การเชื่อมต่อที่ใช้ร่วมกันของทีม
push_to_claude — สร้าง (หรือสร้างใหม่) Developer Notes สำหรับรายงานบั๊ก — สาเหตุต้นตอ, แนวทางการแก้ไขที่แนะนำ, ขั้นตอนการตรวจสอบ และการประเมินความเสี่ยง รับ UUID หรือรหัสย่อ (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 — สร้าง (หรือสร้างใหม่) บล็อกย่อย "Likely Fix Area" ของ Developer Notes — ผลลัพธ์แคบจาก Sonnet ที่ระบุว่าการแก้ไขน่าจะอยู่ในส่วนใดของโค้ดเบส รับ UUID หรือรหัสย่อ ใช้คีย์ Anthropic ของแพลตฟอร์ม เมื่อทีมมีแถว github_connections และโปรเจกต์มี github_repo ที่แมปไว้ ผลลัพธ์จะอ้างอิงจากตัวอย่างไฟล์จริงจาก repo ที่เชื่อมต่อ; มิฉะนั้นจะลดหลั่นไปเป็นคำแนะนำทั่วไปพร้อมคำแนะนำให้เชื่อมต่อ repo คืนข้อความ likely_fix_area, generated_at, repo_used และแฟล็ก grounded ทำงานอัตโนมัติเมื่อสร้างบั๊ก — เอเจนต์โดยทั่วไปต้องเรียกนี้เฉพาะเมื่อต้องการสร้างใหม่ด้วยตนเอง
upgrade_plan — รับลิงก์ลงทะเบียน Enterprise แบบมีฝ่ายขายช่วยเหลือ

⚡

การทดสอบประสิทธิภาพ

create_performance_test — สร้างการกำหนดค่าการทดสอบประสิทธิภาพด้วย URL, อุปกรณ์, ผู้ใช้เสมือน, ระยะเวลา, เกณฑ์คะแนน และสวิตช์สร้างบั๊กอัตโนมัติ เฉพาะ Enterprise
run_performance_test — เรียกใช้การตรวจสอบหน้าเว็บและการทดสอบโหลดสำหรับการทดสอบประสิทธิภาพเว็บ คืน run ID เพื่อใช้สอบถามผลลัพธ์ การรันโปรไฟล์แอปมือถือจะถูกเรียกจากแดชบอร์ด
get_performance_results — รับผลลัพธ์ทั้งหมดรวมถึงคะแนน Lighthouse (Performance, Accessibility, Best Practices, SEO), Core Web Vitals (LCP, FID, CLS, FCP, TTFB, INP, TBT, SI) และเมตริกการทดสอบโหลด (VUs, requests, RPS, p50/p90/p95/p99 latencies)
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 รายการ) พร้อมระดับความลึก 3 ระดับ และรองรับการสแกนแบบต้องมีการรับรองความถูกต้อง (authenticated scanning) การสแกนมือถือใช้ MobSF สำหรับการวิเคราะห์ไบนารี APK/IPA รองรับการสร้างบั๊กอัตโนมัติพร้อมเกณฑ์ระดับความรุนแรง เฉพาะแผน Enterprise เท่านั้น
run_security_scan — เรียกใช้การสแกนหาช่องโหว่ การสแกนเว็บต้องมีการยืนยันโดเมน DNS การสแกนมือถือต้องมีการอัปโหลดแอป คืนค่า run ID เพื่อใช้ตรวจสอบผลลัพธ์
get_security_results — รับผลลัพธ์ทั้งหมด รวมถึงคะแนนความปลอดภัย (0–100) ข้อค้นพบที่จัดหมวดหมู่ตามระดับความรุนแรง (Critical, High, Medium, Low, Info) พร้อมการอ้างอิง 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 รายสัปดาห์บนสาขาหลัก)
get_security_results → ตรวจสอบข้อค้นพบและแนวทางการแก้ไข

📖

Code Review

list_code_reviews — แสดงรายการ AI code review ล่าสุดของทีม คืนค่าคะแนนคุณภาพ จำนวนตามระดับความรุนแรง ข้อมูล PR และ timestamp เฉพาะแผน Enterprise เท่านั้น
get_code_review — รับ code review พร้อมข้อค้นพบทั้งหมด ข้อค้นพบแต่ละรายการประกอบด้วยระดับความรุนแรง หมวดหมู่ (bug/security/performance/style/logic/maintainability) ชื่อเรื่อง คำอธิบาย ข้อเสนอแนะโค้ด เส้นทางไฟล์ และหมายเลขบรรทัด
get_code_review_usage — ตรวจสอบการใช้งาน code review AI code review มีเฉพาะ Enterprise และไม่จำกัดบน Enterprise
get_code_review_analytics — รับ analytics ของรีวิว: แนวโน้ม หมวดหมู่/แหล่งที่มาของข้อค้นพบ การแบ่งตามระดับความรุนแรง เมตริกความเร็ว (velocity) อันดับ repo/ผู้เขียน รองรับการมองย้อนหลัง 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 — รับการกำหนดค่าการสำรวจ พร้อมการตั้งค่าเอเจนต์ เมทาดาทาการรับรองความถูกต้องที่ปลอดภัย และการรันล่าสุด รหัสผ่านและ ciphertext จะไม่ถูกส่งกลับมาเด็ดขาด
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 → ตรวจสอบความคืบหน้าและข้อค้นพบรายเอเจนต์
ดูข้อค้นพบที่ขจัดข้อมูลซ้ำพร้อมการระบุแหล่งที่มาของเอเจนต์ในแดชบอร์ด

📝

Notes

list_notes — แสดงรายการโน้ตพร้อมการค้นหาด้วยคีย์เวิร์ดแบบไม่บังคับ ตัวกรองโปรเจกต์ ตัวกรองผู้เขียน และช่วงวันที่ คืนค่าโน้ตที่ผู้ใช้เป็นเจ้าของหรือโน้ตที่แชร์ภายในทีม
create_note — สร้างโน้ตใน 1 ใน 5 รูปแบบ: markdown, plain_text, rich_text, checklist, outline ตั้งค่า visibility เป็น private หรือ shared ตั้งชื่อเรื่องอัตโนมัติจาก 30 ตัวอักษรแรกหากไม่มีการระบุชื่อเรื่อง อาร์เรย์ attachments แบบไม่บังคับ รองรับไฟล์ที่เข้ารหัส base64 สูงสุด 400 MB ต่อไฟล์: รูปภาพ วิดีโอ เสียง PDF หรือ text/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 → ดึงโน้ตแบบเต็มพร้อมไฟล์แนบ

🤖

Automation

create_automation — สร้าง automation ใหม่ด้วยสคริปต์ Playwright ที่กำหนดเอง (ไม่ต้องใช้การบันทึก FAB) ต้องระบุ name ไม่บังคับ: target_url (ดึงอัตโนมัติจาก URL page.goto(...) แรกในสคริปต์หากละเว้น), script (Node.js/JavaScript/TypeScript หรือ Python — ภาษาจะถูกตรวจจับอัตโนมัติ ค่าเริ่มต้นเป็นตัวยึดตำแหน่ง), status (draft หรือ active, ค่าเริ่มต้น: draft), project_id คืนค่า id ของ automation ต้องใช้แผน Enterprise เคล็ดลับ — ทำสำเนา automation: ใช้ get_automation เพื่อดึงสคริปต์ต้นฉบับ จากนั้นเรียก create_automation โดยตั้ง name เป็น "[Copy] Original Name" และส่ง script, target_url และ project_id ต้นฉบับ สำเนาจะเริ่มต้นด้วยสถานะ draft โดยไม่มีประวัติเวอร์ชัน
list_automations — แสดงรายการสคริปต์ Playwright automation กรองโดย project_id หรือ status (draft, active, paused) คืนค่าอาร์เรย์ของ automation พร้อมชื่อ, target_url, last_run_status และ run_count
get_automation — รับรายละเอียด automation แบบเต็ม รวมถึงสคริปต์ Playwright และการรันล่าสุด ต้องระบุ id คืนค่า automation พร้อม script ที่ใช้งานจริง สแตก script_versions (เรียงจากเก่าไปใหม่ สูงสุด 100 รายการก่อนหน้า แต่ละรายการคือ { script, source, timestamp }) และอาร์เรย์ recent_runs ที่การรันแต่ละครั้งบรรจุ script_version_label/script_version_source ที่ใช้ดำเนินการ เรียกสิ่งนี้ก่อน run_automation หากคุณต้องการเลือกเวอร์ชันประวัติที่เฉพาะเจาะจง
run_automation — เรียกใช้การทดสอบ Playwright ทันที ต้องระบุ automation_id Locator แบบซ่อมตัวเอง (อัตโนมัติ): เมื่อการทำงานของ locator หมดเวลา runner จะขอให้ Claude เลือก selector ที่ใช้งานได้และลองขั้นตอนนั้นซ้ำหนึ่งครั้ง — assertions จะไม่ถูกซ่อม ดังนั้น regression จริงจะยังคงล้มเหลว — และการซ่อมแต่ละครั้งจะถูกบันทึกลงใน stdout ของการรัน โหมดเสมือน (ค่าเริ่มต้น): device แบบไม่บังคับสำหรับการจำลอง viewport (เช่น desktop, iphone-15) โหมด Live: ตั้งค่า browserstack: true พร้อม bs_browser (chrome, firefox, safari, edge), bs_os (Windows, OS X) และ bs_os_version เพื่อรันบนเบราว์เซอร์เดสก์ท็อปจริง Live บนมือถือจริง: ตั้งค่า 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 ของ automation ค่าเริ่มต้น: เมื่อละเว้น version_index หรือเป็น null สคริปต์ปัจจุบันจะถูกเรียกใช้ — อย่าส่งค่าตัวยึดตำแหน่งเพียงเพื่อ "เลือกเวอร์ชันปัจจุบัน" ค่าที่เกินช่วง ติดลบ หรือไม่ใช่จำนวนเต็มจะถูกปฏิเสธ บันทึกการรันจะเก็บ snapshot ที่แน่นอนที่รัน และรายงานบั๊กใด ๆ ที่สร้างอัตโนมัติจากการรันที่ล้มเหลวจะลิงก์ลึกกลับไปยังเวอร์ชันนั้นในตัวแก้ไข
list_automation_runs — แสดงรายการการรันล่าสุดของ automation ต้องระบุ automation_id คืนค่าการรันพร้อมสถานะ, duration_ms และ error_message
list_schedules — แสดงรายการการรัน web automation ตามกำหนดการทั้งหมด พร้อม cron, โซนเวลา, อุปกรณ์ และการตั้งค่าการแจ้งเตือน
create_schedule — สร้างการรัน web automation ตามกำหนดการ ต้องระบุ 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 — ลบการรัน web automation ตามกำหนดการ
list_mobile_schedules — แสดงรายการการรัน mobile automation ตามกำหนดการทั้งหมด พร้อมอุปกรณ์, cron, โซนเวลา และการแจ้งเตือน
create_mobile_schedule — สร้างการรัน mobile automation ตามกำหนดการบนอุปกรณ์จริง ต้องระบุ automation_id, cron_expression และอาร์เรย์ devices
delete_mobile_schedule — ลบการรัน mobile automation ตามกำหนดการ
optimize_automation_script — ส่งสคริปต์ Playwright ให้ Sonnet 4 เพื่อการปรับให้เหมาะสมด้วย AI ใช้รายการตรวจสอบ 12 จุดที่แก้ไข selectors, กลยุทธ์การรอ, assertions, การจัดการข้อผิดพลาด, รูปแบบการรับรองความถูกต้อง, ความเข้ากันได้กับมือถือ และโหมดเข้มงวด ต้องระบุ automation_id เวอร์ชันสคริปต์ปัจจุบันจะถูกบันทึกก่อนการปรับให้เหมาะสม คืนค่าสคริปต์ที่ปรับแล้วและสรุปการเปลี่ยนแปลง
undo_automation_script — เปลี่ยนสคริปต์ automation กลับเป็นเวอร์ชันก่อนหน้า เก็บเวอร์ชันก่อนหน้าได้สูงสุด 10 เวอร์ชัน ต้องระบุ automation_id คืนค่าสคริปต์ที่กู้คืนและจำนวนเวอร์ชันที่เหลือ

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

⏱️

Time Tracking

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

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

☑️

Test Cases

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

ขีดจำกัดของแผนฟรี: กรณีทดสอบที่จัดเก็บ 10 รายการ ชุดทดสอบ 1 ชุด โฟลเดอร์ 3 โฟลเดอร์ เนื้อหาแบบมีโครงสร้าง 128 KB ต่อกรณี คีย์ API ของเวิร์กสเปซที่ใช้งานอยู่ 2 คีย์ และการรันทดสอบทั้งหมด 10 ครั้งต่อเดือนปฏิทิน UTC ในการรันเหล่านั้นสูงสุด 3 ครั้งอาจใช้ Hermes หรือเอเจนต์ภายนอกอื่น โดยมีการรันภายนอกที่ใช้งานอยู่ 1 รายการและกรณีสูงสุด 10 กรณีในแต่ละแผนภายนอก ปริมาณการรับส่ง MCP ของคีย์ API ฟรีจำกัดที่ 30 คำขอต่อคีย์และ 60 ต่อเวิร์กสเปซต่อนาที การจัดเก็บกรณีทดสอบและการรันขององค์กรไม่จำกัด ภายใต้การป้องกันแพลตฟอร์มทั่วไป

การสร้างกรณีทดสอบด้วย AI คำแนะนำแท็กด้วย AI การนำเข้า Figma และไฟล์แนบกรณีทดสอบต้องใช้แผน Enterprise ขีดจำกัดเนื้อหาแบบมีโครงสร้าง 128 KB ของแผนฟรีแยกจากการแนบไฟล์ของ Enterprise แผนฟรีสามารถจัดเก็บการอ้างอิง URL ได้ เครื่องมือ MCP หลักสำหรับกรณีทดสอบยังคงใช้งานได้บนแผนฟรีภายใต้ขีดจำกัดข้างต้น

การดำเนินการแบบไม่ใช้มือ: หน้ารีวิวการรันเป็นรูปแบบคารูเซลที่แสดงทีละกรณี มีปุ่มลัดคีย์บอร์ด (P Pass · F Fail · B Block · S Skip) และการควบคุมด้วยเสียง คลิกไมโครโฟนแล้วพูด "Pass" "Fail" "Block" "Skip" "Next" "Previous" "Add notes" (ถอดเสียงลงในช่องบันทึก) "Save notes" หรือ "Voice off" เลื่อนอัตโนมัติไปยังกรณีถัดไปที่ยังไม่ทดสอบเมื่อผลสำเร็จ คงอยู่ที่ผล Fail เพื่อให้ผู้ทดสอบสามารถบอกรายละเอียดและสร้างบั๊กได้ ทำงานใน 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) ผู้เรียกผ่านคีย์ API ต้องมี test_cases:read
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 (วินาที) การแนบไฟล์ต้องใช้ Enterprise และอัปโหลดผ่านเอนด์พอยต์ POST /api/test-cases/:id/attachments ของแดชบอร์ด (multipart) — ยังไม่เปิดเป็นเครื่องมือ MCP ผู้เรียกผ่านคีย์ API ต้องมี test_cases:write
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 เพื่อย้ายกรณีเข้าไป ผู้เรียกผ่านคีย์ API ต้องมี test_cases:write
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 (Enterprise) (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 — แสดงรายการชุดทดสอบพร้อมข้อมูลประจำตัวโปรเจกต์ จำนวนกรณี และสถานะการรันล่าสุด ผู้เรียกผ่านคีย์ API ต้องมี test_runs:read
create_test_suite — สร้างชุดทดสอบ ซ้อนได้ลึกถึง 3 ระดับผ่าน parent_suite_id
list_test_runs — แสดงรายการการรันทดสอบพร้อมชื่อชุดทดสอบ ผู้รับผิดชอบ และสรุปผ่าน/ไม่ผ่าน
create_test_run — สร้างการรันชุดทดสอบที่จัดการโดยแดชบอร์ด การรันชุดทดสอบหลักจะรวมทุกกรณีในชุดย่อยทุกระดับโดยอัตโนมัติ (กรณีที่เชื่อมโยงกับทั้งสองจะถูกเพิ่มเพียงครั้งเดียว) แต่ละแถว test_run_results บันทึกว่ากรณีมาจากชุดย่อยต้นทางใด เพื่อให้หน้าผลลัพธ์สามารถจัดกลุ่มตามต้นทางได้

การดำเนินการโดยเอเจนต์ภายนอก

เครื่องมือเหล่านี้ให้ Hermes หรือรันไทม์เอเจนต์อื่นดำเนินการชุดทดสอบที่ได้รับการอนุมัติโดยไม่ต้องเป็นระบบบันทึก QA หลัก ใช้คีย์ที่จำกัดขอบเขตเวิร์กสเปซที่มีเฉพาะ test_runs:read และ test_runs:write เท่านั้น ชุดทดสอบกำหนดขอบเขตโปรเจกต์ ผู้เรียกไม่สามารถแทนที่ได้

start_test_plan — เริ่มหรือดำเนินการต่อสแนปช็อตชุดทดสอบที่ไม่เปลี่ยนแปลงพร้อม external_run_id ที่เสถียร ID ที่ส่งซ้ำจะส่งคืนการรันที่ตรงกันที่มีอยู่และหน้าแรกแทนการสร้างรายการซ้ำ
get_test_run_plan — อ่านสถานะการรันตามมาตรฐานและหน้าแผนที่เสถียร ส่ง next_cursor ก่อนหน้า; หน้าเริ่มต้นที่ 100 กรณีและจำกัดสูงสุดที่ 200
report_test_results — ส่งผลลัพธ์ 1–200 รายการพร้อมสถานะ passed, failed, blocked หรือ skipped การลองซ้ำแบบเหมือนเดิมปลอดภัย; การพยายามเขียนทับกรณีด้วยสถานะอื่นจะถูกปฏิเสธ
abort_test_run — หยุดการรันที่ถูกขัดจังหวะแบบ idempotent พร้อมรักษาผลลัพธ์บางส่วนที่ยอมรับและสรุปตามมาตรฐาน

พฤติกรรมโควตา: ลอง start_test_plan อีกครั้งด้วย external_run_id เดียวกันเพื่อดำเนินการต่อการรันที่ตรงกันโดยไม่ใช้การรันเพิ่ม การลบข้อมูลไม่รีเซ็ตการใช้งานการรันรายเดือน

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

คู่มือ Hermes Agent แพ็กเกจลูปนี้เป็นทักษะชุมชนที่ดูแลโดย bugAgent ชุดเริ่มต้นสาธารณะประกอบด้วยคอนฟิกที่พร้อมคัดลอกและทักษะที่ติดตั้งได้ ไม่ใช่การผสานรวมอย่างเป็นทางการของ Nous Research

รายงาน (การวิเคราะห์ Tier 1 + Tier 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 → สร้างการรันที่จัดการโดยมนุษย์/แดชบอร์ดจากชุดทดสอบหลัก — รวมชุดย่อยอัตโนมัติ
start_test_plan → เริ่มหรือดำเนินการต่อการรันเอเจนต์ภายนอกที่ปลอดภัยต่อการลองซ้ำ
get_test_run_plan → ดึงทุกหน้าแผนที่ไม่เปลี่ยนแปลง จากนั้นดำเนินการในรันไทม์ที่เลือก
report_test_results → ส่งคืนชุดผลลัพธ์ที่จำกัดขอบเขต; เรียก abort_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 ใช้ได้ในแผน Enterprise คุณจะไม่ถูกเรียกเก็บเงินจนกว่าจะได้รับการอนุมัติ

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

📱

การทดสอบบนมือถือ (Enterprise)

ทรัพยากรบนมือถือจำกัดขอบเขตตามโปรเจกต์ ส่ง project_id หรือตัวเลือก project แบบยืดหยุ่นในการสร้าง การนำเข้า และรายการที่กรองแล้ว ระบบอัตโนมัติสืบทอดโปรเจกต์ของแอปที่เชื่อมโยง; มิฉะนั้นเซิร์ฟเวอร์ใช้โปรเจกต์เริ่มต้นของเวิร์กสเปซ รายการที่ไม่กรองอาจยังรวมแถวระดับเวิร์กสเปซแบบเดิมจนกว่าจะถูกย้าย

list_mobile_apps — แสดงรายการแอปที่อัปโหลด พร้อมตัวกรอง project_id/project, platform, และ limit หากต้องการ คืนค่า project_id ของแต่ละแอป เพื่อให้เอเจนต์สามารถดำเนินการถัดไปในโปรเจกต์เดียวกันได้
upload_mobile_app — ลงทะเบียนแอป APK (Android) หรือ IPA (iOS) เพื่อทดสอบบนอุปกรณ์จริง ต้องระบุ name, platform (android/ios), และ file_url; ระบุ project_id เพื่อกำหนดให้กับโปรเจกต์ที่ใช้งานอยู่ สำหรับ iOS ให้อัปโหลด IPA สำหรับการรันบนอุปกรณ์จริง แล้วใช้แดชบอร์ดอัปโหลดบิลด์ .app ของซิมูเลเตอร์เพื่อการบันทึก
update_mobile_app — แทนที่ไบนารีแอปด้วยเวอร์ชันใหม่ ล้าง URL ที่แคชและบิลด์ซิมูเลเตอร์ เพื่อให้ระบบอัตโนมัติทั้งหมดใช้เวอร์ชันใหม่ในการรันครั้งถัดไป ต้องระบุ app_id และ file_url เพิ่มเติมได้: version หากระบบอัตโนมัติที่เชื่อมโยงใช้โปรไฟล์เข้าสู่ระบบ ผู้เรียกต้องได้รับอนุญาตสำหรับทุกโปรไฟล์หรือเป็นเจ้าของ/ผู้ดูแลเวิร์กสเปซที่ใช้งานอยู่ ตารางเวลาจะสืบทอดค่าเริ่มต้นของระบบอัตโนมัติที่ได้รับการป้องกัน
list_mobile_automations — แสดงรายการระบบอัตโนมัติบนมือถือ พร้อมตัวกรอง project_id/project, app_id, status, และ limit หากต้องการ ผลลัพธ์รวม project_id และ ID แอปที่เชื่อมโยง
create_mobile_automation — สร้างสคริปต์ทดสอบ ต้องระบุ name, app_id, script_type (maestro สำหรับ YAML, appium สำหรับ Appium Python, appium_js สำหรับ Appium JavaScript), และ script; ระบุ project_id เมื่อแอปไม่ได้อยู่ในขอบเขตโปรเจกต์แล้ว สำหรับโฟลว์ Maestro YAML แบบสมบูรณ์ที่ตรวจสอบภายนอกหนึ่งชุด ให้ตั้งค่า execution_mode เป็น browserstack_maestro; มิฉะนั้นค่าเริ่มต้นคือ appium_actions appId ของ YAML ต้องตรงกับ package หรือ bundle ID ที่เก็บไว้ของแอปที่เชื่อมโยง; หากไม่มีข้อมูลที่เก็บไว้ โฟลว์เนทีฟที่ตรวจสอบแล้วตัวแรกจะกำหนดค่า ID แอปที่ใช้แทนที่และ ID ทรัพยากร Android ที่ถูกออบฟัสเคตจะถูกปฏิเสธ รองรับ runFlow แบบอินไลน์ แต่การอ้างอิงไฟล์โฟลว์/สคริปต์ภายนอกถูกปฏิเสธใน v1. Maestro เนทีฟรักษาคำสั่งเช่น inputRandomText และ copyTextFrom รวมถึงนิพจน์รันไทม์เช่น ${maestro.copiedText} และ ${output.value} credential_id ในโปรเจกต์เดียวกันอาจให้ค่า inputText ที่สมบูรณ์ของ ${USERNAME}/${PASSWORD} variable_profile_id ในโปรเจกต์เดียวกันอาจบันทึกค่าเริ่มต้นสำหรับค่า ${DATA_*} ที่อ้างอิง; ทุกคีย์ที่อ้างอิงต้องมีอยู่ โปรไฟล์ข้อมูลเป็นข้อมูลสังเคราะห์ที่ไม่ได้เป็นความลับเท่านั้น
import_mobile_script — นำเข้าสคริปต์ทดสอบบนมือถือที่มีอยู่แล้วแปลงเป็นระบบอัตโนมัติที่รันได้ โดยรักษา locators ของนักพัฒนาเองเพื่อให้การรันแก้ไของค์ประกอบอย่างแม่นยำ ไดอะเล็กต์ที่รองรับ: Appium‑Python, WebdriverIO, Maestro (โฟลว์ YAML), และ Playwright (มือถือ‑เว็บ) ตำแหน่ง ID ทรัพยากร Android ที่ถูกออบฟัสเคตจะถูกข้ามและรายงานใน warnings ของการแมปตัวเลือก เฉพาะแอป Android ต้องระบุ name, app_id, และ script; เพิ่มเติมได้ target_devices และ project_id คืนค่าระบบอัตโนมัติพร้อม action_count, dialect ที่ตรวจพบ และ warnings ของการแมปตัวเลือก
run_mobile_automation — เริ่มระบบอัตโนมัติบนมือถือบนอุปกรณ์จริง ต้องระบุ automation_id; เพิ่มเติมได้ device, os_version, credential_id, และ variable_profile_id ของ Maestro เนทีฟ สำหรับข้อมูล ให้ละเว้น variable_profile_id เพื่อรับค่าเริ่มต้นจากระบบอัตโนมัติ ระบุ null เพื่อไม่ใช้โปรไฟล์ หรือระบุ UUID ในโปรเจกต์เดียวกันเพื่อแทนที่ ทุกคีย์ ${DATA_*} ที่อ้างอิงต้องมีอยู่ เฉพาะผู้สร้างโปรไฟล์ที่ใช้งานอยู่หรือเจ้าของ/ผู้ดูแลเวิร์กสเปซที่ใช้งานอยู่เท่านั้นที่สามารถรันโปรไฟล์ที่เลือกได้ ค่าความลับที่ทราบแน่นอนจะถูกกรอง และค่าโปรไฟล์ข้อมูลที่แน่นอนจะได้รับการกรองแบบพยายามเต็มที่จากหลักฐานข้อความที่เก็บไว้; ค่าข้อมูลที่แปลงแล้ว บางส่วน เข้ารหัส หรือได้มาจากแอปอาจยังคงอยู่ วิดีโอ/ภาพหน้าจอส่วนตัวที่ได้รับอนุญาตยังคงพร้อมใช้งานและอาจแสดงค่าที่เรนเดอร์โดยแอปที่ทดสอบ ดังนั้นโปรไฟล์ข้อมูลต้องมีเฉพาะค่าสังเคราะห์ที่ไม่เป็นความลับ หากไม่มีบริบทการลบข้อมูลรับรองหรือไม่สามารถพิสูจน์ความปลอดภัยของการทำความสะอาดได้ ข้อความที่ละเอียดพร้อมข้อมูลรับรองจะถูกระงับ ในขณะที่สถานะและหลักฐานภาพที่มีอยู่ยังคงแสดง การวินิจฉัยต้องได้รับอนุญาตจากเวิร์กสเปซและโปรเจกต์; ลิงก์สื่อหมดอายุหลังจากห้านาที
list_mobile_runs — รับผลการรันบนมือถือที่ได้รับอนุญาต (สถานะ, อุปกรณ์, สรุปผล, ลิงก์วิดีโอและภาพหน้าจอส่วนตัว, เซสชัน BrowserStack, บันทึก Maestro เนทีฟที่กรองข้อมูลรับรองและความล้มเหลวเมื่อปลอดภัย และบั๊กที่สร้างอัตโนมัติ) การเป็นสมาชิกเวิร์กสเปซและการเข้าถึงโปรเจกต์ถูกบังคับใช้สำหรับการวินิจฉัยการรัน ตัวกรองเพิ่มเติม: project_id, automation_id, status (queued, running, passed, failed, error, archived), และ limit การรันที่เก็บถาวรถูกยกเว้นโดยค่าเริ่มต้น
create_mobile_credential — สร้างโปรไฟล์การเข้าสู่ระบบที่มีชื่อ (เช่น “Admin”, “Contributor”) สำหรับโปรเจกต์: ชื่อผู้ใช้ + รหัสผ่านที่ใช้โดยระบบอัตโนมัติบนมือถือ ค่าทั้งสองถูกจัดเก็บเข้ารหัส AES‑256‑GCM และเป็น เขียน‑เท่านั้น — ไม่มีเครื่องมือหรือ API ใดคืนค่าเหล่านั้น และสมาชิกอื่น / UI เห็นเพียงชื่อเท่านั้น เฉพาะสมาชิกเวิร์กสเปซที่ใช้งานอยู่ซึ่งเป็นผู้สร้างหรือเจ้าของ/ผู้ดูแลเวิร์กสเปซที่ใช้งานอยู่เท่านั้นที่สามารถผูก รัน หมุน หรือลบได้ ต้องระบุ project_id, name, username, password องค์กรเท่านั้น
list_mobile_credentials — แสดงรายการโปรไฟล์การเข้าสู่ระบบ (เลือกได้หนึ่ง project_id) คืนค่าเฉพาะฟิลด์ที่ไม่เป็นความลับ (id, name, โปรเจกต์, ผู้สร้าง, วันที่สร้าง) — ไม่เคยคืนชื่อผู้ใช้หรือรหัสผ่าน ใช้ id ที่คืนมาเป็นตัวเลือกข้อมูลรับรองเมื่อรันระบบอัตโนมัติ
update_mobile_credential — เปลี่ยนชื่อโปรไฟล์การเข้าสู่ระบบหรือหมุนชื่อผู้ใช้/รหัสผ่านโดยใช้ id ระบุเฉพาะฟิลด์ที่ต้องการเปลี่ยน ค่าความลับใหม่ถูกเข้ารหัสทันทีและไม่ถูกคืน เฉพาะสมาชิกเวิร์กสเปซที่ใช้งานอยู่ซึ่งเป็นผู้สร้างโปรไฟล์หรือเจ้าของ/ผู้ดูแลเวิร์กสเปซที่ใช้งานอยู่เท่านั้นที่สามารถอัปเดตได้
delete_mobile_credential — ลบโปรไฟล์การเข้าสู่ระบบแบบซอฟต์โดยใช้ id เฉพาะสมาชิกเวิร์กสเปซที่ใช้งานอยู่ซึ่งเป็นผู้สร้างโปรไฟล์หรือเจ้าของ/ผู้ดูแลเวิร์กสเปซที่ใช้งานอยู่เท่านั้นที่สามารถลบได้ ข้อมูลยังคงอยู่สำหรับการตรวจสอบและประวัติการรัน แต่ไม่สามารถใช้หรือแสดงรายการอีกต่อไป; ค่าเริ่มต้นของระบบอัตโนมัติถูกล้างและชื่อสามารถใช้ซ้ำได้
create_mobile_variable_profile — สร้างข้อมูลทดสอบสังเคราะห์ที่นำกลับมาใช้ใหม่ได้และผูกกับโปรเจกต์ด้วย project_id, name, และอ็อบเจ็กต์ variables เช่น {"DATA_EMAIL":"qa@example.test","DATA_REGION":"ca"} คีย์ต้องเป็นตัวระบุ DATA_* ตัวพิมพ์ใหญ่ โปรไฟล์อนุญาต 1–100 สตริง, 4096 ไบต์ UTF-8 ต่อค่า, และรวม 65536 ไบต์ ชื่อที่สงวนไว้สำหรับข้อมูลรับรอง/รันไทม์จะถูกปฏิเสธ ห้ามเก็บข้อมูลรับรอง โทเค็น ข้อมูลส่วนบุคคลการผลิต หรือความลับอื่น ๆ
list_mobile_variable_profiles — แสดงรายการโปรไฟล์และค่าที่ไม่เป็นความลับที่อ่านได้สำหรับ project_id ที่ได้รับอนุญาตหนึ่งรายการ กฎการกำหนดโปรเจกต์มีผล
update_mobile_variable_profile — เปลี่ยนชื่อโปรไฟล์หรือแทนที่อ็อบเจ็กต์ variables ทั้งหมดโดยใช้ id เฉพาะผู้สร้างที่ใช้งานอยู่หรือเจ้าของ/ผู้ดูแลเวิร์กสเปซที่ใช้งานอยู่เท่านั้นที่สามารถอัปเดตได้
delete_mobile_variable_profile — ลบโปรไฟล์แบบซอฟต์โดยใช้ id เฉพาะผู้สร้างที่ใช้งานอยู่หรือเจ้าของ/ผู้ดูแลเวิร์กสเปซที่ใช้งานอยู่เท่านั้นที่สามารถลบได้; ค่าเริ่มต้นของระบบอัตโนมัติถูกล้างในขณะที่การอ้างอิงประวัติการรันยังคงอยู่
list_mobile_schedules, create_mobile_schedule, delete_mobile_schedule — แสดงรายการ สร้าง และลบตารางเวลาอุปกรณ์จริง ตารางเวลาสืบทอดบริบทโปรเจกต์ โปรไฟล์การเข้าสู่ระบบ และโปรไฟล์ตัวแปรที่ไม่เป็นความลับจากระบบอัตโนมัติที่เลือก ตารางเวลาที่ใช้โปรไฟล์ที่ได้รับการป้องกันใด ๆ ต้องมีผู้สร้างโปรไฟล์ที่ใช้งานอยู่หรือเจ้าของ/ผู้ดูแลเวิร์กสเปซที่ใช้งานอยู่; การเปลี่ยนแปลงและการลบตารางเวลาจำกัดเฉพาะผู้สร้างตารางเวลาที่ใช้งานอยู่หรือเจ้าของ/ผู้ดูแลเวิร์กสเปซที่ใช้งานอยู่

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

list_projects → ระบุ project_id เป้าหมาย
upload_mobile_app → ลงทะเบียน APK ในโปรเจกต์นั้น
บันทึกอย่างปลอดภัยในแดชบอร์ด หรือใช้ import_mobile_script / create_mobile_automation
list_mobile_automations → ระบุระบบอัตโนมัติในโปรเจกต์เดียวกัน
run_mobile_automation → เรียกใช้บนอุปกรณ์จริง อาจมีโปรไฟล์การเข้าสู่ระบบ
list_mobile_runs → ตรวจสอบสถานะ สรุปผล ลิงก์ภาพส่วนตัว และข้อมูลเมตาเซสชัน BrowserStack
ความล้มเหลวสร้างรายงานบั๊กอัตโนมัติพร้อมสแน็ปช็อตความล้มเหลวและการแจกแจงขั้นตอน

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

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

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

upload_mobile_app → ลงทะเบียน APK หรือ IPA ในโปรเจกต์เป้าหมาย
create_mobile_credential → เลือกสร้างโปรไฟล์ในโปรเจกต์เดียวกันสำหรับโฟลว์ที่ต้องมีการรับรองความถูกต้อง
create_mobile_variable_profile → เลือกสร้างค่า DATA_* สังเคราะห์ในโปรเจกต์เดียวกันที่ใช้โดยโฟลว์
create_mobile_automation → ระบุโฟลว์ YAML ที่ทำงานได้หนึ่งชุดพร้อม package/bundle appId ที่แน่นอนของแอปที่เชื่อมโยง, script_type: maestro, และ execution_mode: browserstack_maestro ใช้ ${USERNAME}/${PASSWORD} สำหรับการเข้าสู่ระบบและตัวแทน ${DATA_EMAIL}-สไตล์สำหรับอินพุตสังเคราะห์; ระบุ ID โปรไฟล์เพื่อบันทึกค่าเริ่มต้น
run_mobile_automation → เลือกอุปกรณ์ที่เข้ากันได้และเลือกแทนที่โปรไฟล์การเข้าสู่ระบบหรือตัวแปร ละเว้นโปรไฟล์ตัวแปรเพื่อรับค่าเริ่มต้น หรือระบุ null เพื่อปิดใช้งานในการรันครั้งเดียว
list_mobile_runs → ตรวจสอบสรุปผ่าน/ล้มเหลวที่ได้รับอนุญาต วิดีโอ/ภาพหน้าจอส่วนตัว บันทึกที่กรอง ชื่อขั้นตอนจริง รายละเอียดความล้มเหลว และข้อมูลเมตาเซสชัน หากไม่สามารถสร้างความปลอดภัยการทำความสะอาดสำหรับการรันที่มีข้อมูลรับรอง ข้อความละเอียดจะถูกระงับในขณะที่สถานะและหลักฐานภาพที่มีอยู่ยังคงแสดง

ปรับปรุงด้วย AI: เบต้าที่อนุญาตมีให้ผ่านแดชบอร์ดและจุดสิ้นสุด REST สำหรับการปรับปรุง ยังไม่มีเครื่องมือ Refine MCP ในแคตตาล็อกสาธารณะ

✅

การปฏิบัติตามข้อกำหนดและหลักฐาน (องค์กร)

collect_compliance_evidence — เรียกใช้การรวบรวมหลักฐานอัตโนมัติจากบริการที่เชื่อมต่อ (Cloudflare, GitHub, Sentry, Supabase, Railway) คืนค่า run 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"]
Environment: BUGAGENT_API_KEY

CLI

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

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

ทำให้เวิร์กโฟลว์เป็นอัตโนมัติ — ผสานการรายงานบั๊กเข้ากับไปป์ไลน์ CI/CD สคริปต์ และ cron jobs
ดำเนินการแบบกลุ่ม — ดูรายการ กรอง และจัดการรายงานโดยไม่ต้องออกจากเทอร์มินัล
เอาต์พุตที่รองรับไปป์ — รูปแบบ 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 keys

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 ที่เหมาะสมและดำเนินการ

🎬

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

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

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

ชุมชน Discord

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

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

support@bugagent.com — เรามักจะตอบกลับภายใน 24 ชั่วโมง