bugAgent

MCP v1

Navigasyon

Model Context Protocol

MCP

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

Hata raporlarını, özellik isteklerini ve daha fazlasını doğrudan AI kodlama asistanınızdan dosyalayın, sınıflandırın ve yönetin. Bağlam değiştirme yok, kopyala-yapıştır yok — sadece sorunu tanımlayın, bug_Agent_ gerisini halleder.

Discord Topluluğu support@bugagent.com

Başlarken

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

1

API anahtarınızı alın

Ücretsiz bir hesap oluşturun; yeni çalışma alanı sahipleri doğrudan API anahtarı kurulumuna yönlendirilir. Dönen kullanıcılar Ayarlar → Geliştiriciler → API Anahtarları bölümünden bir anahtar oluşturabilir.

2

AI istemcinizi yapılandırın

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

3

Hata dosyalamaya başlayın

Bir hatayı doğal dilde tanımlayın; bug_Agent_ otomatik olarak sınıflandırır, zenginleştirir ve saklar.

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

Küresel 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ğlantınızda bug_Agent_ sizden API anahtarınızı isteyecektir. Ayrıca ortam değişkeniyle de ayarlayabilirsiniz:

export BUGAGENT_API_KEY=ba_live_your_key_here

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

MCP İstemci Yapılandırması

Aşağıdakini MCP istemcinizin yapılandırma dosyasına 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 değerini konsoldaki gerçek API anahtarınızla değiştirin.

Sunucuya Bağlanın

bug_Agent_ MCP sunucusu, Streamable HTTP taşıması üzerinden https://mcp.bugagent.com/mcp adresinde aktiftir. Aşağıdaki sekiz istemciden herhangi birinden bağlanın — iş akışınıza uyanı seçin.

Küçük, kopyalamaya hazır bir yapılandırma, kapsamlı anahtar rehberi 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 bölümüne giriş yapın, API Anahtarı Oluştur'a tıklayın ve değeri kopyalayın (ba_live_ ile başlar). Yalnızca bir kez görürsünüz, 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 testler için önerilir)

Resmi Anthropic aracı. Her aracı 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 gerektirmez.

macOS (Terminal)

Terminal

npx @modelcontextprotocol/inspector

Windows (PowerShell veya CMD)

PowerShell

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

1. Taşıma 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 atlamak 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+ bug_Agent_ aracının tamamını görürsünüz.
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örünür.

Ön koşullar: Node.js 18 veya üzeri. 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, 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. bug_Agent_ girişini mcpServers altına 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 artık bug_Agent_ araçlarını göstermelidir.
5. Deneyin: "Son 5 hata raporumu listele" yazın — Claude list_bug_reports aracını otomatik olarak ç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 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 yeşil noktalı bugagent öğesini 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 ekleme)

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

Seçenek 5 — Cursor (Mac + Windows)

Cursor'un yerleşik MCP desteği vardır. bug_Agent_'i bir kez ekleyin; Cursor içindeki AI asistanı, düzenleyiciden ayrılmadan hata dosyalayabilir, raporları listeleyebilir, taramaları çalıştırabilir vb.

1. Cursor'u 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 taşıma 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. Bağlandığında Cursor yeşil bir gösterge gösterir.
6. Cursor'un sohbetini açın (Cmd+L / Ctrl+L) ve "Başlığı 'Giriş bozuk' ve önem derecesi yüksek olan 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) dosyalarını da okur. Claude Desktop bölümünde gösterilen aynı JSON formatını ekleyin.

Seçenek 6 — Continue uzantılı VS Code (Mac + Windows)

VS Code'u tercih ediyorsanız, Continue uzantısı MCP sunucularını yerel olarak destekler.

1. VS Code pazarından Continue uzantısını yükleyin.
2. Continue'un 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 bug_Agent_ araçlarını kenar çubuğunda gösterecektir.
5. Continue sohbet panelini açın ve deneyin: "Güvenlik taramalarımı listele."

MCP destekli diğer VS Code uzantıları: Cline, Roo Code ve Windsurf (fork) — hepsi mcpServers anahtarı ve HTTP taşımasıyla benzer JSON yapılandırma desenlerini izler.

Seçenek 7 — OAuth destekli 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 bunu ana bilgisayarın bağlayıcı formuna yapıştırırsınız. Kimlik bilgileri MCP ana bilgisayarından bağımsızdır — Authorization Code + PKCE destekleyen herhangi bir OAuth istemcisi bunları kullanabilir. Aşağıdaki yol gösterimi 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 adresidir — diğerleri için ana bilgisayarınızın bağlayıcı belgelerine bakın) ve kimlik doğrulama yöntemi olarak Gizli seçeneğini 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 özel olarak: claude.ai/customize/connectors adresine gidin ve MCP bağlayıcısı ekle'ye tıklayın.
3. Kaydedin. Ana bilgisayar sizi bug_Agent_'e giriş yapmanız için yönlendirir (Google veya e-posta/şifre — panoda hangi yöntemi kullanıyorsanız) ve izni onaylayın, 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 yönetirler ve yukarıda gösterildiği gibi API anahtarıyla kimlik doğrularlar. 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 istiyorsanız, HTTP uç noktasına curl ile istek gönderebilirsiniz. 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 Server-Sent Events (MCP Streamable HTTP standardı) olarak gelir. Her parça data: önekiyle başlayan bir satır ve ardından bir JSON nesnesidir. Accept: application/json, text/event-stream başlığı zorunludur — sunucu onsuz istekleri reddeder.

ℹ️

401 Yetkisiz sorun giderme: API anahtarınızın Ayarlar → Geliştiriciler bölümünde iptal edilmediğini kontrol edin. Anahtarlar ba_live_ ile başlar. Hâlâ takıldıysanız anahtarı yeniden oluşturun ve tekrar deneyin.

Deneyin — Düz İngilizce İstemler

Bağlandıktan sonra araç adlarını veya parametrelerini bilmenize gerek yok. Ne istediğinizi düz İngilizceyle tanımlayın; AI asistanınız doğru bug_Agent_ aracını otomatik olarak çağırır.

Hata Raporları

AI 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şifsel AI

Run an exploratory AI session on https://app.example.com with 5 parallel agents
Get the latest exploration run results — list any bugs that were filed
What testing strategies did the agents use and which found the most issues?

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ı Referans

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

