bugAgent MCP Server

официальный

Подключите bugAgent к любому MCP-совместимому AI-клиенту. Создавайте, классифицируйте и управляйте багами, запросами функций и другими задачами прямо из вашего AI-ассистента для кода. Никакого переключения контекста, никакого копирования — просто опишите проблему, и bugAgent сделает всё остальное.

Смотреть на bugagent.com

Документация

MCP v1

Навигация

Model Context Protocol

MCP

Подключите bug_Agent_ к любому AI-клиенту, совместимому с MCP.

Создавайте, классифицируйте и управляйте багами, запросами функций и многим другим прямо из вашего AI-ассистента для кодинга. Никакого переключения контекста, никакого копирования и вставки — просто опишите проблему, а bug_Agent_ сделает всё остальное.

Discord Community [email protected]

Начало работы

MCP-сервер bug_Agent_ позволяет AI-клиентам создавать, запрашивать и управлять отчётами об ошибках, запросами функций, улучшениями и многим другим через Model Context Protocol. Он работает локально и взаимодействует с облачным API bug_Agent_.

1

Получите свой API-ключ

Зарегистрируйтесь на app.bugagent.com и сгенерируйте API-ключ в консоли.

2

Настройте свой AI-клиент

Добавьте bug_Agent_ как MCP-сервер в конфигурации вашего клиента (см. инструкцию ниже).

3

Начинайте создавать баги

Опишите баг на естественном языке, и 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

Настройка

Установка

Глобальная установка не требуется. Используйте npx для запуска MCP-сервера по требованию:

npx @bugagent/mcp-server

Настройка вашего API-ключа

При первом подключении bug_Agent_ запросит ваш API-ключ. Вы также можете задать его через переменную окружения:

export BUGAGENT_API_KEY=ba_live_your_key_here

Получите свой API-ключ в консоли bug_Agent_.

Конфигурация 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-ключ из консоли.

Подключение к серверу

MCP-сервер bug_Agent_ доступен по адресу https://mcp.bugagent.com/mcp через транспорт Streamable HTTP. Подключайтесь из любого из восьми клиентов ниже — выберите тот, который подходит для вашего рабочего процесса.

🔑

Сначала получите свой API-ключ. Войдите в app.bugagent.com/dashboard/settings/api-keys, нажмите Create API Key и скопируйте значение (начинается с ba_live_). Вы увидите его только один раз, поэтому сохраните его в надёжном месте. В каждом примере ниже используется этот ключ.

Вариант 1 — MCP Inspector (веб-интерфейс, рекомендуется для первого тестирования)

Официальный инструмент Anthropic. Запускает локальный веб-интерфейс, где вы можете пройтись по всем инструментам, заполнить параметры и увидеть ответы. Нулевая конфигурация, IDE не требуется.

macOS (Терминал)

Терминал

npx @modelcontextprotocol/inspector

Windows (PowerShell или CMD)

PowerShell

В открывшемся интерфейсе браузера:

  1. Transport Type: выберите Streamable HTTP
  2. URL: https://mcp.bugagent.com/mcp
  3. Connection Type: выберите Proxy (по умолчанию — Inspector проксирует через локальный процесс Node, чтобы обойти CORS браузера)
  4. Нажмите вкладку Authentication → добавьте пользовательский заголовок:
    • Header Name: Authorization
    • Value: Bearer ba_live_YOUR_KEY_HERE
  5. Нажмите Connect. Вы увидите все 60+ инструментов bug_Agent_ на левой панели.
  6. Нажмите на любой инструмент (например, list_bug_reports), заполните параметры, нажмите Run Tool. Ответ отобразится справа.

Предварительные требования: Node.js 18 или новее. Установите с nodejs.org, если у вас его нет.

Вариант 2 — Claude Desktop (Mac + Windows)

Если вы используете приложение Claude Desktop, вы можете добавить bug_Agent_ как постоянный MCP-сервер. Тогда у Claude будут доступны все инструменты bug_Agent_ в каждом разговоре.

macOS

  1. Откройте Claude Desktop → в строке меню Claude → Settings → Developer → Edit Config. Откроется ~/Library/Application Support/Claude/claude_desktop_config.json.
  2. Добавьте запись bug_Agent_ в раздел mcpServers: claude_desktop_config.json
{  
  "mcpServers": {  
    "bugagent": {  
      "type": "http",  
      "url": "https://mcp.bugagent.com/mcp",  
      "headers": {  
        "Authorization": "Bearer ba_live_YOUR_KEY_HERE"  
      }  
    }  
  }  
}
  1. Сохраните файл и полностью закройте Claude Desktop (Cmd+Q, а не просто закройте окно).
  2. Перезапустите Claude Desktop. Значок инструментов (молоток) внизу поля ввода чата теперь должен показывать инструменты bug_Agent_.
  3. Попробуйте: введите “Покажи 5 моих последних отчётов об ошибках” — Claude автоматически вызовет list_bug_reports.

