bugAgent MCP Server

resmi

Hubungkan bugAgent ke klien AI yang kompatibel dengan MCP. Ajukan, klasifikasikan, dan kelola bug, permintaan fitur, dan lainnya langsung dari asisten coding AI Anda. Tanpa perpindahan konteks, tanpa salin-tempel — cukup jelaskan masalahnya dan bugAgent menangani sisanya.

Lihat di bugagent.com

Dokumentasi

MCP v1

Navigasi

Model Context Protocol

MCP

Hubungkan bug_Agent_ ke klien AI apa pun yang kompatibel dengan MCP.

Ajukan, klasifikasikan, dan kelola bug, permintaan fitur, dan lainnya langsung dari asisten coding AI Anda. Tanpa perpindahan konteks, tanpa salin-tempel — cukup jelaskan masalahnya dan bug_Agent_ akan menangani sisanya.

Dukungan Komunitas Discord [email protected]

Memulai

Server MCP bug_Agent_ memungkinkan klien AI membuat, menanyakan, dan mengelola laporan bug, permintaan fitur, peningkatan, dan lainnya melalui Model Context Protocol. Server ini berjalan secara lokal dan berkomunikasi dengan API cloud bug_Agent_.

Dapatkan kunci API Anda

Daftar di app.bugagent.com dan buat kunci API dari konsol.

Konfigurasikan klien AI Anda

Tambahkan bug_Agent_ sebagai server MCP di konfigurasi klien Anda (lihat pengaturan di bawah).

Mulai ajukan bug

Deskripsikan bug dalam bahasa alami dan bug_Agent_ akan mengklasifikasikan, memperkaya, dan menyimpannya secara otomatis.

Contoh Cepat

# 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

Pengaturan

Instalasi

Tidak diperlukan instalasi global. Gunakan npx untuk menjalankan server MCP sesuai permintaan:

npx @bugagent/mcp-server

Konfigurasikan kunci API Anda

Saat pertama kali terhubung, bug_Agent_ akan meminta kunci API Anda. Anda juga dapat mengaturnya melalui variabel lingkungan:

export BUGAGENT_API_KEY=ba_live_your_key_here

Dapatkan kunci API Anda dari konsol bug_Agent_.

Konfigurasi Klien MCP

Tambahkan yang berikut ini ke file konfigurasi klien MCP Anda:

mcp.json

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

💡

Ganti ba_live_your_key_here dengan kunci API Anda yang sebenarnya dari konsol.

Hubungkan ke Server

Server MCP bug_Agent_ tersedia di https://mcp.bugagent.com/mcp melalui transport HTTP Streamable. Hubungkan dari salah satu dari delapan klien di bawah ini — pilih yang sesuai dengan alur kerja Anda.

🔑

Dapatkan kunci API Anda terlebih dahulu. Masuk ke app.bugagent.com/dashboard/settings/api-keys, klik Buat Kunci API, dan salin nilainya (dimulai dengan ba_live_). Anda hanya akan melihatnya sekali, jadi tempelkan di tempat yang aman. Setiap contoh di bawah ini menggunakan kunci ini.

Opsi 1 — Inspektur MCP (UI Web, direkomendasikan untuk pengujian pertama)

Alat resmi Anthropic. Memutar UI web lokal tempat Anda dapat mengklik setiap alat, mengisi parameter, dan melihat respons. Tanpa konfigurasi, tidak perlu IDE.

macOS (Terminal)

Terminal

npx @modelcontextprotocol/inspector

Windows (PowerShell atau CMD)

PowerShell

Di UI browser yang terbuka:

Jenis Transport: pilih Streamable HTTP
URL: https://mcp.bugagent.com/mcp
Jenis Koneksi: pilih Proxy (default — Inspektur memproksi melalui proses Node lokal untuk melewati CORS browser)
Klik tab Autentikasi → tambahkan header khusus:
- Nama Header: Authorization
- Nilai: Bearer ba_live_YOUR_KEY_HERE
Klik Hubungkan. Anda akan melihat semua 60+ alat bug_Agent_ di panel kiri.
Klik alat apa pun (mis. list_bug_reports), isi parameter, klik Jalankan Alat. Respons muncul di sebelah kanan.

Prasyarat: Node.js 18 atau yang lebih baru. Instal dari nodejs.org jika Anda belum memilikinya.

Opsi 2 — Claude Desktop (Mac + Windows)

Jika Anda menggunakan aplikasi Claude Desktop, Anda dapat menambahkan bug_Agent_ sebagai server MCP permanen. Claude kemudian akan memiliki semua alat bug_Agent_ yang tersedia di setiap percakapan.

macOS

Buka Claude Desktop → bilah menu Claude → Pengaturan → Pengembang → Edit Konfigurasi. Ini membuka ~/Library/Application Support/Claude/claude_desktop_config.json.
Tambahkan entri bug_Agent_ di bawah mcpServers:
claude_desktop_config.json

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

Simpan file dan keluar sepenuhnya dari Claude Desktop (Cmd+Q, jangan hanya menutup jendela).
Luncurkan kembali Claude Desktop. Ikon palu alat di bagian bawah input obrolan sekarang seharusnya menampilkan alat bug_Agent_.
Cobalah: ketik “Tampilkan 5 laporan bug terbaru saya” — Claude akan memanggil list_bug_reports secara otomatis.

Windows

Buka Claude Desktop → File → Pengaturan → Pengembang → Edit Konfigurasi. Ini membuka %APPDATA%\Claude\claude_desktop_config.json (biasanya C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json).
Tambahkan blok JSON yang sama seperti yang ditunjukkan di bagian macOS.
Simpan file dan keluar sepenuhnya dari Claude Desktop dari baki sistem (klik kanan ikon Claude → Keluar), lalu luncurkan kembali.
Ikon palu alat akan menampilkan alat bug_Agent_.

Opsi 3 — Claude Code (CLI)

Jika Anda menggunakan Claude Code dari terminal (versi CLI Claude), daftarkan server bug_Agent_ dengan satu perintah. Bekerja identik di macOS, Linux, dan Windows.

Terminal / PowerShell

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

Kemudian mulai ulang sesi Claude Code Anda. Verifikasi bahwa sudah terhubung:

claude mcp list

Anda seharusnya melihat bugagent dalam daftar dengan titik hijau. Mulai gunakan alat di obrolan apa pun: “Tunjukkan penggunaan eksplorasi saya bulan ini.”

Untuk menghapusnya nanti:

claude mcp remove bugagent

Opsi 4 — OpenAI Codex CLI

Jika Anda menggunakan OpenAI Codex CLI, tambahkan bug_Agent_ ke ~/.codex/config.toml untuk pendaftaran permanen, atau berikan konfigurasi secara inline untuk sesi satu kali.

Pendaftaran permanen (tambahkan ke konfigurasi)

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

Inline — satu sesi

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 menyelesaikan panggilan alat secara otomatis dari prompt bahasa alami Anda. Coba: “Tampilkan bug terbuka saya yang diurutkan berdasarkan tingkat keparahan.”

Opsi 5 — Cursor (Mac + Windows)

Cursor memiliki dukungan MCP bawaan. Tambahkan bug_Agent_ sekali dan asisten AI di dalam Cursor dapat mengajukan bug, mencantumkan laporan, menjalankan pemindaian, dll. tanpa meninggalkan editor Anda.