İstemci Yapılandırma konumu / komut

MCP Inspector Dosya yok — npx @modelcontextprotocol/inspector sonrasında tarayıcı arayüzünde URL + 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 ekleyin

Sorun Giderme

Belirti Çözüm

401 Unauthorized Anahtar yanlış, süresi dolmuş veya iptal edilmiş. Ayarlar → Geliştiriciler bölümü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 kapatmayın). Cursor'da yeşil nokta için Ayarlar → MCP bölümünü kontrol edin.

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

Yanlış çalışma alanının verileri Her API anahtarı tek bir çalışma alanıyla kapsamlıdır. Sorgulamak istediğiniz çalışma alanından Ayarlar → Geliştiriciler bölümünde 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 (Doğrudan değil) seçin. Inspector, tarayıcı CORS kısıtlamalarını atlamak için yerel bir Node süreci üzerinden proxy yapar.

Codex CLI — araçlar tanınmıyor ~/.codex/config.toml dosyasının [[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 şu araçları sağlar:

🐛

Hata Raporu Yönetimi

• create_bug_report — 19 tür arasında otomatik sınıflandırma ile yeni bir rapor oluşturun — hatalar, özellik istekleri, iyileştirmeler, teknik borç ve daha fazlası (başlık: 3-500 karakter). İsteğe bağlı attachments dizisi, her biri en fazla 400 MB olan base64 kodlu dosyaları kabul eder: herhangi bir görsel, video, ses, PDF veya metin/JSON. format_description: true değerini ayarlayarak açıklamayı yapay zeka ile yapılandırılmış bir şablona otomatik olarak yeniden biçimlendirin. QA eforunu takip etmek için time_spent_seconds değerini iletin. Düzeltme aciliyetini önem derecesinden bağımsız olarak ayarlamak için priority (urgent / high / normal / low) değerini iletin. Bir Epic oluşturmak için is_epic: true değerini veya aynı yetkili projede bir alt öğe oluşturmak için parent_epic_id (UUID/kısa kimlik) değerini iletin. Yanıt, hiyerarşi alanlarının yanı sıra project_id, project, short_id, legacy_short_id ve project_short_id değerlerini içerir.
• list_bug_reports — Raporları listele ve filtrele (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, is_epic, type, severity, status, resolution, root_cause veya reporter_user_id ile filtreleyin. Her sonuç, kiracı kapsamlı kişi/proje tanımlayıcılarının yanı sıra is_epic, parent_epic_id, parent_epic ve sınırlandırılmış epic_progress içerir. Rapor okuma araçları üye e-posta adreslerini açığa çıkarmaz.
• pick_next_bug — Ajan döngüsünün üzerinde çalışması gereken bir sonraki hatayı/hataları öncelik sırasına göre döndürür (S1 → S2 → S3, her grupta en eskisi önce). Çalışma alanınıza otomatik olarak kapsamlanır — ekibinizdeki tüm projelerde status new, awaiting-triage veya confirmed durumuna 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ç kompozisyonu için satırları list_bug_reports ile aynı biçimde döndürür. Okuma-sonra-talep deseni için claim_bug ile birlikte kullanın.
• claim_bug — Bir hatayı status new, awaiting-triage veya confirmed durumundan status='in-progress' durumuna atomik olarak geçirir, assigned_to değerini çağıran kullanıcıya ayarlar ve claimed_at=NOW() damgasını ekler. Postgres'in UPDATE-WHERE-RETURNING deseni sayesinde eşzamanlı çağrıcılar arasında yarış koşulundan bağımsızdır — iki ajan aynı kimliğe yakın zamanlarda claim_bug çağırırsa, tam olarak biri hata gövdesiyle birlikte claimed:true alır ve diğeri bir neden dizesiyle claimed:false alır. Başarılı yanıtlar reporter_user_id, reporter_name, assigned_to ve assignee_name içerir. Bir pg_cron reaper'ı, süresi dolmuş talepleri (durum=in-progress + claimed_at > 30 dakika) otomatik olarak new durumuna geri bırakır, böylece çöken bir ajanın biletleri manuel müdahale olmadan kuyruğa yeniden girer. Girdiler: id (UUID veya kısa kimlik).
• get_bug_report — Bir raporun tüm ayrıntılarını UUID veya çalışma alanı/proje kısa kimliği ile alın. Standart kişi/proje/kalite alanlarının yanı sıra is_epic, üst kimliği, toplu ilerlemeyi ve Epic'ler için sınırlandırılmış ilk alt öğe sayfasını döndürür.
• list_epic_children — Bir Epic'in alt raporlarını id, limit (1–100) ve offset ile sayfalayın. Her alt raporu yüklemeden children, total, has_more ve SQL ile toplanan epic_progress değerlerini döndürür.
• update_bug_report — Standart rapor alanlarının yanı sıra is_epic ve parent_epic_id alanlarını güncelleyin. Ayırmak için parent_epic_id: null değerini iletin; yeniden üst atama/ayırma atomiktir ve aynı çalışma alanı, aynı proje yetkilendirmesi gerektirir. Epic'e yükseltme mevcut üst öğeyi ayırırken, alt öğeleri olan bir Epic düşürülemez. Mevcut durum/çözüm/kök neden ve atama bildirim kuralları geçerli olmaya devam eder.
• add_comment — Bir hata raporuna yorum ekleyin (UUID veya kısa kimlik, gövde 1-10000 karakter). Rapor Jira ile senkronize edilirse, yorum otomatik olarak bağlantılı Jira kaydına gönderilir.
• list_comments — Bir raporun tam yorum zincirini en eskiden en yeniye listeler — her yorum yazar adı, parentId (zincirlenmiş yanıtlar) ve zaman damgalarıyla birlikte. Yorumlar get_bug_report kapsamında değildir, bu nedenle bir biletin tartışmasını okumanın yolu budur. UUID veya kısa kimlik kabul eder.
• link_bug_reports — Aynı yetkili projedeki iki rapor arasında yönlü anlamsal bağlantı oluşturun. parent-of için, kaynak rapor bir Epic ve hedef rapor standart bir alt öğe olmalıdır. Epic ataması için oluşturma/güncelleme sırasında parent_epic_id işlevini tercih edin.
• unlink_bug_reports — Daha önce oluşturulmuş bir hata raporu bağlantısını UUID'sine göre 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 her kullanıcı tarafından oluşturulmuş bağlantıyı listeler. Her bağlantıyı sağlanan raporun bakış açısından okur gibi döndürür — örn. bu raporun hedef olduğu saklı bir duplicate-of satırı duplicated-by olarak görünür; bu raporun hedef olduğu parent-of subtask-of olarak görünür; bu raporun hedef olduğu depends-on blocks olarak görünür; bu raporun hedef olduğu testing-blocked-by blocks-testing olarak görünür. 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, iyileştirmeler vb.)
• flush_reports — Eski raporları toplu olarak silin (yalnızca yönetici)

📊

Kullanım ve Analitik

• get_usage — Plan limitlerine karşı kullanımı kontrol edin. API anahtarı çağıranları usage:read gerektirir.
• get_stats — Günlük sayılar, tür/önem derecesi/durum dağılımları

📁

Proje Yönetimi

• list_projects — Mevcut projeleri id, name, slug, ticket_prefix, açıklama ve varsayılan durumla birlikte listeler. Bu değerleri doğru projeyi hedeflemek için create_bug_report ve list_bug_reports ile birlikte 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 kalıcı olarak silin (hata raporları, otomasyonlar, test senaryoları, mobil uygulamalar, programlar, coğrafi anlık görüntüler, notlar, zaman kayıtları). Yalnızca sahip/yönetici. Son proje silinemez. Depolama otomatik olarak boşaltılır
• export_okf_bundle — Bir projenin QA bilgisini — hata raporları, test senaryoları, otomasyonlar ve performans, güvenlik ve keşif testleri — OKF/OQA markdown paketi olarak dışa aktarın (oqa.ai tarafından kullanılan Açık Sorgu Ajanı formatı). Varsayılan olarak etkin projeyi kullanır; farklı bir projeyi dışa aktarmak için isteğe bağlı project (kısa ad veya ad) değerini iletin. Paketteki dosyaların listesini ve paketin kendisini base64 kodlu 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çleri 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 — Etkin 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 hızlandırıcı bayraklarıyla listeleyin
• invite_team_member — Bir kullanıcıyı e-posta ile davet edin (yöneticiler katkıda bulunanları ve yöneticileri davet edebilir; yalnızca sahipler yöneticileri davet edebilir). 5 günlük sona erme 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 itirazı → tam metni okuyan ve bağımsız yargıyla son notları yazan Claude Opus hakemi). 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 yanıta düşer. Hata oluşturulduğunda otomatik 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 kod tabanında büyük olasılıkla nereye ait olduğunu adlandıran dar kapsamlı 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 projede bir github_repo eşlendiğinde, çıktı bağlı depodaki gerçek dosya parçalarına dayanır; aksi takdirde bir depo bağlama önerisiyle genel yönlendirmeye geri döner. likely_fix_area metnini, generated_at, repo_used ve bir grounded bayrağını döndürür. Hata oluşturulduğunda otomatik tetiklenir — ajanların genellikle yalnızca manuel yeniden oluşturma için çağırması gerekir.
• upgrade_plan — Satış destekli Enterprise kayıt bağlantısını alın

⚡

Performans Testi

• create_performance_test — URL, cihaz, sanal kullanıcılar, süre, puan eşiği ve otomatik hata oluşturma anahtarıyla 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ı yoklamak için bir çalıştırma kimliği döndürür. Mobil uygulama profilleme çalıştırmaları panodan tetiklenir
• get_performance_results — Lighthouse puanları (Performans, Erişilebilirlik, En İyi Uygulamalar, SEO), Temel Web Verileri (LCP, FID, CLS, FCP, TTFB, INP, TBT, SI) ve yük testi metrikleri (VU'lar, istekler, RPS, p50/p90/p95/p99 gecikmeleri) dahil tam sonuçları alın
• list_performance_tests — Geçerli 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'a özeldir. Ü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 → denetimi + yük testini tetikleyin
4. get_performance_results → puanları ve temel verileri inceleyin

🛡

Güvenlik Taraması

• create_security_scan — 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+ şablon) kullanır. Mobil taramalar, APK/IPA ikili analizi için MobSF kullanır. Önem derecesi eşikleriyle yapılandırılabilir otomatik hata oluşturma. Yalnızca Enterprise
• run_security_scan — Güvenlik açığı taraması tetikleyin. Web taramaları DNS alan adı doğrulaması gerektirir. Mobil taramalar yüklenmiş bir uygulama gerektirir. Sonuçları yoklamak için bir çalıştırma kimliği döndürür
• get_security_results — Güvenlik puanı (0-100), CWE referansları, OWASP eşlemeleri, kanıt ve düzeltme rehberliği ile önem derecesine göre (Kritik, Yüksek, Orta, Düşük, Bilgi) kategorize edilmiş bulgular dahil tam sonuçları alın
• list_security_scans — Geçerli ekip için son puan ve kimlik doğrulama/derinlik rozetleriyle 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'a özeldir. Enterprise=sınırsız
• list_security_schedules — Ekip için cron, saat dilimi, etkin durum, sonraki çalıştırma ve bildirim ayarlarıyla tüm zamanlanmış güvenlik taramalarını listeleyin. Üst tarama yapılandırmasıyla birleştirir (ad, scan_type, target_url)
• 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 (yok/e-posta/slack/her ikisi), notify_email, slack_channel_id. Her çalıştırma aylık kotanıza sayılır; yönetici kullanıcılar kotayı atlar. Tarama derinliği her zaman çalıştırma sırası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 daldaki haftalık SAST)
5. get_security_results → bulguları ve düzeltmeyi inceleyin

📖

Kod İncelemesi

• list_code_reviews — Ekip için son yapay zeka kod incelemelerini listeleyin. Kalite puanları, önem derecesi sayıları, PR bilgileri 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/bakım kolaylığı), başlık, açıklama, kod önerisi, dosya yolu ve satır numaralarını içerir
• get_code_review_usage — Kod incelemesi kullanımını kontrol edin. Yapay zeka kod incelemesi yalnızca Enterprise'a özeldir; Enterprise'da sınırsız
• get_code_review_analytics — İnceleme analitiği 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. Panoda /dashboard/code-review adresinde bir PR'ı inceleyin
3. list_code_reviews → son incelemeleri görün
4. get_code_review → bulguları ve önerileri alın

