bugAgent

आधिकारिक

bugAgent को किसी भी MCP-संगत AI क्लाइंट से कनेक्ट करें। अपने AI कोडिंग असिस्टेंट से सीधे बग, फीचर अनुरोध और अधिक को फ़ाइल, वर्गीकृत और प्रबंधित करें। कोई संदर्भ स्विचिंग नहीं, कोई कॉपी-पेस्ट नहीं — बस समस्या का वर्णन करें और bugAgent बाकी संभाल लेता है।

bugagent.com पर देखें

Bug Agent MCP के साथ आप क्या कर सकते हैं?

File and auto-classify bug reports — Ask your assistant to create a bug with create_bug_report, which auto-classifies the type and severity from a natural-language description.
Query and filter existing reports — Retrieve reports with list_bug_reports by status, severity, project, or date range, and get full details via get_bug_report.
Update report status and assign work — Transition a bug’s status, assign it to a team member, and set resolution or root cause using update_bug_report.
Claim the next priority bug — Use pick_next_bug to find the highest-priority open ticket, then atomically claim it with claim_bug.
Generate developer notes for a fix — Run push_to_claude on a report to produce root-cause analysis, suggested fixes, and verification steps.
Run and review security scans — Create a scan config with create_security_scan, execute it via run_security_scan, and retrieve findings with get_security_scan_results.

दस्तावेज़

MCP v1

नेविगेशन

मॉडल कॉन्टेक्स्ट प्रोटोकॉल

MCP

bug_Agent_ को किसी भी MCP-संगत AI क्लाइंट से कनेक्ट करें।

अपने AI कोडिंग असिस्टेंट से सीधे बग, फीचर अनुरोध और बहुत कुछ फ़ाइल, वर्गीकृत और प्रबंधित करें। कोई कॉन्टेक्स्ट स्विचिंग नहीं, कोई कॉपी-पेस्ट नहीं — बस समस्या का वर्णन करें और बाकी काम bug_Agent_ संभाल लेगा।

डिस्कॉर्ड समुदाय support@bugagent.com

शुरू करना

bug_Agent_ MCP सर्वर AI क्लाइंट्स को मॉडल कॉन्टेक्स्ट प्रोटोकॉल के माध्यम से बग रिपोर्ट, फीचर अनुरोध, एन्हांसमेंट और बहुत कुछ बनाने, क्वेरी करने और प्रबंधित करने देता है। यह स्थानीय रूप से चलता है और bug_Agent_ के क्लाउड API के साथ संचार करता है।

अपनी API कुंजी प्राप्त करें

app.bugagent.com पर साइन अप करें और कंसोल से एक API कुंजी जनरेट करें।

अपने AI क्लाइंट को कॉन्फ़िगर करें

अपने क्लाइंट के कॉन्फ़िग में bug_Agent_ को MCP सर्वर के रूप में जोड़ें (नीचे सेटअप देखें)।

बग दर्ज करना शुरू करें

प्राकृतिक भाषा में एक बग का वर्णन करें और bug_Agent_ स्वचालित रूप से वर्गीकृत, समृद्ध और संग्रहीत करता है।

त्वरित उदाहरण

# Create a bug report
"File a bug: Login button is unresponsive on iOS Safari.
Steps: tap login, nothing happens. Expected: navigate to
dashboard. Severity: high."

# bugAgent auto-classifies as UI bug, severity high

# File a feature request
"Feature request: Add dark mode toggle to the
settings page. Users have asked for this in surveys."

# Auto-classified as feature-request, severity medium

सेटअप

इंस्टॉल करें

कोई वैश्विक इंस्टॉल आवश्यक नहीं है। मांग पर MCP सर्वर चलाने के लिए npx का उपयोग करें:

npx @bugagent/mcp-server

अपनी API कुंजी कॉन्फ़िगर करें

जब आप पहली बार कनेक्ट करते हैं, तो bug_Agent_ आपसे आपकी API कुंजी मांगेगा। आप इसे एनवायरनमेंट वेरिएबल के माध्यम से भी सेट कर सकते हैं:

export BUGAGENT_API_KEY=ba_live_your_key_here

bug_Agent_ कंसोल से अपनी API कुंजी प्राप्त करें।

MCP क्लाइंट कॉन्फ़िगरेशन

अपने MCP क्लाइंट की कॉन्फ़िगरेशन फ़ाइल में निम्नलिखित जोड़ें:

mcp.json

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

💡

ba_live_your_key_here को कंसोल से अपनी वास्तविक API कुंजी से बदलें।

सर्वर से कनेक्ट करें

bug_Agent_ MCP सर्वर स्ट्रीमेबल HTTP ट्रांसपोर्ट पर https://mcp.bugagent.com/mcp पर लाइव है। नीचे दिए गए आठ क्लाइंट्स में से किसी से भी कनेक्ट करें — वह चुनें जो आपके वर्कफ़्लो में फिट बैठता है।

एक छोटी कॉपी-रेडी कॉन्फ़िगरेशन, स्कोप्ड-की मार्गदर्शन और सुरक्षित स्टार्टर प्रॉम्प्ट के लिए, सार्वजनिक MCP क्विकस्टार्ट का उपयोग करें।

🔑

पहले अपनी API कुंजी प्राप्त करें। सेटिंग्स → डेवलपर्स में साइन इन करें, API कुंजी बनाएं पर क्लिक करें, और मान कॉपी करें (ba_live_ से शुरू होता है)। आप इसे केवल एक बार देखेंगे, इसलिए इसे किसी सुरक्षित स्थान पर पेस्ट करें। नीचे दिया गया हर उदाहरण इस कुंजी का उपयोग करता है।

विकल्प 1 — MCP इंस्पेक्टर (वेब UI, पहली बार परीक्षण के लिए अनुशंसित)

आधिकारिक एंथ्रोपिक टूल। एक स्थानीय वेब UI खोलता है जहाँ आप हर टूल पर क्लिक कर सकते हैं, पैरामीटर भर सकते हैं और प्रतिक्रियाएँ देख सकते हैं। शून्य कॉन्फ़िग, कोई IDE आवश्यक नहीं।

macOS (टर्मिनल)

टर्मिनल

npx @modelcontextprotocol/inspector

विंडोज (PowerShell या CMD)

PowerShell

खुलने वाले ब्राउज़र UI में:

ट्रांसपोर्ट प्रकार: Streamable HTTP चुनें
URL: https://mcp.bugagent.com/mcp
कनेक्शन प्रकार: प्रॉक्सी चुनें (डिफ़ॉल्ट — इंस्पेक्टर ब्राउज़र CORS को बायपास करने के लिए एक स्थानीय Node प्रक्रिया के माध्यम से प्रॉक्सी करता है)
प्रमाणीकरण टैब पर क्लिक करें → एक कस्टम हेडर जोड़ें:
- हेडर नाम: Authorization
- मान: Bearer ba_live_YOUR_KEY_HERE
कनेक्ट पर क्लिक करें। आप बाएं पैनल में सभी 110+ bug_Agent_ टूल देखेंगे।
किसी भी टूल पर क्लिक करें (जैसे list_bug_reports), पैरामीटर भरें, टूल चलाएँ पर क्लिक करें। प्रतिक्रिया दाईं ओर दिखाई देगी।

पूर्वापेक्षाएँ: Node.js 18 या बाद का संस्करण। यदि आपके पास नहीं है तो nodejs.org से इंस्टॉल करें।

विकल्प 2 — Claude डेस्कटॉप (Mac + विंडोज)

यदि आप Claude डेस्कटॉप ऐप का उपयोग करते हैं, तो आप bug_Agent_ को एक स्थायी MCP सर्वर के रूप में जोड़ सकते हैं। तब Claude के पास हर बातचीत में सभी bug_Agent_ टूल उपलब्ध होंगे।

macOS

Claude डेस्कटॉप खोलें → मेनू बार Claude → सेटिंग्स → डेवलपर → कॉन्फ़िग संपादित करें। यह ~/Library/Application Support/Claude/claude_desktop_config.json खोलता है।
mcpServers के अंतर्गत bug_Agent_ प्रविष्टि जोड़ें:
claude_desktop_config.json

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

फ़ाइल सहेजें और Claude डेस्कटॉप को पूरी तरह से छोड़ दें (Cmd+Q, केवल विंडो बंद न करें)।
Claude डेस्कटॉप को पुनः लॉन्च करें। चैट इनपुट के नीचे टूल्स हैमर आइकन को अब bug_Agent_ टूल दिखाना चाहिए।
इसे आज़माएँ: टाइप करें “मेरी 5 सबसे हालिया बग रिपोर्ट सूचीबद्ध करें” — Claude स्वचालित रूप से list_bug_reports को कॉल करेगा।

विंडोज

Claude डेस्कटॉप खोलें → फ़ाइल → सेटिंग्स → डेवलपर → कॉन्फ़िग संपादित करें। यह %APPDATA%\Claude\claude_desktop_config.json खोलता है (आमतौर पर C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json)।
macOS अनुभाग में दिखाया गया वही JSON ब्लॉक जोड़ें।
फ़ाइल सहेजें और Claude डेस्कटॉप को सिस्टम ट्रे से पूरी तरह से छोड़ दें (Claude आइकन पर राइट-क्लिक करें → छोड़ें), फिर पुनः लॉन्च करें।
टूल्स हैमर आइकन bug_Agent_ टूल दिखाएगा।

विकल्प 3 — Claude कोड (CLI)

यदि आप अपने टर्मिनल से Claude कोड (Claude का CLI संस्करण) का उपयोग करते हैं, तो एक कमांड से bug_Agent_ सर्वर पंजीकृत करें। macOS, Linux और विंडोज पर समान रूप से काम करता है।

टर्मिनल / PowerShell

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

फिर अपना Claude कोड सत्र पुनः आरंभ करें। सत्यापित करें कि यह जुड़ा हुआ है:

claude mcp list

आपको सूची में bugagent को हरे बिंदु के साथ देखना चाहिए। किसी भी चैट में टूल का उपयोग शुरू करें: “मुझे इस महीने का अपना अन्वेषण उपयोग दिखाओ।”

बाद में इसे हटाने के लिए:

claude mcp remove bugagent

विकल्प 4 — OpenAI कोडेक्स CLI

यदि आप OpenAI कोडेक्स CLI का उपयोग करते हैं, तो स्थायी पंजीकरण के लिए bug_Agent_ को ~/.codex/config.toml में जोड़ें, या एक बार के सत्र के लिए कॉन्फ़िग इनलाइन पास करें।

स्थायी पंजीकरण (कॉन्फ़िग में जोड़ें)

~/.codex/config.toml

[[mcp_servers]]
name = "bugagent"
type = "http"
url  = "https://mcp.bugagent.com/mcp"

[mcp_servers.headers]
Authorization = "Bearer ba_live_YOUR_KEY_HERE"

इनलाइन — एक सत्र

टर्मिनल

codex \
  --mcp-server '{"name":"bugagent","type":"http","url":"https://mcp.bugagent.com/mcp","headers":{"Authorization":"Bearer ba_live_YOUR_KEY_HERE"}}' \
  "list the last 5 bug reports"

कोडेक्स आपके प्राकृतिक-भाषा प्रॉम्प्ट से टूल कॉल को स्वचालित रूप से हल करता है। आज़माएँ: “गंभीरता के अनुसार क्रमबद्ध मेरे खुले बग सूचीबद्ध करें।”

विकल्प 5 — कर्सर (Mac + विंडोज)

कर्सर में अंतर्निहित MCP समर्थन है। bug_Agent_ को एक बार जोड़ें और कर्सर के अंदर AI असिस्टेंट आपके संपादक को छोड़े बिना बग दर्ज कर सकता है, रिपोर्ट सूचीबद्ध कर सकता है, स्कैन चला सकता है, आदि।