Buka Cursor → Pengaturan (Cmd+, di Mac / Ctrl+, di Windows) → MCP di bilah sisi kiri.
Klik + Tambah server MCP baru.
Pilih jenis transport HTTP.
Isi:
- Nama: bugagent
- URL: https://mcp.bugagent.com/mcp
- Nama header: Authorization
- Nilai header: Bearer ba_live_YOUR_KEY_HERE
Klik Simpan. Cursor menampilkan indikator hijau saat terhubung.
Buka obrolan Cursor (Cmd+L / Ctrl+L) dan ketik “Buat laporan bug berjudul 'Login rusak' dengan tingkat keparahan tinggi.” Cursor akan memanggil create_bug_report.

Alternatif: Cursor juga membaca ~/.cursor/mcp.json (Mac) atau %USERPROFILE%\.cursor\mcp.json (Windows). Tambahkan format JSON yang sama seperti yang ditunjukkan di bagian Claude Desktop.

Opsi 6 — VS Code dengan ekstensi Continue (Mac + Windows)

Jika Anda lebih suka VS Code, ekstensi Continue mendukung server MCP secara native.

Instal ekstensi Continue dari marketplace VS Code.
Buka konfigurasi Continue: Palet Perintah (Cmd+Shift+P / Ctrl+Shift+P) → Continue: Buka config.json. File berada di:
- macOS: ~/.continue/config.json
- Windows: %USERPROFILE%\.continue\config.json
Tambahkan entri 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"  
        }  
      }  
    }  
  ]  
}

Simpan. Continue akan memuat ulang secara otomatis dan menampilkan alat bug_Agent_ di bilah sisi.
Buka panel obrolan Continue dan coba: “Tampilkan pemindaian keamanan saya.”

Ekstensi VS Code lain yang mendukung MCP: Cline, Roo Code, dan Windsurf (fork) semuanya mengikuti pola konfigurasi JSON yang serupa dengan kunci mcpServers dan transport HTTP.

Opsi 7 — Host yang sadar OAuth (Claude.ai web ditampilkan sebagai contoh)

Beberapa host MCP mengautentikasi melalui OAuth 2.0 dan meminta client_id statis dan client_secret di awal alih-alih menerima kunci API pembawa. Untuk host tersebut, Anda membuat pasangan kredensial OAuth dengan cakupan ruang kerja dari dasbor bug_Agent_ dan menempelkannya ke formulir konektor host. Kredensial ini tidak bergantung pada host MCP — klien OAuth mana pun yang mendukung Kode Otorisasi + PKCE dapat menggunakannya. Panduan di bawah ini menggunakan aplikasi web Claude.ai sebagai contoh paling umum.