🔍

Keşifsel Yapay Zeka

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 Yapay Zeka yapılandırmalarını listeleyin
• create_exploration — Yeni bir keşif oluşturun. Benzersiz stratejilerle birden fazla paralel ajan çalıştırmak için agent_count (1–10, maks. 10) kabul eder: happy_path, edge_case, security, accessibility, error_path, performance, mobile, data_integrity, navigation, custom
• get_exploration — Ajan ayarları, güvenli kimlik doğrulama meta verileri ve son çalıştırmalarla keşif yapılandırmasını alın. Parolalar ve şifreli metin asla döndürülmez.
• get_exploration_run — Ajan başına ilerleme, faz 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 Yapay Zeka yalnızca Enterprise'a özeldir; 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 için yoklayın
4. Panoda ajan atıflı yinelenmeyen bulguları görüntüleyin

📝

Notlar

• list_notes — İsteğe bağlı anahtar kelime araması, proje filtresi, yazar filtresi ve tarih aralığıyla 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 değerini private veya shared olarak ayarlayın. Başlık sağlanmazsa ilk 30 karakterden otomatik başlık. İsteğe bağlı attachments dizisi, her biri 400 MB'a kadar base64 kodlu dosyaları kabul eder: herhangi bir görsel, video, ses, PDF veya metin/JSON. Kalite güvence çabasını takip etmek 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 değerini güncelleyin. Notun mevcut eklerini değiştirmeden yeni dosyalar eklemek için bir attachments dizisi iletin (her biri maks. 400 MB). 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özlemlerinizi ekleyin
3. list_notes → anahtar kelime veya projeye göre geçmiş notları arayın
4. get_note → ekleriyle birlikte tam notu alın

