bugAgent

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 support@bugagent.com

Başlangıç

bug_Agent_ MCP sunucusu, yapay zeka istemcilerinin Model Context Protocol aracılığıyla hata raporları, özellik istekleri, geliş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.

1

API anahtarınızı alın

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

2

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

3

Hata bildirmeye başlayın

Bir hatayı doğal dilde tanımlayın, bug_Agent_ otomatik olarak sınıflandırsın, zenginleştirsin ve saklasın.

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, Akışkan 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.

Kopyalamaya hazır küçük bir yapılandırma, kapsamlı anahtar rehberliği ve güvenli başlangıç istemleri için genel MCP hızlı başlangıcını kullanın.

🔑

Önce API anahtarınızı alın. Ayarlar → Geliştiriciler'e giriş yapın, API Anahtarı Oluştur'a tıklayın ve değeri kopyalayın (ba_live_ ile başlar). Sadece 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:

1. Aktarım Türü: Streamable HTTP seçin
2. URL: https://mcp.bugagent.com/mcp
3. 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)
4. 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
5. Bağlan'a tıklayın. Sol panelde 110'dan fazla bug_Agent_ aracını göreceksiniz.
6. 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österilir.

Ö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

1. 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.
2. 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"  
      }  
    }  
  }  
}  

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

Windows

1. 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).
2. macOS bölümünde gösterilen aynı JSON bloğunu ekleyin.
3. Dosyayı kaydedin ve Claude Desktop'ı sistem tepsisinden tamamen kapatın (Claude simgesine sağ tıklayın → Çık), ardından yeniden başlatın.
4. 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ı editörden ayrılmadan hata bildirebilir, raporları listeleyebilir, taramalar çalıştırabilir vb.

1. Cursor'ı açın → Ayarlar (Mac'te Cmd+, / Windows'ta Ctrl+,) → sol kenar çubuğunda MCP.
2. + Yeni MCP sunucusu ekle'ye tıklayın.
3. HTTP aktarım türünü seçin.
4. 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
5. Kaydet'e tıklayın. Cursor bağlandığında yeşil bir gösterge gösterir.
6. Cursor'ın sohbetini açın (Cmd+L / Ctrl+L) ve “'Giriş bozuk' başlıklı, yüksek önem dereceli bir hata raporu oluştur” yazın. Cursor create_bug_report ç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 aynı JSON formatını ekleyin.

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

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

1. VS Code pazar yerinden Continue eklentisini yükleyin.
2. 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
3. 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"  
        }  
      }  
    }  
  ]  
}  

4. Kaydedin. Continue otomatik olarak yeniden yüklenecek ve kenar çubuğunda bug_Agent_ araçlarını gösterecektir.
5. 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 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ı 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 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.

1. bug_Agent_'de: 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.
2. 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 özellikle: claude.ai/customize/connectors adresine gidin ve MCP bağlayıcı ekle'ye tıklayın.
3. 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.
4. 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ü, Akışkan 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 Akışkan 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 → Geliştiriciler'de iptal edilmediğini kontrol edin. Anahtarlar ba_live_ ile başlar. Hala takılırsanız, anahtarı yeniden oluşturun ve tekrar deneyin.

Deneyin — Düz İngilizce İstemler

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

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
Use Hermes to execute the curated "Checkout smoke" suite and report every result to bugAgent
Show failing test cases from the last 7 days
Which test cases have never been run in the past 90 days?
Get a pass-rate trend for this month vs last month

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şif Amaçlı 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, Akışkan 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 → Geliştiriciler'i 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 kapatmayın). Cursor'da, Ayarlar → MCP'de yeşil bir nokta olup olmadığını kontrol edin.

