bugAgent MCP Server

resmi

bugAgent'ı MCP uyumlu herhangi bir AI istemcisine bağlayın. Doğrudan AI kodlama asistanınızdan hataları dosyalayın, sınıflandırın ve yönetin, özellik talepleri ve daha fazlasını yapın. Bağlam değiştirme yok, kopyala-yapıştır yok — sadece sorunu tanımlayın ve bugAgent gerisini halleder.

bugagent.com üzerinde görüntüle

Dokümantasyon

MCP v1

Navigasyon

Model Context Protocol

MCP

bug_Agent_'i herhangi bir MCP uyumlu yapay zeka istemcisine bağlayın.

Hataları, özellik isteklerini ve daha fazlasını doğrudan yapay zeka kodlama asistanınızdan dosyalayın, sınıflandırın ve yönetin. Bağlam değiştirmek yok, kopyala-yapıştır yok — sadece sorunu tanımlayın, gerisini bug_Agent_ halletsin.

Discord Topluluğu [email protected]

Başlangıç

bug_Agent_ MCP sunucusu, yapay zeka istemcilerinin Model Context Protocol aracılığıyla hata raporları, özellik istekleri, iyileştirmeler ve daha fazlasını oluşturmasına, sorgulamasına ve yönetmesine olanak tanır. Yerel olarak çalışır ve bug_Agent_'in bulut API'si ile iletişim kurar.

API anahtarınızı alın

app.bugagent.com adresinden kaydolun ve konsoldan bir API anahtarı oluşturun.

Yapay zeka istemcinizi yapılandırın

İstemcinizin yapılandırmasına bug_Agent_'i bir MCP sunucusu olarak ekleyin (aşağıdaki kuruluma bakın).

Hata bildirmeye başlayın

Doğal dilde bir hata tanımlayın; bug_Agent_ otomatik olarak sınıflandırır, zenginleştirir ve depolar.

Hızlı Örnek

# 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

Kurulum

Yükleme

Genel kurulum gerekmez. MCP sunucusunu isteğe bağlı çalıştırmak için npx kullanın:

npx @bugagent/mcp-server

API anahtarınızı yapılandırın

İlk bağlandığınızda, bug_Agent_ sizden API anahtarınızı isteyecektir. Ayrıca ortam değişkeni aracılığıyla da ayarlayabilirsiniz:

export BUGAGENT_API_KEY=ba_live_your_key_here

API anahtarınızı bug_Agent_ konsolundan alın.

MCP İstemci Yapılandırması

MCP istemcinizin yapılandırma dosyasına aşağıdakini ekleyin:

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 kısmını konsoldan aldığınız gerçek API anahtarınızla değiştirin.

Sunucuya Bağlanın

bug_Agent_ MCP sunucusu, Streamable HTTP aktarımı üzerinden https://mcp.bugagent.com/mcp adresinde canlıdır. Aşağıdaki sekiz istemciden herhangi biriyle bağlanın — iş akışınıza uygun olanı seçin.

🔑

Önce API anahtarınızı alın. app.bugagent.com/dashboard/settings/api-keys adresinde oturum açın, API Anahtarı Oluştur'a tıklayın ve değeri kopyalayın (ba_live_ ile başlar). Yalnızca bir kez göreceksiniz, bu yüzden güvenli bir yere yapıştırın. Aşağıdaki her örnek bu anahtarı kullanır.

Seçenek 1 — MCP Inspector (Web Arayüzü, ilk test için önerilir)

Resmi Anthropic aracı. Her araca tıklayabileceğiniz, parametreleri doldurabileceğiniz ve yanıtları görebileceğiniz yerel bir web arayüzü başlatır. Sıfır yapılandırma, IDE gerekmez.

macOS (Terminal)

Terminal

npx @modelcontextprotocol/inspector

Windows (PowerShell veya CMD)

PowerShell

Açılan tarayıcı arayüzünde:

Aktarım Türü: Streamable HTTP seçin
URL: https://mcp.bugagent.com/mcp
Bağlantı Türü: Proxy seçin (varsayılan — Inspector, tarayıcı CORS'unu aşmak için yerel bir Node süreci üzerinden proxy yapar)
Kimlik Doğrulama sekmesine tıklayın → özel bir başlık ekleyin:
- Başlık Adı: Authorization
- Değer: Bearer ba_live_YOUR_KEY_HERE
Bağlan'a tıklayın. Sol panelde 60'tan fazla bug_Agent_ aracını göreceksiniz.
Herhangi bir araca tıklayın (örn. list_bug_reports), parametreleri doldurun, Aracı Çalıştır'a tıklayın. Yanıt sağda görünür.

Ön Koşullar: Node.js 18 veya üstü. Eğer yoksa nodejs.org adresinden yükleyin.

Seçenek 2 — Claude Desktop (Mac + Windows)

Claude Desktop uygulamasını kullanıyorsanız, bug_Agent_'i kalıcı bir MCP sunucusu olarak ekleyebilirsiniz. Claude daha sonra her konuşmada tüm bug_Agent_ araçlarına sahip olacaktır.

macOS

Claude Desktop'ı açın → menü çubuğu Claude → Ayarlar → Geliştirici → Yapılandırmayı Düzenle. Bu, ~/Library/Application Support/Claude/claude_desktop_config.json dosyasını açar.
mcpServers altına bug_Agent_ girişini ekleyin:
claude_desktop_config.json

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

Dosyayı kaydedin ve Claude Desktop'ı tamamen kapatın (Cmd+Q, sadece pencereyi kapatmak değil).
Claude Desktop'ı yeniden başlatın. Sohbet girişinin altındaki araçlar çekiç simgesi artık bug_Agent_ araçlarını göstermelidir.
Deneyin: “En son 5 hata raporumu listele” yazın — Claude otomatik olarak list_bug_reports aracını çağıracaktır.

Windows

Claude Desktop'ı açın → Dosya → Ayarlar → Geliştirici → Yapılandırmayı Düzenle. Bu, %APPDATA%\Claude\claude_desktop_config.json dosyasını açar (genellikle C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json).
macOS bölümünde gösterilen JSON bloğunun aynısını ekleyin.
Dosyayı kaydedin ve Claude Desktop'ı sistem tepsisinden tamamen kapatın (Claude simgesine sağ tıklayın → Çık), ardından yeniden başlatın.
Araçlar çekiç simgesi bug_Agent_ araçlarını gösterecektir.

Seçenek 3 — Claude Code (CLI)

Terminalinizden Claude Code kullanıyorsanız (Claude'un CLI sürümü), bug_Agent_ sunucusunu tek bir komutla kaydedin. macOS, Linux ve Windows'ta aynı şekilde çalışır.

Terminal / PowerShell

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

Ardından Claude Code oturumunuzu yeniden başlatın. Bağlı olduğunu doğrulayın:

claude mcp list

Listede bugagent öğesini yeşil bir nokta ile görmelisiniz. Herhangi bir sohbette araçları kullanmaya başlayın: “Bu ayki keşif kullanımımı göster.”

Daha sonra kaldırmak için:

claude mcp remove bugagent

Seçenek 4 — OpenAI Codex CLI

OpenAI Codex CLI kullanıyorsanız, kalıcı kayıt için bug_Agent_'i ~/.codex/config.toml dosyasına ekleyin veya tek seferlik bir oturum için yapılandırmayı satır içi olarak iletin.

Kalıcı kayıt (yapılandırmaya ekle)

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

Satır içi — tek oturum

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, doğal dil isteminizden araç çağrılarını otomatik olarak çözer. Deneyin: “Önem derecesine göre sıralanmış açık hatalarımı listele.”

Seçenek 5 — Cursor (Mac + Windows)

Cursor, yerleşik MCP desteğine sahiptir. bug_Agent_'i bir kez ekleyin; Cursor içindeki yapay zeka asistanı, düzenleyicinizden ayrılmadan hata bildirebilir, raporları listeleyebilir, taramalar çalıştırabilir vb.

Cursor'ı açın → Ayarlar (Mac'te Cmd+, / Windows'ta Ctrl+,) → sol kenar çubuğunda MCP.
+ Yeni MCP sunucusu ekle'ye tıklayın.
HTTP aktarım türünü seçin.
Doldurun:
- Ad: bugagent
- URL: https://mcp.bugagent.com/mcp
- Başlık adı: Authorization
- Başlık değeri: Bearer ba_live_YOUR_KEY_HERE
Kaydet'e tıklayın. Cursor bağlandığında yeşil bir gösterge gösterir.
Cursor'ın sohbetini açın (Cmd+L / Ctrl+L) ve “Başlığı 'Giriş bozuk', önem derecesi yüksek bir hata raporu oluştur” yazın. Cursor, create_bug_report aracını çağıracaktır.

Alternatif: Cursor ayrıca ~/.cursor/mcp.json (Mac) veya %USERPROFILE%\.cursor\mcp.json (Windows) dosyasını okur. Claude Desktop bölümünde gösterilen JSON formatının aynısını ekleyin.

Seçenek 6 — Continue eklentili VS Code (Mac + Windows)

VS Code tercih ediyorsanız, Continue eklentisi MCP sunucularını yerel olarak destekler.

VS Code pazar yerinden Continue eklentisini yükleyin.
Continue yapılandırmasını açın: Komut Paleti (Cmd+Shift+P / Ctrl+Shift+P) → Continue: config.json'u aç. Dosya şu konumdadır:
- macOS: ~/.continue/config.json
- Windows: %USERPROFILE%\.continue\config.json
Bir mcpServers girişi ekleyin:
~/.continue/config.json

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

Kaydedin. Continue otomatik olarak yeniden yüklenecek ve kenar çubuğunda bug_Agent_ araçlarını gösterecektir.
Continue sohbet panelini açın ve deneyin: “Güvenlik taramalarımı listele.”

Diğer MCP özellikli VS Code eklentileri: Cline, Roo Code ve Windsurf (çatal), hepsi bir mcpServers anahtarı ve HTTP aktarımı ile benzer JSON yapılandırma desenlerini takip eder.

Seçenek 7 — OAuth farkında ana bilgisayarlar (Örnek olarak Claude.ai web gösterilmiştir)

Bazı MCP ana bilgisayarları OAuth 2.0 ile kimlik doğrular ve taşıyıcı bir API anahtarı kabul etmek yerine önceden statik bir client_id ve client_secret ister. Bu ana bilgisayarlar için, bug_Agent_ panosundan çalışma alanı kapsamlı bir OAuth kimlik bilgisi çifti oluşturur ve bunu ana bilgisayarın bağlayıcı formuna yapıştırırsınız. Kimlik bilgileri MCP ana bilgisayarından bağımsızdır — Yetkilendirme Kodu + PKCE'yi destekleyen herhangi bir OAuth istemcisi bunları kullanabilir. Aşağıdaki adım adım anlatım, en yaygın örnek olarak Claude.ai web uygulamasını kullanır.

bug_Agent_ içinde: Ayarlar → Geliştiriciler → MCP Bağlayıcıları'nı açın. Bağlayıcı oluştur'a tıklayın, ana bilgisayarı tanımlayan bir ad verin (örn. “Claude.ai (iş)”), MCP ana bilgisayarınızın gerektirdiği yönlendirme URI'sini yapıştırın (Claude.ai web uygulaması için bu https://claude.ai/api/mcp/auth_callback şeklindedir — diğerleri için ana bilgisayarınızın bağlayıcı belgelerine bakın) ve kimlik doğrulama yöntemi için Gizli'yi seçin. Başarı ekranında bir kez gösterilen client_id ve client_secret değerlerini kopyalayın.
MCP ana bilgisayarınızın bağlayıcı / OAuth ayarlarında şunları yapıştırın:
- Sunucu URL'si: https://mcp.bugagent.com/mcp
- İstemci Kimliği + İstemci Sırrı: 1. adımdan
- Yetkilendirme URL'si: https://mcp.bugagent.com/authorize
- Belirteç URL'si: https://mcp.bugagent.com/token
  Claude.ai için özel olarak: claude.ai/customize/connectors adresine gidin ve MCP bağlayıcısı ekle'ye tıklayın.
Kaydedin. Ana bilgisayar, oturum açmanız (Google veya e-posta/şifre — pano için hangi yöntemi kullanıyorsanız) ve onayı kabul etmeniz için sizi bug_Agent_'e yönlendirir, ardından OAuth el sıkışmasını tamamlar.
Oluşturulan bağlayıcıları aynı Ayarlar sayfasından yönetin ve iptal edin. İptal anında gerçekleşir — o bağlayıcıdan gelen bir sonraki istek invalid_client döndürür.

Not: Claude Code, Cursor, VS Code ve MCP Inspector bu akışa ihtiyaç duymaz — dinamik istemci kaydını (RFC 7591) otomatik olarak işler ve yukarıda gösterildiği gibi API anahtarı ile kimlik doğrular. MCP Bağlayıcıları formu yalnızca statik OAuth kimlik bilgileri gerektiren ana bilgisayarlar içindir.

Seçenek 8 — curl ile Doğrudan HTTP (Terminal)

Sunucuyu herhangi bir istemci olmadan doğrudan test etmek veya bir betiğe entegre etmek isterseniz, curl ile HTTP uç noktasına istek yapabilirsiniz. MCP protokolü, Streamable HTTP üzerinden JSON-RPC 2.0'dır.

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

Yanıtlar Sunucu Tarafından Gönderilen Olaylar (MCP Streamable HTTP standardı) olarak gelir. Her parça, data: ile ön eklenmiş ve ardından bir JSON nesnesi gelen bir satırdır. Accept: application/json, text/event-stream başlığı zorunludur — sunucu, bu başlık olmadan istekleri reddeder.

ℹ️

401 Yetkisiz Sorun Giderme: API anahtarınızın Ayarlar → API Anahtarları'nda iptal edilmediğini kontrol edin. Anahtarlar ba_live_ ile başlar. Hâlâ takılı kaldıysanız, anahtarı yeniden oluşturun ve tekrar deneyin.

Deneyin — Sade İngilizce İstemler

Bağlandıktan sonra, araç adlarını veya parametreleri bilmeniz gerekmez. Ne istediğinizi sade İngilizce ile tanımlayın; yapay zeka asistanınız doğru bug_Agent_ aracını otomatik olarak çağırır.

Hata Raporları

Yapay zeka asistanınıza sorun

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

Test Yönetimi

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

Güvenlik ve Performans

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 Otomasyonu

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

Keşifsel Yapay Zeka

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?

Kullanım ve İstatistikler

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?

Hızlı Başvuru

Sekiz istemcinin tümü için yapılandırma dosyası konumları. Her istemci, Streamable HTTP üzerinden Authorization: Bearer ba_live_YOUR_KEY_HERE başlığı ile https://mcp.bugagent.com/mcp adresine bağlanır.

İstemci Yapılandırma konumu / komutu

MCP Inspector Dosya yok — npx @modelcontextprotocol/inspector sonrasında tarayıcı arayüzüne URL ve kimlik doğrulama başlığını girin

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 Ayarlar → MCP arayüzü veya ~/.cursor/mcp.json

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

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

Doğrudan HTTP (curl) curl / Invoke-RestMethod — Accept: application/json, text/event-stream dahil edin

Sorun Giderme

Belirti Çözüm

401 Unauthorized Anahtar yanlış, süresi dolmuş veya iptal edilmiş. Ayarlar → API Anahtarları'nı kontrol edin — anahtarlar ba_live_ ile başlar. Gerekirse yeniden oluşturun.

Araçlar istemcide görünmüyor Yapılandırmayı düzenledikten sonra istemciyi tamamen kapatıp yeniden başlatın. Claude Desktop'ta, Cmd+Q (sadece pencereyi kapatmak değil). Cursor'da, yeşil nokta için Ayarlar → MCP'yi kontrol edin.

Accept header required Doğrudan HTTP çağrıları Accept: application/json, text/event-stream içermelidir — Streamable HTTP belirtimi bunu gerektirir. Sunucu, bu olmadan 406 döndürür.

Yanlış çalışma alanının verileri Her API anahtarı bir çalışma alanına kapsamlıdır. Sorgulamak istediğiniz çalışma alanından Ayarlar → API Anahtarları'nda yeni bir anahtar oluşturun.

Araçlar görünüyor ancak çağrılar sessizce başarısız oluyor Sunucunun erişilebilir olduğunu doğrulayın: curl -I https://mcp.bugagent.com/health, 200 döndürmelidir. Zaman aşımına uğrarsa, ağ/güvenlik duvarı kurallarını kontrol edin.

MCP Inspector CORS hatası Inspector arayüzünde Bağlantı Türü için Proxy'yi (Direct değil) seçin. Inspector, tarayıcı CORS kısıtlamalarını aşmak için yerel bir Node süreci üzerinden proxy yapar.

Codex CLI — araçlar tanınmıyor ~/.codex/config.toml öğesinin [[mcp_servers]] kullandığını doğrulayın (çift köşeli parantez, dizi sözdizimi). Codex CLI sürümünün MCP'yi destekleyecek kadar yeni olduğunu kontrol edin (codex --version).

MCP Özellikleri

bug_Agent_ MCP sunucusu şunlar için araçlar sağlar:

🐛

Hata Raporu Yönetimi

create_bug_report — 19 türde (hata, özellik isteği, geliştirme, teknik borç ve daha fazlası) otomatik sınıflandırma ile yeni bir rapor oluşturun (başlık: 3-500 karakter). İsteğe bağlı attachments dizisi, her biri 400 MB'a kadar base64 ile kodlanmış dosyaları kabul eder: herhangi bir resim, video, ses, PDF veya metin/JSON. Açıklamayı yapay zeka kullanarak yapılandırılmış bir şablona otomatik olarak yeniden biçimlendirmek için format_description: true ayarlayın. QA çabasını izlemek için time_spent_seconds iletin. Düzeltme aciliyetini önem derecesinden bağımsız olarak ayarlamak için priority (urgent / high / normal / low) iletin. Yanıt project_id, project, short_id, legacy_short_id ve project_short_id içerir.
list_bug_reports — Raporları listeleyin ve filtreleyin (sayfa başına en fazla 100). Proje filtreleri, sayfalamadan önce sunucu tarafında uygulanır. project (UUID, kısa ad, tam ad veya bilet öneki), project_id, project_slug, project_prefix, workspace (UUID, tam ad veya çalışma alanı bilet öneki), workspace_id/team_id, type (19 gösterge paneli kategorisinden biri), severity (s1-s4 veya eski critical/high/medium/low), status (gösterge panelinin tam değerlerini kullanarak: new, awaiting-triage, confirmed, in-progress, blocked, resolved, retesting, closed, reopened — tireler bilinçlidir), resolution (fixed / duplicate / works-as-designed / cannot-reproduce / will-not-fix / need-more-info / unresolved), root_cause (açık uçlu kebab-case etiketi — yaygın değerler: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch) veya reporter_user_id (raporu oluşturan ekip üyesinin UUID'si — bir adı UUID'ye çözümlemek için önce list_team_members çağrısı yapın) ile filtreleyin. Her sonuç reporter_user_id, project_id, project, short_id, legacy_short_id ve project_short_id içerir, böylece aracılar doğru proje kapsamlı raporu bağlayabilir ve güncelleyebilir.
pick_next_bug — Aracı döngüsünün üzerinde çalışması gereken sonraki hata(lar)ı öncelik sırasına göre döndürür (S1 → S2 → S3, her grupta en eski önce). Çalışma alanınıza otomatik olarak kapsamlandırılır — ekibinizdeki tüm projelerde status new, awaiting-triage veya confirmed ve S1-S3 önem derecesine sahip biletleri döndürür. Salt okunur — biletleri atomik olarak talep etmez. İsteğe bağlı severity (tek katman), limit (1-50, varsayılan 1). Araç birleştirilebilirliği için list_bug_reports ile aynı şekilde satırlar döndürür. Oku-sonra-talep et deseni için claim_bug ile eşleştirin.
claim_bug — Bir hatayı status new, awaiting-triage veya confirmed durumundan status='in-progress' durumuna atomik olarak geçirin, assigned_to çağıran kullanıcıya ayarlayın ve claimed_at=NOW() damgasını vurun. Postgres'in UPDATE-WHERE-RETURNING deseni aracılığıyla eşzamanlı çağrıcılar arasında yarış durumu olmaksızın — iki aracı aynı kimlik üzerinde kısa süre içinde claim_bug çağrısı yaparsa, tam olarak biri hata gövdesiyle claimed:true alır ve diğeri bir neden dizesiyle claimed:false alır. Bir pg_cron temizleyicisi, eski talepleri (durum=in-progress + claimed_at > 30 dakika) otomatik olarak new durumuna geri döndürür, böylece çöken bir aracının biletleri manuel müdahale olmadan kuyruğa yeniden girer. Girdiler: id (UUID veya kısa kimlik).
get_bug_report — Kimliğe göre bir raporun tüm ayrıntılarını alın. Kimlik biçimleri: UUID'yi (örn. 1fb72a2c-87c7-...), çalışma alanı kapsamlı kısa kimliği (örn. WRKID-545) veya proje kapsamlı kısa kimliği (örn. WRKID-APP-042) kabul eder. Kısa kimlik aramaları ekip kapsamlıdır — başka bir çalışma alanının kısa kimliğini tahmin etmek 404 döndürür. project_id, project, short_id, legacy_short_id, project_short_id, ticket_number, project_ticket_number, qualityScore (1–10 tamsayı) ve qualityBreakdown (10 boyut puanına sahip nesne: reproductionSteps, expectedVsActual, environmentDetails, evidence, rootCauseAnalysis, impactAssessment, contextAndHistory, heuristicsAndOracles, clarityAndStructure, actionability — her biri 0.0–1.0) döndürür.
update_bug_report — Mevcut bir rapordaki alanları güncelleyin. UUID veya kısa kimlik kabul eder (WRKID-545). Güncellenebilir alanlar şunları içerir: title, description, type (19 gösterge paneli kategorisinden herhangi biri), severity, priority (urgent / high / normal / low — düzeltme aciliyeti, önem derecesinden bağımsız), status (gösterge paneliyle tam olarak eşleşir: new, awaiting-triage, confirmed, in-progress, blocked, resolved, retesting, closed, reopened — tireler bilinçlidir), resolution (fixed / duplicate / works-as-designed / cannot-reproduce / will-not-fix / need-more-info / unresolved) ve root_cause (açık uçlu kebab-case etiketi — yaygın değerler: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch). Aracı döngüsü kuralı, status new dışına her geçiş yaptığında hem resolution hem de root_cause ayarlanmasını gerektirir; gösterge paneli, analitik ve gelecekteki claude-bot eğitim külliyatı bu alanlara bağlıdır. Ayrıca assigned_to (list_team_members kullanıcı kimliği) ve zamanlayıcı takibi için time_spent_seconds içerir. assigned_to değiştirildiğinde, uygulama içi zil bildirimini VE yeni atanan kişiye bir bilgilendirme e-postasını otomatik olarak tetikler (Hesap Ayarları'ndaki kullanıcı başına devre dışı bırakma tercihlerine saygı göstererek — gösterge paneli uç noktalarıyla aynı işlem hattı).
add_comment — Bir hata raporuna yorum ekleyin (UUID veya kısa kimlik, gövde 1-10000 karakter). Rapor Jira ile senkronize edilmişse, yorum otomatik olarak bağlantılı Jira konusuna iletilir.
list_comments — Bir raporun tüm yorum dizisini en eskiden en yeniye doğru listeleyin — her yorum yazar adı, parentId (iç içe yanıtlar) ve zaman damgalarıyla birlikte. Yorumlar get_bug_report parçası değildir, bu nedenle bir biletin tartışmasını bu şekilde okursunuz. UUID veya kısa kimlik kabul eder.
link_bug_reports — Aynı çalışma alanındaki iki hata raporu arasında yönlü bir anlamsal bağlantı oluşturun. link_type şunlardan biridir: duplicate-of, parent-of, related-to veya depends-on. Ters perspektifler (duplicated-by / subtask-of / blocks) okuma zamanında türetilir — yalnızca bir satırın depolanması gerekir. Hem from_report_id hem de to_report_id UUID'leri veya kısa kimlikleri kabul eder (WRKID-545).
unlink_bug_reports — UUID'sine göre önceden oluşturulmuş bir hata raporu bağlantısını kaldırın (link_id, link_bug_reports veya list_bug_report_links tarafından döndürülür).
list_bug_report_links — Bir hata raporuna dokunan kullanıcı tarafından seçilmiş her bağlantıyı listeleyin. Her bağlantıyı, sağlanan raporun perspektifinden okunduğu şekliyle döndürür — örn. bu raporun hedef olduğu depolanmış bir duplicate-of satırı duplicated-by olarak işlenir; bu raporun hedef olduğu parent-of subtask-of olarak işlenir; bu raporun hedef olduğu depends-on blocks olarak işlenir. related-to simetriktir. get_bug_report tarafından döndürülen otomatik algılanan similar_reports alanını tamamlar.
classify_bug — Bir açıklamayı güven puanıyla 19 rapor türünden birine (hatalar, özellikler, geliştirmeler vb.) sınıflandırın
flush_reports — Eski raporları toplu olarak silin (yalnızca yönetici)

📊

Kullanım ve Analitik

get_usage — Plan limitlerine göre kullanımı kontrol edin
get_stats — Günlük sayımlar, tür/önem derecesi/durum dökümleri

📁

Proje Yönetimi

list_projects — id, name, slug, ticket_prefix, açıklama ve varsayılan durum ile mevcut projeleri listeleyin. Doğru projeyi hedeflemek için bu değerleri create_bug_report ve list_bug_reports ile kullanın.
create_project — Yeni bir proje oluşturun (ilk ise otomatik olarak varsayılan olur)
delete_project — Bir projeyi ve ilişkili tüm verileri (hata raporları, otomasyonlar, test senaryoları, mobil uygulamalar, zamanlamalar, coğrafi anlık görüntüler, notlar, zaman girişleri) kalıcı olarak silin. Yalnızca sahip/yönetici. Son proje silinemez. Depolama otomatik olarak serbest bırakılır
export_okf_bundle — Bir projenin QA bilgisini — hata raporları, test senaryoları, otomasyonlar ve performans, güvenlik ve keşif testleri — bir OKF/OQA markdown paketi (oqa.ai tarafından kullanılan Open Query Agent formatı) olarak dışa aktarın. Varsayılan olarak aktif projeyi kullanır; farklı bir projeyi dışa aktarmak için isteğe bağlı project (kısa ad veya ad) iletin. Paketteki dosyaların listesini ve paketin kendisini base64 ile kodlanmış bir zip olarak döndürür

🔐

Kimlik Doğrulama ve Hesap

register_account — Yeni bir hesap oluşturun (şifre: 8-128 karakter, hız sınırlı: 5/15dk)
login — Oturum açın ve erişim belirteçlerini alın (hız sınırlı: 5/15dk)
update_profile — Görünen adı güncelleyin
change_password — Hesap şifresini değiştirin
get_settings / update_settings — Tercihleri yönetin

🔑

API Anahtarı Yönetimi

generate_api_key — Adlandırılmış bir API anahtarı oluşturun
list_api_keys — Aktif anahtarları listeleyin (yalnızca önek)
regenerate_api_key — Bir anahtarı iptal edin ve değiştirin
delete_api_key — Bir anahtarı kalıcı olarak iptal edin

👥

Ekip Yönetimi

list_team_members — Çalışma alanınızın tüm üyelerini roller, durum ve booster bayraklarıyla listeleyin
invite_team_member — E-posta ile bir kullanıcı davet edin (yöneticiler katkıda bulunanları ve yöneticileri davet edebilir; yalnızca sahipler admin'leri davet edebilir). 5 günlük son kullanma bağlantısı

🎯

Entegrasyonlar

sync_to_jira — Ekibin paylaşılan bağlantısını kullanarak bir raporu Jira'ya senkronize edin
push_to_claude — Bir hata raporu için Geliştirici Notlarını oluşturun (veya yeniden oluşturun) — kök neden, önerilen düzeltme, doğrulama adımları ve risk değerlendirmesi. UUID veya kısa kimlik kabul eder (WRKID-545). Platform anahtarlarını kullanır — ekip başına Claude bağlantısı gerekmez. Uyarlanabilir bir zincir çalıştırır: s3/medium veya s4/low hatalarında üç adım (Sonnet taslağı → OpenAI gpt-5 eleştirisi → Sonnet sentezi), en üst iki önem derecesi grubunda — s1/critical veya s2/high — beş adım (taslak → eleştiri → Sonnet reddiye → tam transkripti okuyan ve bağımsız yargıyla nihai notları yazan Claude Opus hakem). Yanıt her turu gösterir: analysis, draft, critique, rebuttal, challenger_model, adjudicator_model ve bir debated bayrağı. Herhangi bir adımın başarısız olması durumunda bir sonraki en iyi cevaba geçilir. Hata oluşturmada otomatik olarak tetiklenir; genellikle yalnızca manuel yeniden oluşturma için çağrılır.
analyze_fix_area — Geliştirici Notları'nın "Olası Düzeltme Alanı" alt bloğunu oluşturun (veya yeniden oluşturun) — düzeltmenin büyük olasılıkla kod tabanının neresine ait olduğunu belirten dar bir Sonnet çıktısı. UUID veya kısa kimlik kabul eder. Platform Anthropic anahtarını kullanır. Ekibin bir github_connections satırı olduğunda ve projenin bir github_repo eşlemesi olduğunda, çıktı bağlı depodaki gerçek dosya parçacıklarına dayanır; aksi takdirde bir depo bağlama önerisiyle genel rehberliğe düşer. likely_fix_area metnini, generated_at, repo_used ve bir grounded bayrağını döndürür. Hata oluşturmada otomatik olarak tetiklenir — aracıların genellikle bunu yalnızca manuel yeniden oluşturma için çağırması gerekir.
upgrade_plan — Stripe aracılığıyla aboneliği yükseltin

⚡

Performans Testi

create_performance_test — URL, cihaz, sanal kullanıcı, süre, skor eşiği ve otomatik hata oluşturma seçeneği ile bir performans testi yapılandırması oluşturun. Yalnızca Enterprise
run_performance_test — Bir web performans testi için sayfa denetimi ve yük testi tetikleyin. Sonuçları sorgulamak için bir çalıştırma kimliği döndürür. Mobil uygulama profil oluşturma çalıştırmaları panodan tetiklenir
get_performance_results — Lighthouse skorları (Performans, Erişilebilirlik, En İyi Uygulamalar, SEO), Temel Web Verileri (LCP, FID, CLS, FCP, TTFB, INP, TBT, SI) ve yük testi metrikleri (VU, istek, RPS, p50/p90/p95/p99 gecikmeler) dahil tam sonuçları alın
list_performance_tests — Mevcut ekip için tüm performans testi yapılandırmalarını listeleyin
get_performance_usage — Aylık performans testi kullanımını kontrol edin. Performans testi yalnızca Enterprise'tır. Ücretsiz=0, Enterprise=sınırsız

Örnek İş Akışı

get_performance_usage → kalan kotayı kontrol edin
create_performance_test → URL'niz için bir test yapılandırın
run_performance_test → denetim + yük testini tetikleyin
get_performance_results → skorları ve temel verileri inceleyin

🛡

Güvenlik Taraması

create_security_scan — Bir güvenlik taraması yapılandırması oluşturun. Web taramaları, üç derinlik seviyesi ve isteğe bağlı kimlik doğrulamalı tarama ile Hızlı Tarayıcı + Nuclei (4.000'den fazla şablon) kullanır. Mobil taramalar, APK/IPA ikili analizi için MobSF kullanır. Önem derecesi eşikleri ile yapılandırılabilir otomatik hata oluşturma. Yalnızca Enterprise
run_security_scan — Bir güvenlik açığı taraması tetikleyin. Web taramaları DNS alan adı doğrulaması gerektirir. Mobil taramalar yüklenmiş bir uygulama gerektirir. Sonuçları sorgulamak için bir çalıştırma kimliği döndürür
get_security_results — Güvenlik skoru (0-100), CWE referansları, OWASP eşlemeleri, kanıt ve düzeltme rehberliği ile önem derecesine göre kategorize edilmiş bulgular (Kritik, Yüksek, Orta, Düşük, Bilgi) dahil tam sonuçları alın
list_security_scans — Mevcut ekip için son skor ve yetkilendirme/derinlik rozetleri ile tüm güvenlik taraması yapılandırmalarını listeleyin
get_security_usage — Aylık güvenlik taraması kullanımını kontrol edin. Güvenlik taraması yalnızca Enterprise'tır. Enterprise=sınırsız
list_security_schedules — Ekip için cron, saat dilimi, etkin durumu, sonraki çalıştırma ve bildirim ayarları ile tüm zamanlanmış güvenlik taramalarını listeleyin. Üst tarama yapılandırmasıyla (ad, tarama_türü, hedef_url) birleştirir
create_security_schedule — Bir güvenlik taraması için yinelenen bir zamanlama oluşturun. scan_id ve cron_expression gerektirir. Tarama yapılandırması başına bir zamanlama. İsteğe bağlı timezone, notify_on_fail (hiçbiri/e-posta/slack/her ikisi), notify_email, slack_channel_id. Her çalıştırma aylık kotanızdan düşer; yönetici kullanıcılar kotayı aşar. Tarama derinliği her zaman çalışma zamanında tarama yapılandırmasından okunur
delete_security_schedule — Zamanlanmış bir güvenlik taramasını silin. Üst tarama yapılandırmasını veya tamamlanmış çalıştırmaları etkilemez

get_security_usage → kalan kotayı kontrol edin
create_security_scan → URL'niz veya deponuz için bir tarama yapılandırın
run_security_scan → tek seferlik bir güvenlik açığı taraması tetikleyin
create_security_schedule → yinelenen çalıştırmaları otomatikleştirin (örn. ana dalda haftalık SAST)
get_security_results → bulguları ve düzeltmeyi inceleyin

📖

Kod İncelemesi

list_code_reviews — Ekip için son AI kod incelemelerini listeleyin. Kalite skorlarını, önem derecesi sayımlarını, PR bilgilerini ve zaman damgalarını döndürür. Yalnızca Enterprise
get_code_review — Tüm bulgularla bir kod incelemesi alın. Her bulgu; önem derecesi, kategori (hata/güvenlik/performans/stil/mantık/sürdürülebilirlik), başlık, açıklama, kod önerisi, dosya yolu ve satır numaralarını içerir
get_code_review_usage — Kod inceleme kullanımını kontrol edin. AI kod incelemesi yalnızca Enterprise'tır; Enterprise'da sınırsız
get_code_review_analytics — İnceleme analizlerini alın: eğilimler, bulgu kategorileri/kaynakları, önem derecesi dağılımı, hız metrikleri, en iyi depolar/yazarlar. 7/30/90 günlük geriye dönük bakışı destekler

get_code_review_usage → kalan incelemeleri kontrol edin
/dashboard/code-review adresindeki panoda bir PR'ı inceleyin
list_code_reviews → son incelemeleri görün
get_code_review → bulguları ve önerileri alın

🔍

Keşifsel AI

Her biri farklı bir test stratejisi kullanan, 10'a kadar paralel ajan içeren çok ajanlı otonom web sitesi hata bulucu.

list_explorations — Ekip için Keşifsel AI yapılandırmalarını listeleyin
create_exploration — Yeni bir keşif oluşturun. Benzersiz stratejilere sahip birden fazla paralel ajan çalıştırmak için agent_count (1–10, maks. 10) kabul eder: mutlu_yol, uç_durum, güvenlik, erişilebilirlik, hata_yolu, performans, mobil, veri_bütünlüğü, navigasyon, özel
get_exploration — Ajan ayarları ve son çalıştırmalarla keşif yapılandırmasını alın
get_exploration_run — Ajan başına ilerleme, aşama verileri, ajan atıflı bulgular (agent_index, agent_strategy) ve bağlantılı hatalarla çalıştırma sonuçlarını alın
get_exploration_usage — Aylık kullanımı kontrol edin. Keşifsel AI yalnızca Enterprise'tır; Enterprise: sınırsız (10 ajan)

create_exploration ile agent_count: 5 → 5 paralel ajan yapılandırın
Panodan veya POST /api/explorations/run aracılığıyla bir çalıştırma tetikleyin
get_exploration_run → ajan başına ilerleme ve bulguları sorgulayın
Panoda ajan atıflı tekilleştirilmiş bulguları görüntüleyin

📝

Notlar

list_notes — İsteğe bağlı anahtar kelime araması, proje filtresi, yazar filtresi ve tarih aralığı ile notları listeleyin. Kullanıcının sahip olduğu notları veya ekip içinde paylaşılan notları döndürür.
create_note — 5 formattan birinde bir not oluşturun: markdown, plain_text, rich_text, checklist, outline. visibility öğesini private veya shared olarak ayarlayın. Başlık sağlanmazsa ilk 30 karakterden otomatik başlık oluşturulur. İsteğe bağlı attachments dizisi, her biri 400 MB'a kadar base64 kodlu dosyaları kabul eder: herhangi bir resim, video, ses, PDF veya metin/JSON. QA çabasını izlemek için time_spent_seconds iletin.
get_note — İçerik ve ekler dahil tam not ayrıntılarını alın. id gerektirir.
update_note — Başlığı, içeriği, formatı, görünürlüğü, projeyi veya time_spent_seconds güncelleyin. Notun mevcut eklerini değiştirmeden yeni dosyalar (her biri maks. 400 MB) eklemek için bir attachments dizisi iletin. Yalnızca yazar güncelleyebilir. id gerektirir.
delete_note — Bir notu ve eklerini kalıcı olarak silin. Yalnızca yazar silebilir. id gerektirir.

create_note → bir test oturumu notu başlatın
update_note → test ederken gözlemleri ekleyin
list_notes → anahtar kelime veya projeye göre geçmiş notları arayın
get_note → eklerle birlikte tam notu alın

🤖

Otomasyon

create_automation — Özel bir Playwright betiği ile yeni bir otomasyon oluşturun (FAB kaydı gerekmez). name gerektirir. İsteğe bağlı: target_url (atlanırsa betikteki ilk page.goto(...) URL'sinden otomatik türetilir), script (Node.js/JavaScript/TypeScript veya Python — dil otomatik algılanır; varsayılan olarak bir yer tutucu), status (draft veya active, varsayılan: draft), project_id. Otomasyon id döndürür. Ekip planı gereklidir. İpucu — Bir otomasyonu çoğaltın: orijinal betiği almak için get_automation kullanın, ardından name öğesini "[Copy] Original Name" olarak ayarlayarak create_automation çağrısı yapın ve orijinal script, target_url ve project_id iletin. Kopya, sürüm geçmişi olmadan draft durumunda başlar.
list_automations — Playwright otomasyon betiklerini listeleyin. project_id veya status (draft, active, paused) ile filtreleyin. Ad, hedef_url, son_çalıştırma_durumu ve çalıştırma_sayısı ile otomasyon dizisi döndürür.
get_automation — Playwright betiği ve son çalıştırmalar dahil tam otomasyon ayrıntılarını alın. id gerektirir. Canlı script, bir script_versions yığını (en eskiden en yeniye, 100'e kadar önceki giriş, her biri { script, source, timestamp }) ve her çalıştırmanın yürüten script_version_label/script_version_source taşıdığı bir recent_runs dizisi ile otomasyonu döndürür. Belirli bir geçmiş sürümü seçmeniz gerekiyorsa run_automation öncesinde bunu çağırın.
run_automation — Bir Playwright testinin anında çalıştırılmasını tetikleyin. automation_id gerektirir. Sanal mod (varsayılan): görünüm alanı öykünmesi için isteğe bağlı device (örn. desktop, iphone-15). Canlı mod: gerçek bir masaüstü tarayıcıda çalıştırmak için browserstack: true ile bs_browser (chrome, firefox, safari, edge), bs_os (Windows, OS X) ve bs_os_version ayarlayın. Canlı gerçek-mobil: bs_os: "android" (cihazlar: "Samsung Galaxy S25 Ultra", "Google Pixel 10", "OnePlus 13R") veya bs_os: "ios" (cihazlar: "iPhone 17 Pro Max", "iPhone 16 Pro Max", "iPhone 15 Pro Max") ayarlayın ve cihaz adını bs_os_version içinde iletin. Node.js betikleri browserstack-node-sdk üzerinden yönlendirilir (masaüstü + Android + iPhone'u kapsar). Python betikleri browserstack-sdk (pytest-playwright) üzerinden yönlendirilir ve yalnızca masaüstünü kapsar — Python aracılığıyla gerçek mobil desteklenmez çünkü pytest-playwright'ın browser_type.connect() BrowserStack'in gerçek mobil uç noktalarını yönetemez. Video ve ağ günlükleri otomatik olarak yakalanır; konsol günlükleri yalnızca masaüstü. Sürüm tekrarı: otomasyonun script_versions geçmişinden önceki bir girişi yürütmek için isteğe bağlı version_index (tamsayı, 0 dizinli) iletin. Varsayılan: version_index atlandığında veya null olduğunda, mevcut canlı betik çalışır — sadece "mevcut olanı seç" diye bir yer tutucu değer iletmeyin. Aralık dışı, negatif veya tamsayı olmayan değerler reddedilir. Çalıştırma kaydı, çalışan tam anlık görüntüyü saklar ve başarısız bir çalıştırmadan otomatik oluşturulan herhangi bir hata raporu, düzenleyicide o sürüme derin bağlantı verir.
list_automation_runs — Bir otomasyon için son çalıştırmaları listeleyin. automation_id gerektirir. Durum, süre_ms ve hata_mesajı ile çalıştırmaları döndürür.
list_schedules — Cron, saat dilimi, cihaz ve bildirim ayarları ile tüm zamanlanmış web otomasyonu çalıştırmalarını listeleyin
create_schedule — Zamanlanmış bir web otomasyonu çalıştırması oluşturun. automation_id ve cron_expression gerektirir. Cihaz, saat dilimi, hata_durumunda_bildir (e-posta/slack/her ikisi) ve Slack kanalı seçeneklerini destekler. Zamanlanmış çalıştırmalarda BrowserStack Canlı: browserstack: true ile bs_browser, bs_os ve bs_os_version iletin — run_automation ile aynı cihaz matrisi (Node = masaüstü + gerçek Android + gerçek iPhone; Python = yalnızca masaüstü).
delete_schedule — Zamanlanmış bir web otomasyonu çalıştırmasını silin
list_mobile_schedules — Cihazlar, cron, saat dilimi ve bildirimlerle tüm zamanlanmış mobil otomasyon çalıştırmalarını listeleyin
create_mobile_schedule — Gerçek cihazlarda zamanlanmış bir mobil otomasyon çalıştırması oluşturun. automation_id, cron_expression ve devices dizisi gerektirir
delete_mobile_schedule — Zamanlanmış bir mobil otomasyon çalıştırmasını silin
optimize_automation_script — AI destekli optimizasyon için bir Playwright betiğini Sonnet 4'e gönderin. Seçicileri, bekleme stratejilerini, onaylamaları, hata işlemeyi, yetkilendirme desenlerini, mobil uyumluluğu ve katı modu düzelten 12 maddelik bir kontrol listesi uygular. automation_id gerektirir. Mevcut betik sürümü optimizasyondan önce kaydedilir. Optimize edilmiş betiği ve bir değişiklik özetini döndürür.
undo_automation_script — Bir otomasyon betiğini önceki sürümüne geri döndürün. 10'a kadar önceki sürüm saklanır. automation_id gerektirir. Geri yüklenen betiği ve kalan sürüm sayısını döndürür.

create_automation → özel bir betikle test oluşturun
list_automations → mevcut testlere göz atın
get_automation → Playwright betiğini inceleyin
run_automation → testi tetikleyin
list_automation_runs → sonuçları ve süreyi kontrol edin

⏱️

Zaman Takibi

list_time_entries — Ekip için zaman girişlerini listele. period (today, week, month, all), project_id, category ve sort (newest, oldest, most_time, least_time) ile filtrele. Yalnızca Ekip planı.
create_time_entry — QA görevlerine harcanan zamanı kaydet. description, category ve duration_minutes gerektirir. İsteğe bağlı olarak project_id ve entry_date ayarlayın (varsayılan bugün). Yalnızca Ekip planı.
update_time_entry — Mevcut bir zaman girişini güncelle. id gerektirir. description, category, duration_minutes, project_id veya entry_date güncellenebilir. Yalnızca Ekip planı.
delete_time_entry — Bir zaman girişini kalıcı olarak sil. id gerektirir. Yalnızca Ekip planı.

create_time_entry → 45 dakikalık regresyon testini kaydet
list_time_entries → bu haftanın zaman girişlerini görüntüle
update_time_entry → süreyi veya kategoriyi ayarla
delete_time_entry → hatalı bir girişi kaldır

☑️

Test Senaryoları

Hiyerarşik klasörler, iç içe suitler (çalıştırmalarda alt suitlerin otomatik genişletilmesiyle 3 seviyeye kadar derinlik), sürükle-bırak yeniden sıralama, yapay zeka destekli senaryo oluşturma ve KPI trendleri, hata analizi, suit sağlığı, kapsam ve testçi üretkenliği içeren analitik Raporlar sekmesi ile tam test yönetimi. Tüm araçlar doğrudan Supabase'i çağırır — HTTP gidiş-dönüşü yok, kontrol paneliyle aynı gecikme süresi.

Eller serbest yürütme: çalıştırma inceleme sayfası, her seferinde bir senaryonun göründüğü bir karuseldir, klavye kısayolları (P Geçti · F Kaldı · B Engelli · S Atla) ve ses kontrolü. Mikrofona tıklayın, ardından "Geçti", "Kaldı", "Engelli", "Atla", "Sonraki", "Önceki", "Not ekle" (not alanına yazdırır), "Notları kaydet" veya "Sesi kapat" deyin. Başarılı sonuçlarda bir sonraki test edilmemiş senaryoya otomatik ilerler; Kaldı durumunda testçilerin ayrıntıları dikte edip bir hata oluşturabilmesi için yerinde kalır. Chrome, Edge ve Safari'de çalışır.

Senaryolar ve Klasörler

list_test_cases — İsteğe bağlı search, priority (critical, high, medium, low), type (functional, regression, smoke, integration, performance, security, usability, exploratory), status (active, draft, deprecated) ve sort (newest, oldest, name, priority) ile test senaryolarını listele.
create_test_case — Bir test senaryosu oluştur. İki şablon çeşidi: steps (varsayılan) — steps dizisi aracılığıyla adım başına { action, expected } ızgarası; text — text_content aracılığıyla tek serbest biçimli açıklama. Her iki alan da aynı çağrıda gönderilebilir (platform bunları bağımsız olarak depolar, böylece daha sonra template_type değiştiren bir testçi her iki tarafın verisini de kaybetmez). İsteğe bağlı urls dizisi (en fazla 10 http/https URL'si) referans bağlantıları ekler. name gerektirir. İsteğe bağlı: description, preconditions, template_type, steps, text_content, urls, priority, type, tags, estimated_time (saniye). Dosya ekleri, kontrol panelinin POST /api/test-cases/:id/attachments uç noktası (çok parçalı) üzerinden yüklenir — henüz bir MCP aracı olarak sunulmamıştır.
get_test_case — Adımlar ve yürütme geçmişi dahil olmak üzere tam test senaryosu ayrıntılarını al.
list_test_case_folders — Ekibin klasörlerini listele (folder_id aracılığıyla senaryo başına bir klasör; çoktan çoğa test planı gruplamaları olan suitlerden farklıdır). 500 ile sınırlıdır; project_id ve parent_folder_id filtrelerini dikkate alır (yalnızca en üst seviye için "root" kullanın).
create_test_case_folder — Bir klasör oluştur (parent_folder_id aracılığıyla 3 seviyeye kadar iç içe). Senaryoları içine taşımak için bulk_update_test_cases kullanın.
bulk_update_test_cases — Aynı anda 500'e kadar senaryoya tek bir eylem uygula: set_priority, set_status, set_type, add_tags, remove_tags, add_to_suite, pin, unpin.
link_test_case_to_bug — Bir test senaryosu ile bir hata raporu arasında izlenebilirlik kur (verified_by, covers veya relates).
list_test_case_links — Bir test senaryosu için tüm izlenebilirlik bağlantılarını listele.
list_test_case_review_candidates — Ölü test bayrakları: never_run (oluşturulduktan sonra 90+ gün), always_passes (90 gün içinde 5+ ardışık başarılı), always_skipped (3+ ardışık atlama).
mark_test_case_review_flags — Mevcut arşiv adayı bayraklarını test_cases.review_flag üzerinde kalıcı hale getir. pg_cron aracılığıyla her Pazartesi 09:00 UTC'de otomatik çalışır.

İçe Aktarmalar

Figma içe aktarma (kontrol paneli UI + REST): Figma çerçevelerinin bir zip dışa aktarımını yükleyin (100 MB'a kadar), Claude her ekranı analiz eder ve seçtiğiniz veya oluşturduğunuz bir klasöre test senaryoları taslağı hazırlar. Çok geçişli işlem hattı (sınıflandır → ekran başına senaryolar → ortak ön ekli ekranlar arasında akış seviyesinde senaryolar → öz eleştiri) ile istem önbellekleme, 429 yeniden deneme ve çerçeve başına hata izolasyonu sayesinde bir hatalı çerçeve toplu işlemi başarısız kılmaz. Senaryolar status=active olarak gelir, ai_generated=true ile etiketlenir, source='figma' ve source_frame_name orijinal çerçeveye bir bağlantı korur. Platform Anthropic anahtarını kullanır — ekip başına Claude bağlantısı gerekmez. Uç noktalar: POST /api/test-cases/import/figma/request, POST /api/test-cases/import/figma/start, GET /api/test-cases/import/figma/:id.

Suitler ve Çalıştırmalar

list_test_suites — Test suitlerini senaryo sayısı ve son çalıştırma durumuyla listele.
create_test_suite — Bir suit oluştur. parent_suite_id aracılığıyla 3 seviyeye kadar iç içe.
list_test_runs — Test çalıştırmalarını suit adı, atanan kişi ve başarılı/başarısız özetiyle listele.
create_test_run — Bir suiti yeni bir çalıştırmaya anlık görüntüle. Bir üst suiti çalıştırmak, her alt suit'teki her senaryoyu otomatik olarak içerir (her ikisine de bağlı bir senaryo tam olarak bir kez eklenir). Her test_run_results satırı, senaryonun hangi kaynak alt suitten geldiğini kaydeder, böylece sonuç sayfaları kaynağa göre gruplandırabilir.

Raporlar (Kademe 1 + Kademe 4 analitik)

get_test_reports_overview — Bir zaman aralığı için başlık KPI'ları (başarı oranı, tamamlanan çalıştırmalar, yürütülen senaryolar) ve önceki eşdeğer aralığa göre farklar. Raporlar sekmesindeki KPI şeridinin gösterdiği sayıların aynısı.
get_test_reports_failures — Dört "ne düzeltilmeli?" listesi: failing_cases (≥%50 başarısız, en az 3 çalıştırma), flaky_cases (en çok başarılı/başarısız dalgalanması), failing_suites (≥%30 başarısız, en az 5 çalıştırma), regressed_cases (aralıkta daha önce başarılı olup en son başarısız olan).

create_test_case_folder → bir klasör ağacı oluştur (örn. Smoke → Auth)
create_test_case → senaryoları tanımla; bulk_update_test_cases ile klasörlere taşı
create_test_suite → bir test planı oluştur (alt suitler isteğe bağlı, 3 seviyeye kadar derinlik)
create_test_run → bir üst suitten çalıştırma anlık görüntüsü al — alt suitler otomatik dahil edilir
get_test_reports_failures → çalıştırma tamamlandığında "bu hafta ne düzeltilmeli?" diye sor
get_test_reports_overview → haftalık başarı oranı trendini takip et

⚡

Ekip Güçlendirici

scale_team — Güçlendirici testçilerle QA ekibinizi anında ölçeklendirin. Hesaplar testçi erişimiyle otomatik olarak sağlanır. team_size (1–10), location, duration, budget ve isteğe bağlı olarak product_url, product_types ve tech_levels belirtin. Ekip planında kullanılabilir. Onay verilene kadar ücretlendirilmezsiniz.

scale_team → ABD'de 1 aylığına 5 kıdemli testçi sağla
list_team_members → yeni testçilerin ekibinizde göründüğünü doğrula
list_reports → güçlendirici testçiler tarafından dosyalanan raporları incele

📱

Mobil Test

upload_mobile_app — Gerçek cihazlarda test için bir APK (Android) veya IPA (iOS) uygulaması yükleyin. name, platform (android/ios) ve file_url gerektirir. iOS için: gerçek cihaz çalıştırmaları için IPA'yı yükleyin, ardından kaydı etkinleştirmek için uygulama detay sayfasına bir simülatör .app derlemesi yükleyin.
update_mobile_app — Bir uygulama ikilisini yeni bir sürümle değiştirin. Önbelleğe alınmış URL'leri ve simülatör derlemelerini temizler, böylece tüm otomasyonlar bir sonraki çalıştırmada yeni sürümü kullanır. app_id ve file_url gerektirir. İsteğe bağlı: version.
create_mobile_automation — Bir test betiği oluşturun. name, app_id, script_type (YAML için maestro, Appium Python için appium, Appium JavaScript için appium_js) ve script (test betiği içeriği) gerektirir.
list_mobile_runs — Mobil test çalıştırmalarının sonuçlarını alın (durum, cihaz, video, BrowserStack oturumu ve otomatik oluşturulan hatalar). Mobil çalıştırmalar kontrol panelinden veya bir zamanlamayla tetiklenir. İsteğe bağlı filtreler: automation_id, status (queued, running, passed, failed, error, archived), limit. Arşivlenmiş çalıştırmalar varsayılan listelemeye dahil edilmez.

Örnek İş Akışı — Android

upload_mobile_app → APK'nızı yükleyin
Tarayıcıda test kaydedin → eylemler otomatik yakalanır
Kontrol panelinden veya bir zamanlamayla gerçek bir cihazda (örn. Google Pixel 8) çalıştırmayı tetikleyin
list_mobile_runs → video ve günlüklerle sonuçları kontrol edin
Başarısızlıklar, hata anlık görüntüsü ve adım dökümü ile otomatik hata raporları oluşturur

Örnek İş Akışı — iOS

upload_mobile_app → IPA'nızı yükleyin (gerçek cihaz çalıştırmaları için)
Kayıt için uygulama detay sayfasına simülatör .app derlemesi yükleyin
Tarayıcıda test kaydedin → eylemler simülatörden yakalanır
Kontrol panelinden veya bir zamanlamayla gerçek bir cihazda (örn. iPhone 15 Pro, IPA'yı kullanır) çalıştırmayı tetikleyin
update_mobile_app → hazır olduğunda IPA'yı yeni sürümle değiştirin

✅

Uyumluluk ve Kanıt (Kurumsal)

collect_compliance_evidence — Bağlı hizmetlerden (Cloudflare, GitHub, Sentry, Supabase, Railway) otomatik kanıt toplamayı tetikleyin. Çalıştırma kimliği döndürür. SSL/TLS ayarlarını, WAF durumunu, Dependabot uyarılarını, hata trendlerini, dağıtım geçmişini ve daha fazlasını toplar.
check_config_drift — Tüm bağlı hizmetleri, temel yapılandırmalardan güvenlik yapılandırması sapmalarına karşı kontrol edin (SSL modu, TLS sürümü, HSTS, WAF kuralları, güvenlik başlıkları).
generate_access_review — Üç aylık erişim inceleme raporu oluşturun. Ekip üyelerini, rolleri, MFA durumunu, API anahtarı kullanımını denetler ve öneriler oluşturur (örn. etkin olmayan anahtarları iptal et).
get_security_events — Hizmetler arası güvenlik olayı zaman çizelgesini sorgulayın. Kaynağa (cloudflare, sentry, github) ve önem derecesine (kritik, yüksek, orta, düşük, bilgi) göre filtreleyin. Olaylar hizmetler arasında otomatik olarak ilişkilendirilir.

Uyumluluk Kapsamı

Bu araçlar 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) ve GDPR (Mad. 5, 25, 32, 33) uyumluluk gereksinimlerine yardımcı olur.

Uyumlu İstemciler

bug_Agent_, Model Bağlam Protokolü'nü destekleyen tüm istemcilerle çalışır. Popüler istemciler için kurulum kılavuzları:

🤖

Claude Desktop

Ayarlar → Geliştirici → Yapılandırmayı Düzenle'yi açın, ardından ekleyin:

claude_desktop_config.json

Kaydettikten sonra Claude Desktop'ı yeniden başlatın.

✳️

Cursor

Ayarlar → MCP Sunucuları → Sunucu Ekle'yi açın veya proje kökünüzdeki .cursor/mcp.json dosyasını düzenleyin:

.cursor/mcp.json

🌊

Windsurf

Ayarlar → MCP → Sunucu Ekle'yi açın veya MCP yapılandırma dosyanızı düzenleyin:

mcp_config.json

💻

Claude Code (CLI)

bug_Agent_'ı doğrudan terminalden ekleyin:

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

Başlatmadan önce API anahtarınızı export BUGAGENT_API_KEY=ba_live_... ile ayarlayın.

🔧

Diğer MCP İstemcileri

MCP stdio aktarımını destekleyen tüm istemciler bug_Agent_ ile çalışır. Standart yapılandırmayı kullanın:

Komut: npx
Argümanlar: ["-y", "@bugagent/mcp-server"]
Ortam: BUGAGENT_API_KEY

CLI

CLI ile Başlarken

bug_Agent_ CLI, terminalinizden hata raporları, özellik istekleri, projeler ve entegrasyonlar üzerinde tam kontrol sağlar. Şunlar için kullanın:

İş akışlarını otomatikleştirin — Hata raporlamayı CI/CD işlem hatlarına, betiklere ve cron işlerine entegre edin
Toplu işlemler — Terminalinizden ayrılmadan raporları listeleyin, filtreleyin ve yönetin
Pipe dostu çıktı — jq, yq ve diğer araçlarla birleştirmek için JSON, YAML ve ham formatlar
Hızlı yineleme — Tarayıcıya gerek yok — saniyeler içinde rapor oluşturun ve güncelleyin

Kurulum

npm install -g @bugagent/cli

Kurulumu doğrulayın:

bugagent --version

Kimlik Doğrulama

API anahtarınızı bir ortam değişkeni olarak ayarlayın:

Veya doğrudan --api-key bayrağıyla iletin:

bugagent reports list --api-key ba_live_your_key_here

🔑

API anahtarınızı bug_Agent_ konsolundan alın. Anahtarlar ba_live_ ile başlar.

Kalıcı kimlik doğrulama için, dışa aktarma komutunu shell profilinize ekleyin (~/.bashrc, ~/.zshrc, vb.).

Kullanım

Komutlar şu kalıbı izler:

bugagent <resource> <action> [flags]

Kaynaklar, alt kaynaklar için iki nokta üst üste sözdizimini de kullanabilir:

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

Herhangi bir komutta ayrıntılar için --help kullanın:

bugagent reports --help
bugagent reports create --help

Örnek Oturum

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

CLI Özellikleri

CLI şu işlemler için komutlar sağlar:

reports Hata raporları oluşturma, listeleme, getirme, güncelleme ve temizleme

projects Proje oluşturma, listeleme, güncelleme ve silme

keys API anahtarları oluşturma, listeleme, yeniden oluşturma ve iptal etme

jira Jira ayarlarını bağlama, raporları senkronize etme ve yapılandırma

usage Plan limitlerine göre mevcut kullanımı kontrol etme

stats Analitikleri ve dökümleri görüntüleme

profile Profilinizi ve ayarlarınızı görüntüleme ve güncelleme

auth Giriş yapma, kaydolma ve kimlik bilgilerini yönetme

Genel Bayraklar

Bayrak Açıklama

--api-key <key> Bu komut için API anahtarını geçersiz kılma

--format <fmt> Çıktı formatı: json, yaml, pretty, raw

--debug Sorun giderme için istek/yanıt ayrıntılarını gösterme

--help Herhangi bir komut için yardım gösterme

--version CLI sürümünü yazdırma

Çıktı Formatları

CLI, farklı kullanım durumları için birden çok çıktı formatını destekler:

`json`

Makine tarafından okunabilir JSON. jq veya diğer araçlara yönlendirme için idealdir.

`yaml`

Yapılandırma dosyaları ve okunabilirlik için insan dostu YAML çıktısı.

`pretty`

Varsayılan. Terminal için tasarlanmış, renklendirilmiş, biçimlendirilmiş çıktı.

`raw`

Biçimlendirilmemiş çıktı. Betikleme ve otomasyon için kullanışlıdır.

--transform ile Filtreleme

Çıktı verilerini sorgulamak ve filtrelemek için --transform ile GJSON sözdizimini kullanın:

# 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 Yeteneği

CLI ayrıca bir AgentSkill olarak da mevcuttur ve AI kodlama asistanlarının sizin adınıza bug_Agent_ kullanmasına olanak tanır.

✨

AgentSkill Nedir?

AgentSkill'ler, AI kodlama asistanlarının (Claude Code, Cursor, vb.) CLI araçlarını bağlamsal olarak çağırmasına izin verir. bug_Agent_ yeteneği, AI asistanınıza siz bir komut yazmadan hata bildirme, proje durumunu kontrol etme ve Jira'ya senkronize etme yeteneği verir.

Yeteneği Kurun

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

Kurulduktan sonra, bağlam farkında AI Asistanı, ürününüz, test yönergeleriniz ve yüklenen belgeleriniz hakkında tam bilgiyle bug_Agent_ komutlarını doğal olarak kullanabilir:

AI Asistan İstemi

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

Yetkinlik, doğal dili uygun CLI komutlarına çevirir ve bunları yürütür.

🎬

Oturum Tekrarı + AI Asistan: Oturum Tekrarı etkinleştirildiğinde (Team planı), AI Asistanı, tam yeniden oluşturma bağlamıyla daha zengin, daha doğru hata raporlarını otomatik olarak taslak haline getirmek için yakalanan kullanıcı oturumuna (son 60 saniyedeki tıklamalar, gezinme, hatalar ve ağ arızaları) başvurabilir.

Yardım Alın

Yardıma mı ihtiyacınız var? Size yardımcı olmak için buradayız.

Discord Topluluğu

Gerçek zamanlı destek ve topluluk tartışmaları için Discord'umuza katılın.

E-posta Desteği

[email protected] — Genellikle 24 saat içinde yanıt veririz.