Di bug_Agent_: buka Pengaturan → Pengembang → Konektor MCP. Klik Buat konektor, beri nama yang menjelaskan host (mis. “Claude.ai (kerja)”), tempelkan URI pengalihan yang diperlukan host MCP Anda (untuk aplikasi web Claude.ai adalah https://claude.ai/api/mcp/auth_callback — periksa dokumen konektor host Anda untuk yang lain), dan pilih Rahasia untuk metode autentikasi. Salin client_id dan client_secret yang ditampilkan sekali di layar sukses.
Di pengaturan konektor / OAuth host MCP Anda, tempelkan:
- URL Server: https://mcp.bugagent.com/mcp
- ID Klien + Rahasia Klien: dari langkah 1
- URL Otorisasi: https://mcp.bugagent.com/authorize
- URL Token: https://mcp.bugagent.com/token
  Untuk Claude.ai secara khusus: buka claude.ai/customize/connectors dan klik Tambah konektor MCP.
Simpan. Host mengarahkan Anda ke bug_Agent_ untuk masuk (Google atau email/kata sandi — metode apa pun yang Anda gunakan untuk dasbor) dan menyetujui persetujuan, lalu menyelesaikan jabat tangan OAuth.
Kelola dan cabut konektor yang dibuat dari halaman Pengaturan yang sama. Pencabutan berlaku segera — permintaan berikutnya dari konektor tersebut mengembalikan invalid_client.

Catatan: Claude Code, Cursor, VS Code, dan Inspektur MCP tidak memerlukan alur ini — mereka menangani pendaftaran klien dinamis (RFC 7591) secara otomatis dan mengautentikasi melalui kunci API seperti yang ditunjukkan di atas. Formulir Konektor MCP hanya untuk host yang memerlukan kredensial OAuth statis.

Opsi 8 — HTTP Langsung dengan curl (Terminal)

Jika Anda ingin menguji server secara langsung tanpa klien apa pun, atau mengintegrasikannya ke dalam skrip, Anda dapat mengakses endpoint HTTP dengan curl. Protokol MCP adalah JSON-RPC 2.0 melalui HTTP Streamable.

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

Respons tiba sebagai Server-Sent Events (standar HTTP Streamable MCP). Setiap potongan adalah baris yang diawali dengan data: diikuti oleh objek JSON. Header Accept: application/json, text/event-stream wajib — server menolak permintaan tanpanya.

ℹ️

Pemecahan Masalah 401 Tidak Sah: Periksa apakah kunci API Anda belum dicabut di Pengaturan → Kunci API. Kunci dimulai dengan ba_live_. Jika masih buntu, buat ulang kunci dan coba lagi.

Cobalah — Prompt Bahasa Inggris Sederhana

Setelah terhubung, Anda tidak perlu mengetahui nama alat atau parameter. Deskripsikan apa yang Anda inginkan dalam bahasa Inggris sederhana dan asisten AI Anda akan memanggil alat bug_Agent_ yang tepat secara otomatis.

Laporan Bug

Tanyakan asisten AI Anda

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

Manajemen Pengujian

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

Keamanan & Kinerja

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?

Otomatisasi 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 Eksplorasi

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?

Penggunaan & Statistik

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?

Referensi Cepat

Lokasi file konfigurasi untuk kedelapan klien. Setiap klien terhubung ke https://mcp.bugagent.com/mcp dengan header Authorization: Bearer ba_live_YOUR_KEY_HERE melalui HTTP Streamable.

Klien Lokasi konfigurasi / perintah

Inspektur MCP Tanpa file — masukkan URL + header auth di UI browser setelah 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 Pengaturan → UI MCP, atau ~/.cursor/mcp.json

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

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

HTTP Langsung (curl) curl / Invoke-RestMethod — sertakan Accept: application/json, text/event-stream

Pemecahan Masalah

Gejala Perbaikan

401 Unauthorized Kunci salah, kedaluwarsa, atau dicabut. Periksa Pengaturan → Kunci API — kunci dimulai dengan ba_live_. Buat ulang jika perlu.

Alat tidak muncul di klien Keluar sepenuhnya dan luncurkan kembali klien setelah mengedit konfigurasi. Di Claude Desktop, Cmd+Q (jangan hanya menutup jendela). Di Cursor, periksa Pengaturan → MCP untuk titik hijau.

Accept header required Panggilan HTTP langsung harus menyertakan Accept: application/json, text/event-stream — spesifikasi HTTP Streamable memerlukannya. Server mengembalikan 406 tanpanya.

Data ruang kerja yang salah Setiap kunci API dibatasi untuk satu ruang kerja. Buat kunci baru dari ruang kerja yang ingin Anda kueri di Pengaturan → Kunci API.

Alat muncul tetapi panggilan gagal tanpa pesan Konfirmasi server dapat dijangkau: curl -I https://mcp.bugagent.com/health seharusnya mengembalikan 200. Jika waktu habis, periksa aturan jaringan/firewall.

Kesalahan CORS Inspektur MCP Pilih Proxy (bukan Langsung) untuk Jenis Koneksi di UI Inspektur. Inspektur memproksi melalui proses Node lokal untuk melewati pembatasan CORS browser.

Codex CLI — alat tidak dikenali Verifikasi ~/.codex/config.toml menggunakan [[mcp_servers]] (tanda kurung ganda, sintaks array). Periksa versi Codex CLI cukup baru untuk mendukung MCP (codex --version).

Fitur MCP

Server MCP bug_Agent_ menyediakan alat untuk:

🐛

Manajemen Laporan Bug

create_bug_report — Ajukan laporan baru dengan klasifikasi otomatis ke dalam 19 jenis — bug, permintaan fitur, peningkatan, utang teknis, dan lainnya (judul: 3-500 karakter). Array attachments opsional menerima file berkode base64 hingga 400 MB per file: gambar, video, audio, PDF, atau teks/JSON apa pun. Atur format_description: true untuk memformat ulang deskripsi secara otomatis menjadi templat terstruktur menggunakan AI. Berikan time_spent_seconds untuk melacak upaya QA. Berikan priority (urgent / high / normal / low) untuk menetapkan urgensi perbaikan secara independen dari tingkat keparahan. Respons mencakup project_id, project, short_id, legacy_short_id, dan project_short_id.
list_bug_reports — Tampilkan dan filter laporan (maks 100 per halaman). Filter proyek diterapkan di sisi server sebelum paginasi. Filter berdasarkan project (UUID, slug, nama persis, atau awalan tiket), project_id, project_slug, project_prefix, workspace (UUID, nama persis, atau awalan tiket ruang kerja), workspace_id/team_id, type (salah satu dari 19 kategori dasbor), severity (s1-s4 atau lama critical/high/medium/low), status (menggunakan nilai persis dasbor: new, awaiting-triage, confirmed, in-progress, blocked, resolved, retesting, closed, reopened — tanda hubung disengaja), resolution (fixed / duplicate / works-as-designed / cannot-reproduce / will-not-fix / need-more-info / unresolved), root_cause (tag kebab-case terbuka — nilai umum: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch), atau reporter_user_id (UUID anggota tim yang mengajukan laporan — panggil list_team_members terlebih dahulu untuk mengubah nama menjadi UUID). Setiap hasil mencakup reporter_user_id, project_id, project, short_id, legacy_short_id, dan project_short_id sehingga agen dapat menautkan dan memperbarui laporan dengan cakupan proyek yang benar.
pick_next_bug — Mengembalikan bug berikutnya yang harus dikerjakan oleh loop agen, dalam urutan prioritas (S1 → S2 → S3, terlama terlebih dahulu dalam setiap kelompok). Secara otomatis dibatasi ke ruang kerja Anda — mengembalikan tiket di semua proyek dalam tim Anda dengan status new, awaiting-triage, atau confirmed dan tingkat keparahan S1-S3. Hanya-baca — tidak mengklaim tiket secara atomik. severity opsional (tingkat tunggal), limit (1-50, default 1). Mengembalikan baris dalam bentuk yang sama seperti list_bug_reports untuk komposabilitas alat. Pasangkan dengan claim_bug untuk pola baca-lalu-klaim.
claim_bug — Secara atomik mentransisikan bug dari status new, awaiting-triage, atau confirmed ke status='in-progress', atur assigned_to ke pengguna yang memanggil, dan cap claimed_at=NOW(). Bebas race di antara pemanggil bersamaan melalui pola UPDATE-WHERE-RETURNING Postgres — jika dua agen memanggil claim_bug pada id yang sama dalam waktu berdekatan, tepat satu mendapatkan claimed:true dengan isi bug dan yang lainnya mendapatkan claimed:false dengan string alasan. Pembersih pg_cron melepaskan klaim basi (status=in-progress + claimed_at > 30 menit) kembali ke new secara otomatis, sehingga tiket agen yang mogok masuk kembali ke antrean tanpa intervensi manual. Input: id (UUID atau ID pendek).
get_bug_report — Dapatkan detail lengkap laporan berdasarkan ID. Format ID: menerima UUID (mis. 1fb72a2c-87c7-...), ID pendek dengan cakupan ruang kerja (mis. WRKID-545), atau ID pendek dengan cakupan proyek (mis. WRKID-APP-042). Pencarian ID pendek dibatasi tim — menebak ID pendek ruang kerja lain mengembalikan 404. Mengembalikan project_id, project, short_id, legacy_short_id, project_short_id, ticket_number, project_ticket_number, qualityScore (integer 1–10), dan qualityBreakdown (objek dengan 10 skor dimensi: reproductionSteps, expectedVsActual, environmentDetails, evidence, rootCauseAnalysis, impactAssessment, contextAndHistory, heuristicsAndOracles, clarityAndStructure, actionability — masing-masing 0.0–1.0).
update_bug_report — Perbarui bidang pada laporan yang ada. Menerima UUID atau ID pendek (WRKID-545). Bidang yang dapat diperbarui meliputi title, description, type (salah satu dari 19 kategori dasbor), severity, priority (urgent / high / normal / low — urgensi perbaikan, independen dari tingkat keparahan), status (cocok dengan dasbor persis: new, awaiting-triage, confirmed, in-progress, blocked, resolved, retesting, closed, reopened — tanda hubung disengaja), resolution (fixed / duplicate / works-as-designed / cannot-reproduce / will-not-fix / need-more-info / unresolved), dan root_cause (tag kebab-case terbuka — nilai umum: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch). Konvensi loop agen mengharuskan resolution dan root_cause diatur setiap kali status bertransisi keluar dari new; dasbor, analitik, dan korpus pelatihan claude-bot di masa mendatang semuanya bergantung pada bidang tersebut. Juga mencakup assigned_to (ID pengguna dari list_team_members) dan time_spent_seconds untuk pelacakan timer. Mengubah assigned_to secara otomatis memicu notifikasi lonceng dalam aplikasi DAN email pemberitahuan ke penerima tugas baru (menghormati opt-out per pengguna mereka di Pengaturan Akun — alur yang sama seperti titik akhir dasbor).
add_comment — Tambahkan komentar ke laporan bug (UUID atau ID pendek, isi 1-10000 karakter). Jika laporan disinkronkan ke Jira, komentar secara otomatis dikirim ke isu Jira yang tertaut.
list_comments — Tampilkan utas komentar lengkap laporan, terlama terlebih dahulu — setiap komentar dengan nama penulis, parentId (balasan berutas), dan stempel waktu. Komentar bukan bagian dari get_bug_report, jadi ini adalah cara Anda membaca diskusi tiket. Menerima UUID atau ID pendek.
link_bug_reports — Buat tautan semantik terarah antara dua laporan bug di ruang kerja yang sama. link_type adalah salah satu dari duplicate-of, parent-of, related-to, atau depends-on. Perspektif kebalikan (duplicated-by / subtask-of / blocks) diturunkan saat pembacaan — hanya satu baris yang perlu disimpan. from_report_id dan to_report_id menerima UUID atau ID pendek (WRKID-545).
unlink_bug_reports — Hapus tautan laporan bug yang dibuat sebelumnya berdasarkan UUID-nya (link_id, dikembalikan oleh link_bug_reports atau list_bug_report_links).
list_bug_report_links — Tampilkan setiap tautan yang dikurasi pengguna yang terkait dengan laporan bug. Mengembalikan setiap tautan sebagaimana terbaca dari perspektif laporan yang diberikan — mis. baris duplicate-of yang tersimpan di mana laporan ini adalah target ditampilkan sebagai duplicated-by; parent-of di mana laporan ini adalah target ditampilkan sebagai subtask-of; depends-on di mana laporan ini adalah target ditampilkan sebagai blocks. related-to bersifat simetris. Melengkapi bidang similar_reports yang terdeteksi otomatis yang dikembalikan oleh get_bug_report.
classify_bug — Klasifikasikan deskripsi ke dalam salah satu dari 19 jenis laporan (bug, fitur, peningkatan, dll.) dengan skor keyakinan
flush_reports — Hapus massal laporan lama (khusus admin)

📊

Penggunaan & Analitik

get_usage — Periksa penggunaan terhadap batas paket
get_stats — Rincian harian, jenis/tingkat keparahan/status

📁

Manajemen Proyek

list_projects — Tampilkan proyek yang tersedia dengan id, name, slug, ticket_prefix, deskripsi, dan status default. Gunakan nilai-nilai tersebut dengan create_bug_report dan list_bug_reports untuk menargetkan proyek yang benar.
create_project — Buat proyek baru (otomatis menjadi default jika pertama)
delete_project — Hapus permanen proyek dan semua data terkait (laporan bug, otomatisasi, kasus uji, aplikasi seluler, jadwal, cuplikan geo, catatan, entri waktu). Hanya pemilik/manajer. Tidak dapat menghapus proyek terakhir. Penyimpanan dibebaskan secara otomatis
export_okf_bundle — Ekspor pengetahuan QA proyek — laporan bug, kasus uji, otomatisasi, serta pengujian performa, keamanan, dan eksplorasi — sebagai bundel markdown OKF/OQA (format Open Query Agent yang digunakan oleh oqa.ai). Default ke proyek aktif; berikan project opsional (slug atau nama) untuk mengekspor yang berbeda. Mengembalikan daftar file dalam bundel plus bundel itu sendiri sebagai zip berkode base64

🔐

Autentikasi & Akun

register_account — Buat akun baru (kata sandi: 8-128 karakter, dibatasi laju: 5/15 menit)
login — Masuk dan terima token akses (dibatasi laju: 5/15 menit)
update_profile — Perbarui nama tampilan
change_password — Ubah kata sandi akun
get_settings / update_settings — Kelola preferensi

🔑

Manajemen Kunci API

generate_api_key — Buat kunci API bernama
list_api_keys — Tampilkan kunci aktif (hanya awalan)
regenerate_api_key — Cabut dan ganti kunci
delete_api_key — Cabut kunci secara permanen

👥

Manajemen Tim

list_team_members — Tampilkan semua anggota ruang kerja Anda dengan peran, status, dan bendera booster
invite_team_member — Undang pengguna melalui email (manajer dapat mengundang kontributor dan manajer; hanya pemilik yang dapat mengundang admin). Tautan kedaluwarsa 5 hari

🎯

Integrasi

sync_to_jira — Sinkronkan laporan ke Jira menggunakan koneksi bersama tim
push_to_claude — Hasilkan (atau hasilkan ulang) Catatan Pengembang untuk laporan bug — akar penyebab, perbaikan yang disarankan, langkah verifikasi, dan penilaian risiko. Menerima UUID atau ID pendek (WRKID-545). Menggunakan kunci platform — tidak diperlukan koneksi Claude per tim. Menjalankan rantai adaptif: tiga langkah pada bug s3/medium atau s4/low (draf Sonnet → kritik OpenAI gpt-5 → sintesis Sonnet), lima langkah pada dua kelompok tingkat keparahan teratas — s1/critical atau s2/high — (draf → kritik → sanggahan Sonnet → adjudikator Claude Opus yang membaca transkrip lengkap dan menulis catatan akhir dengan penilaian independen). Respons mengekspos setiap putaran: analysis, draft, critique, rebuttal, challenger_model, adjudicator_model, dan bendera debated. Setiap langkah yang gagal akan beralih ke jawaban terbaik berikutnya. Otomatis menyala saat pembuatan bug; biasanya hanya dipanggil untuk pembuatan ulang manual.
analyze_fix_area — Hasilkan (atau hasilkan ulang) sub-blok "Area Perbaikan yang Mungkin" dari Catatan Pengembang — keluaran Sonnet sempit yang menyebutkan di mana dalam basis kode perbaikan kemungkinan besar berada. Menerima UUID atau ID pendek. Menggunakan kunci Anthropic platform. Ketika tim memiliki baris github_connections dan proyek memiliki github_repo yang dipetakan, keluaran didasarkan pada cuplikan file nyata dari repo yang terhubung; jika tidak, kembali ke panduan umum dengan dorongan untuk menghubungkan repo. Mengembalikan teks likely_fix_area, generated_at, repo_used, dan bendera grounded. Otomatis menyala saat pembuatan bug — agen biasanya hanya perlu memanggil ini untuk pembuatan ulang manual.
upgrade_plan — Tingkatkan langganan melalui Stripe

⚡

Pengujian Performa

create_performance_test — Buat konfigurasi pengujian performa dengan URL, perangkat, pengguna virtual, durasi, ambang skor, dan toggle pembuatan bug otomatis. Hanya Enterprise
run_performance_test — Picu audit halaman dan pengujian beban untuk pengujian performa web. Mengembalikan ID proses untuk memantau hasil. Proses profiling aplikasi seluler dipicu dari dasbor
get_performance_results — Dapatkan hasil lengkap termasuk skor Lighthouse (Performa, Aksesibilitas, Praktik Terbaik, SEO), Core Web Vitals (LCP, FID, CLS, FCP, TTFB, INP, TBT, SI), dan metrik pengujian beban (VU, permintaan, RPS, latensi p50/p90/p95/p99)
list_performance_tests — Tampilkan semua konfigurasi pengujian performa untuk tim saat ini
get_performance_usage — Periksa penggunaan pengujian performa bulanan. Pengujian performa hanya untuk Enterprise. Gratis=0, Enterprise=tidak terbatas

Contoh Alur Kerja

get_performance_usage → periksa kuota tersisa
create_performance_test → konfigurasikan pengujian untuk URL Anda
run_performance_test → picu audit + pengujian beban
get_performance_results → tinjau skor dan vital

🛡

Pemindaian Keamanan

create_security_scan — Buat konfigurasi pemindaian keamanan. Pemindaian web menggunakan Quick Scanner + Nuclei (4.000+ templat) dengan tiga tingkat kedalaman dan pemindaian terautentikasi opsional. Pemindaian seluler menggunakan MobSF untuk analisis biner APK/IPA. Pembuatan bug otomatis yang dapat dikonfigurasi dengan ambang tingkat keparahan. Hanya Enterprise
run_security_scan — Picu pemindaian kerentanan. Pemindaian web memerlukan verifikasi domain DNS. Pemindaian seluler memerlukan aplikasi yang diunggah. Mengembalikan ID proses untuk memantau hasil
get_security_results — Dapatkan hasil lengkap termasuk skor keamanan (0-100), temuan yang dikategorikan berdasarkan tingkat keparahan (Kritis, Tinggi, Sedang, Rendah, Info) dengan referensi CWE, pemetaan OWASP, bukti, dan panduan remediasi
list_security_scans — Tampilkan semua konfigurasi pemindaian keamanan untuk tim saat ini dengan skor terakhir dan lencana auth/kedalaman
get_security_usage — Periksa penggunaan pemindaian keamanan bulanan. Pemindaian keamanan hanya untuk Enterprise. Enterprise=tidak terbatas
list_security_schedules — Tampilkan semua pemindaian keamanan terjadwal untuk tim dengan cron, zona waktu, status aktif, proses berikutnya, dan pengaturan notifikasi. Bergabung dengan konfigurasi pemindaian induk (nama, tipe_pemindaian, url_target)
create_security_schedule — Buat jadwal berulang untuk pemindaian keamanan. Memerlukan scan_id dan cron_expression. Satu jadwal per konfigurasi pemindaian. Opsional timezone, notify_on_fail (tidak ada/email/slack/keduanya), notify_email, slack_channel_id. Setiap proses dihitung terhadap batas bulanan Anda; pengguna admin melewati batas tersebut. Kedalaman pemindaian selalu dibaca dari konfigurasi pemindaian saat waktu proses
delete_security_schedule — Hapus pemindaian keamanan terjadwal. Tidak memengaruhi konfigurasi pemindaian induk atau proses yang telah selesai

get_security_usage → periksa kuota tersisa
create_security_scan → konfigurasikan pemindaian untuk URL atau repositori Anda
run_security_scan → picu pemindaian kerentanan satu kali
create_security_schedule → otomatiskan proses berulang (mis. SAST mingguan di cabang utama)
get_security_results → tinjau temuan dan remediasi

📖

Tinjauan Kode

list_code_reviews — Tampilkan tinjauan kode AI terbaru untuk tim. Mengembalikan skor kualitas, jumlah tingkat keparahan, info PR, dan stempel waktu. Hanya Enterprise
get_code_review — Dapatkan tinjauan kode dengan semua temuan. Setiap temuan mencakup tingkat keparahan, kategori (bug/keamanan/performa/gaya/logika/kemudahan pemeliharaan), judul, deskripsi, saran kode, jalur file, dan nomor baris
get_code_review_usage — Periksa penggunaan tinjauan kode. Tinjauan kode AI hanya untuk Enterprise; tidak terbatas di Enterprise
get_code_review_analytics — Dapatkan analitik tinjauan: tren, kategori/sumber temuan, rincian tingkat keparahan, metrik kecepatan, repositori/penulis teratas. Mendukung retrospeksi 7/30/90 hari

get_code_review_usage → periksa tinjauan tersisa
Tinjau PR di dasbor di /dashboard/code-review
list_code_reviews → lihat tinjauan terbaru
get_code_review → dapatkan temuan dan saran

🔍

AI Eksplorasi

Pencari bug situs web otonom multi-agen dengan hingga 10 agen paralel, masing-masing menggunakan strategi pengujian yang berbeda.

list_explorations — Tampilkan konfigurasi AI Eksplorasi untuk tim
create_exploration — Buat eksplorasi baru. Menerima agent_count (1–10, maks 10) untuk menjalankan beberapa agen paralel dengan strategi unik: happy_path, edge_case, security, accessibility, error_path, performance, mobile, data_integrity, navigation, custom
get_exploration — Dapatkan konfigurasi eksplorasi dengan pengaturan agen dan proses terbaru
get_exploration_run — Dapatkan hasil proses dengan progres per agen, data fase, temuan dengan atribusi agen (agent_index, agent_strategy), dan bug tertaut
get_exploration_usage — Periksa penggunaan bulanan. AI Eksplorasi hanya untuk Enterprise; Enterprise: tidak terbatas (10 agen)

create_exploration dengan agent_count: 5 → konfigurasikan 5 agen paralel
Picu proses dari dasbor atau melalui POST /api/explorations/run
get_exploration_run → pantau progres per agen dan temuan
Lihat temuan yang telah dideduplikasi dengan atribusi agen di dasbor

📝

Catatan

list_notes — Tampilkan catatan dengan pencarian kata kunci opsional, filter proyek, filter penulis, dan rentang tanggal. Mengembalikan catatan yang dimiliki pengguna atau catatan bersama dalam tim.
create_note — Buat catatan dalam salah satu dari 5 format: markdown, plain_text, rich_text, checklist, outline. Atur visibility ke private atau shared. Judul otomatis dari 30 karakter pertama jika tidak ada judul yang diberikan. Array attachments opsional menerima file yang dienkode base64 hingga masing-masing 400 MB: gambar, video, audio, PDF, atau teks/JSON apa pun. Berikan time_spent_seconds untuk melacak upaya QA.
get_note — Dapatkan detail catatan lengkap termasuk konten dan lampiran. Memerlukan id.
update_note — Perbarui judul, konten, format, visibilitas, proyek, atau time_spent_seconds. Berikan array attachments untuk menambahkan file baru (maks masing-masing 400 MB) ke lampiran catatan yang ada tanpa menggantinya. Hanya penulis yang dapat memperbarui. Memerlukan id.
delete_note — Hapus catatan dan lampirannya secara permanen. Hanya penulis yang dapat menghapus. Memerlukan id.

create_note → mulai catatan sesi pengujian
update_note → tambahkan observasi saat Anda menguji
list_notes → cari catatan sebelumnya berdasarkan kata kunci atau proyek
get_note → ambil catatan lengkap dengan lampiran

🤖

Otomatisasi

create_automation — Buat otomatisasi baru dengan skrip Playwright kustom (tidak perlu perekaman FAB). Memerlukan name. Opsional: target_url (otomatis diturunkan dari URL page.goto(...) pertama dalam skrip jika dihilangkan), script (Node.js/JavaScript/TypeScript atau Python — bahasa terdeteksi otomatis; default ke placeholder), status (draft atau active, default: draft), project_id. Mengembalikan id otomatisasi. Memerlukan paket Tim. Tips — Gandakan otomatisasi: gunakan get_automation untuk mengambil skrip asli, lalu panggil create_automation dengan name diatur ke "[Copy] Original Name" dan berikan script, target_url, dan project_id asli. Duplikat dimulai dalam status draft tanpa riwayat versi.
list_automations — Tampilkan skrip otomatisasi Playwright. Filter berdasarkan project_id atau status (draft, active, paused). Mengembalikan array otomatisasi dengan nama, url_target, status_proses_terakhir, dan jumlah_proses.
get_automation — Dapatkan detail otomatisasi lengkap termasuk skrip Playwright dan proses terbaru. Memerlukan id. Mengembalikan otomatisasi dengan script langsung, tumpukan script_versions (terlama-pertama, hingga 100 entri sebelumnya, masing-masing { script, source, timestamp }), dan array recent_runs di mana setiap proses membawa script_version_label/script_version_source yang dieksekusi. Panggil ini sebelum run_automation jika Anda perlu memilih versi historis tertentu.
run_automation — Picu proses langsung dari pengujian Playwright. Memerlukan automation_id. Mode virtual (default): device opsional untuk emulasi viewport (mis. desktop, iphone-15). Mode langsung: atur browserstack: true dengan bs_browser (chrome, firefox, safari, edge), bs_os (Windows, OS X), dan bs_os_version untuk dijalankan di browser desktop nyata. Seluler-nyata langsung: atur bs_os: "android" (perangkat: "Samsung Galaxy S25 Ultra", "Google Pixel 10", "OnePlus 13R") atau bs_os: "ios" (perangkat: "iPhone 17 Pro Max", "iPhone 16 Pro Max", "iPhone 15 Pro Max") dan berikan nama perangkat di bs_os_version. Skrip Node.js dirutekan melalui browserstack-node-sdk (mencakup desktop + Android + iPhone). Skrip Python dirutekan melalui browserstack-sdk (pytest-playwright) dan hanya mencakup desktop — seluler nyata melalui Python tidak didukung karena browser_type.connect() pytest-playwright tidak dapat mengarahkan endpoint seluler-nyata BrowserStack. Video dan log jaringan diambil secara otomatis; log konsol hanya desktop. Pemutaran ulang versi: berikan version_index opsional (integer, berindeks 0) untuk mengeksekusi entri sebelumnya dari riwayat script_versions otomatisasi. Default: ketika version_index dihilangkan atau null, skrip langsung saat ini berjalan — jangan berikan nilai placeholder hanya untuk "memilih yang saat ini". Nilai di luar jangkauan, negatif, atau bukan integer akan ditolak. Catatan proses menyimpan snapshot persis yang berjalan, dan setiap laporan bug yang dibuat otomatis dari proses yang gagal menautkan kembali ke versi tersebut di editor.
list_automation_runs — Tampilkan proses terbaru untuk otomatisasi. Memerlukan automation_id. Mengembalikan proses dengan status, durasi_ms, dan pesan_kesalahan.
list_schedules — Tampilkan semua proses otomatisasi web terjadwal dengan pengaturan cron, zona waktu, perangkat, dan notifikasi
create_schedule — Buat proses otomatisasi web terjadwal. Memerlukan automation_id dan cron_expression. Mendukung opsi perangkat, zona waktu, notifikasi_saat_gagal (email/slack/keduanya), dan saluran Slack. BrowserStack Live pada proses terjadwal: berikan browserstack: true dengan bs_browser, bs_os, dan bs_os_version — matriks perangkat yang sama dengan run_automation (Node = desktop + Android nyata + iPhone nyata; Python = hanya desktop).
delete_schedule — Hapus proses otomatisasi web terjadwal
list_mobile_schedules — Tampilkan semua proses otomatisasi seluler terjadwal dengan perangkat, cron, zona waktu, dan notifikasi
create_mobile_schedule — Buat proses otomatisasi seluler terjadwal di perangkat nyata. Memerlukan automation_id, cron_expression, dan array devices
delete_mobile_schedule — Hapus proses otomatisasi seluler terjadwal
optimize_automation_script — Kirim skrip Playwright ke Sonnet 4 untuk optimasi bertenaga AI. Menerapkan daftar periksa 12 poin yang memperbaiki pemilih, strategi tunggu, asersi, penanganan kesalahan, pola auth, kompatibilitas seluler, dan mode ketat. Memerlukan automation_id. Versi skrip saat ini disimpan sebelum optimasi. Mengembalikan skrip yang dioptimalkan dan ringkasan perubahan.
undo_automation_script — Kembalikan skrip otomatisasi ke versi sebelumnya. Hingga 10 versi sebelumnya dipertahankan. Memerlukan automation_id. Mengembalikan skrip yang dipulihkan dan jumlah versi yang tersisa.

create_automation → buat pengujian dengan skrip kustom
list_automations → jelajahi pengujian yang tersedia
get_automation → periksa skrip Playwright
run_automation → picu pengujian
list_automation_runs → periksa hasil dan durasi

⏱️

Pelacakan Waktu

list_time_entries — Menampilkan entri waktu untuk tim. Filter berdasarkan period (today, week, month, all), project_id, category, dan sort (newest, oldest, most_time, least_time). Hanya untuk paket Tim.
create_time_entry — Mencatat waktu yang dihabiskan untuk tugas QA. Memerlukan description, category, dan duration_minutes. Opsional mengatur project_id dan entry_date (default hari ini). Hanya untuk paket Tim.
update_time_entry — Memperbarui entri waktu yang sudah ada. Memerlukan id. Dapat memperbarui description, category, duration_minutes, project_id, atau entry_date. Hanya untuk paket Tim.
delete_time_entry — Menghapus permanen entri waktu. Memerlukan id. Hanya untuk paket Tim.

create_time_entry → mencatat 45 menit pengujian regresi
list_time_entries → melihat entri waktu minggu ini
update_time_entry → menyesuaikan durasi atau kategori
delete_time_entry → menghapus entri yang salah

☑️

Kasus Uji

Manajemen pengujian lengkap dengan folder hierarkis, suite bersarang (hingga 3 tingkat dengan ekspansi otomatis sub-suite saat dijalankan), pengurutan ulang seret-dan-lepas, pembuatan kasus berbantuan AI, dan tab Laporan analitik dengan tren KPI, analisis kegagalan, kesehatan suite, cakupan, dan produktivitas penguji. Semua alat memanggil Supabase secara langsung — tanpa roundtrip HTTP, latensi sama dengan dasbor.

Eksekusi hands-free: halaman tinjauan run adalah karusel dengan satu kasus terlihat pada satu waktu, pintasan keyboard (P Lulus · F Gagal · B Blokir · S Lewati), dan kontrol suara. Klik mikrofon, lalu ucapkan "Lulus", "Gagal", "Blokir", "Lewati", "Berikutnya", "Sebelumnya", "Tambah catatan" (mentranskripsi ke bidang catatan), "Simpan catatan", atau "Suara mati". Otomatis maju ke kasus berikutnya yang belum diuji pada hasil sukses; tetap di tempat saat Gagal sehingga penguji dapat mendiktekan detail dan memunculkan bug. Bekerja di Chrome, Edge, dan Safari.

Kasus & Folder

list_test_cases — Menampilkan kasus uji dengan opsional search, priority (critical, high, medium, low), type (functional, regression, smoke, integration, performance, security, usability, exploratory), status (active, draft, deprecated), dan sort (newest, oldest, name, priority).
create_test_case — Membuat kasus uji. Dua varian templat: steps (default) — grid { action, expected } per langkah melalui array steps; text — deskripsi bebas tunggal melalui text_content. Kedua bidang dapat dikirim dalam panggilan yang sama (platform menyimpannya secara independen sehingga penguji yang beralih template_type nanti tidak kehilangan data dari sisi mana pun). Array urls opsional (maks 10 URL http/https) melampirkan tautan referensi. Memerlukan name. Opsional: description, preconditions, template_type, steps, text_content, urls, priority, type, tags, estimated_time (detik). Lampiran file diunggah melalui endpoint POST /api/test-cases/:id/attachments dasbor (multipart) — belum tersedia sebagai alat MCP.
get_test_case — Mendapatkan detail lengkap kasus uji termasuk langkah dan riwayat eksekusi.
list_test_case_folders — Menampilkan folder tim (satu folder per kasus melalui folder_id; berbeda dari suite, yang merupakan pengelompokan rencana uji banyak-ke-banyak). Dibatasi 500; menghormati filter project_id dan parent_folder_id (gunakan "root" hanya untuk tingkat atas).
create_test_case_folder — Membuat folder (bersarang hingga 3 tingkat melalui parent_folder_id). Gunakan bulk_update_test_cases untuk memindahkan kasus ke dalamnya.
bulk_update_test_cases — Menerapkan satu tindakan ke hingga 500 kasus sekaligus: set_priority, set_status, set_type, add_tags, remove_tags, add_to_suite, pin, unpin.
link_test_case_to_bug — Membangun ketertelusuran antara kasus uji dan laporan bug (verified_by, covers, atau relates).
list_test_case_links — Menampilkan semua tautan ketertelusuran untuk kasus uji.
list_test_case_review_candidates — Bendera uji mati: never_run (90+ hari sejak pembuatan), always_passes (5+ lulus berturut-turut dalam 90 hari), always_skipped (3+ lewati berturut-turut).
mark_test_case_review_flags — Menyimpan bendera kandidat arsip saat ini ke test_cases.review_flag. Berjalan otomatis setiap Senin 09:00 UTC melalui pg_cron.

Impor

Impor Figma (UI dasbor + REST): unggah ekspor zip bingkai Figma (hingga 100 MB), Claude menganalisis setiap layar dan menyusun kasus uji ke dalam folder yang Anda pilih atau buat. Pipeline multi-pass (klasifikasi → kasus per layar → kasus tingkat alur di seluruh layar dengan awalan bersama → kritik diri) dengan caching prompt, percobaan ulang 429, dan isolasi kesalahan per bingkai sehingga satu bingkai buruk tidak menggagalkan batch. Kasus masuk sebagai status=active, ditandai ai_generated=true, dengan source='figma' dan source_frame_name menyimpan tautan ke bingkai asli. Menggunakan kunci Anthropic platform — tidak perlu koneksi Claude per tim. Endpoint: POST /api/test-cases/import/figma/request, POST /api/test-cases/import/figma/start, GET /api/test-cases/import/figma/:id.

Suite & Run

list_test_suites — Menampilkan suite uji dengan jumlah kasus dan status run terakhir.
create_test_suite — Membuat suite. Bersarang hingga 3 tingkat melalui parent_suite_id.
list_test_runs — Menampilkan run uji dengan nama suite, penerima tugas, dan ringkasan lulus/gagal.
create_test_run — Membuat snapshot suite menjadi run baru. Menjalankan suite induk secara otomatis menyertakan setiap kasus di setiap sub-suite turunan (kasus yang tertaut ke keduanya ditambahkan tepat satu kali). Setiap baris test_run_results mencatat sub-suite asal kasus tersebut, sehingga halaman hasil dapat mengelompokkan berdasarkan asal.

Laporan (Analitik Tingkat 1 + Tingkat 4)

get_test_reports_overview — KPI utama untuk suatu jendela (tingkat kelulusan, run selesai, kasus dieksekusi) dengan delta vs jendela setara sebelumnya. Angka yang sama dengan yang ditampilkan strip KPI tab Laporan.
get_test_reports_failures — Empat daftar "apa yang harus diperbaiki?": failing_cases (≥50% gagal, min 3 run), flaky_cases (paling banyak bolak-balik lulus/gagal), failing_suites (≥30% gagal, min 5 run), regressed_cases (gagal terbaru dengan lulus sebelumnya di jendela yang sama).

create_test_case_folder → membuat pohon folder (mis. Smoke → Auth)
create_test_case → menentukan kasus; pindahkan ke folder dengan bulk_update_test_cases
create_test_suite → membangun rencana uji (sub-suite opsional, hingga 3 tingkat)
create_test_run → membuat snapshot run dari suite induk — sub-suite otomatis disertakan
get_test_reports_failures → tanyakan "apa yang harus diperbaiki minggu ini?" setelah run selesai
get_test_reports_overview → melacak tren tingkat kelulusan minggu demi minggu

⚡

Team Booster

scale_team — Skalakan tim QA Anda secara instan dengan penguji booster. Akun disediakan secara otomatis dengan akses penguji. Tentukan team_size (1–10), location, duration, budget, dan opsional product_url, product_types, dan tech_levels. Tersedia di paket Tim. Anda tidak akan dikenakan biaya sampai persetujuan diberikan.

scale_team → menyediakan 5 penguji senior di AS selama 1 bulan
list_team_members → verifikasi penguji baru muncul di tim Anda
list_reports → tinjau laporan yang diajukan oleh penguji booster

📱

Pengujian Seluler

upload_mobile_app — Unggah APK (Android) atau IPA (iOS) untuk pengujian di perangkat nyata. Memerlukan name, platform (android/ios), dan file_url. Untuk iOS: unggah IPA untuk run perangkat nyata, lalu unggah build simulator .app di halaman detail aplikasi untuk mengaktifkan perekaman.
update_mobile_app — Ganti biner aplikasi dengan versi baru. Menghapus URL cache dan build simulator sehingga semua otomatisasi menggunakan versi baru pada run berikutnya. Memerlukan app_id dan file_url. Opsional: version.
create_mobile_automation — Membuat skrip uji. Memerlukan name, app_id, script_type (maestro untuk YAML, appium untuk Appium Python, appium_js untuk Appium JavaScript), dan script (konten skrip uji).
list_mobile_runs — Mendapatkan hasil untuk run uji seluler (status, perangkat, video, sesi BrowserStack, dan bug yang dibuat otomatis). Run seluler dipicu dari dasbor atau sesuai jadwal. Filter opsional: automation_id, status (queued, running, passed, failed, error, archived), limit. Run yang diarsipkan dikecualikan dari daftar default.

Contoh Alur Kerja — Android

upload_mobile_app → unggah APK Anda
Rekam uji di browser → tindakan ditangkap otomatis
Picu run di perangkat nyata (mis. Google Pixel 8) dari dasbor atau jadwal
list_mobile_runs → periksa hasil dengan video dan log
Kegagalan otomatis membuat laporan bug dengan snapshot kegagalan dan rincian langkah

Contoh Alur Kerja — iOS

upload_mobile_app → unggah IPA Anda (untuk run perangkat nyata)
Unggah build simulator .app di halaman detail aplikasi (untuk perekaman)
Rekam uji di browser → tindakan ditangkap dari simulator
Picu run di perangkat nyata (mis. iPhone 15 Pro, menggunakan IPA) dari dasbor atau jadwal
update_mobile_app → ganti IPA dengan versi baru saat siap

✅

Kepatuhan & Bukti (Enterprise)

collect_compliance_evidence — Memicu pengumpulan bukti otomatis dari layanan terhubung (Cloudflare, GitHub, Sentry, Supabase, Railway). Mengembalikan ID run. Mengumpulkan pengaturan SSL/TLS, status WAF, peringatan Dependabot, tren kesalahan, riwayat deploy, dan lainnya.
check_config_drift — Memeriksa semua layanan terhubung untuk penyimpangan konfigurasi keamanan dari baseline (mode SSL, versi TLS, HSTS, aturan WAF, header keamanan).
generate_access_review — Membuat laporan tinjauan akses triwulanan. Mengaudit anggota tim, peran, status MFA, penggunaan kunci API, dan menghasilkan rekomendasi (mis., cabut kunci tidak aktif).
get_security_events — Kueri linimasa peristiwa keamanan lintas layanan. Filter berdasarkan sumber (cloudflare, sentry, github) dan tingkat keparahan (critical, high, medium, low, info). Peristiwa dikorelasikan otomatis di seluruh layanan.

Cakupan Kepatuhan

Alat ini membantu persyaratan kepatuhan 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), dan GDPR (Art. 5, 25, 32, 33).