Accept header required Doğrudan HTTP çağrıları Accept: application/json, text/event-stream içermelidir — Akışkan HTTP spesifikasyonu 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. Ayarlar → Geliştiriciler'de sorgulamak istediğiniz çalışma alanından 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 seçin (Doğrudan değil). 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 olup olmadığını 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 otomatik sınıflandırma ile yeni bir rapor oluşturun — hatalar, özellik istekleri, geliştirmeler, teknik borç ve daha fazlası (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 olarak 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, sayfalandırmadan önce sunucu tarafında uygulanır. project (UUID, slug, 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 (uçları açık 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 kademe), 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 bırakı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 kimliği kabul eder (WRKID-545). Güncellenebilir alanlar arasında title, description, type (19 gösterge paneli kategorisinden herhangi biri), severity, priority (urgent / high / normal / low — önem derecesinden bağımsız düzeltme aciliyeti), 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 (uçları açık kebab-case etiketi — yaygın değerler: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch) bulunur. 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, analitikler 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ştirmek, uygulama içi zil bildirimini VE yeni atanan kişiye bir nezaket e-postasını otomatik olarak tetikler (Hesap Ayarları'ndaki kullanıcı başına devre dışı bırakma tercihlerine saygı gösterir — 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 sorununa iletilir.
• list_comments — Bir raporun tüm yorum dizisini en eskiden başlayarak 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 kimliği 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, duplicate-of, parent-of, related-to, depends-on veya testing-blocked-by değerlerinden biridir. Ters perspektifler (duplicated-by / subtask-of / blocks / blocks-testing) 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 — örneğin, 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; bu raporun hedef olduğu testing-blocked-by blocks-testing 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 sınıflandırın (hatalar, özellikler, geliştirmeler vb.)
• flush_reports — Eski raporları toplu olarak silin (yalnızca yönetici)

📊

Kullanım ve Analitikler

• get_usage — Plan limitlerine göre kullanımı kontrol edin
• get_stats — Günlük sayılar, tür/önem/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 (slug 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 destekleyici 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 süresi dolan bağlantı

🎯

Entegrasyonlar

• sync_to_jira — Ekibin paylaşılan bağlantısını kullanarak bir raporu Jira ile 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 kimliği 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ı ile nihai notları yazan Claude Opus hakem). Yanıt her turu açığa çıkarır: analysis, draft, critique, rebuttal, challenger_model, adjudicator_model ve bir debated bayrağı. Başarısız olan herhangi bir adım bir sonraki en iyi cevaba düşer. 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 "Muhtemel 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 adlandıran dar bir Sonnet çıktısı. UUID veya kısa kimliği kabul eder. Platform Anthropic anahtarını kullanır. Ekibin bir github_connections satırı olduğunda ve projenin bir github_repo eşlemesi yapıldığında, çı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 yalnızca manuel yeniden oluşturma için bunu çağırması gerekir.
• upgrade_plan — Team veya Enterprise için satış destekli kayıt bağlantısını alın