🤖

Otomasyon

• create_automation — Özel bir Playwright betiğiyle (FAB kaydı gerekmez) yeni bir otomasyon oluşturun. 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 bir yer tutucudur), status (draft veya active, varsayılan: draft), project_id. Otomasyon id değerini döndürür. Enterprise planı gereklidir. İpucu — Bir otomasyonu çoğaltın: orijinal betiği almak için get_automation kullanın, ardından name değeri "[Copy] Original Name" olarak ayarlanmış create_automation çağırın ve orijinal script, target_url ve project_id değerlerini iletin. Çoğaltılan, sürüm geçmişi olmadan draft durumunda başlar.
• list_automations — Playwright otomasyon betiklerini listeleyin. project_id veya status ile filtreleyin (draft, active, paused). Ad, target_url, last_run_status ve run_count 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 ile otomasyonu, bir script_versions yığınını (en eskiden en yeniye, 100'e kadar önceki girdi, her biri { script, source, timestamp }) ve her çalıştırmanın yürütülen script_version_label/script_version_source değerini taşıdığı bir recent_runs dizisini döndürür. Belirli bir tarihsel 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 — iddialar asla iyileştirilmez, bu nedenle gerçek gerilemeler yine de başarısız olur — ve her iyileştirme çalıştırma stdout'una 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 değerini bs_browser (chrome, firefox, safari, edge), bs_os (Windows, OS X) ve bs_os_version ile 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 kapsar). Python betikleri browserstack-sdk (pytest-playwright) üzerinden yönlendirilir ve yalnızca masaüstünü kapsar — Python ile gerçek mobil desteklenmez çünkü pytest-playwright'ın browser_type.connect() değeri BrowserStack'in gerçek mobil uç noktalarını süremez. Video ve ağ günlükleri otomatik yakalanır; konsol günlükleri yalnızca masaüstü. Sürüm tekrarı: otomasyonun script_versions geçmişinden önceki bir girdiyi yürütmek için isteğe bağlı version_index (tamsayı, 0 tabanlı) iletin. Varsayılan: version_index atlandığında veya null olduğunda, geçerli canlı betik çalışır — yalnızca "geçerliyi seçmek" için bir yer tutucu değeri iletmeyin. Aralık dışı, negatif veya tamsayı olmayan değerler reddedilir. Çalıştırma kaydı, çalıştırılan 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, duration_ms ve error_message ile çalıştırmaları döndürür.
• list_schedules — Cron, saat dilimi, cihaz ve bildirim ayarlarıyla 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, notify_on_fail (e-posta/slack/her ikisi) ve Slack kanalı seçeneklerini destekler. Zamanlanmış çalıştırmalarda BrowserStack Live: browserstack: true değerini bs_browser, bs_os ve bs_os_version ile 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 otomasyonu çalıştırmalarını listeleyin
• create_mobile_schedule — Gerçek cihazlarda zamanlanmış bir mobil otomasyonu çalıştırması oluşturun. automation_id, cron_expression ve devices dizisi gerektirir
• delete_mobile_schedule — Zamanlanmış bir mobil otomasyonu çalıştırmasını silin
• optimize_automation_script — Yapay zeka destekli optimizasyon için bir Playwright betiğini Sonnet 4'e gönderin. Seçicileri, bekleme stratejilerini, iddiaları, hata işlemeyi, kimlik doğrulama desenlerini, mobil uyumluluğu ve katı modu düzelten 12 maddelik bir kontrol listesi uygular. automation_id gerektirir. Geçerli 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 alı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 girdilerini listeleyin. period (today, week, month, all), project_id, category ve sort (newest, oldest, most_time, least_time) ile filtreleyin. Yalnızca Enterprise planı.
• create_time_entry — Kalite güvence görevlerinde harcanan zamanı kaydedin. description, category ve duration_minutes gerektirir. İsteğe bağlı olarak project_id ve entry_date ayarlayın (varsayılan bugün). Yalnızca Enterprise planı.
• update_time_entry — Mevcut bir zaman girdisini güncelleyin. id gerektirir. description, category, duration_minutes, project_id veya entry_date güncellenebilir. Yalnızca Enterprise planı.
• delete_time_entry — Bir zaman girdisini kalıcı olarak silin. id gerektirir. Yalnızca Enterprise planı.

1. create_time_entry → 45 dakikalık regresyon testini kaydedin
2. list_time_entries → bu haftanın zaman girdilerini görüntüleyin
3. update_time_entry → süreyi veya kategoriyi ayarlayın
4. delete_time_entry → hatalı bir girdiyi kaldırın

☑️