कर्सर खोलें → सेटिंग्स (Mac पर Cmd+, / विंडोज पर Ctrl+,) → बाएं साइडबार में MCP।
+ नया MCP सर्वर जोड़ें पर क्लिक करें।
HTTP ट्रांसपोर्ट प्रकार चुनें।
भरें:
- नाम: bugagent
- URL: https://mcp.bugagent.com/mcp
- हेडर नाम: Authorization
- हेडर मान: Bearer ba_live_YOUR_KEY_HERE
सहेजें पर क्लिक करें। कनेक्ट होने पर कर्सर एक हरा संकेतक दिखाता है।
कर्सर की चैट खोलें (Cmd+L / Ctrl+L) और टाइप करें “'लॉगिन टूटा हुआ' शीर्षक के साथ उच्च गंभीरता वाली एक बग रिपोर्ट बनाएं।” कर्सर create_bug_report को आमंत्रित करेगा।

वैकल्पिक: कर्सर ~/.cursor/mcp.json (Mac) या %USERPROFILE%\.cursor\mcp.json (विंडोज) भी पढ़ता है। Claude डेस्कटॉप अनुभाग में दिखाया गया वही JSON प्रारूप जोड़ें।

विकल्प 6 — कंटिन्यू एक्सटेंशन के साथ VS कोड (Mac + विंडोज)

यदि आप VS कोड पसंद करते हैं, तो कंटिन्यू एक्सटेंशन मूल रूप से MCP सर्वर का समर्थन करता है।

VS कोड मार्केटप्लेस से कंटिन्यू एक्सटेंशन इंस्टॉल करें।
कंटिन्यू का कॉन्फ़िग खोलें: कमांड पैलेट (Cmd+Shift+P / Ctrl+Shift+P) → Continue: Open config.json। फ़ाइल यहाँ है:
- macOS: ~/.continue/config.json
- विंडोज: %USERPROFILE%\.continue\config.json
एक mcpServers प्रविष्टि जोड़ें:
~/.continue/config.json

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

सहेजें। कंटिन्यू ऑटो-रीलोड होगा और साइडबार में bug_Agent_ टूल दिखाएगा।
कंटिन्यू चैट पैनल खोलें और आज़माएँ: “मेरे सुरक्षा स्कैन सूचीबद्ध करें।”

अन्य VS कोड MCP-सक्षम एक्सटेंशन: क्लाइन, रू कोड, और विंडसर्फ (फोर्क) सभी mcpServers कुंजी और HTTP ट्रांसपोर्ट के साथ समान JSON कॉन्फ़िग पैटर्न का पालन करते हैं।

विकल्प 7 — OAuth-जागरूक होस्ट (उदाहरण के रूप में Claude.ai वेब दिखाया गया है)

कुछ MCP होस्ट OAuth 2.0 के माध्यम से प्रमाणित करते हैं और बियरर API कुंजी स्वीकार करने के बजाय पहले से एक स्थिर client_id और client_secret मांगते हैं। उन होस्ट के लिए आप bug_Agent_ डैशबोर्ड से एक कार्यक्षेत्र-स्कोप्ड OAuth क्रेडेंशियल जोड़ी उत्पन्न करते हैं और इसे होस्ट के कनेक्टर फॉर्म में पेस्ट करते हैं। क्रेडेंशियल MCP-होस्ट-अज्ञेयवादी हैं — प्राधिकरण कोड + PKCE का समर्थन करने वाला कोई भी OAuth क्लाइंट उनका उपयोग कर सकता है। नीचे दिया गया वॉकथ्रू सबसे सामान्य उदाहरण के रूप में Claude.ai वेब ऐप का उपयोग करता है।

bug_Agent_ में: सेटिंग्स → डेवलपर्स → MCP कनेक्टर्स खोलें। कनेक्टर जनरेट करें पर क्लिक करें, इसे होस्ट का वर्णन करने वाला नाम दें (जैसे “Claude.ai (कार्य)”), वह रीडायरेक्ट URI पेस्ट करें जो आपका MCP होस्ट मांगता है (Claude.ai वेब ऐप के लिए वह https://claude.ai/api/mcp/auth_callback है — दूसरों के लिए अपने होस्ट के कनेक्टर डॉक्स देखें), और प्रमाणीकरण विधि के लिए गोपनीय चुनें। सफलता स्क्रीन पर एक बार दिखाए गए client_id और client_secret को कॉपी करें।
अपने MCP होस्ट के कनेक्टर / OAuth सेटिंग्स में, पेस्ट करें:
- सर्वर URL: https://mcp.bugagent.com/mcp
- क्लाइंट ID + क्लाइंट सीक्रेट: चरण 1 से
- प्राधिकरण URL: https://mcp.bugagent.com/authorize
- टोकन URL: https://mcp.bugagent.com/token
  विशेष रूप से Claude.ai के लिए: claude.ai/customize/connectors पर जाएं और MCP कनेक्टर जोड़ें पर क्लिक करें।
सहेजें। होस्ट आपको साइन इन करने के लिए bug_Agent_ पर रीडायरेक्ट करता है (Google या ईमेल/पासवर्ड — डैशबोर्ड के लिए आप जो भी विधि उपयोग करते हैं) और सहमति स्वीकृत करता है, फिर OAuth हैंडशेक पूरा करता है।
उसी सेटिंग्स पेज से जनरेट किए गए कनेक्टर्स को प्रबंधित और निरस्त करें। निरस्तीकरण तत्काल है — उस कनेक्टर से अगला अनुरोध invalid_client लौटाता है।

नोट: Claude कोड, कर्सर, VS कोड, और MCP इंस्पेक्टर को इस प्रवाह की आवश्यकता नहीं है — वे गतिशील क्लाइंट पंजीकरण (RFC 7591) को स्वचालित रूप से संभालते हैं और जैसा ऊपर दिखाया गया है API कुंजी के माध्यम से प्रमाणित करते हैं। MCP कनेक्टर्स फॉर्म केवल उन होस्ट के लिए है जिन्हें स्थिर OAuth क्रेडेंशियल की आवश्यकता होती है।

विकल्प 8 — curl के साथ प्रत्यक्ष HTTP (टर्मिनल)

यदि आप बिना किसी क्लाइंट के सीधे सर्वर का परीक्षण करना चाहते हैं, या इसे किसी स्क्रिप्ट में एकीकृत करना चाहते हैं, तो आप curl के साथ HTTP एंडपॉइंट को हिट कर सकते हैं। MCP प्रोटोकॉल स्ट्रीमेबल HTTP पर JSON-RPC 2.0 है।

macOS / Linux

टर्मिनल

# Set your API key as a variable
export BUGAGENT_API_KEY="ba_live_YOUR_KEY_HERE"

# 1. List all available tools
curl -N -s https://mcp.bugagent.com/mcp \
  -H "Authorization: Bearer $BUGAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# 2. Call a tool — list 5 reports from a specific project
curl -N -s https://mcp.bugagent.com/mcp \
  -H "Authorization: Bearer $BUGAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc":"2.0",
    "id":2,
    "method":"tools/call",
    "params":{
      "name":"list_bug_reports",
      "arguments":{"project":"bugagent","limit":5}
    }
  }'