Klien yang Kompatibel

bug_Agent_ bekerja dengan klien apa pun yang mendukung Model Context Protocol. Berikut panduan pengaturan untuk klien populer:

🤖

Claude Desktop

Buka Settings → Developer → Edit Config, lalu tambahkan:

claude_desktop_config.json

Mulai ulang Claude Desktop setelah menyimpan.

✳️

Cursor

Buka Settings → MCP Servers → Add Server, atau edit .cursor/mcp.json di root proyek Anda:

.cursor/mcp.json

🌊

Windsurf

Buka Settings → MCP → Add Server, atau edit file konfigurasi MCP Anda:

mcp_config.json

💻

Claude Code (CLI)

Tambahkan bug_Agent_ langsung dari terminal:

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

Atur kunci API Anda dengan export BUGAGENT_API_KEY=ba_live_... sebelum meluncurkan.

🔧

Klien MCP Lainnya

Klien apa pun yang mendukung transportasi MCP stdio bekerja dengan bug_Agent_. Gunakan konfigurasi standar:

Command: npx
Args: ["-y", "@bugagent/mcp-server"]
Env: BUGAGENT_API_KEY

CLI

Memulai dengan CLI

CLI bug_Agent_ memberi Anda kendali penuh atas laporan bug, permintaan fitur, proyek, dan integrasi dari terminal Anda. Gunakan untuk:

Otomatisasi alur kerja — Integrasikan pelaporan bug ke dalam pipeline CI/CD, skrip, dan cron job
Operasi massal — Daftar, filter, dan kelola laporan tanpa meninggalkan terminal
Output ramah-pipe — Format JSON, YAML, dan mentah untuk dikomposisikan dengan jq, yq, dan alat lainnya
Iterasi cepat — Tidak perlu browser — buat dan perbarui laporan dalam hitungan detik

Instalasi

npm install -g @bugagent/cli

Verifikasi instalasi:

bugagent --version

Autentikasi

Atur kunci API Anda sebagai variabel lingkungan:

Atau teruskan langsung dengan flag --api-key:

bugagent reports list --api-key ba_live_your_key_here

🔑

Dapatkan kunci API Anda dari konsol bug_Agent_. Kunci dimulai dengan ba_live_.

Untuk autentikasi persisten, tambahkan ekspor ke profil shell Anda (~/.bashrc, ~/.zshrc, dll.).

Penggunaan

Perintah mengikuti pola:

bugagent <resource> <action> [flags]

Sumber daya juga dapat menggunakan sintaks titik dua untuk sub-sumber daya:

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

Gunakan --help pada perintah apa pun untuk detailnya:

bugagent reports --help
bugagent reports create --help