Test Durumları

Test yönetimi; hiyerarşik klasörler, iç içe geçmiş suite'ler (çalıştırmalarda alt-suite otomatik genişletmesiyle en fazla 3 seviye derinlik), sürükle-bırak yeniden sıralama ve KPI trendleri, hata analizi, suite sağlığı, kapsam ve test uzmanı verimliliği içeren bir analitik Raporlar sekmesi sunar. Tüm araçlar doğrudan Supabase'i çağırır — HTTP gidiş-dönüşü yok, dashboard ile aynı gecikme süresi.

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

AI test senaryosu oluşturma, AI etiket önerileri, Figma içe aktarma ve test senaryosu dosya ekleri Kurumsal plan gerektirir. 128 KB Ücretsiz yapılandırılmış içerik sınırı, Kurumsal dosya eklerinden ayrıdır. Ücretsiz plan URL referanslarını saklayabilir. Çekirdek MCP test senaryosu araçları, yukarıdaki sınırlar dahilinde Ücretsiz planda kullanılabilir.

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 Engellendi · S Atlandı) ve ses kontrolü içerir. Mikrofona tıklayın, ardından "Geçti", "Kaldı", "Engellendi", "Atlandı", "Sonraki", "Önceki", "Not ekle" (not alanına yazıya dönüştürür), "Notları kaydet" veya "Ses kapalı" deyin. Başarılı sonuçlarda otomatik olarak bir sonraki test edilmemiş senaryoya ilerler; Kaldı durumunda bekler, böylece test uzmanları ayrıntıları dikte edebilir ve hata kaydı oluşturabilir. Chrome, Edge ve Safari'de çalışır.

Senaryolar ve Klasörler