Windows

  1. Откройте Claude Desktop → File → Settings → Developer → Edit Config. Откроется %APPDATA%\Claude\claude_desktop_config.json (обычно C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json).
  2. Добавьте тот же блок JSON, что показан в разделе macOS.
  3. Сохраните файл и полностью закройте Claude Desktop из системного трея (щелкните правой кнопкой мыши значок Claude → Quit), затем перезапустите.
  4. Значок инструментов (молоток) покажет инструменты bug_Agent_.

Вариант 3 — Claude Code (CLI)

Если вы используете Claude Code из терминала (CLI-версия Claude), зарегистрируйте сервер bug_Agent_ одной командой. Работает одинаково на macOS, Linux и Windows.

Терминал / PowerShell

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

Затем перезапустите сессию Claude Code. Проверьте подключение:

claude mcp list

Вы должны увидеть bugagent в списке с зелёной точкой. Начинайте использовать инструменты в любом чате: “Покажи использование exploration в этом месяце.”

Чтобы удалить позже:

claude mcp remove bugagent

Вариант 4 — OpenAI Codex CLI

Если вы используете OpenAI Codex 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"

Codex автоматически разрешает вызовы инструментов из вашего запроса на естественном языке. Попробуйте: “Покажи мои открытые баги, отсортированные по серьёзности.”

Вариант 5 — Cursor (Mac + Windows)

Cursor имеет встроенную поддержку MCP. Добавьте bug_Agent_ один раз, и AI-ассистент внутри Cursor сможет создавать баги, выводить списки отчётов, запускать сканирования и т.д., не покидая редактор.

  1. Откройте Cursor → Settings (Cmd+, на Mac / Ctrl+, на Windows) → MCP на левой боковой панели.
  2. Нажмите + Add new MCP server.
  3. Выберите тип транспорта HTTP.
  4. Заполните:
    • Name: bugagent
    • URL: https://mcp.bugagent.com/mcp
    • Header name: Authorization
    • Header value: Bearer ba_live_YOUR_KEY_HERE
  5. Нажмите Save. Cursor покажет зелёный индикатор при подключении.
  6. Откройте чат Cursor (Cmd+L / Ctrl+L) и введите “Создай отчёт об ошибке с заголовком 'Login broken' и серьёзностью high.” Cursor вызовет create_bug_report.

Альтернатива: Cursor также читает ~/.cursor/mcp.json (Mac) или %USERPROFILE%\.cursor\mcp.json (Windows). Добавьте тот же формат JSON, что показан в разделе Claude Desktop.

Вариант 6 — VS Code с расширением Continue (Mac + Windows)

Если вы предпочитаете VS Code, расширение Continue изначально поддерживает MCP-серверы.

  1. Установите расширение Continue из магазина VS Code.
  2. Откройте конфигурацию Continue: Command Palette (Cmd+Shift+P / Ctrl+Shift+P) → Continue: Open config.json. Файл находится по адресу:
    • macOS: ~/.continue/config.json
    • Windows: %USERPROFILE%\.continue\config.json
  3. Добавьте запись 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"  
        }  
      }  
    }  
  ]  
}
  1. Сохраните. Continue автоматически перезагрузится и покажет инструменты bug_Agent_ на боковой панели.
  2. Откройте панель чата Continue и попробуйте: “Покажи мои сканирования безопасности.”

Другие расширения VS Code с поддержкой MCP: Cline, Roo Code и Windsurf (форк) следуют аналогичным шаблонам конфигурации JSON с ключом mcpServers и HTTP-транспортом.

Вариант 7 — Хосты с поддержкой OAuth (на примере веб-версии Claude.ai)