Sesi Contoh

Terminal

# List your projects
bugagent projects list

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

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

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

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

# Check your usage
bugagent usage get --format json

Fitur CLI

CLI menyediakan perintah untuk:

reports Membuat, mendaftar, mendapatkan, memperbarui, dan menghapus laporan bug

projects Membuat, mendaftar, memperbarui, dan menghapus proyek

keys Membuat, mendaftar, membuat ulang, dan mencabut kunci API

jira Menghubungkan, menyinkronkan laporan, dan mengonfigurasi pengaturan Jira

usage Memeriksa penggunaan saat ini terhadap batas paket

stats Melihat analitik dan perincian

profile Melihat dan memperbarui profil serta pengaturan Anda

auth Masuk, mendaftar, dan mengelola kredensial

Flag Global

Flag Deskripsi

--api-key <key> Menimpa kunci API untuk perintah ini

--format <fmt> Format keluaran: json, yaml, pretty, raw

--debug Menampilkan detail permintaan/respons untuk pemecahan masalah

--help Menampilkan bantuan untuk perintah apa pun

--version Mencetak versi CLI

Format Keluaran

CLI mendukung berbagai format keluaran untuk kasus penggunaan yang berbeda:

`json`

JSON yang dapat dibaca mesin. Ideal untuk disalurkan ke jq atau alat lainnya.