⚡

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), Core Web Vitals (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ışı

1. get_performance_usage → kalan kotayı kontrol edin
2. create_performance_test → URL'niz için bir test yapılandırın
3. run_performance_test → denetim + yük testini tetikleyin
4. get_performance_results → skorları ve vitalleri 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 Quick Scanner + 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ştirilir
• 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

1. get_security_usage → kalan kotayı kontrol edin
2. create_security_scan → URL'niz veya deponuz için bir tarama yapılandırın
3. run_security_scan → tek seferlik bir güvenlik açığı taraması tetikleyin
4. create_security_schedule → yinelenen çalıştırmaları otomatikleştirin (örn. ana dalda haftalık SAST)
5. 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 bulgularıyla 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

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

🔍

Keşifsel AI

Her biri farklı bir test stratejisi kullanan, 10'a kadar paralel ajana sahip ç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)

1. create_exploration ile agent_count: 5 → 5 paralel ajan yapılandırın
2. Panodan veya POST /api/explorations/run aracılığıyla bir çalıştırma tetikleyin
3. get_exploration_run → ajan başına ilerleme ve bulguları sorgulayın
4. 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. Mevcut ekleri değiştirmeden nota 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.

1. create_note → bir test oturumu notu başlatın
2. update_note → test ederken gözlemleri ekleyin
3. list_notes → anahtar kelime veya projeye göre geçmiş notları arayın
4. 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 eski önce, 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. Kendi kendini iyileştiren konumlandırıcılar (otomatik): bir konumlandırıcı eylemi zaman aşımına uğradığında, çalıştırıcı Claude'dan çalışan bir seçici ister ve adımı bir kez yeniden dener — doğrulamalar asla iyileştirilmez, böylece gerçek gerilemeler yine de başarısız olur — ve her iyileştirme çalıştırma stdout'unda günlüğe kaydedilir. 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 — pytest-playwright'ın browser_type.connect() BrowserStack'in gerçek mobil uç noktalarını yönetemediği için Python ile gerçek mobil desteklenmez. 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, başarısızlıkta_bildir (e-posta/slack/her ikisi) ve Slack kanalı seçeneklerini destekler. Zamanlanmış çalıştırmalarda BrowserStack Live: 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, doğrulamaları, 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.

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

⏱️

Zaman Takibi

• list_time_entries — Ekip için zaman girişlerini listeler. period (today, week, month, all), project_id, category ve sort (newest, oldest, most_time, least_time) ile filtreleyin. Yalnızca ekip planı.
• create_time_entry — QA görevlerinde harcanan zamanı kaydeder. 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ünceller. 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 siler. id gerektirir. Yalnızca ekip planı.

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

☑️

Test Durumları

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 ve KPI trendleri, hata analizi, suit sağlığı, kapsam ve test uzmanı üretkenliğini içeren bir analitik Raporlar sekmesi ile test yönetimi. Tüm araçlar doğrudan Supabase'i çağırır — HTTP gidiş-dönüşü yok, pano ile aynı gecikme süresi.

Ücretsiz limitler: 10 depolanmış test durumu, 1 suit, 3 klasör, durum başına 128 KB yapılandırılmış içerik, 2 aktif çalışma alanı API anahtarı ve UTC takvim ayı başına 10 toplam test çalıştırması. Bu çalıştırmaların en fazla 3'ü Hermes veya başka bir harici ajan kullanabilir, 1 aktif harici çalıştırma ve her harici planda en fazla 10 durum ile. Ücretsiz API anahtarı MCP trafiği, anahtar başına dakikada 30 ve çalışma alanı başına dakikada 60 istekle sınırlıdır. Ekip ve Kurumsal test durumu depolama ve çalıştırmalar, genel platform korumalarına tabi olarak sınırsızdır.

Yapay zeka test durumu oluşturma, yapay zeka etiket önerileri, Figma içe aktarma ve test durumu dosya ekleri Ekip veya Kurumsal gerektirir. Ücretsiz 128 KB yapılandırılmış içerik sınırı, ücretli dosya eklerinden ayrıdır. Ücretsiz, URL referanslarını depolayabilir. Temel MCP test durumu araçları, yukarıdaki limitler dahilinde Ücretsiz'de kullanılabilir durumda kalır.

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

Durumlar 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 durumlarını listeler.
• create_test_case — Bir test durumu oluşturur. İ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 bir test uzmanı daha sonra template_type değiştirdiğinde her iki tarafın verisi de kaybolmaz). İsteğe bağlı urls dizisi (en fazla 10 http/https URL'si) referans bağlantıları ekler ve Ücretsiz'de kullanılabilir. name gerektirir. İsteğe bağlı: description, preconditions, template_type, steps, text_content, urls, priority, type, tags, estimated_time (saniye). Dosya ekleri Ekip veya Kurumsal gerektirir ve pano POST /api/test-cases/:id/attachments uç noktası (çok parçalı) aracılığıyla 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 durumu ayrıntılarını getirir.
• list_test_case_folders — Ekibin klasörlerini listeler (folder_id aracılığıyla durum başına bir klasör; çoktan çoğa test planı gruplandırmaları 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şturur (parent_folder_id aracılığıyla 3 seviyeye kadar iç içe). Durumları içine taşımak için bulk_update_test_cases kullanın.
• bulk_update_test_cases — Aynı anda en fazla 500 duruma bir eylem uygular: set_priority, set_status, set_type, add_tags, remove_tags, add_to_suite, pin, unpin.
• link_test_case_to_bug — Bir test durumu ile bir hata raporu arasında izlenebilirlik kurar (verified_by, covers veya relates).
• list_test_case_links — Bir test durumu için tüm izlenebilirlik bağlantılarını listeler.
• 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 geçti), always_skipped (3+ ardışık atlandı).
• mark_test_case_review_flags — Mevcut arşiv adayı bayraklarını test_cases.review_flag üzerinde kalıcı hale getirir. pg_cron aracılığıyla her Pazartesi 09:00 UTC'de otomatik olarak çalışır.

İçe Aktarmalar

• Figma içe aktarma (Ekip/Kurumsal) (pano kullanıcı arayüzü + 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 durumları taslağı hazırlar. İstem önbellekleme, 429 yeniden deneme ve çerçeve başına hata izolasyonu ile çok geçişli işlem hattı (sınıflandır → ekran başına durumlar → paylaşılan ön ekli ekranlar arasında akış seviyesinde durumlar → öz eleştiri), böylece bir hatalı çerçeve toplu işlemi başarısız kılmaz. Durumlar 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 — Proje kimliği, durum sayısı ve son çalıştırma durumu ile test suitlerini listeler. API anahtarı çağrıcıları test_runs:read gerektirir.
• create_test_suite — Bir suit oluşturur. parent_suite_id aracılığıyla 3 seviyeye kadar iç içe.
• list_test_runs — Suit adı, atanan kişi ve geçti/kaldı özeti ile test çalıştırmalarını listeler.
• create_test_run — Pano tarafından yönetilen bir suit çalıştırması oluşturur. Bir üst suit çalıştırmak, her alt suit'teki her durumu otomatik olarak içerir (her ikisine de bağlı bir durum tam olarak bir kez eklenir). Her test_run_results satırı, durumun hangi kaynak alt suitten geldiğini kaydeder, böylece sonuç sayfaları kökene göre gruplandırabilir.

Harici Ajan Yürütme

Bu araçlar, Hermes'in veya başka bir ajan çalışma zamanının, QA kayıt sistemi haline gelmeden onaylanmış bir suiti yürütmesine izin verir. Yalnızca test_runs:read ve test_runs:write içeren çalışma alanı kapsamlı bir anahtar kullanın. Suit proje sınırını sağlar; çağrıcılar bunu geçersiz kılamaz.

• start_test_plan — Sabit bir external_run_id ile değişmez bir suit anlık görüntüsü başlatır veya sürdürür. Tekrarlanan bir kimlik, yinelenen oluşturmak yerine mevcut eşleşen çalıştırmayı ve ilk sayfayı döndürür.
• get_test_run_plan — Kanonik çalıştırma durumunu ve sabit bir plan sayfasını okur. Önceki next_cursor iletin; sayfalar varsayılan olarak 100 durumdur ve 200 ile sınırlıdır.
• report_test_results — passed, failed, blocked veya skipped durumu ile 1–200 sonuç gönderin. Tam yeniden denemeler güvenlidir; bir durumu başka bir durumla üzerine yazmaya çalışmak reddedilir.
• abort_test_run — Kabul edilmiş kısmi sonuçları ve kanonik özeti korurken kesintiye uğramış bir çalıştırmayı idempotent olarak durdurur.

Kota davranışı: başka bir çalıştırma harcamadan eşleşen çalıştırmayı sürdürmek için aynı external_run_id ile start_test_plan yeniden deneyin. Verileri silmek aylık çalıştırma kullanımını sıfırlamaz.

Çalışma zamanı sınırı: durum anlık görüntüleri kimlik bilgilerini, dosya gövdelerini ve özel ek yollarını hariç tutar. Sonuç kanıtı MVP'de metindir. Hedef kimlik bilgileri yürütme çalışma zamanında kalır. Tarayıcı, model ve ağ maliyetleri müşteri tarafında kalır ve müşteriler hedef erişimini ve ağ çıkışını kısıtlamalıdır. Hata ve sürüm kararlarından bir insan sorumlu kalır.

Hermes Ajan kılavuzu, bu döngüyü bugAgent tarafından sağlanan bir topluluk becerisi olarak paketler. Genel başlangıç kiti, kopyalamaya hazır bir yapılandırma ve yüklenebilir beceri içerir. Resmi bir Nous Research entegrasyonu değildir.

Raporlar (Kademe 1 + Kademe 4 analitiği)

• get_test_reports_overview — Bir pencere için başlık KPI'ları (geçme oranı, tamamlanan çalıştırmalar, yürütülen durumlar) ve önceki eşdeğer pencereye göre deltalar. Raporlar sekmesi 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 geçti/kaldı değişimi), failing_suites (≥%30 başarısız, en az 5 çalıştırma), regressed_cases (pencerede daha önce geçmiş olan en son başarısız).

1. create_test_case_folder → bir klasör ağacı oluştur (örn. Smoke → Auth)
2. create_test_case → durumları tanımla; bulk_update_test_cases ile klasörlere taşı
3. create_test_suite → bir test planı oluştur (alt suitler isteğe bağlı, 3 seviyeye kadar derinlik)
4. create_test_run → bir üst suitten insan/pano tarafından yönetilen bir çalıştırma oluştur — alt suitler otomatik dahil edilir
5. start_test_plan → yeniden deneme güvenli harici ajan çalıştırması başlat veya sürdür
6. get_test_run_plan → her değişmez plan sayfasını al, ardından seçilen çalışma zamanında yürüt
7. report_test_results → sınırlı sonuç gruplarını döndür; yürütme güvenli şekilde devam edemezse abort_test_run çağır
8. get_test_reports_failures → çalıştırma tamamlandığında "bu hafta ne düzeltilmeli?" diye sor
9. get_test_reports_overview → haftalık geçme oranı trendini izle

⚡

Ekip Güçlendirici

• scale_team — Güçlendirici test uzmanlarıyla QA ekibinizi anında ölçeklendirin. Hesaplar test uzmanı 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.

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

📱

Mobil Test (Kurumsal)

Mobil kaynaklar proje kapsamlıdır. Oluşturma, içe aktarma ve filtrelenmiş listelerde project_id veya esnek bir project seçici iletin. Otomasyonlar bağlı uygulamanın projesini devralır; aksi takdirde sunucu çalışma alanı varsayılan projesini kullanır. Filtrelenmemiş listeler, taşınana kadar eski çalışma alanı seviyesindeki satırları içermeye devam edebilir.

• list_mobile_apps — İsteğe bağlı project_id/project, platform ve limit filtreleriyle yüklenen uygulamaları listeler. Aracıların sonraki işlemleri aynı projede tutabilmesi için her uygulamanın project_id bilgisini döndürür.
• upload_mobile_app — Gerçek cihazlarda test etmek için bir APK (Android) veya IPA (iOS) uygulaması kaydeder. name, platform (android/ios) ve file_url gerektirir; aktif projeye atamak için project_id iletin. iOS için, gerçek cihaz çalıştırmaları için IPA'yı yükleyin, ardından kayıt için bir simülatör .app derlemesi yüklemek üzere kontrol panelini kullanın.
• update_mobile_app — Bir uygulama ikili dosyasını yeni bir sürümle değiştirir. Ö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.
• list_mobile_automations — İsteğe bağlı project_id/project, app_id, status ve limit filtreleriyle mobil otomasyonları listeler. Sonuçlar project_id ve bağlı uygulama kimliğini içerir.
• create_mobile_automation — Bir test betiği oluşturur. name, app_id, script_type (YAML için maestro, Appium Python için appium, Appium JavaScript için appium_js) ve script gerektirir; uygulama henüz proje kapsamında değilse project_id iletin.
• import_mobile_script — Mevcut bir mobil test betiğini içe aktarır ve çalıştırılabilir bir otomasyona dönüştürür; geliştiricinin kendi konumlandırıcılarını korur, böylece çalıştırmalar öğeleri hassas bir şekilde çözümler. Desteklenen lehçeler: Appium‑Python, WebdriverIO, Maestro (YAML akışları) ve Playwright (mobil‑web). Yalnızca Android uygulamaları. name, app_id ve script gerektirir; isteğe bağlı target_devices ve project_id. Otomasyonun yanı sıra action_count, algılanan dialect ve seçici eşleme warnings döndürür.
• run_mobile_automation — Gerçek bir cihazda mobil otomasyon başlatır. automation_id gerektirir; isteğe bağlı device, os_version ve credential_id. Çalıştırma başına kimlik bilgisi, otomasyonun varsayılan oturum açma profilini geçersiz kılar ve aynı projeye ait olmalıdır.
• list_mobile_runs — Mobil çalıştırma sonuçlarını alır (durum, cihaz, video, BrowserStack oturumu ve otomatik oluşturulan hatalar). İsteğe bağlı filtreler: project_id, automation_id, status (queued, running, passed, failed, error, archived) ve limit. Arşivlenmiş çalıştırmalar varsayılan olarak hariç tutulur.
• create_mobile_credential — Bir proje için adlandırılmış oturum açma profili (örn. "Admin", "Katkıda Bulunan") oluşturur: mobil otomasyonlar tarafından kullanılan bir kullanıcı adı + şifre. Her iki değer de AES‑256‑GCM ile şifrelenmiş olarak saklanır ve salt yazılır — hiçbir araç veya API bunları asla döndürmez ve diğer üyeler / kullanıcı arayüzü yalnızca adı görür. Yeniden kayıt yapmadan farklı rollerle oturum açmak için çalıştırma başına bir profil seçin. project_id, name, username, password gerektirir. Yalnızca Kurumsal.
• list_mobile_credentials — Oturum açma profillerini listeler (isteğe bağlı olarak bir project_id). Yalnızca gizli olmayan alanları (id, name, proje, oluşturan, oluşturulma tarihi) döndürür — asla kullanıcı adı veya şifreyi değil. Bir otomasyon çalıştırırken kimlik bilgisi seçimi olarak döndürülen id kullanın.
• update_mobile_credential — Bir oturum açma profilini yeniden adlandırır veya id ile kullanıcı adını/şifresini değiştirir. Yalnızca değiştirilecek alanları dahil edin. Yeni gizli değerler hemen şifrelenir ve asla döndürülmez.
• delete_mobile_credential — id ile bir oturum açma profilini geçici olarak siler. Denetim ve çalıştırma geçmişi için saklanır ancak artık kullanılamaz veya listelenmez; adı yeniden kullanım için serbest bırakır.
• list_mobile_schedules, create_mobile_schedule, delete_mobile_schedule — Gerçek cihaz zamanlamalarını listeler, oluşturur ve kaldırır. Zamanlamalar, seçilen otomasyonları aracılığıyla proje bağlamını devralır.

Örnek İş Akışı — Android

1. list_projects → hedef project_id çözümle
2. upload_mobile_app → APK'yı o projeye kaydet
3. Kontrol panelinde güvenli bir şekilde kaydedin veya import_mobile_script / create_mobile_automation kullanın
4. list_mobile_automations → aynı projedeki otomasyonu çözümle
5. run_mobile_automation → gerçek bir cihazda, isteğe bağlı olarak bir oturum açma profiliyle tetikle
6. list_mobile_runs → video ve günlüklerle sonuçları kontrol et
7. Başarısızlıklar, hata anlık görüntüsü ve adım dökümü ile otomatik olarak hata raporları oluşturur

Örnek İş Akışı — iOS

1. upload_mobile_app → gerçek cihaz çalıştırmaları için IPA'nızı project_id ile kaydedin
2. Uygulama detay sayfasına simülatör .app derlemesi yükleyin (kayıt için)
3. Tarayıcıda test kaydedin → eylemler simülatörden yakalanır
4. run_mobile_automation → kaydedilmiş otomasyonu bir iPhone'da tetikleyin (IPA'yı kullanır)
5. update_mobile_app → hazır olduğunda IPA'yı yeni sürümle değiştirin

Yapay Zeka ile İyileştirme: izin verilenler listesindeki beta, kontrol paneli ve REST iyileştirme uç noktaları aracılığıyla kullanılabilir. Henüz genel katalogda hiçbir İyileştirme MCP aracı bulunmamaktadır.

✅

Uyumluluk ve Kanıt (Kurumsal)

• collect_compliance_evidence — Bağlı hizmetlerden (Cloudflare, GitHub, Sentry, Supabase, Railway) otomatik kanıt toplamayı tetikler. Çalıştırma kimliğini döndürür. SSL/TLS ayarlarını, WAF durumunu, Dependabot uyarılarını, hata eğilimlerini, dağıtım geçmişini ve daha fazlasını toplar.
• check_config_drift — Tüm bağlı hizmetleri, temel yapılandırmalardan (SSL modu, TLS sürümü, HSTS, WAF kuralları, güvenlik başlıkları) güvenlik yapılandırması sapmalarına karşı kontrol eder.
• generate_access_review — Üç aylık erişim inceleme raporu oluşturur. Ekip üyelerini, rolleri, MFA durumunu, API anahtarı kullanımını denetler ve öneriler oluşturur (örn. etkin olmayan anahtarları iptal etme).
• get_security_events — Hizmetler arası güvenlik olayı zaman çizelgesini sorgular. 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 herhangi bir istemciyle çalışır. Popüler istemciler için kurulum kılavuzları aşağıdadır:

🤖

Claude Desktop

Ayarlar → Geliştirici → Yapılandırmayı Düzenle'yi açın, ardından şunu 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_ öğesini 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 herhangi bir istemci bug_Agent_ ile çalışır. Standart yapılandırmayı kullanın:

• Komut: npx
• Argümanlar: ["-y", "@bugagent/mcp-server"]
• Ortam Değişkeni: BUGAGENT_API_KEY

CLI

CLI'ye Başlarken

bug_Agent_ CLI'si, 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 aktarmayı 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 şunlar için komutlar sağlar:

reports Hata raporlarını oluşturun, listeleyin, alın, güncelleyin ve temizleyin

projects Projeleri oluşturun, listeleyin, güncelleyin ve silin

keys API anahtarlarını oluşturun, listeleyin, yeniden oluşturun ve iptal edin

jira Jira'ya bağlanın, raporları senkronize edin ve Jira ayarlarını yapılandırın

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

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

profile Profilinizi ve ayarlarınızı görüntüleyin ve güncelleyin

auth Oturum açın, kaydolun ve kimlik bilgilerini yönetin

Genel Bayraklar

Bayrak Açıklama

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

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

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

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

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

Çı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önlendirmek 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ı. Betik yazma ve otomasyon için kullanışlıdır.

--transform ile Filtreleme

Çıktı verilerini sorgulamak ve filtrelemek için GJSON sözdizimiyle --transform 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"

Yapay Zeka Yeteneği

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

✨

AgentSkill Nedir?

AgentSkill'ler, yapay zeka kodlama asistanlarının (Claude Code, Cursor, vb.) CLI araçlarını bağlamsal olarak çağırmasına olanak tanır. bug_Agent_ yeteneği, yapay zeka asistanınıza hataları dosyalamak, proje durumunu kontrol etmek ve Jira'ya senkronize etmek için yetenek verir — tüm bunları siz bir komut yazmadan yapar.

Yeteneği Yükleyin

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

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

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

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

🎬

Oturum Tekrarı + Yapay Zeka Asistanı: Oturum Tekrarı etkinleştirildiğinde (Takım planı), Yapay Zeka 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ğ başarısızlıkları) 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

support@bugagent.com — Genellikle 24 saat içinde yanıt veririz.