Некоторые MCP-хосты аутентифицируются через OAuth 2.0 и запрашивают статические client_id и client_secret заранее, вместо принятия bearer API-ключа. Для таких хостов вы генерируете пару учётных данных OAuth с областью действия рабочей области из панели управления bug_Agent_ и вставляете её в форму подключения хоста. Учётные данные не зависят от MCP-хоста — любой OAuth-клиент, поддерживающий Authorization Code + PKCE, может их использовать. В приведённом ниже пошаговом руководстве в качестве наиболее распространённого примера используется веб-приложение Claude.ai.

  1. В bug_Agent_: откройте Settings → Developers → MCP Connectors. Нажмите Generate connector, дайте ему имя, описывающее хост (например, “Claude.ai (work)”), вставьте URI перенаправления, который требует ваш MCP-хост (для веб-приложения Claude.ai это https://claude.ai/api/mcp/auth_callback — для других хостов смотрите документацию по подключению), и выберите Confidential в качестве метода аутентификации. Скопируйте client_id и client_secret, показанные один раз на экране успеха.
  2. В настройках подключения / OAuth вашего MCP-хоста вставьте:
    • Server URL: https://mcp.bugagent.com/mcp
    • Client ID + Client Secret: из шага 1
    • Authorization URL: https://mcp.bugagent.com/authorize
    • Token URL: https://mcp.bugagent.com/token Конкретно для Claude.ai: перейдите на claude.ai/customize/connectors и нажмите Add MCP connector.
  3. Сохраните. Хост перенаправит вас на bug_Agent_ для входа (Google или email/пароль — в зависимости от того, какой метод вы используете для панели управления) и подтверждения согласия, затем завершит рукопожатие OAuth.
  4. Управляйте и отзывайте сгенерированные подключения на той же странице Settings. Отзыв происходит немедленно — следующий запрос от этого подключения вернёт invalid_client.

Примечание: Claude Code, Cursor, VS Code и MCP Inspector не нуждаются в этом потоке — они автоматически обрабатывают динамическую регистрацию клиента (RFC 7591) и аутентифицируются через API-ключ, как показано выше. Форма MCP Connectors предназначена только для хостов, которым требуются статические учётные данные OAuth.

Вариант 8 — Прямой HTTP с curl (Терминал)

Если вы хотите протестировать сервер напрямую без какого-либо клиента или интегрировать его в скрипт, вы можете обратиться к конечной точке HTTP с помощью curl. Протокол MCP — это JSON-RPC 2.0 поверх Streamable HTTP.

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}
    }
  }'

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

Ответы приходят в виде Server-Sent Events (стандарт MCP Streamable HTTP). Каждый фрагмент — это строка с префиксом data:, за которым следует объект JSON. Заголовок Accept: application/json, text/event-stream обязателен — сервер отклоняет запросы без него.

ℹ️

Устранение неполадок 401 Unauthorized: Проверьте, не был ли отозван ваш API-ключ в Settings → API Keys. Ключи начинаются с 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
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?

Автоматизация Playwright

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

Исследовательский AI

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?

Краткий справочник

Расположение файлов конфигурации для всех восьми клиентов. Каждый клиент подключается к https://mcp.bugagent.com/mcp с заголовком Authorization: Bearer ba_live_YOUR_KEY_HERE через Streamable HTTP.

Клиент Расположение конфигурации / команда

MCP Inspector Нет файла — введите URL и заголовок аутентификации в интерфейсе браузера после npx @modelcontextprotocol/inspector

Claude Desktop — macOS ~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop — Windows %APPDATA%\Claude\claude_desktop_config.json

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

Codex CLI ~/.codex/config.toml

Cursor — macOS Settings → MCP UI, или ~/.cursor/mcp.json

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

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

Прямой HTTP (curl) curl / Invoke-RestMethod — включите Accept: application/json, text/event-stream

Устранение неполадок

Симптом Решение

401 Unauthorized Ключ неверен, истёк или отозван. Проверьте Settings → API Keys — ключи начинаются с ba_live_. При необходимости перегенерируйте.

Инструменты не отображаются в клиенте Полностью закройте и перезапустите клиент после редактирования конфигурации. В Claude Desktop: Cmd+Q (а не просто закройте окно). В Cursor проверьте Settings → MCP на наличие зелёной точки.

Accept header required Прямые HTTP-вызовы должны включать Accept: application/json, text/event-stream — спецификация Streamable HTTP требует этого. Сервер возвращает 406 без него.

Данные не той рабочей области Каждый API-ключ привязан к одной рабочей области. Сгенерируйте новый ключ из нужной рабочей области в Settings → API Keys.

Инструменты отображаются, но вызовы завершаются молчаливым сбоем Убедитесь, что сервер доступен: curl -I https://mcp.bugagent.com/health должен вернуть 200. Если время ожидания истекло, проверьте правила сети/брандмауэра.

Ошибка CORS в MCP Inspector Выберите Proxy (а не Direct) для Connection Type в интерфейсе Inspector. Inspector проксирует через локальный процесс Node, чтобы обойти ограничения CORS браузера.

Codex CLI — инструменты не распознаются Убедитесь, что ~/.codex/config.toml использует [[mcp_servers]] (двойные скобки, синтаксис массива). Проверьте, что версия Codex CLI достаточно новая для поддержки MCP (codex --version).

Возможности MCP