`yaml`

Keluaran YAML yang ramah manusia untuk file konfigurasi dan keterbacaan.

`pretty`

Default. Keluaran berwarna dan terformat yang dirancang untuk terminal.

`raw`

Keluaran tanpa format. Berguna untuk skrip dan otomatisasi.

Memfilter dengan --transform

Gunakan --transform dengan sintaks GJSON untuk menanyakan dan memfilter data keluaran:

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

Keterampilan AI

CLI juga tersedia sebagai AgentSkill, memungkinkan asisten pengkodean AI menggunakan bug_Agent_ atas nama Anda.

✨

Apa itu AgentSkill?

AgentSkill memungkinkan asisten pengkodean AI (Claude Code, Cursor, dll.) memanggil alat CLI secara kontekstual. Keterampilan bug_Agent_ memberi asisten AI Anda kemampuan untuk mengajukan bug, memeriksa status proyek, dan menyinkronkan ke Jira — semuanya tanpa Anda mengetik perintah.

Instal Keterampilan

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

Setelah terinstal, Asisten AI yang sadar konteks dapat menggunakan perintah bug_Agent_ secara alami — dengan pengetahuan penuh tentang produk Anda, pedoman pengujian, dan dokumentasi yang diunggah:

Prompt Asisten 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."

Keterampilan ini menerjemahkan bahasa alami ke dalam perintah CLI yang sesuai dan menjalankannya.

🎬

Pemutaran Ulang Sesi + Asisten AI: Saat Pemutaran Ulang Sesi diaktifkan (paket Tim), Asisten AI dapat merujuk ke sesi pengguna yang direkam — klik, navigasi, kesalahan, dan kegagalan jaringan dari 60 detik terakhir — untuk secara otomatis menyusun laporan bug yang lebih kaya dan lebih akurat dengan konteks reproduksi penuh.

Dapatkan Bantuan

Butuh bantuan? Kami siap membantu.

Komunitas Discord

Bergabunglah dengan Discord kami untuk dukungan waktu nyata dan diskusi komunitas.

Dukungan Email

[email protected] — Kami biasanya merespons dalam waktu 24 jam.