• list_test_cases — Opsiyonel 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ı listeler. API anahtarı çağıranlar test_cases:read gerektirir.
• create_test_case — Test senaryosu oluşturur. İki şablon varyantı: steps (varsayılan) — steps dizisi aracılığıyla adım adım { 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 saklar, böylece test uzmanı daha sonra template_type değiştirirse iki tarafın verisi de kaybolmaz). Opsiyonel urls dizisi (maks. 10 http/https URL) referans bağlantıları ekler ve Ücretsiz planda kullanılabilir. name gerektirir. Opsiyonel: description, preconditions, template_type, steps, text_content, urls, priority, type, tags, estimated_time (saniye). Dosya ekleri Kurumsal plan gerektirir ve dashboard'ın POST /api/test-cases/:id/attachments uç noktası (multipart) üzerinden yüklenir — henüz bir MCP aracı olarak sunulmamıştır. API anahtarı çağıranlar test_cases:write gerektirir.
• get_test_case — Adımlar ve yürütme geçmişi dahil tam test senaryosu ayrıntılarını alır.
• list_test_case_folders — Ekibin klasörlerini listeler (folder_id aracılığıyla senaryo başına bir klasör; çoktan çoğa test planı gruplamaları olan suite'lerden farklıdır). 500 ile sınırlıdır; project_id ve parent_folder_id filtrelerini dikkate alır (yalnızca üst düzey için "root" kullanın).
• create_test_case_folder — Klasör oluşturur (parent_folder_id ile en fazla 3 seviye iç içe yerleşim). Senaryoları taşımak için bulk_update_test_cases kullanın. API anahtarı çağıranlar test_cases:write gerektirir.
• bulk_update_test_cases — En fazla 500 senaryoya aynı anda tek bir eylem uygular: set_priority, set_status, set_type, add_tags, remove_tags, add_to_suite, pin, unpin.
• link_test_case_to_bug — Test senaryosu ile hata raporu arasında izlenebilirlik kurar (verified_by, covers veya relates).
• list_test_case_links — Bir test senaryosu için tüm izlenebilirlik bağlantılarını listeler.
• list_test_case_review_candidates — Ölü test bayrakları: never_run (oluşturulduktan 90+ gün), always_passes (90 günde 5+ ardışık geçme), always_skipped (3+ ardışık atlama).
• mark_test_case_review_flags — Geçerli arşiv adayı bayraklarını test_cases.review_flag üzerine kalıcı olarak yazar. Her Pazartesi 09:00 UTC'de pg_cron aracılığıyla otomatik çalışır.

İçe Aktarmalar

• Figma içe aktarma (Kurumsal) (dashboard arayüzü + REST): Figma frame'lerinin zip dışa aktarımını yükleyin (en fazla 100 MB), Claude her ekranı analiz eder ve seçtiğiniz veya oluşturduğunuz bir klasöre test senaryoları taslağı hazırlar. Çok aşamalı işlem hattı (sınıflandır → ekran başına senaryolar → ortak önekli ekranlar arasında akış düzeyinde senaryolar → öz-eleştiri), önbelleğe alma istemleri, 429 yeniden deneme ve frame başına hata izolasyonu ile çalışır; böylece tek bir hatalı frame toplu işlemi bozmaz. Senaryolar status=active olarak kaydedilir, ai_generated=true etiketiyle işaretlenir ve source='figma' ile source_frame_name orijinal frame'e bağlantıyı 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.

Suite'ler ve Çalıştırmalar

• list_test_suites — Proje kimliği, senaryo sayısı ve son çalıştırma durumuyla test suite'lerini listeler. API anahtarı çağıranlar test_runs:read gerektirir.
• create_test_suite — Suite oluşturur. parent_suite_id ile en fazla 3 seviye iç içe yerleşim.
• list_test_runs — Suite adı, atanan kişi ve geçti/kaldı özetiyle test çalıştırmalarını listeler.
• create_test_run — Dashboard tarafından yönetilen suite çalıştırması oluşturur. Üst suite çalıştırıldığında, her alt suite'teki tüm senaryolar otomatik olarak dahil edilir (ikisine de bağlı bir senaryo tam olarak bir kez eklenir). Her test_run_results satırı, senaryonun hangi alt suite'ten geldiğini kaydeder; böylece sonuç sayfaları kaynağa göre gruplayabilir.

Harici Aracı Yürütme

Bu araçlar, Hermes veya başka bir aracı çalışma zamanının, QA kayıt sistemi olmadan onaylanmış bir suite'i yürütmesine olanak tanır. Yalnızca test_runs:read ve test_runs:write izinlerine sahip çalışma alanı kapsamlı bir anahtar kullanın. Suite proje sınırını belirler; çağıranlar bunu geçersiz kılamaz.

• start_test_plan — Kararlı bir external_run_id ile değişmez bir suite anlık görüntüsünü başlatır veya sürdürür. Yinelenen bir kimlik, yeni bir kayıt oluşturmak yerine mevcut eşleşen çalıştırmayı ve ilk sayfayı döndürür.
• get_test_run_plan — Kurallı çalıştırma durumunu ve kararlı bir plan sayfasını okur. Önceki next_cursor değerini iletin; sayfalar varsayılan olarak 100 senaryodur ve 200 ile sınırlıdır.
• report_test_results — passed, failed, blocked veya skipped durumuyla 1–200 sonuç gönderir. Tam yeniden denemeler güvenlidir; bir senaryoyu başka bir durumla üzerine yazmaya çalışmak reddedilir.
• abort_test_run — Kabul edilen kısmi sonuçları ve kurallı özeti koruyarak kesintiye uğramış bir çalıştırmayı idempotent biçimde durdurur.

Kota davranışı: start_test_plan çağrısını aynı external_run_id ile yeniden deneyerek başka bir çalıştırma tüketmeden eşleşen çalıştırmayı sürdürün. Veri silme, aylık çalıştırma kullanımını sıfırlamaz.

Çalışma zamanı sınırı: senaryo anlık görüntüleri kimlik bilgilerini, dosya gövdelerini ve özel ek yollarını hariç tutar. Sonuç kanıtları 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. Kusur ve sürüm kararlarından bir insan sorumlu kalır.

Hermes Aracı kılavuzu bu döngüyü bugAgent tarafından sürdürülen bir topluluk becerisi olarak paketler. Genel başlangıç kiti, kopyaya hazır bir yapılandırma ve kurulabilir beceri içerir. Resmi bir Nous Research entegrasyonu değildir.

Raporlar (Katman 1 + Katman 4 analitiği)

• get_test_reports_overview — Bir pencere için öne çıkan KPI'lar (geçme oranı, tamamlanan çalıştırmalar, yürütülen senaryolar) ile önceki eşdeğer pencereye göre farklar. Raporlar sekmesindeki KPI şeridinin gösterdiği sayılarla aynıdır.
• get_test_reports_failures — Dört "neyi düzeltmeli?" listesi: failing_cases (≥%50 kaldı, min 3 çalıştırma), flaky_cases (en çok geçti/kaldı değişimi), failing_suites (≥%30 kaldı, min 5 çalıştırma), regressed_cases (pencerede daha önce geçme olan en son kaldı).

1. create_test_case_folder → bir klasör ağacı oluşturun (örn. Duman → Kimlik Doğrulama)
2. create_test_case → senaryoları tanımlayın; bulk_update_test_cases ile klasörlere taşıyın
3. create_test_suite → bir test planı oluşturun (alt-suite'ler opsiyonel, en fazla 3 seviye derinlik)
4. create_test_run → üst suite'ten insan/dashboard tarafından yönetilen bir çalıştırma oluşturun — alt-suite'ler otomatik dahil edilir
5. start_test_plan → yeniden denemeye güvenli harici aracı çalıştırmasını başlatın veya sürdürün
6. get_test_run_plan → her değişmez plan sayfasını alın, ardından seçilen çalışma zamanında yürütün
7. report_test_results → sınırlı sonuç gruplarını döndürün; yürütme güvenli şekilde devam edemezse abort_test_run çağırın
8. get_test_reports_failures → çalıştırma tamamlandığında "bu hafta neyi düzeltmeli?" diye sorun
9. get_test_reports_overview → haftadan haftaya geçme oranı trendini takip edin

⚡

Ekip Hızlandırıcı

• scale_team — Hızlandırıcı test uzmanlarıyla QA ekibinizi anında ölçeklendirin. Hesaplar otomatik olarak test uzmanı erişimiyle sağlanır. team_size (1–10), location, duration, budget ve isteğe bağlı olarak product_url, product_types ve tech_levels belirtin. Kurumsal planda kullanılabilir. Onay verilene kadar ücretlendirilmezsiniz.

1. scale_team → ABD'de 1 ay için 5 kıdemli test uzmanı sağlayın
2. list_team_members → yeni test uzmanlarının ekibinizde göründüğünü doğrulayın
3. list_reports → hızlandırıcı test uzmanlarının gönderdiği raporları inceleyin

📱

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, geçirilene kadar eski çalışma alanı düzeyindeki satırları içerebilir.

• list_mobile_apps — Yüklenen uygulamaları isteğe bağlı project_id/project, platform ve limit filtreleriyle listeler. Her uygulamanın project_id değerini döndürür, böylece ajanlar sonraki işlemleri aynı projede tutabilir.
• upload_mobile_app — Gerçek cihazlarda test etmek için bir APK (Android) veya IPA (iOS) uygulamasını kaydeder. name, platform (android/ios) ve file_url gerektirir; aktif projeye atamak için project_id değerini 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 paneli 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. Bağlı otomasyonlar oturum açma profilleri kullanıyorsa, çağıran kişi her profil için yetkili olmalı veya aktif çalışma alanı sahibi/yöneticisi olmalıdır; zamanlamalar korumalı otomasyon varsayılanını devralır.
• list_mobile_automations — Mobil otomasyonları isteğe bağlı project_id/project, app_id, status ve limit filtreleriyle 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 zaten proje kapsamında değilse project_id değerini iletin. Harici olarak doğrulanmış, kendi kendine yeten tek bir Maestro YAML akışı için execution_mode değerini browserstack_maestro olarak ayarlayın; aksi takdirde varsayılan appium_actions olur. YAML appId değeri, bağlı uygulamanın saklanan paket veya bundle kimliğiyle eşleşmelidir; hiçbiri saklanmamışsa, ilk doğrulanmış yerel akış bunu belirler. Yer tutucu uygulama kimlikleri ve karartılmış Android kaynak kimlikleri reddedilir. Satır içi runFlow desteklenir, ancak harici akış/betik dosyası referansları v1'de reddedilir. Yerel Maestro, inputRandomText ve copyTextFrom gibi komutların yanı sıra ${maestro.copiedText} ve ${output.value} gibi çalışma zamanı ifadelerini korur. Aynı projedeki bir credential_id, ${USERNAME}/${PASSWORD} değerlerinin tam inputText değerlerini sağlayabilir. Aynı projedeki bir variable_profile_id, başvurulan ${DATA_*} değerleri için varsayılanı kaydedebilir; başvurulan her anahtar mevcut olmalıdır. Veri profilleri yalnızca gizli olmayan sentetik verilerdir.
• import_mobile_script — Mevcut bir mobil test betiğini içe aktarır ve onu çalıştırılabilir bir otomasyona dönüştürür; geliştiricinin kendi konum belirleyicilerini korur, böylece çalıştırmalar öğeleri hassas bir şekilde çözer. Desteklenen diller: Appium-Python, WebdriverIO, Maestro (YAML akışları) ve Playwright (mobil-web). Karartılmış Android kaynak kimliği yer tutucuları atlanır ve seçici eşleme warnings içinde raporlanır. Yalnızca Android uygulamaları. name, app_id ve script gerektirir; isteğe bağlı target_devices ve project_id. Otomasyonu ve action_count, algılanan dialect ve seçici eşleme warnings değerlerini 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, credential_id ve yerel-Maestro variable_profile_id. Veriler için, otomasyon varsayılanını devralmak üzere variable_profile_id değerini atlayın, profil kullanmamak için null değerini iletin veya geçersiz kılmak için aynı projeden bir UUID iletin. Başvurulan her ${DATA_*} anahtarı mevcut olmalıdır. Yalnızca aktif profil oluşturucu veya aktif çalışma alanı sahibi/yöneticisi seçili bir profili çalıştırabilir. Bilinen kimlik bilgisi değerlerinin tamamı filtrelenir ve veri profili değerlerine kalıcı metinsel kanıtlardan en iyi çabayla filtreleme uygulanır; dönüştürülmüş, kısmi, kodlanmış veya uygulama türevli veri değerleri kalabilir. Yetkili özel video/ekran görüntüleri kullanılabilir durumda kalır ve test edilen uygulama tarafından işlenen değerleri gösterebilir; bu nedenle veri profilleri yalnızca sentetik, gizli olmayan değerler içermelidir. Kimlik bilgisi karartma bağlamı kullanılamıyorsa veya temizlemenin güvenli olduğu kanıtlanamıyorsa, durum ve mevcut görsel kanıtlar kalırken ayrıntılı kimlik bilgili metin gizlenir. Tanılama, çalışma alanı ve proje yetkilendirmesi gerektirir; medya bağlantıları beş dakika sonra dolar.
• list_mobile_runs — Yetkili mobil çalıştırma sonuçlarını alır (durum, cihaz, sonuç özeti, özel video ve ekran görüntüsü bağlantıları, BrowserStack oturumu, güvenli olduğunda filtrelenmiş kimlik bilgili yerel Maestro günlükleri ve hataları ve otomatik oluşturulan hata raporu). Çalıştırma tanılaması için çalışma alanı üyeliği ve proje erişimi zorunludur. İ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ış bir oturum açma profili oluşturur (örn. "Admin", "Contributor"): mobil otomasyonlar tarafından kullanılan bir kullanıcı adı + parola. Her iki değer de AES-256-GCM şifreli olarak saklanır ve yalnızca yazılabilir — hiçbir araç veya API bunları asla döndürmez ve diğer üyeler / arayüz yalnızca adı görür. Yalnızca onu oluşturan aktif çalışma alanı üyesi veya aktif çalışma alanı sahibi/yöneticisi bağlayabilir, çalıştırabilir, döndürebilir veya silebilir. 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ı döndürür (id, name, proje, oluşturucu, oluşturma tarihi) — kullanıcı adını veya parolayı asla döndürmez. Bir otomasyonu çalıştırırken kimlik bilgisi seçimi olarak döndürülen id değerini kullanın.
• update_mobile_credential — Bir oturum açma profilini yeniden adlandırır veya id ile kullanıcı adını/parolasını döndürür. Yalnızca değiştirilecek alanları ekleyin. Yeni gizli değerler anında şifrelenir ve asla döndürülmez. Yalnızca profili oluşturan aktif çalışma alanı üyesi veya aktif çalışma alanı sahibi/yöneticisi güncelleyebilir.
• delete_mobile_credential — Bir oturum açma profilini id ile yumuşak siler. Yalnızca profili oluşturan aktif çalışma alanı üyesi veya aktif çalışma alanı sahibi/yöneticisi silebilir. Denetim ve çalıştırma geçmişi için saklanır ancak artık kullanılamaz veya listelenemez; otomasyon varsayılanları temizlenir ve ad yeniden kullanılabilir hale gelir.
• create_mobile_variable_profile — project_id, name ve {"DATA_EMAIL":"qa@example.test","DATA_REGION":"ca"} gibi bir variables nesnesiyle yeniden kullanılabilir, proje kapsamlı sentetik test verileri oluşturur. Anahtarlar büyük harf DATA_* tanımlayıcıları olmalıdır. Profiller 1-100 dizeye, değer başına 4096 UTF-8 bayta ve toplam 65536 bayta izin verir. Ayrılmış kimlik bilgisi/çalışma zamanı adları reddedilir. Kimlik bilgilerini, belirteçleri, üretim kişisel verilerini veya diğer gizli bilgileri asla saklamayın.
• list_mobile_variable_profiles — Yetkili bir project_id için profilleri ve okunabilir gizli olmayan değerlerini listeler. Proje atama kuralları geçerlidir.
• update_mobile_variable_profile — Bir profili yeniden adlandırır veya id ile tam variables nesnesini değiştirir. Yalnızca aktif oluşturucu veya aktif çalışma alanı sahibi/yöneticisi güncelleyebilir.
• delete_mobile_variable_profile — Bir profili id ile yumuşak siler. Yalnızca aktif oluşturucu veya aktif çalışma alanı sahibi/yöneticisi silebilir; geçmiş çalıştırma referansları kalırken otomasyon varsayılanları temizlenir.
• list_mobile_schedules, create_mobile_schedule, delete_mobile_schedule — Gerçek cihaz zamanlamalarını listeler, oluşturur ve kaldırır. Zamanlamalar, seçili otomasyonlarından proje bağlamını, oturum açma profilini ve gizli olmayan değişken profilini devralır. Korumalı profillerden birini kullanan bir zamanlama, aktif profil oluşturucu veya aktif çalışma alanı sahibi/yöneticisi gerektirir; zamanlama değişiklikleri ve silme, aktif zamanlama oluşturucu veya aktif çalışma alanı sahibi/yöneticisi ile sınırlıdır.

Örnek İş Akışı — Android

1. list_projects → hedef project_id değerini çözümleyin
2. upload_mobile_app → APK'yı bu projeye kaydedin
3. Panelde güvenli bir şekilde kaydedin veya import_mobile_script / create_mobile_automation kullanın
4. list_mobile_automations → otomasyonu aynı projede çözümleyin
5. run_mobile_automation → isteğe bağlı olarak bir oturum açma profiliyle gerçek bir cihazda tetikleyin
6. list_mobile_runs → durumu, sonuç özetini, özel görsel bağlantılarını ve BrowserStack oturum meta verilerini kontrol edin
7. Hatalar, hata anlık görüntüsü ve adım dökümüyle otomatik 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 ayrıntı sayfasında simülatör .app derlemesini yükleyin (kayıt için)
3. Tarayıcıda testi kaydedin → eylemler simülatörden yakalanır
4. run_mobile_automation → kayıtlı 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

Örnek İş Akışı — Yerel Maestro

1. upload_mobile_app → APK veya IPA'yı hedef projeye kaydedin
2. create_mobile_credential → isteğe bağlı olarak kimliği doğrulanmış bir akış için aynı projede bir profil oluşturun
3. create_mobile_variable_profile → isteğe bağlı olarak akış tarafından kullanılan aynı proje sentetik DATA_* değerleri oluşturun
4. create_mobile_automation → bağlı uygulamanın tam paket/bundle appId, script_type: maestro ve execution_mode: browserstack_maestro değerleriyle bilinen çalışan bir YAML akışı iletin. Oturum açma için ${USERNAME}/${PASSWORD} ve sentetik giriş için ${DATA_EMAIL} tarzı yer tutucular kullanın; varsayılanları kaydetmek için profil kimliklerini iletin.
5. run_mobile_automation → uyumlu bir cihaz seçin ve isteğe bağlı olarak oturum açma veya değişken profilini geçersiz kılın. Değişken profilini devralmak için atlayın veya tek bir çalıştırma için devre dışı bırakmak üzere null değerini iletin.
6. list_mobile_runs → yetkili geçti/kaldı özetlerini, özel video/ekran görüntülerini, filtrelenmiş günlükleri, gerçek adım adlarını, ayrıntılı hataları ve oturum meta verilerini inceleyin. Kimlik bilgili bir çalıştırma için güvenli temizleme sağlanamıyorsa, durum ve mevcut görsel kanıt kalırken ayrıntılı metin gizlenir.

Yapay Zeka ile İyileştirme: beyaz listeye alınan beta, panel ve REST iyileştirme uç noktaları aracılığıyla kullanılabilir. Genel katalogda henüz Refine MCP araçları yoktur.

✅

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ı hizmetlerde temel çizgilerden güvenlik yapılandırma sapmasını kontrol eder (SSL modu, TLS sürümü, HSTS, WAF kuralları, güvenlik başlıkları).
• generate_access_review — Üç aylık erişim inceleme raporu oluşturur. Ekip üyelerini, rollerini, MFA durumunu, API anahtarı kullanımını denetler ve öneriler üretir (örn. etkin olmayan anahtarları iptal et).
• get_security_events — Hizmetler arası güvenlik olayı zaman çizelgesini sorgular. Kaynağa (cloudflare, sentry, github) ve önem düzeyine (critical, high, medium, low, info) 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 (Madde 5, 25, 32, 33) uyumluluk gereksinimlerine yardımcı olur.

Uyumlu İstemciler

bug_Agent_, Model Context Protocol'ü destekleyen her istemciyle çalışır. Popüler istemciler için kurulum kılavuzları:

🤖

Claude Desktop

Ayarlar → Geliştirici → Yapılandırmayı Düzenle seçeneğini açın, ardından ekleyin:

claude_desktop_config.json

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

✳️

Cursor

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

.cursor/mcp.json

🌊

Windsurf

Ayarlar → MCP → Sunucu Ekle seçeneğini 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 her istemci 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

Here is the translation of the Markdown chunk into Türkçe:

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 boru hatlarına, betiklere ve cron görevlerine entegre edin
• Toplu işlemler — Terminalinizden ayrılmadan raporları listeleyin, filtreleyin ve yönetin
• Boru hattı 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 — raporları saniyeler içinde 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 --api-key bayrağıyla doğrudan 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ı kabuk 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"

Ayrıntılar için herhangi bir komutta --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 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ı üretin, listeleyin, yeniden üretin ve iptal edin

jira Jira ayarlarını bağlayın, raporları senkronize edin ve yapılandırın

usage Plan limitlerine karşı mevcut kullanımı kontrol edin

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

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

auth Giriş yapın, kayıt olun ve kimlik bilgilerini yönetin

Genel Bayraklar

Bayrak Açıklama

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

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

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

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

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

Çı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 oluşturma 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"

AI Becerisi

CLI ayrıca bir AgentSkill olarak da kullanılabilir 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 olanak tanır. bug_Agent_ becerisi, AI asistanınıza tek bir komut yazmadan hata bildirme, proje durumunu kontrol etme ve Jira'ya senkronize etme yeteneği verir.

Beceriyi Yükleme

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

Yüklendikten sonra, bağlam duyarlı AI Asistanı bug_Agent_ komutlarını doğal bir şekilde kullanabilir — ürününüz, test yönergeleriniz ve yüklenen dokümantasyonunuz hakkında tam bilgiyle:

AI Asistan Komutu

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

Beceri, doğal dili uygun CLI komutlarına çevirir ve bunları çalıştırır.

🎬

Oturum Kaydı + AI Asistan: Oturum Kaydı etkinleştirildiğinde (Kurumsal plan), AI Asistanı yakalanan kullanıcı oturumuna başvurabilir — son 60 saniyedeki tıklamalar, gezinme, hatalar ve ağ arızaları — tam yeniden üretim bağlamıyla daha zengin, daha doğru hata raporları otomatik olarak taslak haline getirebilir.

Yardım Alın

Yardıma mı ihtiyacınız var? 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.