MCP-сервер bug_Agent_ предоставляет инструменты для:

🐛

Управление отчётами об ошибках

  • create_bug_report — Подать новый отчёт с автоматической классификацией по 19 типам — ошибки, запросы функций, улучшения, технический долг и другое (заголовок: 3-500 символов). Опциональный массив attachments принимает файлы в кодировке base64 размером до 400 МБ каждый: любые изображения, видео, аудио, PDF или текст/JSON. Установите format_description: true для автоматического переформатирования описания в структурированный шаблон с помощью ИИ. Передайте time_spent_seconds для отслеживания трудозатрат QA. Передайте priority (urgent / high / normal / low), чтобы установить срочность исправления независимо от серьёзности. Ответ включает project_id, project, short_id, legacy_short_id и project_short_id.
  • list_bug_reports — Вывести список и отфильтровать отчёты (макс. 100 на страницу). Фильтры проекта применяются на стороне сервера до пагинации. Фильтрация по project (UUID, slug, точное имя или префикс тикета), 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 (открытый тег в kebab-case — распространённые значения: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch) или reporter_user_id (UUID члена команды, подавшего отчёт — сначала вызовите list_team_members, чтобы преобразовать имя в UUID). Каждый результат включает reporter_user_id, project_id, project, short_id, legacy_short_id и project_short_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 — если два агента вызовут claim_bug для одного и того же id почти одновременно, ровно один получит claimed:true с телом ошибки, а другой получит claimed:false со строкой причины. Сборщик pg_cron автоматически освобождает устаревшие резервирования (status=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. Возвращает 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 (открытый тег в kebab-case — распространённые значения: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch). Соглашение цикла агента требует, чтобы оба поля resolution и root_cause были установлены при каждом переходе status из new; панель управления, аналитика и будущий обучающий корпус claude-bot зависят от этих полей. Также включает assigned_to (ID пользователя из 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. Обратные перспективы (duplicated-by / subtask-of / blocks) вычисляются во время чтения — хранить нужно только одну строку. Оба параметра 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. related-to симметрична. Дополняет автоматически обнаруженное поле similar_reports, возвращаемое get_bug_report.
  • 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 markdown (формат Open Query Agent, используемый oqa.ai). По умолчанию используется активный проект; передайте опциональный project (slug или имя) для экспорта другого. Возвращает список файлов в пакете и сам пакет в виде zip-архива в кодировке base64

🔐

Аутентификация и учётная запись

  • 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 — Пригласить пользователя по email (менеджеры могут приглашать участников и менеджеров; только владельцы могут приглашать администраторов). Ссылка действительна 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 — Обновить подписку через Stripe

⚡

Тестирование производительности

  • create_performance_test — Создать конфигурацию нагрузочного теста с URL, устройством, виртуальными пользователями, длительностью, порогом оценки и переключателем автоматического создания багов. Только для Enterprise
  • run_performance_test — Запустить аудит страницы и нагрузочный тест для веб-теста производительности. Возвращает ID запуска для опроса результатов. Запуски профилирования мобильных приложений осуществляются из панели управления
  • get_performance_results — Получить полные результаты, включая оценки Lighthouse (Производительность, Доступность, Лучшие практики, SEO), Core Web Vitals (LCP, FID, CLS, FCP, TTFB, INP, TBT, SI) и метрики нагрузочного теста (VUs, запросы, RPS, задержки p50/p90/p95/p99)
  • list_performance_tests — Список всех конфигураций нагрузочных тестов для текущей команды
  • get_performance_usage — Проверить ежемесячное использование нагрузочных тестов. Нагрузочное тестирование доступно только в Enterprise. Free=0, Enterprise=безлимитно

Пример рабочего процесса

  1. get_performance_usage → проверить оставшуюся квоту
  2. create_performance_test → настроить тест для вашего URL
  3. run_performance_test → запустить аудит + нагрузочный тест
  4. get_performance_results → просмотреть оценки и показатели

🛡

Сканирование безопасности

  • create_security_scan — Создать конфигурацию сканирования безопасности. Веб-сканирования используют Quick Scanner + Nuclei (4000+ шаблонов) с тремя уровнями глубины и опциональным аутентифицированным сканированием. Сканирования мобильных приложений используют MobSF для бинарного анализа APK/IPA. Настраиваемое автоматическое создание багов с порогами серьезности. Только для Enterprise
  • run_security_scan — Запустить сканирование уязвимостей. Веб-сканирования требуют верификации DNS-домена. Сканирования мобильных приложений требуют загруженное приложение. Возвращает ID запуска для опроса результатов
  • get_security_results — Получить полные результаты, включая оценку безопасности (0-100), находки, классифицированные по серьезности (Критическая, Высокая, Средняя, Низкая, Информационная) с ссылками CWE, сопоставлениями OWASP, доказательствами и рекомендациями по исправлению
  • list_security_scans — Список всех конфигураций сканирования безопасности для текущей команды с последней оценкой и бейджами аутентификации/глубины
  • get_security_usage — Проверить ежемесячное использование сканирований безопасности. Сканирование безопасности доступно только в Enterprise. Enterprise=безлимитно
  • list_security_schedules — Список всех запланированных сканирований безопасности для команды с cron, часовым поясом, состоянием активности, следующим запуском и настройками уведомлений. Объединяется с родительской конфигурацией сканирования (имя, scan_type, target_url)
  • create_security_schedule — Создать повторяющееся расписание для сканирования безопасности. Требуется scan_id и cron_expression. Одно расписание на конфигурацию сканирования. Опционально timezone, notify_on_fail (none/email/slack/both), notify_email, slack_channel_id. Каждый запуск учитывается в ежемесячном лимите; пользователи-администраторы обходят лимит. Глубина сканирования всегда считывается из конфигурации сканирования во время выполнения
  • delete_security_schedule — Удалить запланированное сканирование безопасности. Не влияет на родительскую конфигурацию сканирования или завершенные запуски
  1. get_security_usage → проверить оставшуюся квоту
  2. create_security_scan → настроить сканирование для вашего URL или репозитория
  3. run_security_scan → запустить разовое сканирование уязвимостей
  4. create_security_schedule → автоматизировать повторяющиеся запуски (например, еженедельный SAST на основной ветке)
  5. get_security_results → просмотреть находки и рекомендации по исправлению

📖

Код-ревью

  • list_code_reviews — Список недавних AI код-ревью для команды. Возвращает оценки качества, количество проблем по серьезности, информацию о PR и временные метки. Только для Enterprise
  • get_code_review — Получить код-ревью со всеми находками. Каждая находка включает серьезность, категорию (bug/security/performance/style/logic/maintainability), заголовок, описание, предложение по коду, путь к файлу и номера строк
  • get_code_review_usage — Проверить использование код-ревью. AI код-ревью доступно только в Enterprise; безлимитно на Enterprise
  • get_code_review_analytics — Получить аналитику ревью: тренды, категории/источники находок, разбивка по серьезности, метрики скорости, топ репозиториев/авторов. Поддерживает ретроспективу за 7/30/90 дней
  1. get_code_review_usage → проверить оставшиеся ревью
  2. Провести ревью PR в панели управления на /dashboard/code-review
  3. list_code_reviews → посмотреть недавние ревью
  4. 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 доступен только в Enterprise; Enterprise: безлимитно (10 агентов)
  1. create_exploration с agent_count: 5 → настроить 5 параллельных агентов
  2. Запустить выполнение из панели управления или через POST /api/explorations/run
  3. get_exploration_run → опрашивать прогресс по агентам и находки
  4. Просмотреть дедуплицированные находки с атрибуцией агентов в панели управления

📝

Заметки

  • list_notes — Список заметок с опциональным поиском по ключевым словам, фильтром по проекту, автору и диапазону дат. Возвращает заметки, которыми пользователь владеет, или общие заметки в команде.
  • create_note — Создать заметку в одном из 5 форматов: markdown, plain_text, rich_text, checklist, outline. Установить visibility в private или shared. Авто-заголовок из первых 30 символов, если заголовок не указан. Опциональный массив attachments принимает файлы в кодировке base64 размером до 400 МБ каждый: любые изображения, видео, аудио, PDF или текст/JSON. Передайте time_spent_seconds для учета усилий QA.
  • get_note — Получить полную информацию о заметке, включая содержимое и вложения. Требуется id.
  • update_note — Обновить заголовок, содержимое, формат, видимость, проект или time_spent_seconds. Передайте массив attachments для добавления новых файлов (макс. 400 МБ каждый) к существующим вложениям заметки без их замены. Только автор может обновлять. Требуется id.
  • delete_note — Безвозвратно удалить заметку и ее вложения. Только автор может удалять. Требуется id.
  1. create_note → начать заметку о сессии тестирования
  2. update_note → добавлять наблюдения по мере тестирования
  3. list_notes → искать прошлые заметки по ключевому слову или проекту
  4. get_note → получить полную заметку с вложениями

🤖

Автоматизация

  • create_automation — Создать новую автоматизацию с пользовательским скриптом Playwright (запись FAB не требуется). Требуется name. Опционально: target_url (автоматически определяется из первого URL page.goto(...) в скрипте, если не указан), script (Node.js/JavaScript/TypeScript или Python — язык определяется автоматически; по умолчанию используется заполнитель), status (draft или active, по умолчанию: draft), project_id. Возвращает id автоматизации. Требуется тарифный план Team. Совет — Дублирование автоматизации: используйте 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. Виртуальный режим (по умолчанию): опциональный device для эмуляции области просмотра (например, desktop, iphone-15). Режим Live: установите browserstack: true с bs_browser (chrome, firefox, safari, edge), bs_os (Windows, OS X) и bs_os_version для запуска на реальном десктопном браузере. Live real-mobile: установите 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) и охватывают только десктоп — real mobile через Python не поддерживается, так как browser_type.connect() pytest-playwright не может управлять конечными точками real-mobile BrowserStack. Видео и сетевые логи захватываются автоматически; консольные логи — только для десктопа. Воспроизведение версии: передайте опциональный version_index (целое число, с индексом 0) для выполнения предыдущей записи из истории script_versions автоматизации. По умолчанию: когда version_index опущен или null, выполняется текущий живой скрипт — не передавайте значение-заполнитель только для того, чтобы «выбрать текущий». Значения вне диапазона, отрицательные или нецелые отклоняются. Запись запуска сохраняет точный снимок, который выполнялся, а любой баг-репорт, автоматически созданный из неудачного запуска, содержит глубокую ссылку на эту версию в редакторе.
  • list_automation_runs — Список недавних запусков для автоматизации. Требуется automation_id. Возвращает запуски со статусом, duration_ms и error_message.
  • list_schedules — Список всех запланированных запусков веб-автоматизации с cron, часовым поясом, устройством и настройками уведомлений
  • create_schedule — Создать запланированный запуск веб-автоматизации. Требуется automation_id и cron_expression. Поддерживает параметры устройства, часового пояса, notify_on_fail (email/slack/both) и канала Slack. BrowserStack Live для запланированных запусков: передайте browserstack: true с bs_browser, bs_os и bs_os_version — та же матрица устройств, что и для run_automation (Node = десктоп + реальный Android + реальный iPhone; Python = только десктоп).
  • delete_schedule — Удалить запланированный запуск веб-автоматизации
  • list_mobile_schedules — Список всех запланированных запусков мобильной автоматизации с устройствами, cron, часовым поясом и уведомлениями
  • create_mobile_schedule — Создать запланированный запуск мобильной автоматизации на реальных устройствах. Требуется automation_id, cron_expression и массив devices
  • delete_mobile_schedule — Удалить запланированный запуск мобильной автоматизации
  • optimize_automation_script — Отправить скрипт Playwright в Sonnet 4 для оптимизации с помощью AI. Применяется контрольный список из 12 пунктов, который исправляет селекторы, стратегии ожидания, утверждения, обработку ошибок, шаблоны аутентификации, совместимость с мобильными устройствами и строгий режим. Требуется automation_id. Текущая версия скрипта сохраняется перед оптимизацией. Возвращает оптимизированный скрипт и сводку изменений.
  • undo_automation_script — Откатить скрипт автоматизации к предыдущей версии. Сохраняется до 10 предыдущих версий. Требуется automation_id. Возвращает восстановленный скрипт и количество оставшихся версий.
  1. create_automation → создать тест с пользовательским скриптом
  2. list_automations → просмотреть доступные тесты
  3. get_automation → изучить скрипт Playwright
  4. run_automation → запустить тест
  5. list_automation_runs → проверить результаты и длительность

⏱️

Учет времени* list_time_entries — Список записей времени для команды. Фильтрация по period (today, week, month, all), project_id, category и sort (newest, oldest, most_time, least_time). Только для тарифного плана Team.

  • create_time_entry — Учет времени, затраченного на задачи QA. Требует description, category и duration_minutes. Опционально можно задать project_id и entry_date (по умолчанию — сегодня). Только для тарифного плана Team.
  • update_time_entry — Обновление существующей записи времени. Требует id. Можно обновить description, category, duration_minutes, project_id или entry_date. Только для тарифного плана Team.
  • delete_time_entry — Безвозвратное удаление записи времени. Требует id. Только для тарифного плана Team.
  1. create_time_entry → зарегистрировать 45 минут регрессионного тестирования
  2. list_time_entries → посмотреть записи времени за эту неделю
  3. update_time_entry → скорректировать продолжительность или категорию
  4. delete_time_entry → удалить неверную запись

☑️

Тестовые сценарии

Полноценное управление тестированием с иерархическими папками, вложенными наборами (до 3 уровней вложенности с автоматическим развертыванием поднаборов при запусках), перетаскиванием для изменения порядка, генерацией сценариев с помощью ИИ и вкладкой аналитических отчетов с трендами KPI, анализом отказов, состоянием наборов, покрытием и продуктивностью тестировщиков. Все инструменты обращаются напрямую к Supabase — без HTTP-запросов, с той же задержкой, что и панель управления.

Выполнение без участия рук: страница проверки запуска представляет собой карусель с одним видимым сценарием за раз, горячими клавишами (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 (по умолчанию) — пошаговая сетка { action, expected } через массив steps; text — единое описание в свободной форме через text_content. Оба поля можно отправить в одном вызове (платформа хранит их независимо, поэтому переключение тестировщиком template_type позже не приведет к потере данных ни с одной стороны). Опциональный массив urls (макс. 10 URL-адресов http/https) прикрепляет ссылки на источники. Требует name. Опционально: description, preconditions, template_type, steps, text_content, urls, priority, type, tags, estimated_time (секунды). Вложения файлов загружаются через конечную точку POST /api/test-cases/:id/attachments панели управления (multipart) — пока не представлены в виде инструмента MCP.
  • get_test_case — Получение полной информации о тестовом сценарии, включая шаги и историю выполнения.
  • list_test_case_folders — Список папок команды (одна папка на сценарий через folder_id; в отличие от наборов, которые являются группировками тест-планов «многие ко многим»). Ограничено 500; учитывает фильтры project_id и parent_folder_id (используйте "root" только для верхнего уровня).
  • create_test_case_folder — Создание папки (вложенность до 3 уровней через parent_folder_id). Используйте 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 (5+ последовательных прохождений за 90 дней), always_skipped (3+ последовательных пропуска).
  • mark_test_case_review_flags — Сохранение текущих флагов кандидатов на архивацию в test_cases.review_flag. Запускается автоматически каждый понедельник в 09:00 UTC через pg_cron.
Импорт
  • Импорт из Figma (UI панели управления + REST): загрузите zip-экспорт фреймов Figma (до 100 МБ), 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 — Список тестовых наборов с количеством сценариев и статусом последнего запуска.
  • create_test_suite — Создание набора. Вложенность до 3 уровней через parent_suite_id.
  • list_test_runs — Список тестовых запусков с названием набора, исполнителем и сводкой пройдено/провалено.
  • create_test_run — Создание снимка набора для нового запуска. Запуск родительского набора автоматически включает каждый сценарий из каждого дочернего поднабора (сценарий, связанный с обоими, добавляется ровно один раз). Каждая строка test_run_results записывает, из какого исходного поднабора взят сценарий, чтобы страницы результатов могли группировать по источнику.
Отчеты (аналитика Tier 1 + Tier 4)
  • get_test_reports_overview — Ключевые показатели эффективности за период (доля пройденных, завершенные запуски, выполненные сценарии) с изменениями по сравнению с предыдущим аналогичным периодом. Те же цифры, что показывает полоса KPI на вкладке «Отчеты».
  • get_test_reports_failures — Четыре списка «что исправлять?»: failing_cases (≥50% провалов, мин. 3 запуска), flaky_cases (наибольшее количество переключений пройден/провален), failing_suites (≥30% провалов, мин. 5 запусков), regressed_cases (последний провал с более ранним прохождением в периоде).
  1. create_test_case_folder → создать дерево папок (например, Smoke → Auth)
  2. create_test_case → определить сценарии; переместить их в папки с помощью bulk_update_test_cases
  3. create_test_suite → построить тест-план (поднаборы опциональны, до 3 уровней вложенности)
  4. create_test_run → создать снимок запуска из родительского набора — поднаборы включаются автоматически
  5. get_test_reports_failures → спросить «что исправлять на этой неделе?» после завершения запуска
  6. get_test_reports_overview → отслеживать тренд доли пройденных тестов неделя за неделей

⚡

Усиление команды

  • scale_team — Мгновенное масштабирование вашей команды QA с помощью дополнительных тестировщиков. Учетные записи создаются автоматически с доступом тестировщика. Укажите team_size (1–10), location, duration, budget и опционально product_url, product_types и tech_levels. Доступно на тарифном плане Team. Плата не взимается до получения одобрения.
  1. scale_team → предоставить 5 старших тестировщиков в США на 1 месяц
  2. list_team_members → убедиться, что новые тестировщики появились в вашей команде
  3. list_reports → просмотреть отчеты, поданные дополнительными тестировщиками

📱

Мобильное тестирование

  • upload_mobile_app — Загрузка APK (Android) или IPA (iOS) приложения для тестирования на реальных устройствах. Требует name, platform (android/ios) и file_url. Для iOS: загрузите IPA для запусков на реальных устройствах, затем загрузите сборку для симулятора .app на странице сведений о приложении, чтобы включить запись.
  • update_mobile_app — Замена бинарного файла приложения новой версией. Очищает кэшированные URL-адреса и сборки симулятора, чтобы все автоматизации использовали новую версию при следующем запуске. Требует app_id и file_url. Опционально: version.
  • create_mobile_automation — Создание тестового скрипта. Требует name, app_id, script_type (maestro для YAML, appium для Appium Python, appium_js для Appium JavaScript) и script (содержимое тестового скрипта).
  • list_mobile_runs — Получение результатов запусков мобильных тестов (статус, устройство, видео, сессия BrowserStack и любые автоматически созданные ошибки). Мобильные запуски инициируются из панели управления или по расписанию. Опциональные фильтры: automation_id, status (queued, running, passed, failed, error, archived), limit. Архивированные запуски исключены из списка по умолчанию.

Пример рабочего процесса — Android

  1. upload_mobile_app → загрузите ваш APK
  2. Запишите тест в браузере → действия фиксируются автоматически
  3. Запустите выполнение на реальном устройстве (например, Google Pixel 8) из панели управления или по расписанию
  4. list_mobile_runs → проверьте результаты с видео и логами
  5. При сбоях автоматически создаются отчеты об ошибках со снимком экрана сбоя и разбивкой по шагам

Пример рабочего процесса — iOS

  1. upload_mobile_app → загрузите ваш IPA (для запусков на реальных устройствах)
  2. Загрузите сборку для симулятора .app на странице сведений о приложении (для записи)
  3. Запишите тест в браузере → действия фиксируются из симулятора
  4. Запустите выполнение на реальном устройстве (например, iPhone 15 Pro, используется IPA) из панели управления или по расписанию
  5. update_mobile_app → замените IPA новой версией, когда будете готовы

✅

Соответствие требованиям и доказательства (Enterprise)

  • collect_compliance_evidence — Запуск автоматизированного сбора доказательств из подключенных сервисов (Cloudflare, GitHub, Sentry, Supabase, Railway). Возвращает ID запуска. Собирает настройки 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 (Art. 5, 25, 32, 33).

Совместимые клиенты

bug_Agent_ работает с любым клиентом, поддерживающим Model Context Protocol. Вот руководства по настройке для популярных клиентов:

🤖

Claude Desktop

Откройте Настройки → Разработчик → Редактировать конфигурацию, затем добавьте:

claude_desktop_config.json

Перезапустите Claude Desktop после сохранения.

✳️

Cursor

Откройте Настройки → MCP Servers → Добавить сервер или отредактируйте .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

Установите ваш ключ API с помощью export BUGAGENT_API_KEY=ba_live_... перед запуском.

🔧

Другие клиенты MCP

Любой клиент, поддерживающий транспорт MCP stdio, работает с bug_Agent_. Используйте стандартную конфигурацию:

  • Команда: npx
  • Аргументы: ["-y", "@bugagent/mcp-server"]
  • Переменные окружения: BUGAGENT_API_KEY

CLI

Начало работы с CLI

CLI bug_Agent_ дает вам полный контроль над отчетами об ошибках, запросами функций, проектами и интеграциями из вашего терминала. Используйте его для:

  • Автоматизации рабочих процессов — Интеграция отчетов об ошибках в конвейеры CI/CD, скрипты и задания cron
  • Массовых операций — Создание списков, фильтрация и управление отчетами, не покидая терминал
  • Вывода, удобного для конвейеров — Форматы JSON, YAML и raw для компоновки с jq, yq и другими инструментами
  • Быстрой итерации — Не нужен браузер — создавайте и обновляйте отчеты за секунды

Установка

npm install -g @bugagent/cli

Проверьте установку:

bugagent --version

Аутентификация

Установите ваш API-ключ как переменную окружения:

Или передайте его напрямую с флагом --api-key:

bugagent reports list --api-key ba_live_your_key_here

🔑

Получите API-ключ в консоли bug_Agent_. Ключи начинаются с 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

Используйте --transform с синтаксисом GJSON для запроса и фильтрации выходных данных:

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

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-ассистент: Когда включен повтор сессии (план Team), AI-ассистент может ссылаться на захваченную пользовательскую сессию — клики, навигацию, ошибки и сетевые сбои за последние 60 секунд — для автоматического составления более полных и точных отчетов об ошибках с полным контекстом воспроизведения.

Получить помощь

Нужна помощь? Мы здесь, чтобы помочь.

Сообщество Discord

Присоединяйтесь к нашему Discord для поддержки в реальном времени и обсуждений с сообществом.

Поддержка по email

[email protected] — Обычно мы отвечаем в течение 24 часов.