विंडोज (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

प्रतिक्रियाएँ सर्वर-प्रेषित ईवेंट (MCP स्ट्रीमेबल HTTP मानक) के रूप में आती हैं। प्रत्येक खंड data: से उपसर्गित एक पंक्ति है जिसके बाद एक JSON ऑब्जेक्ट है। Accept: application/json, text/event-stream हेडर आवश्यक है — सर्वर इसके बिना अनुरोधों को अस्वीकार करता है।

ℹ️

समस्या निवारण 401 अनधिकृत: जाँचें कि सेटिंग्स → डेवलपर्स में आपकी API कुंजी निरस्त तो नहीं की गई है। कुंजियाँ ba_live_ से शुरू होती हैं। यदि आप अभी भी अटके हुए हैं, तो कुंजी पुनर्जीवित करें और पुनः प्रयास करें।

इसे आज़माएँ — सरल-अंग्रेज़ी प्रॉम्प्ट

एक बार कनेक्ट होने के बाद, आपको टूल के नाम या पैरामीटर जानने की आवश्यकता नहीं है। आप जो चाहते हैं उसे सरल अंग्रेज़ी में वर्णित करें और आपका AI असिस्टेंट स्वचालित रूप से सही bug_Agent_ टूल को कॉल करता है।

बग रिपोर्ट

अपने AI असिस्टेंट से पूछें

List my 5 most recent bug reports
Show all open critical bugs in the Auth project
Create a bug titled "Login broken on Safari" with severity s2
Update TEST-451 status to in-progress and assign it to me
Add a comment to TEST-451: "root cause confirmed — null check missing in auth middleware"
Show me everything filed this week, grouped by severity

परीक्षण प्रबंधन

Create a test suite called "Smoke Tests" with cases for login, checkout, and account settings
Run the Regression suite and list all failures
Use Hermes to execute the curated "Checkout smoke" suite and report every result to bugAgent
Show failing test cases from the last 7 days
Which test cases have never been run in the past 90 days?
Get a pass-rate trend for this month vs last month

सुरक्षा और प्रदर्शन

Run a security scan on https://app.example.com
Get this month's security scan results — show only high and critical findings
Create a performance test for the landing page and check Lighthouse scores
What are the Core Web Vitals for our checkout flow?

प्लेराइट ऑटोमेशन

Create a Playwright script that logs in and verifies the dashboard loads
Run the checkout automation on iPhone 15 Pro on a real device
Optimize the login automation script
Show runs for the checkout automation — any failures?
Schedule the smoke test suite to run every weekday at 6 AM UTC

खोजपूर्ण AI

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

उपयोग और आँकड़े

Check my plan usage for this month
Show team bug stats for this week broken down by severity and type
List all team members and their roles
How many security scans do I have left this month?

त्वरित संदर्भ

सभी आठ क्लाइंट के लिए कॉन्फ़िग फ़ाइल स्थान। प्रत्येक क्लाइंट स्ट्रीमेबल HTTP पर हेडर Authorization: Bearer ba_live_YOUR_KEY_HERE के साथ https://mcp.bugagent.com/mcp से जुड़ता है।

क्लाइंट कॉन्फ़िग स्थान / कमांड

MCP इंस्पेक्टर कोई फ़ाइल नहीं — npx @modelcontextprotocol/inspector के बाद ब्राउज़र UI में URL + प्रमाणीकरण हेडर दर्ज करें

Claude डेस्कटॉप — macOS ~/Library/Application Support/Claude/claude_desktop_config.json

Claude डेस्कटॉप — विंडोज %APPDATA%\Claude\claude_desktop_config.json

Claude कोड (CLI) claude mcp add --transport http bugagent https://mcp.bugagent.com/mcp --header "Authorization: Bearer ba_live_..."

कोडेक्स CLI ~/.codex/config.toml

कर्सर — macOS सेटिंग्स → MCP UI, या ~/.cursor/mcp.json

कर्सर — विंडोज %USERPROFILE%\.cursor\mcp.json

VS कोड + कंटिन्यू ~/.continue/config.json (macOS) / %USERPROFILE%\.continue\config.json (विंडोज)

प्रत्यक्ष HTTP (curl) curl / Invoke-RestMethod — Accept: application/json, text/event-stream शामिल करें

समस्या निवारण

लक्षण समाधान

401 Unauthorized कुंजी गलत, समाप्त या निरस्त है। सेटिंग्स → डेवलपर्स जाँचें — कुंजियाँ ba_live_ से शुरू होती हैं। यदि आवश्यक हो तो पुनर्जीवित करें।

क्लाइंट में टूल नहीं दिख रहे हैं कॉन्फ़िग संपादित करने के बाद क्लाइंट को पूरी तरह से छोड़ें और पुनः लॉन्च करें। Claude डेस्कटॉप में, Cmd+Q (केवल विंडो बंद न करें)। कर्सर में, हरे बिंदु के लिए सेटिंग्स → MCP जाँचें।

Accept header required प्रत्यक्ष HTTP कॉल में Accept: application/json, text/event-stream शामिल होना चाहिए — स्ट्रीमेबल HTTP विनिर्देश के लिए इसकी आवश्यकता है। इसके बिना सर्वर 406 लौटाता है।

गलत कार्यक्षेत्र का डेटा प्रत्येक API कुंजी एक कार्यक्षेत्र के लिए स्कोप्ड है। सेटिंग्स → डेवलपर्स में जिस कार्यक्षेत्र को आप क्वेरी करना चाहते हैं, उससे एक नई कुंजी जनरेट करें।

टूल दिखाई देते हैं लेकिन कॉल चुपचाप विफल हो जाते हैं पुष्टि करें कि सर्वर पहुँच योग्य है: curl -I https://mcp.bugagent.com/health को 200 लौटाना चाहिए। यदि यह समय समाप्त होता है, तो नेटवर्क/फ़ायरवॉल नियम जाँचें।

MCP इंस्पेक्टर CORS त्रुटि इंस्पेक्टर UI में कनेक्शन प्रकार के लिए प्रॉक्सी (प्रत्यक्ष नहीं) चुनें। इंस्पेक्टर ब्राउज़र CORS प्रतिबंधों को बायपास करने के लिए एक स्थानीय Node प्रक्रिया के माध्यम से प्रॉक्सी करता है।

कोडेक्स CLI — टूल पहचाने नहीं गए सत्यापित करें कि ~/.codex/config.toml [[mcp_servers]] (दोहरे कोष्ठक, सरणी सिंटैक्स) का उपयोग करता है। जाँचें कि कोडेक्स CLI संस्करण MCP का समर्थन करने के लिए पर्याप्त हालिया है (codex --version)।

MCP सुविधाएँ

bug_Agent_ MCP सर्वर निम्नलिखित के लिए उपकरण प्रदान करता है:

🐛

बग रिपोर्ट प्रबंधन

create_bug_report — 19 प्रकारों में ऑटो-वर्गीकरण के साथ एक नई रिपोर्ट दर्ज करें — बग, फीचर अनुरोध, संवर्द्धन, तकनीकी ऋण, और अधिक (शीर्षक: 3-500 वर्ण)। वैकल्पिक attachments सरणी प्रत्येक 400 MB तक की बेस64-एन्कोडेड फ़ाइलें स्वीकार करती है: कोई भी छवि, वीडियो, ऑडियो, PDF, या टेक्स्ट/JSON। AI का उपयोग करके विवरण को एक संरचित टेम्पलेट में ऑटो-रीफ़ॉर्मेट करने के लिए format_description: true सेट करें। QA प्रयास को ट्रैक करने के लिए time_spent_seconds पास करें। गंभीरता से स्वतंत्र रूप से समाधान तात्कालिकता सेट करने के लिए priority (urgent / high / normal / low) पास करें। प्रतिक्रिया में project_id, project, short_id, legacy_short_id, और project_short_id शामिल हैं।
list_bug_reports — रिपोर्टों को सूचीबद्ध और फ़िल्टर करें (अधिकतम 100 प्रति पृष्ठ)। प्रोजेक्ट फ़िल्टर पृष्ठांकन से पहले सर्वर-साइड लागू किए जाते हैं। project (UUID, स्लग, सटीक नाम, या टिकट उपसर्ग), project_id, project_slug, project_prefix, workspace (UUID, सटीक नाम, या कार्यक्षेत्र टिकट उपसर्ग), workspace_id/team_id, type (19 डैशबोर्ड श्रेणियों में से एक), severity (s1-s4 या लीगेसी critical/high/medium/low), status (डैशबोर्ड के सटीक मानों का उपयोग करके: new, awaiting-triage, confirmed, in-progress, blocked, resolved, retesting, closed, reopened — हाइफ़न जानबूझकर हैं), resolution (fixed / duplicate / works-as-designed / cannot-reproduce / will-not-fix / need-more-info / unresolved), root_cause (ओपन-एंडेड केबैब-केस टैग — सामान्य मान: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch), या reporter_user_id (रिपोर्ट दर्ज करने वाले टीम सदस्य का UUID) द्वारा फ़िल्टर करें। प्रत्येक परिणाम में reporter_user_id, reporter_name, assigned_to, assignee_name, project_id, project, short_id, legacy_short_id, और project_short_id शामिल हैं ताकि एजेंट लोगों की पहचान कर सकें और सही प्रोजेक्ट-स्कोप्ड रिपोर्ट को अपडेट कर सकें। नाम केवल प्रदर्शन के लिए हैं; ID मानक बने रहते हैं। नाम केवल चयनित कार्यक्षेत्र में सदस्यता के माध्यम से हल किए जाते हैं। रिपोर्ट-पढ़ने के उपकरण सदस्य ईमेल पते उजागर नहीं करते हैं।
pick_next_bug — अगला बग (बग) लौटाता है जिस पर एजेंट लूप को काम करना चाहिए, प्राथमिकता क्रम में (S1 → S2 → S3, प्रत्येक बकेट में सबसे पुराना पहले)। स्वचालित रूप से आपके कार्यक्षेत्र तक सीमित — status new, awaiting-triage, या confirmed और गंभीरता S1-S3 के साथ आपकी टीम के सभी प्रोजेक्टों के टिकट लौटाता है। केवल-पढ़ने के लिए — परमाणु रूप से टिकट का दावा नहीं करता है। वैकल्पिक severity (एकल स्तर), limit (1-50, डिफ़ॉल्ट 1)। उपकरण संयोजन क्षमता के लिए list_bug_reports के समान आकार में पंक्तियाँ लौटाता है। पढ़ें-फिर-दावा करें पैटर्न के लिए claim_bug के साथ जोड़ी बनाएँ।
claim_bug — परमाणु रूप से एक बग को status new, awaiting-triage, या confirmed से status='in-progress' में स्थानांतरित करें, assigned_to को कॉल करने वाले उपयोगकर्ता पर सेट करें, और claimed_at=NOW() पर मुहर लगाएँ। Postgres के UPDATE-WHERE-RETURNING पैटर्न के माध्यम से समवर्ती कॉल करने वालों में रेस-फ्री — यदि दो एजेंट एक ही id पर निकट उत्तराधिकार में claim_bug कॉल करते हैं, तो ठीक एक को बग बॉडी के साथ claimed:true मिलता है और दूसरे को एक कारण स्ट्रिंग के साथ claimed:false मिलता है। सफल प्रतिक्रियाओं में reporter_user_id, reporter_name, assigned_to, और assignee_name शामिल हैं। एक pg_cron रीपर बासी दावों (स्थिति=in-progress + claimed_at > 30 मिनट पुराने) को स्वचालित रूप से वापस new में जारी करता है, इसलिए क्रैश हुए एजेंट के टिकट मैन्युअल हस्तक्षेप के बिना कतार में फिर से प्रवेश करते हैं। इनपुट: id (UUID या संक्षिप्त ID)।
get_bug_report — ID द्वारा किसी रिपोर्ट का पूरा विवरण प्राप्त करें। ID प्रारूप: या तो UUID (जैसे 1fb72a2c-87c7-...), कार्यक्षेत्र-स्कोप्ड संक्षिप्त ID (जैसे WRKID-545), या प्रोजेक्ट-स्कोप्ड संक्षिप्त ID (जैसे WRKID-APP-042) स्वीकार करता है। संक्षिप्त-ID लुकअप टीम-स्कोप्ड हैं — किसी अन्य कार्यक्षेत्र की संक्षिप्त ID का अनुमान लगाने पर 404 लौटता है। reporter_user_id, reporter_name, assigned_to, assignee_name, project_id, project, short_id, legacy_short_id, project_short_id, ticket_number, project_ticket_number, qualityScore (पूर्णांक 1–10), और qualityBreakdown (10 आयाम स्कोर वाली वस्तु: reproductionSteps, expectedVsActual, environmentDetails, evidence, rootCauseAnalysis, impactAssessment, contextAndHistory, heuristicsAndOracles, clarityAndStructure, actionability — प्रत्येक 0.0–1.0) लौटाता है।
update_bug_report — किसी मौजूदा रिपोर्ट पर फ़ील्ड अपडेट करें। UUID या संक्षिप्त ID (WRKID-545) स्वीकार करता है। अपडेट करने योग्य फ़ील्ड में title, description, type (19 डैशबोर्ड श्रेणियों में से कोई भी), severity, priority (urgent / high / normal / low — समाधान तात्कालिकता, गंभीरता से स्वतंत्र), status (डैशबोर्ड से बिल्कुल मेल खाता है: new, awaiting-triage, confirmed, in-progress, blocked, resolved, retesting, closed, reopened — हाइफ़न जानबूझकर हैं), resolution (fixed / duplicate / works-as-designed / cannot-reproduce / will-not-fix / need-more-info / unresolved), और root_cause (ओपन-एंडेड केबैब-केस टैग — सामान्य मान: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch) शामिल हैं। एजेंट-लूप कन्वेंशन के लिए आवश्यक है कि जब भी status new से बाहर संक्रमण करे तो resolution और root_cause दोनों सेट किए जाएं; डैशबोर्ड, एनालिटिक्स, और भविष्य का claude-bot प्रशिक्षण कॉर्पस सभी उन फ़ील्ड पर निर्भर करते हैं। इसमें assigned_to (रिपोर्ट रीड द्वारा लौटाई गई उपयोगकर्ता ID का उपयोग करें; OAuth सत्र list_team_members भी कॉल कर सकते हैं) और टाइमर ट्रैकिंग के लिए time_spent_seconds भी शामिल है। assigned_to बदलने से स्वचालित रूप से इन-ऐप बेल सूचना और नए असाइनी को एक शिष्टाचार ईमेल ट्रिगर होता है (खाता सेटिंग में उनके प्रति-उपयोगकर्ता ऑप्ट-आउट का सम्मान करते हुए — डैशबोर्ड एंडपॉइंट के समान पाइपलाइन)।
add_comment — बग रिपोर्ट में एक टिप्पणी जोड़ें (UUID या संक्षिप्त ID, मुख्य भाग 1-10000 वर्ण)। यदि रिपोर्ट Jira से सिंक है, तो टिप्पणी स्वचालित रूप से लिंक किए गए Jira मुद्दे पर पुश कर दी जाती है।
list_comments — किसी रिपोर्ट का पूर्ण टिप्पणी सूत्र सूचीबद्ध करें, सबसे पुराना पहले — प्रत्येक टिप्पणी लेखक के नाम, parentId (थ्रेडेड उत्तर), और टाइमस्टैम्प के साथ। टिप्पणियाँ get_bug_report का हिस्सा नहीं हैं, इसलिए इस तरह आप टिकट की चर्चा पढ़ते हैं। UUID या संक्षिप्त ID स्वीकार करता है।
link_bug_reports — एक ही कार्यक्षेत्र में दो बग रिपोर्टों के बीच एक दिशात्मक सिमेंटिक लिंक बनाएँ। link_type duplicate-of, parent-of, related-to, depends-on, या testing-blocked-by में से एक है। व्युत्क्रम परिप्रेक्ष्य (duplicated-by / subtask-of / blocks / blocks-testing) पढ़ने के समय प्राप्त होते हैं — केवल एक पंक्ति संग्रहीत करने की आवश्यकता होती है। from_report_id और to_report_id दोनों UUID या संक्षिप्त ID (WRKID-545) स्वीकार करते हैं।
unlink_bug_reports — पहले से बनाए गए बग-रिपोर्ट लिंक को उसके UUID (link_id, link_bug_reports या list_bug_report_links द्वारा लौटाया गया) द्वारा हटाएँ।
list_bug_report_links — किसी बग रिपोर्ट को छूने वाले प्रत्येक उपयोगकर्ता-क्यूरेटेड लिंक को सूचीबद्ध करें। प्रत्येक लिंक को आपूर्ति की गई रिपोर्ट के परिप्रेक्ष्य से पढ़े जाने पर लौटाता है — उदा. एक संग्रहीत duplicate-of पंक्ति जहाँ यह रिपोर्ट लक्ष्य है, duplicated-by के रूप में प्रस्तुत होती है; parent-of जहाँ यह रिपोर्ट लक्ष्य है, subtask-of के रूप में प्रस्तुत होती है; depends-on जहाँ यह रिपोर्ट लक्ष्य है, blocks के रूप में प्रस्तुत होती है; testing-blocked-by जहाँ यह रिपोर्ट लक्ष्य है, blocks-testing के रूप में प्रस्तुत होती है। related-to सममित है। get_bug_report द्वारा लौटाए गए ऑटो-डिटेक्टेड similar_reports फ़ील्ड का पूरक है।
classify_bug — एक विवरण को 19 रिपोर्ट प्रकारों (बग, फीचर्स, संवर्द्धन, आदि) में से एक में विश्वास स्कोर के साथ वर्गीकृत करें
flush_reports — पुरानी रिपोर्टों का बल्क विलोपन (केवल व्यवस्थापक)

📊

उपयोग और विश्लेषिकी

get_usage — योजना सीमाओं के विरुद्ध उपयोग की जाँच करें
get_stats — दैनिक गणना, प्रकार/गंभीरता/स्थिति विश्लेषण

📁

परियोजना प्रबंधन

list_projects — id, name, slug, ticket_prefix, विवरण और डिफ़ॉल्ट स्थिति के साथ उपलब्ध परियोजनाओं की सूची बनाएं। सही परियोजना को लक्षित करने के लिए create_bug_report और list_bug_reports के साथ उन मानों का उपयोग करें।
create_project — एक नई परियोजना बनाएँ (यदि पहली है तो ऑटो-डिफ़ॉल्ट बन जाती है)
delete_project — किसी परियोजना और सभी संबद्ध डेटा (बग रिपोर्ट, ऑटोमेशन, परीक्षण मामले, मोबाइल ऐप्स, शेड्यूल, जियो स्नैप, नोट्स, समय प्रविष्टियाँ) को स्थायी रूप से हटाएँ। केवल स्वामी/प्रबंधक। अंतिम परियोजना नहीं हटा सकते। संग्रहण स्वचालित रूप से मुक्त हो जाता है
export_okf_bundle — किसी परियोजना के QA ज्ञान — बग रिपोर्ट, परीक्षण मामले, ऑटोमेशन, और प्रदर्शन, सुरक्षा, और खोजपूर्ण परीक्षण — को OKF/OQA मार्कडाउन बंडल (oqa.ai द्वारा उपयोग किया जाने वाला ओपन क्वेरी एजेंट प्रारूप) के रूप में निर्यात करें। सक्रिय परियोजना पर डिफ़ॉल्ट; किसी भिन्न को निर्यात करने के लिए वैकल्पिक project (स्लग या नाम) पास करें। बंडल में फ़ाइलों की सूची और साथ ही बंडल को बेस64-एन्कोडेड ज़िप के रूप में लौटाता है

🔐

प्रमाणीकरण और खाता

register_account — एक नया खाता बनाएँ (पासवर्ड: 8-128 वर्ण, दर सीमित: 5/15मिनट)
login — साइन इन करें और एक्सेस टोकन प्राप्त करें (दर सीमित: 5/15मिनट)
update_profile — प्रदर्शन नाम अपडेट करें
change_password — खाता पासवर्ड बदलें
get_settings / update_settings — प्राथमिकताएँ प्रबंधित करें

🔑

API कुंजी प्रबंधन

generate_api_key — एक नामित API कुंजी बनाएँ
list_api_keys — सक्रिय कुंजियाँ सूचीबद्ध करें (केवल उपसर्ग)
regenerate_api_key — एक कुंजी निरस्त करें और बदलें
delete_api_key — एक कुंजी स्थायी रूप से निरस्त करें

👥

टीम प्रबंधन

list_team_members — भूमिकाओं, स्थिति और बूस्टर फ़्लैग के साथ अपने कार्यक्षेत्र के सभी सदस्यों को सूचीबद्ध करें
invite_team_member — ईमेल द्वारा किसी उपयोगकर्ता को आमंत्रित करें (प्रबंधक योगदानकर्ताओं और प्रबंधकों को आमंत्रित कर सकते हैं; केवल स्वामी ही व्यवस्थापकों को आमंत्रित कर सकते हैं)। 5-दिन की समाप्ति लिंक

🎯

एकीकरण

sync_to_jira — टीम के साझा कनेक्शन का उपयोग करके Jira में रिपोर्ट सिंक करें
push_to_claude — बग रिपोर्ट के लिए डेवलपर नोट्स जनरेट (या पुनर्जनरेट) करें — मूल कारण, सुझाया गया समाधान, सत्यापन चरण, और जोखिम आकलन। UUID या छोटी ID स्वीकार करता है (WRKID-545)। प्लेटफ़ॉर्म कुंजियों का उपयोग करता है — प्रति-टीम Claude कनेक्शन की आवश्यकता नहीं है। एक अनुकूली श्रृंखला चलाता है: s3/medium या s4/low बग पर तीन चरण (Sonnet ड्राफ्ट → OpenAI gpt-5 समालोचना → Sonnet संश्लेषण), शीर्ष-दो गंभीरता बकेट — s1/critical या s2/high — पर पाँच चरण (ड्राफ्ट → समालोचना → Sonnet खंडन → Claude Opus निर्णायक जो पूर्ण प्रतिलेख पढ़ता है और स्वतंत्र निर्णय के साथ अंतिम नोट्स लिखता है)। प्रतिक्रिया हर दौर को उजागर करती है: analysis, draft, critique, rebuttal, challenger_model, adjudicator_model, और एक debated फ़्लैग। कोई भी चरण विफल होने पर अगले-सर्वोत्तम उत्तर पर आ जाता है। बग निर्माण पर स्वतः-सक्रिय होता है; आमतौर पर केवल मैन्युअल पुनर्जनन के लिए बुलाया जाता है।
analyze_fix_area — डेवलपर नोट्स के "संभावित समाधान क्षेत्र" उप-खंड को जनरेट (या पुनर्जनरेट) करें — एक संकीर्ण Sonnet आउटपुट जो बताता है कि कोडबेस में समाधान सबसे अधिक संभावित रूप से कहाँ है। UUID या छोटी ID स्वीकार करता है। प्लेटफ़ॉर्म Anthropic कुंजी का उपयोग करता है। जब टीम के पास github_connections पंक्ति हो और प्रोजेक्ट में github_repo मैप किया गया हो, तो आउटपुट कनेक्टेड रिपो से वास्तविक फ़ाइल स्निपेट पर आधारित होता है; अन्यथा रिपो कनेक्ट करने के लिए प्रोत्साहन के साथ सामान्य मार्गदर्शन पर वापस आ जाता है। likely_fix_area टेक्स्ट, generated_at, repo_used, और एक grounded फ़्लैग लौटाता है। बग निर्माण पर स्वतः-सक्रिय होता है — एजेंटों को आमतौर पर केवल मैन्युअल पुनर्जनन के लिए इसे कॉल करने की आवश्यकता होती है।
upgrade_plan — टीम या एंटरप्राइज़ के लिए बिक्री-सहायता नामांकन लिंक प्राप्त करें

⚡

प्रदर्शन परीक्षण

create_performance_test — URL, डिवाइस, वर्चुअल उपयोगकर्ता, अवधि, स्कोर सीमा, और ऑटो-बग निर्माण टॉगल के साथ एक प्रदर्शन परीक्षण कॉन्फ़िगरेशन बनाएँ। केवल एंटरप्राइज़
run_performance_test — एक वेब प्रदर्शन परीक्षण के लिए पृष्ठ ऑडिट और लोड परीक्षण ट्रिगर करें। परिणामों के लिए पोल करने हेतु एक रन ID लौटाता है। मोबाइल ऐप प्रोफाइलिंग रन डैशबोर्ड से ट्रिगर किए जाते हैं
get_performance_results — Lighthouse स्कोर (प्रदर्शन, सुलभता, सर्वोत्तम अभ्यास, SEO), कोर वेब वाइटल्स (LCP, FID, CLS, FCP, TTFB, INP, TBT, SI), और लोड परीक्षण मेट्रिक्स (VUs, अनुरोध, RPS, p50/p90/p95/p99 विलंबता) सहित पूर्ण परिणाम प्राप्त करें
list_performance_tests — वर्तमान टीम के लिए सभी प्रदर्शन परीक्षण कॉन्फ़िगरेशन सूचीबद्ध करें
get_performance_usage — मासिक प्रदर्शन परीक्षण उपयोग की जाँच करें। प्रदर्शन परीक्षण केवल एंटरप्राइज़ है। मुफ़्त=0, एंटरप्राइज़=असीमित

उदाहरण कार्यप्रवाह

get_performance_usage → शेष कोटा जाँचें
create_performance_test → अपने URL के लिए एक परीक्षण कॉन्फ़िगर करें
run_performance_test → ऑडिट + लोड परीक्षण ट्रिगर करें
get_performance_results → स्कोर और वाइटल्स की समीक्षा करें

🛡

सुरक्षा स्कैनिंग

create_security_scan — एक सुरक्षा स्कैन कॉन्फ़िगरेशन बनाएँ। वेब स्कैन तीन गहराई स्तरों और वैकल्पिक प्रमाणीकृत स्कैनिंग के साथ क्विक स्कैनर + Nuclei (4,000+ टेम्पलेट) का उपयोग करते हैं। मोबाइल स्कैन APK/IPA बाइनरी विश्लेषण के लिए MobSF का उपयोग करते हैं। गंभीरता सीमा के साथ कॉन्फ़िगर करने योग्य ऑटो-बग निर्माण। केवल एंटरप्राइज़
run_security_scan — एक भेद्यता स्कैन ट्रिगर करें। वेब स्कैन के लिए DNS डोमेन सत्यापन आवश्यक है। मोबाइल स्कैन के लिए अपलोड किए गए ऐप की आवश्यकता होती है। परिणामों के लिए पोल करने हेतु एक रन ID लौटाता है
get_security_results — सुरक्षा स्कोर (0-100), CWE संदर्भों, OWASP मैपिंग, साक्ष्य, और उपचार मार्गदर्शन के साथ गंभीरता (क्रिटिकल, हाई, मीडियम, लो, जानकारी) द्वारा वर्गीकृत निष्कर्षों सहित पूर्ण परिणाम प्राप्त करें
list_security_scans — अंतिम स्कोर और प्रमाणीकरण/गहराई बैज के साथ वर्तमान टीम के लिए सभी सुरक्षा स्कैन कॉन्फ़िगरेशन सूचीबद्ध करें
get_security_usage — मासिक सुरक्षा स्कैन उपयोग की जाँच करें। सुरक्षा स्कैनिंग केवल एंटरप्राइज़ है। एंटरप्राइज़=असीमित
list_security_schedules — क्रॉन, समयक्षेत्र, सक्षम स्थिति, अगला रन, और अधिसूचना सेटिंग्स के साथ टीम के लिए सभी निर्धारित सुरक्षा स्कैन सूचीबद्ध करें। मूल स्कैन कॉन्फ़िग (नाम, scan_type, target_url) के साथ जुड़ता है
create_security_schedule — एक सुरक्षा स्कैन के लिए आवर्ती शेड्यूल बनाएँ। scan_id और cron_expression की आवश्यकता है। प्रति स्कैन कॉन्फ़िग एक शेड्यूल। वैकल्पिक timezone, notify_on_fail (कोई नहीं/ईमेल/slack/दोनों), notify_email, slack_channel_id। प्रत्येक रन आपकी मासिक सीमा में गिना जाता है; व्यवस्थापक उपयोगकर्ता सीमा को बायपास करते हैं। स्कैन गहराई हमेशा रन समय पर स्कैन कॉन्फ़िग से पढ़ी जाती है
delete_security_schedule — एक निर्धारित सुरक्षा स्कैन हटाएँ। मूल स्कैन कॉन्फ़िग या पूर्ण रन को प्रभावित नहीं करता

get_security_usage → शेष कोटा जाँचें
create_security_scan → अपने URL या रिपो के लिए एक स्कैन कॉन्फ़िगर करें
run_security_scan → एक बार का भेद्यता स्कैन ट्रिगर करें
create_security_schedule → आवर्ती रन स्वचालित करें (जैसे मुख्य शाखा पर साप्ताहिक SAST)
get_security_results → निष्कर्षों और उपचार की समीक्षा करें

📖

कोड समीक्षा

list_code_reviews — टीम के लिए हाल की AI कोड समीक्षाएँ सूचीबद्ध करें। गुणवत्ता स्कोर, गंभीरता गणना, PR जानकारी, और टाइमस्टैम्प लौटाता है। केवल एंटरप्राइज़
get_code_review — सभी निष्कर्षों के साथ एक कोड समीक्षा प्राप्त करें। प्रत्येक निष्कर्ष में गंभीरता, श्रेणी (बग/सुरक्षा/प्रदर्शन/शैली/तर्क/रखरखाव), शीर्षक, विवरण, कोड सुझाव, फ़ाइल पथ, और पंक्ति संख्याएँ शामिल हैं
get_code_review_usage — कोड समीक्षा उपयोग की जाँच करें। AI कोड समीक्षा केवल एंटरप्राइज़ है; एंटरप्राइज़ पर असीमित
get_code_review_analytics — समीक्षा विश्लेषण प्राप्त करें: रुझान, निष्कर्ष श्रेणियाँ/स्रोत, गंभीरता विश्लेषण, वेग मेट्रिक्स, शीर्ष रिपो/लेखक। 7/30/90-दिन की पूर्वव्यापी अवधि का समर्थन करता है

get_code_review_usage → शेष समीक्षाएँ जाँचें
/dashboard/code-review पर डैशबोर्ड में एक PR की समीक्षा करें
list_code_reviews → हाल की समीक्षाएँ देखें
get_code_review → निष्कर्ष और सुझाव प्राप्त करें

🔍

खोजपूर्ण AI

10 समानांतर एजेंटों तक के साथ बहु-एजेंट स्वायत्त वेबसाइट बग खोजक, प्रत्येक एक अलग परीक्षण रणनीति का उपयोग करता है।

list_explorations — टीम के लिए खोजपूर्ण AI कॉन्फ़िग सूचीबद्ध करें
create_exploration — एक नया अन्वेषण बनाएँ। अद्वितीय रणनीतियों के साथ कई समानांतर एजेंट चलाने के लिए agent_count (1–10, अधिकतम 10) स्वीकार करता है: happy_path, edge_case, security, accessibility, error_path, performance, mobile, data_integrity, navigation, custom
get_exploration — एजेंट सेटिंग्स और हाल के रन के साथ अन्वेषण कॉन्फ़िग प्राप्त करें
get_exploration_run — प्रति-एजेंट प्रगति, चरण डेटा, एजेंट एट्रिब्यूशन के साथ निष्कर्ष (agent_index, agent_strategy), और लिंक किए गए बग के साथ रन परिणाम प्राप्त करें
get_exploration_usage — मासिक उपयोग की जाँच करें। खोजपूर्ण AI केवल एंटरप्राइज़ है; एंटरप्राइज़: असीमित (10 एजेंट)

create_exploration के साथ agent_count: 5 → 5 समानांतर एजेंट कॉन्फ़िगर करें
डैशबोर्ड से या POST /api/explorations/run के माध्यम से एक रन ट्रिगर करें
get_exploration_run → प्रति-एजेंट प्रगति और निष्कर्षों के लिए पोल करें
डैशबोर्ड में एजेंट एट्रिब्यूशन के साथ डुप्लिकेट-मुक्त निष्कर्ष देखें

📝

नोट्स

list_notes — वैकल्पिक कीवर्ड खोज, प्रोजेक्ट फ़िल्टर, लेखक फ़िल्टर, और दिनांक सीमा के साथ नोट्स सूचीबद्ध करें। उपयोगकर्ता के स्वामित्व वाले नोट्स या टीम के भीतर साझा नोट्स लौटाता है।
create_note — 5 प्रारूपों में से एक में एक नोट बनाएँ: markdown, plain_text, rich_text, checklist, outline। visibility को private या shared पर सेट करें। यदि कोई शीर्षक प्रदान नहीं किया गया है तो पहले 30 अक्षरों से ऑटो-शीर्षक। वैकल्पिक attachments सरणी प्रत्येक 400 MB तक की base64-एन्कोडेड फ़ाइलें स्वीकार करती है: कोई भी छवि, वीडियो, ऑडियो, PDF, या टेक्स्ट/JSON। QA प्रयास को ट्रैक करने के लिए time_spent_seconds पास करें।
get_note — सामग्री और अनुलग्नकों सहित पूर्ण नोट विवरण प्राप्त करें। id की आवश्यकता है।
update_note — शीर्षक, सामग्री, प्रारूप, दृश्यता, प्रोजेक्ट, या time_spent_seconds अपडेट करें। नोट के मौजूदा अनुलग्नकों को बदले बिना नई फ़ाइलें (प्रत्येक अधिकतम 400 MB) जोड़ने के लिए एक attachments सरणी पास करें। केवल लेखक अपडेट कर सकता है। id की आवश्यकता है।
delete_note — एक नोट और उसके अनुलग्नकों को स्थायी रूप से हटाएँ। केवल लेखक हटा सकता है। id की आवश्यकता है।

create_note → एक परीक्षण सत्र नोट शुरू करें
update_note → परीक्षण करते समय अवलोकन जोड़ें
list_notes → कीवर्ड या प्रोजेक्ट द्वारा पिछले नोट्स खोजें
get_note → अनुलग्नकों के साथ पूर्ण नोट प्राप्त करें

🤖

स्वचालन

create_automation — एक कस्टम Playwright स्क्रिप्ट के साथ एक नया ऑटोमेशन बनाएँ (FAB रिकॉर्डिंग की आवश्यकता नहीं है)। name आवश्यक है। वैकल्पिक: target_url (यदि छोड़ा गया तो स्क्रिप्ट में पहले page.goto(...) URL से स्वतः-व्युत्पन्न), script (Node.js/JavaScript/TypeScript या Python — भाषा स्वतः-पहचानी जाती है; डिफ़ॉल्ट रूप से एक प्लेसहोल्डर), status (draft या active, डिफ़ॉल्ट: draft), project_id। ऑटोमेशन id लौटाता है। टीम प्लान आवश्यक है। सुझाव — एक ऑटोमेशन की नकल करें: मूल स्क्रिप्ट प्राप्त करने के लिए get_automation का उपयोग करें, फिर create_automation को name के साथ "[Copy] Original Name" पर सेट करके कॉल करें और मूल script, target_url, और project_id पास करें। नकल बिना किसी संस्करण इतिहास के draft स्थिति में शुरू होती है।
list_automations — Playwright ऑटोमेशन स्क्रिप्ट की सूची बनाएँ। project_id या status (draft, active, paused) द्वारा फ़िल्टर करें। नाम, target_url, last_run_status, और run_count के साथ ऑटोमेशन की सरणी लौटाता है।
get_automation — Playwright स्क्रिप्ट और हाल के रन सहित पूर्ण ऑटोमेशन विवरण प्राप्त करें। id आवश्यक है। लाइव script, एक script_versions स्टैक (सबसे पुराना-पहले, 100 पूर्व प्रविष्टियों तक, प्रत्येक { script, source, timestamp }), और एक recent_runs सरणी के साथ ऑटोमेशन लौटाता है जहाँ प्रत्येक रन में script_version_label/script_version_source होता है जिसने निष्पादित किया। यदि आपको एक विशिष्ट ऐतिहासिक संस्करण चुनने की आवश्यकता है तो run_automation से पहले इसे कॉल करें।
run_automation — Playwright परीक्षण का तत्काल रन ट्रिगर करें। automation_id आवश्यक है। स्व-उपचार लोकेटर (स्वचालित): जब कोई लोकेटर क्रिया समय समाप्त हो जाती है, तो रनर Claude से एक कार्यशील चयनकर्ता मांगता है और चरण का एक बार पुनः प्रयास करता है — अभिकथन कभी भी ठीक नहीं होते हैं, इसलिए वास्तविक प्रतिगमन अभी भी विफल होते हैं — और प्रत्येक उपचार रन stdout में लॉग किया जाता है। वर्चुअल मोड (डिफ़ॉल्ट): व्यूपोर्ट अनुकरण के लिए वैकल्पिक device (जैसे desktop, iphone-15)। लाइव मोड: एक वास्तविक डेस्कटॉप ब्राउज़र पर चलाने के लिए browserstack: true को bs_browser (chrome, firefox, safari, edge), bs_os (Windows, OS X), और bs_os_version के साथ सेट करें। लाइव रियल-मोबाइल: bs_os: "android" (डिवाइस: "Samsung Galaxy S25 Ultra", "Google Pixel 10", "OnePlus 13R") या bs_os: "ios" (डिवाइस: "iPhone 17 Pro Max", "iPhone 16 Pro Max", "iPhone 15 Pro Max") सेट करें और डिवाइस का नाम bs_os_version में पास करें। Node.js स्क्रिप्ट browserstack-node-sdk के माध्यम से रूट होती हैं (डेस्कटॉप + Android + iPhone को कवर करता है)। Python स्क्रिप्ट browserstack-sdk (pytest-playwright) के माध्यम से रूट होती हैं और केवल डेस्कटॉप को कवर करती हैं — Python के माध्यम से वास्तविक मोबाइल समर्थित नहीं है क्योंकि pytest-playwright का browser_type.connect() BrowserStack के रियल-मोबाइल एंडपॉइंट को ड्राइव नहीं कर सकता है। वीडियो और नेटवर्क लॉग स्वचालित रूप से कैप्चर किए जाते हैं; कंसोल लॉग केवल डेस्कटॉप। संस्करण रीप्ले: ऑटोमेशन के script_versions इतिहास से पूर्व प्रविष्टि निष्पादित करने के लिए वैकल्पिक version_index (पूर्णांक, 0-अनुक्रमित) पास करें। डिफ़ॉल्ट: जब version_index छोड़ा गया या शून्य है, तो वर्तमान लाइव स्क्रिप्ट चलती है — केवल "वर्तमान चुनें" के लिए प्लेसहोल्डर मान पास न करें। सीमा से बाहर, ऋणात्मक, या गैर-पूर्णांक मान अस्वीकार कर दिए जाते हैं। रन रिकॉर्ड उस सटीक स्नैपशॉट को संग्रहीत करता है जो चला, और किसी विफल रन से स्वतः-निर्मित कोई भी बग रिपोर्ट संपादक में उस संस्करण से डीप-लिंक करती है।
list_automation_runs — किसी ऑटोमेशन के लिए हाल के रन की सूची बनाएँ। automation_id आवश्यक है। स्थिति, duration_ms, और error_message के साथ रन लौटाता है।
list_schedules — क्रॉन, समयक्षेत्र, डिवाइस और अधिसूचना सेटिंग्स के साथ सभी निर्धारित वेब ऑटोमेशन रन की सूची बनाएँ
create_schedule — एक निर्धारित वेब ऑटोमेशन रन बनाएँ। automation_id और cron_expression आवश्यक है। डिवाइस, समयक्षेत्र, notify_on_fail (ईमेल/स्लैक/दोनों), और स्लैक चैनल विकल्पों का समर्थन करता है। निर्धारित रन पर BrowserStack लाइव: browserstack: true को bs_browser, bs_os, और bs_os_version के साथ पास करें — run_automation के समान डिवाइस मैट्रिक्स (Node = डेस्कटॉप + वास्तविक Android + वास्तविक iPhone; Python = केवल डेस्कटॉप)।
delete_schedule — एक निर्धारित वेब ऑटोमेशन रन हटाएँ
list_mobile_schedules — डिवाइस, क्रॉन, समयक्षेत्र और अधिसूचनाओं के साथ सभी निर्धारित मोबाइल ऑटोमेशन रन की सूची बनाएँ
create_mobile_schedule — वास्तविक उपकरणों पर एक निर्धारित मोबाइल ऑटोमेशन रन बनाएँ। automation_id, cron_expression, और devices सरणी आवश्यक है
delete_mobile_schedule — एक निर्धारित मोबाइल ऑटोमेशन रन हटाएँ
optimize_automation_script — AI-संचालित अनुकूलन के लिए Sonnet 4 को एक Playwright स्क्रिप्ट भेजें। एक 12-बिंदु चेकलिस्ट लागू करता है जो चयनकर्ताओं, प्रतीक्षा रणनीतियों, अभिकथनों, त्रुटि प्रबंधन, प्रमाणीकरण पैटर्न, मोबाइल संगतता और सख्त मोड को ठीक करता है। automation_id आवश्यक है। वर्तमान स्क्रिप्ट संस्करण अनुकूलन से पहले सहेजा जाता है। अनुकूलित स्क्रिप्ट और परिवर्तनों का सारांश लौटाता है।
undo_automation_script — एक ऑटोमेशन स्क्रिप्ट को उसके पिछले संस्करण पर वापस लाएँ। अधिकतम 10 पिछले संस्करण बनाए रखे जाते हैं। automation_id आवश्यक है। पुनर्स्थापित स्क्रिप्ट और शेष संस्करणों की संख्या लौटाता है।

create_automation → एक कस्टम स्क्रिप्ट के साथ परीक्षण बनाएँ
list_automations → उपलब्ध परीक्षण ब्राउज़ करें
get_automation → Playwright स्क्रिप्ट का निरीक्षण करें
run_automation → परीक्षण ट्रिगर करें
list_automation_runs → परिणाम और अवधि जाँचें

⏱️

समय ट्रैकिंग

list_time_entries — टीम के लिए समय प्रविष्टियाँ सूचीबद्ध करें। period (today, week, month, all), project_id, category, और sort (newest, oldest, most_time, least_time) द्वारा फ़िल्टर करें। केवल टीम प्लान।
create_time_entry — QA कार्यों पर बिताया गया समय लॉग करें। description, category, और duration_minutes आवश्यक है। वैकल्पिक रूप से project_id और entry_date सेट करें (आज का दिन डिफ़ॉल्ट है)। केवल टीम प्लान।
update_time_entry — मौजूदा समय प्रविष्टि अपडेट करें। id आवश्यक है। description, category, duration_minutes, project_id, या entry_date अपडेट कर सकते हैं। केवल टीम प्लान।
delete_time_entry — एक समय प्रविष्टि स्थायी रूप से हटाएँ। id आवश्यक है। केवल टीम प्लान।

create_time_entry → प्रतिगमन परीक्षण के 45 मिनट लॉग करें
list_time_entries → इस सप्ताह की समय प्रविष्टियाँ देखें
update_time_entry → अवधि या श्रेणी समायोजित करें
delete_time_entry → एक गलत प्रविष्टि हटाएँ

☑️

परीक्षण मामले

पदानुक्रमित फ़ोल्डरों, नेस्टेड सूट (रन पर उप-सूट ऑटो-विस्तार के साथ 3 स्तर तक गहरे), ड्रैग-ड्रॉप पुनर्क्रम, और KPI रुझानों, विफलता विश्लेषण, सूट स्वास्थ्य, कवरेज और परीक्षक उत्पादकता के साथ एक विश्लेषण रिपोर्ट टैब के साथ परीक्षण प्रबंधन। सभी उपकरण सीधे Supabase को कॉल करते हैं — कोई HTTP राउंडट्रिप नहीं, डैशबोर्ड के समान विलंबता।

मुफ्त सीमाएँ: 10 संग्रहीत परीक्षण मामले, 1 सूट, 3 फ़ोल्डर, प्रति मामला 128 KB संरचित सामग्री, 2 सक्रिय कार्यक्षेत्र API कुंजियाँ, और प्रति UTC कैलेंडर माह 10 कुल परीक्षण रन। उनमें से 3 रन तक Hermes या किसी अन्य बाहरी एजेंट का उपयोग कर सकते हैं, जिसमें 1 सक्रिय बाहरी रन और प्रत्येक बाहरी योजना में अधिकतम 10 मामले हों। मुफ्त API-कुंजी MCP ट्रैफ़िक प्रति कुंजी 30 अनुरोध और प्रति कार्यक्षेत्र प्रति मिनट 60 तक सीमित है। टीम और एंटरप्राइज़ परीक्षण मामला भंडारण और रन असीमित हैं, सामान्य प्लेटफ़ॉर्म सुरक्षा के अधीन।

AI परीक्षण-मामला निर्माण, AI टैग सुझाव, Figma आयात, और परीक्षण-मामला फ़ाइल अनुलग्नकों के लिए टीम या एंटरप्राइज़ आवश्यक है। 128 KB मुफ्त संरचित-सामग्री सीमा भुगतान किए गए फ़ाइल अनुलग्नकों से अलग है। मुफ्त URL संदर्भ संग्रहीत कर सकता है। कोर MCP परीक्षण-मामला उपकरण ऊपर की सीमाओं के भीतर मुफ्त पर उपलब्ध रहते हैं।

हैंड्स-फ्री निष्पादन: रन समीक्षा पृष्ठ एक कैरोसेल है जिसमें एक समय में एक मामला दिखाई देता है, कीबोर्ड शॉर्टकट (P पास · F फेल · B ब्लॉक · S स्किप), और ध्वनि नियंत्रण। माइक क्लिक करें, फिर "पास", "फेल", "ब्लॉक", "स्किप", "नेक्स्ट", "प्रीवियस", "नोट्स जोड़ें" (नोट्स फ़ील्ड में ट्रांसक्राइब करता है), "नोट्स सेव करें", या "वॉइस ऑफ" कहें। सफलता परिणामों पर अगले अनुपयोगी मामले पर ऑटो-एडवांस; फेल होने पर रुक जाता है ताकि परीक्षक विवरण निर्देशित कर सकें और बग उत्पन्न कर सकें। Chrome, Edge और Safari में काम करता है।

मामले और फ़ोल्डर

list_test_cases — वैकल्पिक search, priority (critical, high, medium, low), type (functional, regression, smoke, integration, performance, security, usability, exploratory), status (active, draft, deprecated), और sort (newest, oldest, name, priority) के साथ परीक्षण मामलों की सूची बनाएँ।
create_test_case — एक परीक्षण मामला बनाएँ। दो टेम्पलेट प्रकार: steps (डिफ़ॉल्ट) — steps सरणी के माध्यम से प्रति-चरण { action, expected } ग्रिड; text — text_content के माध्यम से एकल मुक्त-रूप विवरण। दोनों फ़ील्ड एक ही कॉल में भेजे जा सकते हैं (प्लेटफ़ॉर्म उन्हें स्वतंत्र रूप से संग्रहीत करता है ताकि बाद में template_type स्विच करने वाला परीक्षक किसी भी पक्ष का डेटा न खोए)। वैकल्पिक urls सरणी (अधिकतम 10 http/https URL) संदर्भ लिंक संलग्न करती है और मुफ्त पर उपलब्ध है। name आवश्यक है। वैकल्पिक: description, preconditions, template_type, steps, text_content, urls, priority, type, tags, estimated_time (सेकंड)। फ़ाइल अनुलग्नकों के लिए टीम या एंटरप्राइज़ आवश्यक है और डैशबोर्ड के POST /api/test-cases/:id/attachments एंडपॉइंट (मल्टीपार्ट) के माध्यम से अपलोड किए जाते हैं — अभी तक MCP उपकरण के रूप में उजागर नहीं किया गया है।
get_test_case — चरणों और निष्पादन इतिहास सहित पूर्ण परीक्षण मामला विवरण प्राप्त करें।
list_test_case_folders — टीम के फ़ोल्डरों की सूची बनाएँ (folder_id के माध्यम से प्रति मामला एक फ़ोल्डर; सूट से अलग, जो कई-से-कई परीक्षण-योजना समूह हैं)। 500 पर सीमित; project_id और parent_folder_id फ़िल्टर का सम्मान करता है (केवल शीर्ष-स्तर के लिए "root" का उपयोग करें)।
create_test_case_folder — एक फ़ोल्डर बनाएँ (parent_folder_id के माध्यम से 3 स्तर तक नेस्ट)। इसमें मामलों को स्थानांतरित करने के लिए bulk_update_test_cases का उपयोग करें।
bulk_update_test_cases — एक बार में 500 मामलों तक एक क्रिया लागू करें: set_priority, set_status, set_type, add_tags, remove_tags, add_to_suite, pin, unpin।
link_test_case_to_bug — एक परीक्षण मामले और एक बग रिपोर्ट (verified_by, covers, या relates) के बीच ट्रेसेबिलिटी स्थापित करें।
list_test_case_links — एक परीक्षण मामले के लिए सभी ट्रेसेबिलिटी लिंक सूचीबद्ध करें।
list_test_case_review_candidates — डेड-टेस्ट फ़्लैग: never_run (निर्माण के 90+ दिन बाद), always_passes (90 दिनों में 5+ लगातार पास), always_skipped (3+ लगातार स्किप)।
mark_test_case_review_flags — वर्तमान संग्रह-उम्मीदवार फ़्लैग को test_cases.review_flag पर बनाए रखें। pg_cron के माध्यम से हर सोमवार 09:00 UTC पर स्वचालित रूप से चलता है।

आयात

Figma आयात (टीम/एंटरप्राइज़) (डैशबोर्ड UI + REST): Figma फ़्रेम का एक ज़िप निर्यात अपलोड करें (100 MB तक), Claude प्रत्येक स्क्रीन का विश्लेषण करता है और आपके द्वारा चुने या बनाए गए फ़ोल्डर में परीक्षण मामलों का मसौदा तैयार करता है। मल्टी-पास पाइपलाइन (वर्गीकृत करें → प्रति-स्क्रीन मामले → साझा-उपसर्ग स्क्रीन पर प्रवाह-स्तरीय मामले → आत्म-आलोचना) प्रॉम्प्ट कैशिंग, 429 पुनर्प्रयास, और प्रति-फ़्रेम त्रुटि अलगाव के साथ ताकि एक खराब फ़्रेम पूरे बैच को विफल न करे। मामले status=active के रूप में आते हैं, ai_generated=true टैग किए जाते हैं, source='figma' और source_frame_name मूल फ़्रेम के लिंक को संरक्षित करते हैं। प्लेटफ़ॉर्म Anthropic कुंजी का उपयोग करता है — किसी प्रति-टीम Claude कनेक्शन की आवश्यकता नहीं है। एंडपॉइंट: POST /api/test-cases/import/figma/request, POST /api/test-cases/import/figma/start, GET /api/test-cases/import/figma/:id।

सूट और रन* `list_test_suites` — परियोजना पहचान, केस गणना और अंतिम रन स्थिति के साथ परीक्षण सूट सूचीबद्ध करें। API-कुंजी कॉल करने वालों को `test_runs:read` की आवश्यकता होती है।

create_test_suite — एक सूट बनाएँ। parent_suite_id के माध्यम से 3 स्तरों तक नेस्ट करता है।
list_test_runs — सूट नाम, असाइनी और पास/फेल सारांश के साथ परीक्षण रन सूचीबद्ध करें।
create_test_run — डैशबोर्ड-प्रबंधित सूट रन बनाएँ। मूल सूट चलाने पर प्रत्येक वंशज उप-सूट का प्रत्येक केस स्वचालित रूप से शामिल होता है (दोनों से जुड़ा केस ठीक एक बार जोड़ा जाता है)। प्रत्येक test_run_results पंक्ति रिकॉर्ड करती है कि केस किस मूल उप-सूट से आया, ताकि परिणाम पृष्ठ मूल के अनुसार समूहित कर सकें।

बाहरी एजेंट निष्पादन

ये उपकरण Hermes या किसी अन्य एजेंट रनटाइम को QA प्रणाली का रिकॉर्ड बने बिना स्वीकृत सूट निष्पादित करने देते हैं। केवल test_runs:read और test_runs:write वाली कार्यक्षेत्र-स्कोप्ड कुंजी का उपयोग करें। सूट परियोजना सीमा प्रदान करता है; कॉल करने वाले इसे ओवरराइड नहीं कर सकते।

start_test_plan — एक स्थिर external_run_id के साथ अपरिवर्तनीय सूट स्नैपशॉट प्रारंभ या पुनः आरंभ करें। दोहराई गई आईडी डुप्लिकेट बनाने के बजाय मौजूदा मिलान रन और पहला पृष्ठ लौटाती है।
get_test_run_plan — कैननिकल रन स्थिति और एक स्थिर योजना पृष्ठ पढ़ें। पिछला next_cursor पास करें; पृष्ठ डिफ़ॉल्ट रूप से 100 केस होते हैं और अधिकतम 200 तक सीमित होते हैं।
report_test_results — passed, failed, blocked, या skipped स्थिति के साथ 1–200 परिणाम सबमिट करें। सटीक पुनर्प्रयास सुरक्षित हैं; किसी केस को किसी अन्य स्थिति से अधिलेखित करने का प्रयास अस्वीकार कर दिया जाता है।
abort_test_run — स्वीकृत आंशिक परिणामों और कैननिकल सारांश को संरक्षित करते हुए बाधित रन को निष्प्रभावी रूप से रोकें।

कोटा व्यवहार: किसी अन्य रन का उपभोग किए बिना मिलान रन को फिर से शुरू करने के लिए उसी external_run_id के साथ start_test_plan का पुनर्प्रयास करें। डेटा हटाने से मासिक रन उपयोग रीसेट नहीं होता है।

रनटाइम सीमा: केस स्नैपशॉट में क्रेडेंशियल, फ़ाइल निकाय और निजी अनुलग्नक पथ शामिल नहीं हैं। MVP में परिणाम साक्ष्य टेक्स्ट है। लक्ष्य क्रेडेंशियल निष्पादन रनटाइम में रहते हैं। ब्राउज़र, मॉडल और नेटवर्क लागत ग्राहक-पक्ष रहती है, और ग्राहकों को लक्ष्य पहुँच और नेटवर्क निकास प्रतिबंधित करना चाहिए। दोष और रिलीज़ निर्णयों के लिए एक मानव जिम्मेदार रहता है।

Hermes एजेंट गाइड इस लूप को bugAgent-अनुरक्षित सामुदायिक कौशल के रूप में पैकेज करता है। सार्वजनिक स्टार्टर किट में कॉपी-रेडी कॉन्फ़िग और इंस्टॉल करने योग्य कौशल शामिल है। यह आधिकारिक Nous Research एकीकरण नहीं है।

रिपोर्ट (टियर 1 + टियर 4 विश्लेषण)

get_test_reports_overview — एक विंडो के लिए हेडलाइन KPI (पास दर, पूर्ण रन, निष्पादित केस) पूर्व समतुल्य विंडो की तुलना में डेल्टा के साथ। वही संख्याएँ जो रिपोर्ट टैब KPI पट्टी दिखाती है।
get_test_reports_failures — चार "क्या ठीक करें?" सूचियाँ: failing_cases (≥50% विफल, न्यूनतम 3 रन), flaky_cases (सर्वाधिक पास/फेल फ़्लिप), failing_suites (≥30% विफल, न्यूनतम 5 रन), regressed_cases (विंडो में पूर्व पास के साथ सबसे हालिया विफल)।

create_test_case_folder → एक फ़ोल्डर ट्री बनाएँ (जैसे स्मोक → ऑथ)
create_test_case → केस परिभाषित करें; उन्हें bulk_update_test_cases के साथ फ़ोल्डरों में ले जाएँ
create_test_suite → एक परीक्षण योजना बनाएँ (उप-सूट वैकल्पिक, 3 स्तर तक गहरे)
create_test_run → मूल सूट से मानव/डैशबोर्ड-प्रबंधित रन बनाएँ — उप-सूट स्वतः शामिल
start_test_plan → पुनर्प्रयास-सुरक्षित बाहरी-एजेंट रन प्रारंभ या पुनः आरंभ करें
get_test_run_plan → प्रत्येक अपरिवर्तनीय योजना पृष्ठ पुनर्प्राप्त करें, फिर इसे चयनित रनटाइम में निष्पादित करें
report_test_results → सीमित परिणाम बैच लौटाएँ; यदि निष्पादन सुरक्षित रूप से जारी नहीं रह सकता तो abort_test_run कॉल करें
get_test_reports_failures → रन पूर्ण होने पर पूछें "इस सप्ताह क्या ठीक करें?"
get_test_reports_overview → सप्ताह दर सप्ताह पास-दर प्रवृत्ति ट्रैक करें

⚡

टीम बूस्टर

scale_team — बूस्टर परीक्षकों के साथ अपनी QA टीम को तुरंत स्केल करें। परीक्षक पहुँच के साथ खाते स्वचालित रूप से प्रावधान किए जाते हैं। team_size (1–10), location, duration, budget, और वैकल्पिक रूप से product_url, product_types, और tech_levels निर्दिष्ट करें। टीम योजना पर उपलब्ध। अनुमोदन दिए जाने तक आपसे शुल्क नहीं लिया जाएगा।

scale_team → 1 महीने के लिए अमेरिका में 5 वरिष्ठ परीक्षक प्रावधान करें
list_team_members → सत्यापित करें कि नए परीक्षक आपकी टीम में दिखाई देते हैं
list_reports → बूस्टर परीक्षकों द्वारा दायर रिपोर्टों की समीक्षा करें

📱

मोबाइल परीक्षण (एंटरप्राइज़)

मोबाइल संसाधन परियोजना-स्कोप्ड हैं। निर्माण, आयात और फ़िल्टर की गई सूचियों पर project_id या एक लचीला project चयनकर्ता पास करें। स्वचालन लिंक किए गए ऐप की परियोजना प्राप्त करते हैं; अन्यथा सर्वर कार्यक्षेत्र डिफ़ॉल्ट परियोजना का उपयोग करता है। अनफ़िल्टर्ड सूचियों में तब तक विरासत कार्यक्षेत्र-स्तरीय पंक्तियाँ शामिल हो सकती हैं जब तक वे स्थानांतरित नहीं हो जातीं।

list_mobile_apps — वैकल्पिक project_id/project, platform, और limit फ़िल्टर के साथ अपलोड किए गए ऐप्स सूचीबद्ध करें। प्रत्येक ऐप का project_id लौटाता है ताकि एजेंट बाद के संचालन उसी परियोजना में रख सकें।
upload_mobile_app — वास्तविक उपकरणों पर परीक्षण के लिए एक APK (Android) या IPA (iOS) ऐप पंजीकृत करें। name, platform (android/ios), और file_url की आवश्यकता है; इसे सक्रिय परियोजना को असाइन करने के लिए project_id पास करें। iOS के लिए, वास्तविक-उपकरण रन के लिए IPA अपलोड करें, फिर रिकॉर्डिंग के लिए सिम्युलेटर .app बिल्ड अपलोड करने हेतु डैशबोर्ड का उपयोग करें।
update_mobile_app — ऐप बाइनरी को नए संस्करण से बदलें। कैश्ड URL और सिम्युलेटर बिल्ड साफ़ करता है ताकि सभी स्वचालन अगले रन पर नए संस्करण का उपयोग करें। app_id और file_url की आवश्यकता है। वैकल्पिक: version।
list_mobile_automations — वैकल्पिक project_id/project, app_id, status, और limit फ़िल्टर के साथ मोबाइल स्वचालन सूचीबद्ध करें। परिणामों में project_id और लिंक्ड ऐप आईडी शामिल हैं।
create_mobile_automation — एक परीक्षण स्क्रिप्ट बनाएँ। name, app_id, script_type (YAML के लिए maestro, Appium Python के लिए appium, Appium JavaScript के लिए appium_js), और script की आवश्यकता है; जब ऐप पहले से परियोजना-स्कोप्ड न हो तो project_id पास करें।
import_mobile_script — मौजूदा मोबाइल परीक्षण स्क्रिप्ट आयात करें और इसे चलाने योग्य स्वचालन में बदलें, डेवलपर के स्वयं के लोकेटर संरक्षित करते हुए ताकि रन तत्वों को सटीक रूप से हल करें। समर्थित बोलियाँ: Appium‑Python, WebdriverIO, Maestro (YAML प्रवाह), और Playwright (मोबाइल‑वेब)। केवल Android ऐप्स। name, app_id, और script की आवश्यकता है; वैकल्पिक target_devices और project_id। स्वचालन के साथ action_count, पहचाने गए dialect, और चयनकर्ता-मैपिंग warnings लौटाता है।
run_mobile_automation — वास्तविक उपकरण पर मोबाइल स्वचालन प्रारंभ करें। automation_id की आवश्यकता है; वैकल्पिक device, os_version, और credential_id। प्रति-रन क्रेडेंशियल स्वचालन की डिफ़ॉल्ट लॉगिन प्रोफ़ाइल को ओवरराइड करता है और उसी परियोजना से संबंधित होना चाहिए।
list_mobile_runs — मोबाइल रन परिणाम प्राप्त करें (स्थिति, उपकरण, वीडियो, BrowserStack सत्र, और कोई स्वतः-निर्मित बग)। वैकल्पिक फ़िल्टर: project_id, automation_id, status (queued, running, passed, failed, error, archived), और limit। संग्रहीत रन डिफ़ॉल्ट रूप से बाहर रखे गए हैं।
create_mobile_credential — किसी परियोजना के लिए एक नामित लॉगिन प्रोफ़ाइल बनाएँ (जैसे “व्यवस्थापक”, “योगदानकर्ता”): एक उपयोगकर्ता नाम + पासवर्ड जो मोबाइल स्वचालन द्वारा उपयोग किया जाता है। दोनों मान AES‑256‑GCM एन्क्रिप्टेड संग्रहीत हैं और केवल-लिखने हैं — कोई उपकरण या API उन्हें कभी नहीं लौटाता, और अन्य सदस्य / UI केवल नाम देखते हैं। पुनः रिकॉर्ड किए बिना विभिन्न भूमिकाओं के रूप में लॉग इन करने के लिए प्रति रन एक प्रोफ़ाइल चुनें। project_id, name, username, password की आवश्यकता है। केवल एंटरप्राइज़।
list_mobile_credentials — लॉगिन प्रोफ़ाइल सूचीबद्ध करें (वैकल्पिक रूप से एक project_id)। केवल गैर-गुप्त फ़ील्ड लौटाता है (id, name, परियोजना, निर्माता, निर्मित तिथि) — कभी भी उपयोगकर्ता नाम या पासवर्ड नहीं। स्वचालन चलाते समय क्रेडेंशियल चयन के रूप में लौटाए गए id का उपयोग करें।
update_mobile_credential — लॉगिन प्रोफ़ाइल का नाम बदलें या id द्वारा उसके उपयोगकर्ता नाम/पासवर्ड को घुमाएँ। बदलने के लिए केवल फ़ील्ड शामिल करें। नए गुप्त मान तुरंत एन्क्रिप्ट किए जाते हैं और कभी नहीं लौटाए जाते।
delete_mobile_credential — id द्वारा लॉगिन प्रोफ़ाइल को सॉफ्ट-डिलीट करें। ऑडिट और रन इतिहास के लिए बनाए रखा जाता है लेकिन अब उपयोग या सूचीबद्ध नहीं किया जा सकता; पुन: उपयोग के लिए नाम मुक्त करता है।
list_mobile_schedules, create_mobile_schedule, delete_mobile_schedule — वास्तविक-उपकरण शेड्यूल सूचीबद्ध करें, बनाएँ और हटाएँ। शेड्यूल अपने चयनित स्वचालन के माध्यम से परियोजना संदर्भ प्राप्त करते हैं।

उदाहरण कार्यप्रवाह — Android

list_projects → लक्ष्य project_id हल करें
upload_mobile_app → उस परियोजना में APK पंजीकृत करें
डैशबोर्ड में सुरक्षित रूप से रिकॉर्ड करें, या import_mobile_script / create_mobile_automation का उपयोग करें
list_mobile_automations → उसी परियोजना में स्वचालन हल करें
run_mobile_automation → इसे वास्तविक उपकरण पर ट्रिगर करें, वैकल्पिक रूप से लॉगिन प्रोफ़ाइल के साथ
list_mobile_runs → वीडियो और लॉग के साथ परिणाम जाँचें
विफलताएँ विफलता स्नैपशॉट और चरण विश्लेषण के साथ स्वतः बग रिपोर्ट बनाती हैं

उदाहरण कार्यप्रवाह — iOS

upload_mobile_app → वास्तविक-उपकरण रन के लिए project_id के साथ अपना IPA पंजीकृत करें
ऐप विवरण पृष्ठ पर सिम्युलेटर .app बिल्ड अपलोड करें (रिकॉर्डिंग के लिए)
ब्राउज़र में परीक्षण रिकॉर्ड करें → सिम्युलेटर से क्रियाएँ कैप्चर की गईं
run_mobile_automation → सहेजे गए स्वचालन को iPhone पर ट्रिगर करें (IPA का उपयोग करता है)
update_mobile_app → तैयार होने पर IPA को नए संस्करण से बदलें

AI के साथ परिष्कृत करें: अनुमत सूचीबद्ध बीटा डैशबोर्ड और REST परिष्करण एंडपॉइंट के माध्यम से उपलब्ध है। अभी तक कोई Refine MCP उपकरण सार्वजनिक सूची का हिस्सा नहीं हैं।

✅

अनुपालन और साक्ष्य (एंटरप्राइज़)

collect_compliance_evidence — कनेक्टेड सेवाओं (Cloudflare, GitHub, Sentry, Supabase, Railway) से स्वचालित साक्ष्य संग्रह ट्रिगर करें। रन आईडी लौटाता है। SSL/TLS सेटिंग्स, WAF स्थिति, Dependabot अलर्ट, त्रुटि रुझान, परिनियोजन इतिहास, और अधिक एकत्र करता है।
check_config_drift — बेसलाइन से सुरक्षा कॉन्फ़िगरेशन विचलन के लिए सभी कनेक्टेड सेवाओं की जाँच करें (SSL मोड, TLS संस्करण, HSTS, WAF नियम, सुरक्षा हेडर)।
generate_access_review — त्रैमासिक पहुँच समीक्षा रिपोर्ट बनाएँ। टीम के सदस्यों, भूमिकाओं, MFA स्थिति, API कुंजी उपयोग का ऑडिट करता है, और सिफारिशें उत्पन्न करता है (जैसे, निष्क्रिय कुंजियाँ निरस्त करें)।
get_security_events — क्रॉस-सर्विस सुरक्षा घटना समयरेखा क्वेरी करें। स्रोत (cloudflare, sentry, github) और गंभीरता (critical, high, medium, low, info) द्वारा फ़िल्टर करें। घटनाएँ सेवाओं में स्वतः सहसंबद्ध होती हैं।

अनुपालन कवरेज

ये उपकरण SOC2 (CC4.1, CC6.1, CC7.2, CC8.1), ISO 27001 (A.5.18, A.8.8, A.8.9, A.8.15-16, A.8.29), और GDPR (अनु. 5, 25, 32, 33) अनुपालन आवश्यकताओं में मदद करते हैं।

संगत क्लाइंट

bug_Agent_ मॉडल संदर्भ प्रोटोकॉल का समर्थन करने वाले किसी भी क्लाइंट के साथ काम करता है। लोकप्रिय क्लाइंट के लिए सेटअप गाइड यहाँ हैं:

🤖

Claude Desktop

सेटिंग्स → डेवलपर → कॉन्फ़िग संपादित करें खोलें, फिर जोड़ें:

claude_desktop_config.json

सहेजने के बाद Claude Desktop पुनः आरंभ करें।

✳️

Cursor

सेटिंग्स → MCP सर्वर → सर्वर जोड़ें खोलें, या अपने प्रोजेक्ट रूट में .cursor/mcp.json संपादित करें:

.cursor/mcp.json

🌊

Windsurf

सेटिंग्स → MCP → सर्वर जोड़ें खोलें, या अपनी MCP कॉन्फ़िग फ़ाइल संपादित करें:

mcp_config.json

💻

Claude Code (CLI)

टर्मिनल से सीधे bug_Agent_ जोड़ें:

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

लॉन्च करने से पहले export BUGAGENT_API_KEY=ba_live_... के साथ अपनी API कुंजी सेट करें।

🔧

अन्य MCP क्लाइंट

MCP stdio परिवहन का समर्थन करने वाला कोई भी क्लाइंट bug_Agent_ के साथ काम करता है। मानक कॉन्फ़िगरेशन का उपयोग करें:

कमांड: npx
आर्ग्स: ["-y", "@bugagent/mcp-server"]
एन्व: BUGAGENT_API_KEY

CLI

CLI के साथ शुरुआत करना

bug_Agent_ CLI आपको अपने टर्मिनल से बग रिपोर्ट, सुविधा अनुरोध, परियोजनाओं और एकीकरणों पर पूर्ण नियंत्रण देता है। इसका उपयोग करें:

वर्कफ़्लो स्वचालित करें — CI/CD पाइपलाइनों, स्क्रिप्ट और क्रॉन जॉब में बग रिपोर्टिंग को एकीकृत करें
बल्क ऑपरेशन — टर्मिनल छोड़े बिना रिपोर्ट सूचीबद्ध करें, फ़िल्टर करें और प्रबंधित करें
पाइप-अनुकूल आउटपुट — jq, yq और अन्य उपकरणों के साथ संयोजन के लिए JSON, YAML और कच्चे प्रारूप
तेज़ पुनरावृत्ति — ब्राउज़र की आवश्यकता नहीं — सेकंडों में रिपोर्ट बनाएं और अपडेट करें

इंस्टॉलेशन

npm install -g @bugagent/cli

इंस्टॉलेशन सत्यापित करें:

bugagent --version

प्रमाणीकरण

अपनी API कुंजी को पर्यावरण चर के रूप में सेट करें:

या इसे सीधे --api-key फ़्लैग के साथ पास करें:

bugagent reports list --api-key ba_live_your_key_here

🔑

bug_Agent_ कंसोल से अपनी API कुंजी प्राप्त करें। कुंजियाँ ba_live_ से शुरू होती हैं।

स्थायी प्रमाणीकरण के लिए, अपने शेल प्रोफ़ाइल (~/.bashrc, ~/.zshrc, आदि) में एक्सपोर्ट जोड़ें।

उपयोग

कमांड इस पैटर्न का पालन करते हैं:

bugagent <resource> <action> [flags]

संसाधन उप-संसाधनों के लिए कोलन सिंटैक्स का भी उपयोग कर सकते हैं:

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

विवरण के लिए किसी भी कमांड पर --help का उपयोग करें:

bugagent reports --help
bugagent reports create --help

उदाहरण सत्र

टर्मिनल

# List your projects
bugagent projects list

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

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

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

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

# Check your usage
bugagent usage get --format json

CLI सुविधाएँ

CLI निम्नलिखित के लिए कमांड प्रदान करता है:

reports बग रिपोर्ट बनाएं, सूचीबद्ध करें, प्राप्त करें, अपडेट करें और फ्लश करें

projects प्रोजेक्ट बनाएं, सूचीबद्ध करें, अपडेट करें और हटाएं

keys API कुंजियाँ जनरेट करें, सूचीबद्ध करें, पुनर्जीवित करें और निरस्त करें

jira कनेक्ट करें, रिपोर्ट सिंक करें और Jira सेटिंग्स कॉन्फ़िगर करें

usage योजना सीमाओं के विरुद्ध वर्तमान उपयोग की जाँच करें

stats विश्लेषण और विवरण देखें

profile अपनी प्रोफ़ाइल और सेटिंग्स देखें और अपडेट करें

auth लॉगिन करें, रजिस्टर करें और क्रेडेंशियल प्रबंधित करें

वैश्विक फ़्लैग

फ़्लैग विवरण

--api-key <key> इस कमांड के लिए API कुंजी को ओवरराइड करें

--format <fmt> आउटपुट प्रारूप: json, yaml, pretty, raw

--debug समस्या निवारण के लिए अनुरोध/प्रतिक्रिया विवरण दिखाएं

--help किसी भी कमांड के लिए सहायता दिखाएं

--version CLI संस्करण प्रिंट करें

आउटपुट प्रारूप

CLI विभिन्न उपयोग मामलों के लिए कई आउटपुट प्रारूपों का समर्थन करता है:

`json`

मशीन-पठनीय JSON। jq या अन्य उपकरणों पर पाइप करने के लिए आदर्श।

`yaml`

कॉन्फ़िग फ़ाइलों और पठनीयता के लिए मानव-अनुकूल YAML आउटपुट।

`pretty`

डिफ़ॉल्ट। टर्मिनल के लिए डिज़ाइन किया गया रंगीन, स्वरूपित आउटपुट।

`raw`

अस्वरूपित आउटपुट। स्क्रिप्टिंग और स्वचालन के लिए उपयोगी।

--transform के साथ फ़िल्टरिंग

आउटपुट डेटा को क्वेरी और फ़िल्टर करने के लिए GJSON सिंटैक्स के साथ --transform का उपयोग करें:

# Default pretty output
bugagent reports list

# JSON for piping to other tools
bugagent reports list --format json

# YAML
bugagent reports list --format yaml

# Raw (no formatting)
bugagent reports get rpt_abc123 --format raw

# Filter with GJSON syntax
bugagent reports list --format json \
  --transform "items.#(severity==critical).title"

AI स्किल

CLI एक AgentSkill के रूप में भी उपलब्ध है, जो AI कोडिंग सहायकों को आपकी ओर से bug_Agent_ का उपयोग करने की अनुमति देता है।

✨

AgentSkill क्या है?

AgentSkills AI कोडिंग सहायकों (Claude Code, Cursor, आदि) को CLI उपकरणों को प्रासंगिक रूप से लागू करने देता है। bug_Agent_ स्किल आपके AI सहायक को बग फ़ाइल करने, प्रोजेक्ट स्थिति जाँचने और Jira से सिंक करने की क्षमता देता है — सब कुछ बिना आपके कोई कमांड टाइप किए।

स्किल इंस्टॉल करें

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

एक बार इंस्टॉल हो जाने पर, संदर्भ-जागरूक AI सहायक आपके उत्पाद, परीक्षण दिशानिर्देशों और अपलोड किए गए दस्तावेज़ीकरण के पूर्ण ज्ञान के साथ स्वाभाविक रूप से bug_Agent_ कमांड का उपयोग कर सकता है:

AI सहायक प्रॉम्प्ट

"File a critical bug: the payment webhook is returning
a 403 after the latest deploy. It affects all Stripe
events. Assign it to the payments project."

स्किल प्राकृतिक भाषा को उपयुक्त CLI कमांड में अनुवाद करता है और उन्हें निष्पादित करता है।

🎬

सत्र रीप्ले + AI सहायक: जब सत्र रीप्ले सक्षम होता है (टीम योजना), तो AI सहायक कैप्चर किए गए उपयोगकर्ता सत्र — क्लिक, नेविगेशन, त्रुटियाँ और पिछले 60 सेकंड की नेटवर्क विफलताएँ — को संदर्भित कर सकता है ताकि पूर्ण पुनरुत्पादन संदर्भ के साथ अधिक समृद्ध, अधिक सटीक बग रिपोर्ट स्वचालित रूप से तैयार की जा सके।

सहायता प्राप्त करें

सहायता चाहिए? हम यहाँ मदद के लिए हैं।

डिस्कॉर्ड समुदाय

वास्तविक समय समर्थन और सामुदायिक चर्चाओं के लिए हमारे डिस्कॉर्ड से जुड़ें।

ईमेल समर्थन

support@bugagent.com — हम आमतौर पर 24 घंटों के भीतर जवाब देते हैं।