bugAgent

oficial

Conecta bugAgent a cualquier cliente de IA compatible con MCP. Reporta, clasifica y gestiona errores, solicitudes de funciones y más directamente desde tu asistente de codificación de IA. Sin cambios de contexto, sin copiar y pegar: solo describe el problema y bugAgent se encarga del resto.

Ver en bugagent.com

¿Qué puedes hacer con bugAgent MCP?

Describe un error en inglés sencillo y bugAgent lo archiva, clasifica y gestiona por ti.

Archivar y clasificar errores automáticamente — Pide a tu asistente que archive un error o una solicitud de función en lenguaje natural; create_bug_report lo clasifica automáticamente en 19 tipos.
Listar y filtrar informes — Pide errores recientes o críticos en un proyecto; list_bug_reports filtra por proyecto, gravedad, estado y más.
Reclamar y gestionar la cola — Haz que tu agente elija el siguiente error prioritario con pick_next_bug y lo reclame atómicamente mediante claim_bug.
Ejecutar análisis de seguridad — Activa un análisis de vulnerabilidades en una URL con run_security_scan y revisa los hallazgos mediante get_security_results.
Generar notas para desarrolladores — Pide una causa raíz y una corrección sugerida generadas por IA mediante push_to_claude para cualquier informe de error.

Documentación

MCP v1

Navegación

Protocolo de Contexto de Modelo

MCP

Conecta bug_Agent_ a cualquier cliente de IA compatible con MCP.

Registra, clasifica y gestiona errores, solicitudes de funciones y más directamente desde tu asistente de codificación con IA. Sin cambios de contexto, sin copiar y pegar — solo describe el problema y bug_Agent_ se encarga del resto.

Soporte de Discord community@bugagent.com

Primeros pasos

El servidor MCP de bug_Agent_ permite a los clientes de IA crear, consultar y gestionar informes de errores, solicitudes de funciones, mejoras y más a través del Protocolo de Contexto de Modelo. Se ejecuta localmente y se comunica con la API en la nube de bug_Agent_.

Obtén tu clave API

Crea una cuenta gratuita; los nuevos propietarios de espacios de trabajo son dirigidos directamente a la configuración de la clave API. Los usuarios que regresan pueden generar una clave desde Configuración → Desarrolladores → Claves API.

Configura tu cliente de IA

Añade bug_Agent_ como servidor MCP en la configuración de tu cliente (ver configuración abajo).

Empieza a registrar errores

Describe un error en lenguaje natural y bug_Agent_ lo clasifica, enriquece y almacena automáticamente.

Ejemplo rápido

# 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

Configuración

Instalación

No se requiere instalación global. Usa npx para ejecutar el servidor MCP bajo demanda:

npx @bugagent/mcp-server

Configura tu clave API

Cuando te conectes por primera vez, bug_Agent_ te pedirá tu clave API. También puedes configurarla mediante una variable de entorno:

export BUGAGENT_API_KEY=ba_live_your_key_here

Obtén tu clave API desde la consola de bug_Agent_.

Configuración del cliente MCP

Añade lo siguiente al archivo de configuración de tu cliente MCP:

mcp.json

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

💡

Reemplaza ba_live_your_key_here con tu clave API real de la consola.

Conectarse al Servidor

El servidor MCP de bug_Agent_ está disponible en https://mcp.bugagent.com/mcp mediante transporte HTTP Streamable. Conéctate desde cualquiera de los ocho clientes siguientes — elige el que se adapte a tu flujo de trabajo.

Para una configuración pequeña lista para copiar, orientación sobre claves con alcance y indicaciones iniciales seguras, usa la guía de inicio rápido pública de MCP.

🔑

Obtén tu clave API primero. Inicia sesión en Configuración → Desarrolladores, haz clic en Crear clave API y copia el valor (comienza con ba_live_). Solo lo verás una vez, así que pégalo en un lugar seguro. Cada ejemplo a continuación usa esta clave.

Opción 1 — Inspector MCP (Interfaz web, recomendado para pruebas iniciales)

La herramienta oficial de Anthropic. Inicia una interfaz web local donde puedes explorar cada herramienta, completar parámetros y ver las respuestas. Cero configuración, sin necesidad de IDE.

macOS (Terminal)

Terminal

npx @modelcontextprotocol/inspector

Windows (PowerShell o CMD)

PowerShell

En la interfaz del navegador que se abre:

Tipo de transporte: selecciona Streamable HTTP
URL: https://mcp.bugagent.com/mcp
Tipo de conexión: selecciona Proxy (el valor predeterminado — el Inspector se conecta a través de un proceso local de Node para evitar CORS del navegador)
Haz clic en la pestaña Autenticación → añade un encabezado personalizado:
- Nombre del encabezado: Authorization
- Valor: Bearer ba_live_YOUR_KEY_HERE
Haz clic en Conectar. Verás las más de 110 herramientas de bug_Agent_ en el panel izquierdo.
Haz clic en cualquier herramienta (p. ej., list_bug_reports), completa los parámetros y haz clic en Ejecutar herramienta. La respuesta aparece a la derecha.

Requisitos previos: Node.js 18 o posterior. Instálalo desde nodejs.org si no lo tienes.

Opción 2 — Claude Desktop (Mac + Windows)

Si usas la aplicación Claude Desktop, puedes añadir bug_Agent_ como servidor MCP permanente. Claude tendrá entonces todas las herramientas de bug_Agent_ disponibles en cada conversación.

macOS

Abre Claude Desktop → barra de menú Claude → Configuración → Desarrollador → Editar configuración. Esto abre ~/Library/Application Support/Claude/claude_desktop_config.json.
Añade la entrada de bug_Agent_ bajo mcpServers:
claude_desktop_config.json

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

Guarda el archivo y cierra Claude Desktop por completo (Cmd+Q, no solo la ventana).
Vuelve a abrir Claude Desktop. El icono de herramientas de martillo en la parte inferior del campo de chat debería mostrar ahora las herramientas de bug_Agent_.
Pruébalo: escribe "Enumera mis 5 informes de errores más recientes" — Claude llamará a list_bug_reports automáticamente.

Windows

Abre Claude Desktop → Archivo → Configuración → Desarrollador → Editar configuración. Esto abre %APPDATA%\Claude\claude_desktop_config.json (normalmente C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json).
Añade el mismo bloque JSON que se muestra en la sección de macOS.
Guarda el archivo y cierra Claude Desktop por completo desde la bandeja del sistema (clic derecho en el icono de Claude → Salir) y luego vuelve a abrirlo.
El icono de herramientas de martillo mostrará las herramientas de bug_Agent_.

Opción 3 — Claude Code (CLI)

Si usas Claude Code desde tu terminal (la versión CLI de Claude), registra el servidor de bug_Agent_ con un solo comando. Funciona igual en macOS, Linux y Windows.

Terminal / PowerShell

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

Luego reinicia tu sesión de Claude Code. Verifica que está conectado:

claude mcp list

Deberías ver bugagent en la lista con un punto verde. Comienza a usar las herramientas en cualquier chat: "Muéstrame mi uso de exploración de este mes."

Para eliminarlo más tarde:

claude mcp remove bugagent

Opción 4 — OpenAI Codex CLI

Si usas OpenAI Codex CLI, añade bug_Agent_ a ~/.codex/config.toml para un registro permanente, o pasa la configuración en línea para una sesión única.

Registro permanente (añadir a la configuración)

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

En línea — una sesión

Terminal

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

Codex resuelve las llamadas a herramientas automáticamente a partir de tu mensaje en lenguaje natural. Prueba: "Enumera mis errores abiertos ordenados por severidad."

Opción 5 — Cursor (Mac + Windows)

Cursor tiene soporte MCP integrado. Añade bug_Agent_ una vez y el asistente de IA dentro de Cursor podrá registrar errores, enumerar informes, ejecutar escaneos, etc. sin salir de tu editor.

Abre Cursor → Configuración (Cmd+, en Mac / Ctrl+, en Windows) → MCP en la barra lateral izquierda.
Haz clic en + Añadir nuevo servidor MCP.
Selecciona el tipo de transporte HTTP.
Completa:
- Nombre: bugagent
- URL: https://mcp.bugagent.com/mcp
- Nombre del encabezado: Authorization
- Valor del encabezado: Bearer ba_live_YOUR_KEY_HERE
Haz clic en Guardar. Cursor muestra un indicador verde cuando está conectado.
Abre el chat de Cursor (Cmd+L / Ctrl+L) y escribe "Crea un informe de errores titulado 'Login roto' con severidad alta." Cursor invocará create_bug_report.

Alternativa: Cursor también lee ~/.cursor/mcp.json (Mac) o %USERPROFILE%\.cursor\mcp.json (Windows). Añade el mismo formato JSON que se muestra en la sección de Claude Desktop.

Opción 6 — VS Code con la extensión Continue (Mac + Windows)

Si prefieres VS Code, la extensión Continue admite servidores MCP de forma nativa.

Instala la extensión Continue desde el mercado de VS Code.
Abre la configuración de Continue: Paleta de comandos (Cmd+Shift+P / Ctrl+Shift+P) → Continue: Abrir config.json. El archivo está en:
- macOS: ~/.continue/config.json
- Windows: %USERPROFILE%\.continue\config.json
Añade una entrada 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"  
        }  
      }  
    }  
  ]  
}

Guarda. Continue se recargará automáticamente y mostrará las herramientas de bug_Agent_ en la barra lateral.
Abre el panel de chat de Continue y prueba: "Enumera mis escaneos de seguridad."

Otras extensiones de VS Code compatibles con MCP: Cline, Roo Code y Windsurf (fork) siguen patrones de configuración JSON similares con una clave mcpServers y transporte HTTP.

Opción 7 — Hosts compatibles con OAuth (Claude.ai web mostrado como ejemplo)

Algunos hosts MCP se autentican mediante OAuth 2.0 y solicitan un client_id y client_secret estáticos por adelantado en lugar de aceptar una clave API de portador. Para esos hosts, generas un par de credenciales OAuth con alcance de espacio de trabajo desde el panel de bug_Agent_ y lo pegas en el formulario del conector del host. Las credenciales son independientes del host MCP — cualquier cliente OAuth que admita Código de Autorización + PKCE puede usarlas. El recorrido a continuación utiliza la aplicación web Claude.ai como el ejemplo más común.

En bug_Agent_: abre Configuración → Desarrolladores → Conectores MCP. Haz clic en Generar conector, asígnale un nombre que describa el host (p. ej., "Claude.ai (trabajo)"), pega la URI de redirección que tu host MCP requiere (para la aplicación web Claude.ai es https://claude.ai/api/mcp/auth_callback — consulta la documentación del conector de tu host para otras), y elige Confidencial para el método de autenticación. Copia el client_id y client_secret que se muestran una vez en la pantalla de éxito.
En la configuración del conector/OAuth de tu host MCP, pega:
- URL del servidor: https://mcp.bugagent.com/mcp
- ID de cliente + Secreto de cliente: del paso 1
- URL de autorización: https://mcp.bugagent.com/authorize
- URL de token: https://mcp.bugagent.com/token
  Para Claude.ai específicamente: ve a claude.ai/customize/connectors y haz clic en Añadir conector MCP.
Guarda. El host te redirige a bug_Agent_ para iniciar sesión (Google o correo/contraseña — el método que uses para el panel) y aprobar el consentimiento, luego completa el intercambio OAuth.
Gestiona y revoca los conectores generados desde la misma página de Configuración. La revocación es inmediata — la siguiente solicitud de ese conector devuelve invalid_client.

Nota: Claude Code, Cursor, VS Code y el Inspector MCP no necesitan este flujo — gestionan el registro dinámico de clientes (RFC 7591) automáticamente y se autentican mediante clave API como se muestra arriba. El formulario de Conectores MCP es solo para hosts que requieren credenciales OAuth estáticas.

Opción 8 — HTTP directo con curl (Terminal)

Si quieres probar el servidor directamente sin ningún cliente, o integrarlo en un script, puedes acceder al endpoint HTTP con curl. El protocolo MCP es JSON-RPC 2.0 sobre HTTP Streamable.

macOS / Linux

Terminal

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

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

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

Windows (PowerShell)

PowerShell

# Set your API key
$env:BUGAGENT_API_KEY = "ba_live_YOUR_KEY_HERE"

# Use Invoke-RestMethod (PowerShell's curl equivalent)
$headers = @{
  "Authorization" = "Bearer $env:BUGAGENT_API_KEY"
  "Content-Type" = "application/json"
  "Accept" = "application/json, text/event-stream"
}

# 1. List all tools
$body = '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Invoke-RestMethod -Uri "https://mcp.bugagent.com/mcp" `
  -Method Post -Headers $headers -Body $body

# 2. Call list_bug_reports for a specific project
$body = @{
  jsonrpc = "2.0"
  id = 2
  method = "tools/call"
  params = @{
    name = "list_bug_reports"
    arguments = @{ project = "bugagent"; limit = 5 }
  }
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Uri "https://mcp.bugagent.com/mcp" `
  -Method Post -Headers $headers -Body $body

Las respuestas llegan como Eventos enviados por el servidor (el estándar MCP Streamable HTTP). Cada fragmento es una línea con prefijo data: seguida de un objeto JSON. El encabezado Accept: application/json, text/event-stream es obligatorio — el servidor rechaza las solicitudes sin él.

ℹ️

Solución de problemas 401 No autorizado: Comprueba que tu clave API no haya sido revocada en Configuración → Desarrolladores. Las claves comienzan con ba_live_. Si sigues atascado, regenera la clave y vuelve a intentarlo.

Pruébalo — Indicaciones en lenguaje sencillo

Una vez conectado, no necesitas saber los nombres de las herramientas ni los parámetros. Describe lo que quieres en inglés sencillo y tu asistente de IA llamará a la herramienta correcta de bug_Agent_ automáticamente.

Informes de errores

Pregunta a tu asistente de IA

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

Gestión de pruebas

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

Seguridad y rendimiento

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?

Automatización de 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

IA exploratoria

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?

Uso y estadísticas

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?

Referencia rápida

Ubicaciones de los archivos de configuración para los ocho clientes. Cada cliente se conecta a https://mcp.bugagent.com/mcp con el encabezado Authorization: Bearer ba_live_YOUR_KEY_HERE mediante HTTP Streamable.

Cliente Ubicación de configuración / comando

Inspector MCP Sin archivo — ingresa URL + encabezado de autenticación en la interfaz del navegador después de 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 Configuración → interfaz MCP, o ~/.cursor/mcp.json

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

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

HTTP directo (curl) curl / Invoke-RestMethod — incluye Accept: application/json, text/event-stream

Solución de problemas

Síntoma Solución

401 Unauthorized La clave es incorrecta, expiró o fue revocada. Comprueba Configuración → Desarrolladores — las claves comienzan con ba_live_. Regenera si es necesario.

Las herramientas no aparecen en el cliente Cierra y vuelve a abrir el cliente por completo después de editar la configuración. En Claude Desktop, Cmd+Q (no solo cerrar la ventana). En Cursor, comprueba Configuración → MCP para ver el punto verde.

Accept header required Las llamadas HTTP directas deben incluir Accept: application/json, text/event-stream — la especificación Streamable HTTP lo requiere. El servidor devuelve 406 sin él.

Datos del espacio de trabajo incorrecto Cada clave API está limitada a un espacio de trabajo. Genera una nueva clave desde el espacio de trabajo que quieras consultar en Configuración → Desarrolladores.

Las herramientas aparecen pero las llamadas fallan silenciosamente Confirma que el servidor es accesible: curl -I https://mcp.bugagent.com/health debería devolver 200. Si se agota el tiempo de espera, revisa las reglas de red/firewall.

Error CORS del Inspector MCP Selecciona Proxy (no Directo) para el Tipo de conexión en la interfaz del Inspector. El Inspector se conecta a través de un proceso local de Node para evitar las restricciones CORS del navegador.

Codex CLI — herramientas no reconocidas Verifica que ~/.codex/config.toml usa [[mcp_servers]] (doble corchete, sintaxis de matriz). Comprueba que la versión de Codex CLI sea lo suficientemente reciente para admitir MCP (codex --version).

Funciones de MCP

El servidor MCP de bug_Agent_ proporciona herramientas para:

🐛

Gestión de Informes de Errores

create_bug_report — Presentar un nuevo informe con clasificación automática entre 19 tipos — errores, solicitudes de funciones, mejoras, deuda técnica y más (título: 3-500 caracteres). El array opcional attachments acepta archivos codificados en base64 de hasta 400 MB cada uno: cualquier imagen, video, audio, PDF o texto/JSON. Establece format_description: true para reformatear automáticamente la descripción en una plantilla estructurada usando IA. Pasa time_spent_seconds para hacer seguimiento del esfuerzo de QA. Pasa priority (urgent / high / normal / low) para establecer la urgencia de la corrección independientemente de la severidad. Pasa is_epic: true para crear una Épica, o parent_epic_id (UUID/ID corto) para crear un hijo en el mismo proyecto autorizado. La respuesta incluye campos de jerarquía además de project_id, project, short_id, legacy_short_id y project_short_id.
list_bug_reports — Listar y filtrar informes (máx. 100 por página). Los filtros de proyecto se aplican en el servidor antes de la paginación. Filtra por project (UUID, slug, nombre exacto o prefijo de ticket), project_id, project_slug, project_prefix, workspace (UUID, nombre exacto o prefijo de ticket del espacio de trabajo), workspace_id/team_id, is_epic, type, severity, status, resolution, root_cause o reporter_user_id. Cada resultado incluye identificadores de personas/proyectos con alcance de tenant además de is_epic, parent_epic_id, parent_epic y epic_progress acotado. Las herramientas de lectura de informes no exponen las direcciones de correo de los miembros.
pick_next_bug — Devuelve el/los siguiente(s) error(es) en los que el bucle del agente debería trabajar, en orden de prioridad (S1 → S2 → S3, los más antiguos primero dentro de cada grupo). Se limita automáticamente a tu espacio de trabajo — devuelve tickets de todos los proyectos de tu equipo con status new, awaiting-triage o confirmed y severidad S1-S3. Solo lectura — no reclama tickets atómicamente. severity opcional (un solo nivel), limit (1-50, predeterminado 1). Devuelve filas con la misma forma que list_bug_reports para la componibilidad de herramientas. Combínalo con claim_bug para el patrón leer-luego-reclamar.
claim_bug — Transiciona atómicamente un error de status new, awaiting-triage o confirmed a status='in-progress', establece assigned_to al usuario que llama y sella claimed_at=NOW(). Sin condiciones de carrera entre llamadores concurrentes gracias al patrón UPDATE-WHERE-RETURNING de Postgres — si dos agentes llaman a claim_bug sobre el mismo id en rápida sucesión, exactamente uno recibe claimed:true con el cuerpo del error y el otro recibe claimed:false con una cadena de motivo. Las respuestas exitosas incluyen reporter_user_id, reporter_name, assigned_to y assignee_name. Un reaper de pg_cron libera reclamos vencidos (estado=in-progress + claimed_at > 30 minutos de antigüedad) de vuelta a new automáticamente, de modo que los tickets de un agente caído vuelven a la cola sin intervención manual. Entradas: id (UUID o ID corto).
get_bug_report — Obtiene los detalles completos de un informe por UUID o ID corto de espacio de trabajo/proyecto. Devuelve los campos estándar de personas/proyecto/calidad además de is_epic, la identidad del padre, el progreso agregado y una primera página acotada de hijos para Épicas.
list_epic_children — Pagina los informes hijos de una Épica con id, limit (1–100) y offset. Devuelve children, total, has_more y epic_progress agregado por SQL sin cargar cada informe hijo.
update_bug_report — Actualiza los campos estándar del informe además de is_epic y parent_epic_id. Pasa parent_epic_id: null para desvincular; la reasignación/desvinculación es atómica y requiere autorización del mismo espacio de trabajo y del mismo proyecto. Promover a Épica desvincula un padre existente, mientras que una Épica con hijos no puede degradarse. Se siguen aplicando las reglas existentes de estado/resolución/causa raíz y notificación de asignación.
add_comment — Agrega un comentario a un informe de error (UUID o ID corto, cuerpo de 1-10000 caracteres). Si el informe está sincronizado con Jira, el comentario se envía automáticamente al issue vinculado de Jira.
list_comments — Lista el hilo de comentarios completo de un informe, del más antiguo al más reciente — cada comentario con nombre del autor, parentId (respuestas en hilo) y marcas de tiempo. Los comentarios no forman parte de get_bug_report, así que así es como se lee la discusión de un ticket. Acepta UUID o ID corto.
link_bug_reports — Crea un vínculo semántico direccional entre dos informes en el mismo proyecto autorizado. Para parent-of, el informe de origen debe ser una Épica y el informe de destino un hijo estándar. Prefiere parent_epic_id al crear/actualizar para la asignación de Épicas.
unlink_bug_reports — Elimina un vínculo de informe de error creado previamente por su UUID (link_id, devuelto por link_bug_reports o list_bug_report_links).
list_bug_report_links — Lista todos los vínculos curados por el usuario que tocan un informe de error. Devuelve cada vínculo tal como se lee desde la perspectiva del informe proporcionado — por ejemplo, una fila duplicate-of almacenada donde este informe es el destino se muestra como duplicated-by; parent-of donde este informe es el destino se muestra como subtask-of; depends-on donde este informe es el destino se muestra como blocks; testing-blocked-by donde este informe es el destino se muestra como blocks-testing. related-to es simétrico. Complementa el campo similar_reports auto-detectado devuelto por get_bug_report.
classify_bug — Clasifica una descripción en uno de los 19 tipos de informe (errores, funciones, mejoras, etc.) con puntuación de confianza
flush_reports — Eliminación masiva de informes antiguos (solo administrador)

📊

Uso y Análisis

get_usage — Verifica el uso contra los límites del plan. Los llamadores con clave de API requieren usage:read.
get_stats — Conteos diarios, desgloses por tipo/severidad/estado

📁

Gestión de Proyectos

list_projects — Lista los proyectos disponibles con id, name, slug, ticket_prefix, descripción y estado predeterminado. Usa esos valores con create_bug_report y list_bug_reports para apuntar al proyecto correcto.
create_project — Crea un nuevo proyecto (se vuelve predeterminado automáticamente si es el primero)
delete_project — Elimina permanentemente un proyecto y todos los datos asociados (informes de errores, automatizaciones, casos de prueba, aplicaciones móviles, programaciones, geo snaps, notas, registros de tiempo). Solo propietario/gestor. No se puede eliminar el último proyecto. El almacenamiento se libera automáticamente
export_okf_bundle — Exporta el conocimiento de QA de un proyecto — informes de errores, casos de prueba, automatizaciones y pruebas de rendimiento, seguridad y exploratorias — como un paquete markdown OKF/OQA (el formato Open Query Agent usado por oqa.ai). Se usa por defecto el proyecto activo; pasa el project opcional (slug o nombre) para exportar uno diferente. Devuelve la lista de archivos del paquete además del propio paquete como un zip codificado en base64

🔐

Autenticación y Cuenta

register_account — Crea una nueva cuenta (contraseña: 8-128 caracteres, límite de frecuencia: 5/15min)
login — Inicia sesión y recibe tokens de acceso (límite de frecuencia: 5/15min)
update_profile — Actualiza el nombre para mostrar
change_password — Cambia la contraseña de la cuenta
get_settings / update_settings — Gestiona preferencias

🔑

Gestión de Claves de API

generate_api_key — Crea una clave de API con nombre
list_api_keys — Lista las claves activas (solo prefijo)
regenerate_api_key — Revoca y reemplaza una clave
delete_api_key — Revoca una clave permanentemente

👥

Gestión de Equipos

list_team_members — Lista todos los miembros de tu espacio de trabajo con roles, estado y marcadores de refuerzo
invite_team_member — Invita a un usuario por correo electrónico (los gestores pueden invitar colaboradores y gestores; solo los propietarios pueden invitar administradores). Enlace de expiración a 5 días

🎯

Integraciones

sync_to_jira — Sincroniza un informe con Jira usando la conexión compartida del equipo
push_to_claude — Genera (o regenera) las Notas del Desarrollador para un informe de error — causa raíz, corrección sugerida, pasos de verificación y evaluación de riesgos. Acepta UUID o ID corto (WRKID-545). Usa claves de la plataforma — no se requiere conexión de Claude por equipo. Ejecuta una cadena adaptativa: tres pasos en errores s3/medium o s4/low (borrador de Sonnet → crítica de OpenAI gpt-5 → síntesis de Sonnet), cinco pasos en los dos niveles superiores de severidad — s1/critical o s2/high — (borrador → crítica → refutación de Sonnet → árbitro Claude Opus que lee la transcripción completa y escribe las notas finales con juicio independiente). La respuesta expone cada ronda: analysis, draft, critique, rebuttal, challenger_model, adjudicator_model y un indicador debated. Si algún paso falla, se degrada a la siguiente mejor respuesta. Se dispara automáticamente al crear un error; normalmente solo se llama para regeneración manual.
analyze_fix_area — Genera (o regenera) el sub-bloque "Área de Corrección Probable" de las Notas del Desarrollador — una salida estrecha de Sonnet que nombra dónde en el código es más probable que pertenezca la corrección. Acepta UUID o ID corto. Usa la clave Anthropic de la plataforma. Cuando el equipo tiene una fila github_connections y el proyecto tiene un github_repo mapeado, la salida se fundamenta en fragmentos de archivos reales del repositorio conectado; de lo contrario, recurre a guía general con una sugerencia para conectar un repositorio. Devuelve texto likely_fix_area, generated_at, repo_used y un indicador grounded. Se dispara automáticamente al crear un error — los agentes normalmente solo necesitan llamarlo para regeneración manual.
upgrade_plan — Obtiene el enlace de inscripción Enterprise asistido por ventas

⚡

Pruebas de Rendimiento

create_performance_test — Crea una configuración de prueba de rendimiento con URL, dispositivo, usuarios virtuales, duración, umbral de puntuación y conmutador de creación automática de errores. Solo Enterprise
run_performance_test — Dispara una auditoría de página y una prueba de carga para una prueba de rendimiento web. Devuelve un ID de ejecución para consultar los resultados. Las ejecuciones de perfilado de aplicaciones móviles se disparan desde el panel de control
get_performance_results — Obtiene resultados completos, incluidas las puntuaciones de Lighthouse (Rendimiento, Accesibilidad, Buenas Prácticas, SEO), Core Web Vitals (LCP, FID, CLS, FCP, TTFB, INP, TBT, SI) y métricas de prueba de carga (VU, solicitudes, RPS, latencias p50/p90/p95/p99)
list_performance_tests — Lista todas las configuraciones de prueba de rendimiento del equipo actual
get_performance_usage — Verifica el uso mensual de pruebas de rendimiento. Las pruebas de rendimiento son solo para Enterprise. Gratis=0, Enterprise=ilimitado

Flujo de Trabajo de Ejemplo

get_performance_usage → verifica la cuota restante
create_performance_test → configura una prueba para tu URL
run_performance_test → dispara la auditoría + prueba de carga
get_performance_results → revisa las puntuaciones y las métricas vitales

🛡

Escaneo de Seguridad

create_security_scan — Crea una configuración de escaneo de seguridad. Los escaneos web usan Quick Scanner + Nuclei (más de 4,000 plantillas) con tres niveles de profundidad y escaneo autenticado opcional. Los escaneos móviles usan MobSF para el análisis binario de APK/IPA. Creación automática de bugs configurable con umbrales de severidad. Solo Enterprise
run_security_scan — Ejecuta un escaneo de vulnerabilidades. Los escaneos web requieren verificación de dominio DNS. Los escaneos móviles requieren una app subida. Devuelve un ID de ejecución para consultar los resultados
get_security_results — Obtén los resultados completos, incluida la puntuación de seguridad (0-100), hallazgos categorizados por severidad (Critical, High, Medium, Low, Info) con referencias CWE, mapeos OWASP, evidencia y guía de remediación
list_security_scans — Lista todas las configuraciones de escaneo de seguridad del equipo actual con la última puntuación y las insignias de auth/depth
get_security_usage — Comprueba el uso mensual de escaneos de seguridad. El escaneo de seguridad es solo Enterprise. Enterprise = ilimitado
list_security_schedules — Lista todos los escaneos de seguridad programados del equipo con cron, zona horaria, estado habilitado, próxima ejecución y ajustes de notificación. Se une con la configuración de escaneo principal (name, scan_type, target_url)
create_security_schedule — Crea una programación recurrente para un escaneo de seguridad. Requiere scan_id y cron_expression. Una programación por configuración de escaneo. Opcionales: timezone, notify_on_fail (none/email/slack/both), notify_email, slack_channel_id. Cada ejecución cuenta para tu límite mensual; los usuarios administradores omiten el límite. La profundidad del escaneo siempre se lee de la configuración de escaneo en el momento de la ejecución
delete_security_schedule — Elimina un escaneo de seguridad programado. No afecta a la configuración de escaneo principal ni a las ejecuciones completadas

get_security_usage → comprueba la cuota restante
create_security_scan → configura un escaneo para tu URL o repositorio
run_security_scan → ejecuta un escaneo de vulnerabilidades único
create_security_schedule → automatiza ejecuciones recurrentes (p. ej., SAST semanal en la rama principal)
get_security_results → revisa los hallazgos y la remediación

📖

Code Review

list_code_reviews — Lista las revisiones de código de IA recientes del equipo. Devuelve puntuaciones de calidad, recuentos de severidad, información de PR y marcas de tiempo. Solo Enterprise
get_code_review — Obtén una revisión de código con todos los hallazgos. Cada hallazgo incluye severidad, categoría (bug/security/performance/style/logic/maintainability), título, descripción, sugerencia de código, ruta de archivo y números de línea
get_code_review_usage — Comprueba el uso de la revisión de código. La revisión de código con IA es solo Enterprise; ilimitada en Enterprise
get_code_review_analytics — Obtén analíticas de revisión: tendencias, categorías/fuentes de hallazgos, desglose de severidad, métricas de velocidad, principales repos/autores. Admite períodos de 7/30/90 días

get_code_review_usage → comprueba las revisiones restantes
Revisa un PR en el panel de control en /dashboard/code-review
list_code_reviews → consulta revisiones recientes
get_code_review → obtén hallazgos y sugerencias

🔍

Exploratory AI

Buscador de bugs autónomo para sitios web con múltiples agentes, hasta 10 agentes en paralelo, cada uno con una estrategia de prueba diferente.

list_explorations — Lista las configuraciones de Exploratory AI del equipo
create_exploration — Crea una nueva exploración. Acepta agent_count (1–10, máx. 10) para ejecutar múltiples agentes en paralelo con estrategias únicas: happy_path, edge_case, security, accessibility, error_path, performance, mobile, data_integrity, navigation, custom
get_exploration — Obtén la configuración de exploración con ajustes de agente, metadatos de autenticación seguros y ejecuciones recientes. Las contraseñas y el texto cifrado nunca se devuelven.
get_exploration_run — Obtén los resultados de ejecución con progreso por agente, datos de fase, hallazgos con atribución de agente (agent_index, agent_strategy) y bugs vinculados
get_exploration_usage — Comprueba el uso mensual. Exploratory AI es solo Enterprise; Enterprise: ilimitado (10 agentes)

create_exploration con agent_count: 5 → configura 5 agentes en paralelo
Ejecuta una prueba desde el panel de control o mediante POST /api/explorations/run
get_exploration_run → consulta el progreso por agente y los hallazgos
Consulta los hallazgos deduplicados con atribución de agente en el panel de control

📝

Notes

list_notes — Lista las notas con búsqueda de palabras clave opcional, filtro de proyecto, filtro de autor y rango de fechas. Devuelve las notas que el usuario posee o las notas compartidas dentro del equipo.
create_note — Crea una nota en uno de los 5 formatos: markdown, plain_text, rich_text, checklist, outline. Establece visibility en private o shared. Título automático a partir de los primeros 30 caracteres si no se proporciona título. El array opcional attachments acepta archivos codificados en base64 de hasta 400 MB cada uno: cualquier imagen, vídeo, audio, PDF o texto/JSON. Pasa time_spent_seconds para registrar el esfuerzo de QA.
get_note — Obtén los detalles completos de la nota, incluidos contenido y adjuntos. Requiere id.
update_note — Actualiza título, contenido, formato, visibilidad, proyecto o time_spent_seconds. Pasa un array attachments para adjuntar archivos nuevos (máx. 400 MB cada uno) a los adjuntos existentes de la nota sin reemplazarlos. Solo el autor puede actualizar. Requiere id.
delete_note — Elimina permanentemente una nota y sus adjuntos. Solo el autor puede eliminar. Requiere id.

create_note → inicia una nota de sesión de pruebas
update_note → añade observaciones mientras pruebas
list_notes → busca notas anteriores por palabra clave o proyecto
get_note → recupera la nota completa con adjuntos

🤖

Automation

create_automation — Crea una nueva automatización con un script de Playwright personalizado (no requiere grabación FAB). Requiere name. Opcionales: target_url (se deriva automáticamente de la primera URL page.goto(...) del script si se omite), script (Node.js/JavaScript/TypeScript o Python — el lenguaje se detecta automáticamente; por defecto un placeholder), status (draft o active, por defecto: draft), project_id. Devuelve el id de la automatización. Se requiere plan Enterprise. Consejo — Duplica una automatización: usa get_automation para obtener el script original y luego llama a create_automation con name establecido en "[Copy] Original Name" y pasa el script, target_url y project_id originales. La copia comienza con estado draft y sin historial de versiones.
list_automations — Lista los scripts de automatización de Playwright. Filtra por project_id o status (draft, active, paused). Devuelve un array de automatizaciones con name, target_url, last_run_status y run_count.
get_automation — Obtén los detalles completos de la automatización, incluidos el script de Playwright y las ejecuciones recientes. Requiere id. Devuelve la automatización con el script en vivo, una pila script_versions (de más antigua a más reciente, hasta 100 entradas anteriores, cada una { script, source, timestamp }) y un array recent_runs donde cada ejecución lleva el script_version_label/script_version_source que se ejecutó. Llama a esto antes de run_automation si necesitas elegir una versión histórica específica.
run_automation — Ejecuta inmediatamente una prueba de Playwright. Requiere automation_id. Localizadores auto-reparables (automáticos): cuando una acción de localizador agota el tiempo de espera, el ejecutor pide a Claude un selector que funcione y reintenta el paso una vez — las aserciones nunca se reparan, por lo que las regresiones reales siguen fallando — y cada reparación se registra en la salida estándar de la ejecución. Modo virtual (por defecto): device opcional para emulación de viewport (p. ej., desktop, iphone-15). Modo en vivo: establece browserstack: true con bs_browser (chrome, firefox, safari, edge), bs_os (Windows, OS X) y bs_os_version para ejecutar en un navegador de escritorio real. Móvil real en vivo: establece bs_os: "android" (dispositivos: "Samsung Galaxy S25 Ultra", "Google Pixel 10", "OnePlus 13R") o bs_os: "ios" (dispositivos: "iPhone 17 Pro Max", "iPhone 16 Pro Max", "iPhone 15 Pro Max") y pasa el nombre del dispositivo en bs_os_version. Los scripts de Node.js se enrutan a través de browserstack-node-sdk (cubre escritorio + Android + iPhone). Los scripts de Python se enrutan a través de browserstack-sdk (pytest-playwright) y cubren solo escritorio — el móvil real con Python no es compatible porque el browser_type.connect() de pytest-playwright no puede manejar los endpoints de móvil real de BrowserStack. Vídeo y registros de red capturados automáticamente; registros de consola solo en escritorio. Reproducción de versiones: pasa el version_index opcional (entero, indexado desde 0) para ejecutar una entrada anterior del historial script_versions de la automatización. Por defecto: cuando version_index se omite o es null, se ejecuta el script en vivo actual — no pases un valor placeholder solo para "elegir el actual". Los valores fuera de rango, negativos o no enteros se rechazan. El registro de ejecución almacena la instantánea exacta que se ejecutó, y cualquier informe de bug creado automáticamente desde una ejecución fallida enlaza directamente a esa versión en el editor.
list_automation_runs — Lista las ejecuciones recientes de una automatización. Requiere automation_id. Devuelve ejecuciones con status, duration_ms y error_message.
list_schedules — Lista todas las ejecuciones de automatización web programadas con cron, zona horaria, dispositivo y ajustes de notificación
create_schedule — Crea una ejecución de automatización web programada. Requiere automation_id y cron_expression. Admite dispositivo, zona horaria, notify_on_fail (email/slack/both) y opciones de canal de Slack. BrowserStack Live en ejecuciones programadas: pasa browserstack: true con bs_browser, bs_os y bs_os_version — la misma matriz de dispositivos que run_automation (Node = escritorio + Android real + iPhone real; Python = solo escritorio).
delete_schedule — Elimina una ejecución de automatización web programada
list_mobile_schedules — Lista todas las ejecuciones de automatización móvil programadas con dispositivos, cron, zona horaria y notificaciones
create_mobile_schedule — Crea una ejecución de automatización móvil programada en dispositivos reales. Requiere automation_id, cron_expression y el array devices
delete_mobile_schedule — Elimina una ejecución de automatización móvil programada
optimize_automation_script — Envía un script de Playwright a Sonnet 4 para optimización impulsada por IA. Aplica una lista de verificación de 12 puntos que corrige selectores, estrategias de espera, aserciones, manejo de errores, patrones de autenticación, compatibilidad móvil y modo estricto. Requiere automation_id. La versión actual del script se guarda antes de la optimización. Devuelve el script optimizado y un resumen de cambios.
undo_automation_script — Revierte un script de automatización a su versión anterior. Se conservan hasta 10 versiones anteriores. Requiere automation_id. Devuelve el script restaurado y el número de versiones restantes.

create_automation → crea una prueba con un script personalizado
list_automations → explora las pruebas disponibles
get_automation → inspecciona el script de Playwright
run_automation → ejecuta la prueba
list_automation_runs → comprueba resultados y duración

⏱️

Time Tracking

list_time_entries — Lista las entradas de tiempo del equipo. Filtra por period (today, week, month, all), project_id, category y sort (newest, oldest, most_time, least_time). Solo plan Enterprise.
create_time_entry — Registra el tiempo dedicado a tareas de QA. Requiere description, category y duration_minutes. Opcionalmente establece project_id y entry_date (por defecto, hoy). Solo plan Enterprise.
update_time_entry — Actualiza una entrada de tiempo existente. Requiere id. Puede actualizar description, category, duration_minutes, project_id o entry_date. Solo plan Enterprise.
delete_time_entry — Elimina permanentemente una entrada de tiempo. Requiere id. Solo plan Enterprise.

create_time_entry → registra 45 minutos de pruebas de regresión
list_time_entries → consulta las entradas de tiempo de esta semana
update_time_entry → ajusta la duración o la categoría
delete_time_entry → elimina una entrada incorrecta

☑️

Test Cases

Gestión de pruebas con carpetas jerárquicas, suites anidadas (hasta 3 niveles de profundidad con auto-expansión de sub-suites en las ejecuciones), reordenamiento por arrastrar y soltar, y una pestaña de Informes de analítica con tendencias de KPI, análisis de fallos, salud de suites, cobertura y productividad de testers. Todas las herramientas llaman a Supabase directamente — sin roundtrip HTTP, misma latencia que el panel.

Límites gratuitos: 10 casos de prueba almacenados, 1 suite, 3 carpetas, 128 KB de contenido estructurado por caso, 2 claves API de workspace activas y 10 ejecuciones de prueba totales por mes calendario UTC. Hasta 3 de esas ejecuciones pueden usar Hermes u otro agente externo, con 1 ejecución externa activa y como máximo 10 casos en cada plan externo. El tráfico MCP gratuito con clave API está limitado a 30 solicitudes por clave y 60 por workspace por minuto. El almacenamiento de casos de prueba y las ejecuciones Enterprise son ilimitados, sujetos a las protecciones generales de la plataforma.

La generación de casos de prueba con IA, las sugerencias de etiquetas con IA, la importación de Figma y los archivos adjuntos de casos de prueba requieren Enterprise. El límite gratuito de 128 KB de contenido estructurado es independiente de los archivos adjuntos de Enterprise. Free puede almacenar referencias URL. Las herramientas MCP principales de casos de prueba siguen disponibles en Free dentro de los límites anteriores.

Ejecución sin manos: la página de revisión de ejecución es un carrusel con un caso visible a la vez, atajos de teclado (P Aprobar · F Fallar · B Bloquear · S Omitir) y control por voz. Haz clic en el micrófono y luego di "Aprobar", "Fallar", "Bloquear", "Omitir", "Siguiente", "Anterior", "Añadir notas" (transcribe al campo de notas), "Guardar notas" o "Voz desactivada". Avanza automáticamente al siguiente caso sin probar en resultados exitosos; se queda en Fallar para que los testers puedan dictar detalles y crear un bug. Funciona en Chrome, Edge y Safari.

Casos y Carpetas

list_test_cases — Lista casos de prueba con search, priority opcionales (critical, high, medium, low), type (functional, regression, smoke, integration, performance, security, usability, exploratory), status (active, draft, deprecated) y sort (newest, oldest, name, priority). Los llamadores con clave API requieren test_cases:read.
create_test_case — Crea un caso de prueba. Dos variantes de plantilla: steps (predeterminada) — cuadrícula de { action, expected } por paso mediante el array steps; text — descripción libre única mediante text_content. Ambos campos pueden enviarse en la misma llamada (la plataforma los almacena de forma independiente para que un tester que cambie template_type más tarde no pierda los datos de ninguno de los dos lados). El array urls opcional (máx. 10 URLs http/https) adjunta enlaces de referencia y está disponible en Free. Requiere name. Opcional: description, preconditions, template_type, steps, text_content, urls, priority, type, tags, estimated_time (segundos). Los archivos adjuntos requieren Enterprise y se suben mediante el endpoint POST /api/test-cases/:id/attachments del panel (multipart) — aún no expuesto como herramienta MCP. Los llamadores con clave API requieren test_cases:write.
get_test_case — Obtiene los detalles completos del caso de prueba, incluidos los pasos y el historial de ejecución.
list_test_case_folders — Lista las carpetas del equipo (una carpeta por caso mediante folder_id; distintas de las suites, que son agrupaciones de planes de prueba muchos-a-muchos). Limitado a 500; respeta los filtros project_id y parent_folder_id (usa "root" para solo nivel superior).
create_test_case_folder — Crea una carpeta (anida hasta 3 niveles mediante parent_folder_id). Usa bulk_update_test_cases para mover casos a ella. Los llamadores con clave API requieren test_cases:write.
bulk_update_test_cases — Aplica una acción a hasta 500 casos a la vez: set_priority, set_status, set_type, add_tags, remove_tags, add_to_suite, pin, unpin.
link_test_case_to_bug — Establece trazabilidad entre un caso de prueba y un informe de bug (verified_by, covers o relates).
list_test_case_links — Lista todos los enlaces de trazabilidad de un caso de prueba.
list_test_case_review_candidates — Indicadores de pruebas muertas: never_run (90+ días desde la creación), always_passes (5+ pases consecutivos en 90 días), always_skipped (3+ omisiones consecutivas).
mark_test_case_review_flags — Persiste los indicadores actuales de candidatos a archivo en test_cases.review_flag. Se ejecuta automáticamente cada lunes a las 09:00 UTC mediante pg_cron.

Importaciones

Importación de Figma (Enterprise) (UI del panel + REST): sube una exportación zip de marcos de Figma (hasta 100 MB), Claude analiza cada pantalla y redacta casos de prueba en una carpeta que elijas o crees. Pipeline de múltiples pasadas (clasificar → casos por pantalla → casos a nivel de flujo entre pantallas con prefijo compartido → autocrítica) con caché de prompts, reintento 429 y aislamiento de errores por marco para que un marco defectuoso no falle el lote. Los casos llegan como status=active, etiquetados ai_generated=true, con source='figma' y source_frame_name conservando un enlace al marco original. Usa la clave Anthropic de la plataforma — no se requiere conexión Claude por equipo. Endpoints: POST /api/test-cases/import/figma/request, POST /api/test-cases/import/figma/start, GET /api/test-cases/import/figma/:id.

Suites y Ejecuciones

list_test_suites — Lista suites de prueba con identidad de proyecto, número de casos y estado de la última ejecución. Los llamadores con clave API requieren test_runs:read.
create_test_suite — Crea una suite. Anida hasta 3 niveles mediante parent_suite_id.
list_test_runs — Lista ejecuciones de prueba con nombre de suite, asignado y resumen de aprobados/fallidos.
create_test_run — Crea una ejecución de suite gestionada por el panel. Ejecutar una suite principal incluye automáticamente todos los casos de cada sub-suite descendiente (un caso vinculado a ambas se añade exactamente una vez). Cada fila de test_run_results registra de qué sub-suite de origen proviene el caso, para que las páginas de resultados puedan agrupar por origen.

Ejecución con Agente Externo

Estas herramientas permiten que Hermes u otro runtime de agente ejecute una suite aprobada sin convertirse en el sistema de registro de QA. Usa una clave con ámbito de workspace que tenga solo test_runs:read y test_runs:write. La suite proporciona el límite del proyecto; los llamadores no pueden anularlo.

start_test_plan — Inicia o reanuda una instantánea de suite inmutable con un external_run_id estable. Un ID repetido devuelve la ejecución coincidente existente y la primera página en lugar de crear un duplicado.
get_test_run_plan — Lee el estado canónico de la ejecución y una página de plan estable. Pasa el next_cursor anterior; las páginas tienen por defecto 100 casos y están limitadas a 200.
report_test_results — Envía de 1 a 200 resultados con estado passed, failed, blocked o skipped. Los reintentos exactos son seguros; intentar sobrescribir un caso con otro estado se rechaza.
abort_test_run — Detiene de forma idempotente una ejecución interrumpida conservando los resultados parciales aceptados y el resumen canónico.

Comportamiento de cuota: reintenta start_test_plan con el mismo external_run_id para reanudar la ejecución coincidente sin consumir otra ejecución. Eliminar datos no restablece el uso mensual de ejecuciones.

Límite del runtime: las instantáneas de casos excluyen credenciales, cuerpos de archivos y rutas privadas de adjuntos. La evidencia de resultados es texto en el MVP. Las credenciales objetivo permanecen en el runtime de ejecución. Los costos de navegador, modelo y red permanecen del lado del cliente, y los clientes deben restringir el acceso al objetivo y la salida de red. Un humano sigue siendo responsable de las decisiones sobre defectos y lanzamientos.

La guía del Agente Hermes empaqueta este bucle como una skill comunitaria mantenida por bugAgent. El kit de inicio público contiene una configuración lista para copiar y una skill instalable. No es una integración oficial de Nous Research.

Informes (analítica de Nivel 1 + Nivel 4)

get_test_reports_overview — KPIs principales para una ventana (tasa de aprobación, ejecuciones completadas, casos ejecutados) con deltas frente a la ventana equivalente anterior. Los mismos números que muestra la franja de KPI de la pestaña Informes.
get_test_reports_failures — Cuatro listas de "¿qué corregir?": failing_cases (≥50% de fallos, mín. 3 ejecuciones), flaky_cases (más cambios aprobado/fallido), failing_suites (≥30% de fallos, mín. 5 ejecuciones), regressed_cases (fallo más reciente con un aprobado anterior en la ventana).

create_test_case_folder → crea un árbol de carpetas (p. ej. Smoke → Auth)
create_test_case → define casos; muévelos a carpetas con bulk_update_test_cases
create_test_suite → construye un plan de prueba (sub-suites opcionales, hasta 3 niveles de profundidad)
create_test_run → crea una ejecución gestionada por humano/panel desde una suite principal — las sub-suites se incluyen automáticamente
start_test_plan → inicia o reanuda una ejecución de agente externo segura ante reintentos
get_test_run_plan → recupera todas las páginas del plan inmutable y luego ejecútalo en el runtime seleccionado
report_test_results → devuelve lotes de resultados limitados; llama a abort_test_run si la ejecución no puede continuar de forma segura
get_test_reports_failures → pregunta "¿qué corregir esta semana?" cuando la ejecución se complete
get_test_reports_overview → sigue la tendencia de la tasa de aprobación semana a semana

⚡

Team Booster

scale_team — Escala tu equipo de QA al instante con testers booster. Las cuentas se aprovisionan automáticamente con acceso de tester. Especifica team_size (1–10), location, duration, budget y opcionalmente product_url, product_types y tech_levels. Disponible en el plan Enterprise. No se te cobrará hasta que se haya dado la aprobación.

scale_team → aprovisiona 5 testers senior en EE. UU. por 1 mes
list_team_members → verifica que los nuevos testers aparezcan en tu equipo
list_reports → revisa los informes presentados por los testers booster

📱

Pruebas Móviles (Enterprise)

Los recursos móviles tienen ámbito de proyecto. Pasa project_id o un selector flexible project en creaciones, importaciones y listas filtradas. Las automatizaciones heredan el proyecto de la aplicación vinculada; de lo contrario, el servidor usa el proyecto predeterminado del workspace. Las listas sin filtrar pueden incluir filas heredadas a nivel de workspace hasta que se migren.

list_mobile_apps — Lista las aplicaciones subidas con filtros opcionales project_id/project, platform y limit. Devuelve el project_id de cada aplicación para que los agentes puedan mantener operaciones posteriores en el mismo proyecto.
upload_mobile_app — Registra una aplicación APK (Android) o IPA (iOS) para pruebas en dispositivos reales. Requiere name, platform (android/ios) y file_url; pasa project_id para asignarla al proyecto activo. Para iOS, sube el IPA para ejecuciones en dispositivos reales y luego usa el panel para subir una compilación de simulador .app para grabación.
update_mobile_app — Reemplaza un binario de aplicación con una nueva versión. Limpia las URL en caché y las compilaciones de simulador para que todas las automatizaciones usen la nueva versión en la próxima ejecución. Requiere app_id y file_url. Opcional: version. Si las automatizaciones vinculadas usan perfiles de inicio de sesión, el llamador debe estar autorizado para cada perfil o ser un propietario/administrador activo del espacio de trabajo; los horarios heredan el valor predeterminado de automatización protegida.
list_mobile_automations — Lista las automatizaciones móviles con filtros opcionales project_id/project, app_id, status y limit. Los resultados incluyen project_id y el ID de la aplicación vinculada.
create_mobile_automation — Crea un script de prueba. Requiere name, app_id, script_type (maestro para YAML, appium para Appium Python, appium_js para Appium JavaScript) y script; pasa project_id cuando la aplicación no esté ya en el ámbito del proyecto. Para un flujo Maestro YAML autocontenido y validado externamente, establece execution_mode a browserstack_maestro; de lo contrario, el valor predeterminado es appium_actions. El appId YAML debe coincidir con el paquete o ID de bundle almacenado de la aplicación vinculada; si no hay ninguno almacenado, el primer flujo nativo validado lo establece. Los ID de aplicación de marcador de posición y los ID de recursos de Android ofuscados se rechazan. Se admite runFlow en línea, pero las referencias a archivos de flujo/script externos se rechazan en v1. Maestro nativo conserva comandos como inputRandomText y copyTextFrom además de expresiones en tiempo de ejecución como ${maestro.copiedText} y ${output.value}. Un credential_id del mismo proyecto puede proporcionar valores completos de inputText de ${USERNAME}/${PASSWORD}. Un variable_profile_id del mismo proyecto puede guardar el valor predeterminado para los valores de ${DATA_*} referenciados; cada clave referenciada debe existir. Los perfiles de datos son solo datos sintéticos no secretos.
import_mobile_script — Importa un script de prueba móvil existente y conviértelo en una automatización ejecutable, preservando los localizadores propios del desarrollador para que las ejecuciones resuelvan los elementos con precisión. Dialectos admitidos: Appium‑Python, WebdriverIO, Maestro (flujos YAML) y Playwright (móvil‑web). Los marcadores de posición de ID de recurso de Android ofuscados se omiten y se informan en el mapeo de selectores warnings. Solo aplicaciones Android. Requiere name, app_id y script; opcionales target_devices y project_id. Devuelve la automatización más action_count, dialect detectado y el mapeo de selectores warnings.
run_mobile_automation — Inicia una automatización móvil en un dispositivo real. Requiere automation_id; opcionales device, os_version, credential_id y variable_profile_id de Maestro nativo. Para datos, omite variable_profile_id para heredar el valor predeterminado de la automatización, pasa null para no usar ningún perfil, o pasa un UUID del mismo proyecto para sobrescribir. Cada clave ${DATA_*} referenciada debe existir. Solo el creador activo del perfil o un propietario/administrador activo del espacio de trabajo puede ejecutar un perfil seleccionado. Los valores exactos de credenciales conocidos se filtran y los valores exactos de perfil de datos reciben un filtrado de mejor esfuerzo a partir de evidencia textual persistida; los valores transformados, parciales, codificados o derivados de la aplicación pueden permanecer. Los videos/capturas de pantalla privados autorizados permanecen disponibles y pueden mostrar valores renderizados por la aplicación probada, por lo que los perfiles de datos deben contener solo valores sintéticos no secretos. Si el contexto de redacción de credenciales no está disponible o no se puede demostrar que la sanitización sea segura, se retiene el texto detallado con credenciales mientras permanecen el estado y la evidencia visual disponible. Los diagnósticos requieren autorización del espacio de trabajo y del proyecto; los enlaces de medios caducan después de cinco minutos.
list_mobile_runs — Obtén resultados de ejecución móvil autorizados (estado, dispositivo, resumen de resultados, enlaces privados de video y capturas de pantalla, sesión de BrowserStack, registros nativos de Maestro con credenciales filtrados y fallos cuando estén disponibles de forma segura, y cualquier error creado automáticamente). La membresía del espacio de trabajo y el acceso al proyecto se aplican para los diagnósticos de ejecución. Filtros opcionales: project_id, automation_id, status (queued, running, passed, failed, error, archived) y limit. Las ejecuciones archivadas se excluyen de forma predeterminada.
create_mobile_credential — Crea un perfil de inicio de sesión con nombre (p. ej., “Admin”, “Contributor”) para un proyecto: un nombre de usuario + contraseña utilizados por las automatizaciones móviles. Ambos valores se almacenan cifrados con AES‑256‑GCM y son de solo escritura — ninguna herramienta o API los devuelve jamás, y otros miembros / la interfaz de usuario solo ven el nombre. Solo el miembro activo del espacio de trabajo que lo creó o un propietario/administrador activo del espacio de trabajo puede vincularlo, ejecutarlo, rotarlo o eliminarlo. Requiere project_id, name, username, password. Solo Enterprise.
list_mobile_credentials — Lista los perfiles de inicio de sesión (opcionalmente uno project_id). Devuelve solo campos no secretos (id, name, proyecto, creador, fecha de creación) — nunca el nombre de usuario o la contraseña. Usa el id devuelto como selección de credenciales al ejecutar una automatización.
update_mobile_credential — Renombra un perfil de inicio de sesión o rota su nombre de usuario/contraseña mediante id. Incluye solo los campos a cambiar. Los nuevos valores secretos se cifran inmediatamente y nunca se devuelven. Solo el miembro activo del espacio de trabajo que creó el perfil o un propietario/administrador activo del espacio de trabajo puede actualizarlo.
delete_mobile_credential — Elimina suavemente un perfil de inicio de sesión mediante id. Solo el miembro activo del espacio de trabajo que creó el perfil o un propietario/administrador activo del espacio de trabajo puede eliminarlo. Se conserva para auditoría e historial de ejecuciones, pero ya no es utilizable ni se lista; los valores predeterminados de automatización se limpian y el nombre se vuelve reutilizable.
create_mobile_variable_profile — Crea datos de prueba sintéticos reutilizables y limitados al proyecto con project_id, name y un objeto variables como {"DATA_EMAIL":"qa@example.test","DATA_REGION":"ca"}. Las claves deben ser identificadores DATA_* en mayúsculas. Los perfiles permiten de 1 a 100 cadenas, 4096 bytes UTF-8 por valor y 65536 bytes en total. Se rechazan los nombres reservados de credenciales/tiempo de ejecución. Nunca almacenes credenciales, tokens, datos personales de producción u otros secretos.
list_mobile_variable_profiles — Lista los perfiles y sus valores legibles no secretos para un project_id autorizado. Se aplican las reglas de asignación de proyectos.
update_mobile_variable_profile — Renombra un perfil o reemplaza su objeto variables completo mediante id. Solo el creador activo o un propietario/administrador activo del espacio de trabajo puede actualizarlo.
delete_mobile_variable_profile — Elimina suavemente un perfil mediante id. Solo el creador activo o un propietario/administrador activo del espacio de trabajo puede eliminarlo; los valores predeterminados de automatización se limpian mientras las referencias históricas de ejecución permanecen.
list_mobile_schedules, create_mobile_schedule, delete_mobile_schedule — Lista, crea y elimina horarios de dispositivos reales. Los horarios heredan el contexto del proyecto, el perfil de inicio de sesión y el perfil de variables no secretas de su automatización seleccionada. Un horario que use cualquiera de los perfiles protegidos requiere el creador activo del perfil o un propietario/administrador activo del espacio de trabajo; los cambios y la eliminación de horarios están restringidos al creador activo del horario o a un propietario/administrador activo del espacio de trabajo.

Flujo de ejemplo — Android

list_projects → resuelve el project_id objetivo
upload_mobile_app → registra el APK en ese proyecto
Graba de forma segura en el panel, o usa import_mobile_script / create_mobile_automation
list_mobile_automations → resuelve la automatización en el mismo proyecto
run_mobile_automation → actívala en un dispositivo real, opcionalmente con un perfil de inicio de sesión
list_mobile_runs → verifica el estado, el resumen de resultados, los enlaces visuales privados y los metadatos de la sesión de BrowserStack
Los fallos crean automáticamente informes de errores con instantánea del fallo y desglose de pasos

Flujo de ejemplo — iOS

upload_mobile_app → registra tu IPA con project_id para ejecuciones en dispositivos reales
Sube la compilación de simulador .app en la página de detalles de la aplicación (para grabación)
Graba la prueba en el navegador → las acciones se capturan desde el simulador
run_mobile_automation → activa la automatización guardada en un iPhone (usa el IPA)
update_mobile_app → reemplaza el IPA con una nueva versión cuando esté listo

Flujo de ejemplo — Maestro nativo

upload_mobile_app → registra el APK o IPA en el proyecto objetivo
create_mobile_credential → opcionalmente crea un perfil del mismo proyecto para un flujo autenticado
create_mobile_variable_profile → opcionalmente crea valores sintéticos DATA_* del mismo proyecto utilizados por el flujo
create_mobile_automation → pasa un flujo YAML conocido y funcional con el paquete/bundle exacto de la aplicación vinculada appId, script_type: maestro y execution_mode: browserstack_maestro. Usa ${USERNAME}/${PASSWORD} para el inicio de sesión y marcadores de posición de estilo ${DATA_EMAIL} para entrada sintética; pasa los ID de perfil para guardar los valores predeterminados.
run_mobile_automation → selecciona un dispositivo compatible y opcionalmente sobrescribe el perfil de inicio de sesión o de variables. Omite el perfil de variables para heredar, o pasa null para deshabilitarlo en una ejecución.
list_mobile_runs → inspecciona los resúmenes de aprobado/fallido autorizados, videos/capturas de pantalla privados, registros filtrados, nombres de pasos reales, fallos detallados y metadatos de sesión. Si no se puede establecer una sanitización segura para una ejecución con credenciales, se retiene el texto detallado mientras permanecen el estado y la evidencia visual disponible.

Refina con IA: la beta en lista de permitidos está disponible a través del panel y los endpoints de refinamiento REST. Aún no hay herramientas MCP de Refine en el catálogo público.

✅

Cumplimiento y evidencia (Enterprise)

collect_compliance_evidence — Activa la recopilación automatizada de evidencia desde servicios conectados (Cloudflare, GitHub, Sentry, Supabase, Railway). Devuelve el ID de ejecución. Recopila configuraciones SSL/TLS, estado de WAF, alertas de Dependabot, tendencias de errores, historial de despliegues y más.
check_config_drift — Verifica todos los servicios conectados para detectar desviaciones de configuración de seguridad respecto a las líneas base (modo SSL, versión TLS, HSTS, reglas WAF, cabeceras de seguridad).
generate_access_review — Crea un informe trimestral de revisión de accesos. Audita miembros del equipo, roles, estado de MFA, uso de claves API y genera recomendaciones (p. ej., revocar claves inactivas).
get_security_events — Consulta la línea de tiempo de eventos de seguridad entre servicios. Filtra por fuente (cloudflare, sentry, github) y severidad (critical, high, medium, low, info). Los eventos se correlacionan automáticamente entre servicios.

Cobertura de cumplimiento

Estas herramientas ayudan con los requisitos de cumplimiento de 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) y GDPR (Art. 5, 25, 32, 33).

Clientes compatibles

bug_Agent_ funciona con cualquier cliente que admita el Protocolo de Contexto de Modelo. Aquí tienes guías de configuración para clientes populares:

🤖

Claude Desktop

Abre Configuración → Desarrollador → Editar configuración, luego agrega:

claude_desktop_config.json

Reinicia Claude Desktop después de guardar.

✳️

Cursor

Abre Configuración → Servidores MCP → Agregar servidor, o edita .cursor/mcp.json en la raíz de tu proyecto:

.cursor/mcp.json

🌊

Windsurf

Abre Configuración → MCP → Agregar servidor, o edita tu archivo de configuración MCP:

mcp_config.json

💻

Claude Code (CLI)

Agrega bug_Agent_ directamente desde la terminal:

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

Establece tu clave API con export BUGAGENT_API_KEY=ba_live_... antes de iniciar.

🔧

Otros clientes MCP

Cualquier cliente que admita el transporte stdio de MCP funciona con bug_Agent_. Usa la configuración estándar:

Comando: npx
Argumentos: ["-y", "@bugagent/mcp-server"]
Entorno: BUGAGENT_API_KEY

CLI

Primeros pasos con CLI

La CLI de bug_Agent_ te da control total sobre informes de errores, solicitudes de funciones, proyectos e integraciones desde tu terminal. Úsala para:

Automatiza flujos de trabajo — Integra el informe de errores en pipelines de CI/CD, scripts y trabajos cron
Operaciones masivas — Lista, filtra y gestiona informes sin salir de tu terminal
Salida compatible con pipes — Formatos JSON, YAML y sin procesar para componer con jq, yq y otras herramientas
Iteración rápida — Sin necesidad de navegador: crea y actualiza informes en segundos

Instalación

npm install -g @bugagent/cli

Verifica la instalación:

bugagent --version

Autenticación

Establece tu clave de API como variable de entorno:

O pásala directamente con la bandera --api-key:

bugagent reports list --api-key ba_live_your_key_here

🔑

Obtén tu clave de API desde la consola de bug_Agent_. Las claves comienzan con ba_live_.

Para autenticación persistente, agrega la exportación a tu perfil de shell (~/.bashrc, ~/.zshrc, etc.).

Uso

Los comandos siguen el patrón:

bugagent <resource> <action> [flags]

Los recursos también pueden usar sintaxis de dos puntos para subrecursos:

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

Usa --help en cualquier comando para obtener detalles:

bugagent reports --help
bugagent reports create --help

Sesión de ejemplo

Terminal

# List your projects
bugagent projects list

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

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

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

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

# Check your usage
bugagent usage get --format json

Características de la CLI

La CLI proporciona comandos para:

reports Crear, listar, obtener, actualizar y vaciar informes de errores

projects Crear, listar, actualizar y eliminar proyectos

keys Generar, listar, regenerar y revocar claves de API

jira Conectar, sincronizar informes y configurar ajustes de Jira

usage Verificar el uso actual contra los límites del plan

stats Ver análisis y desgloses

profile Ver y actualizar tu perfil y configuración

auth Iniciar sesión, registrarse y gestionar credenciales

Banderas Globales

Descripción de la bandera

--api-key <key> Sobrescribir la clave de API para este comando

--format <fmt> Formato de salida: json, yaml, pretty, raw

--debug Mostrar detalles de solicitud/respuesta para solucionar problemas

--help Mostrar ayuda para cualquier comando

--version Imprimir la versión de la CLI

Formatos de Salida

La CLI admite múltiples formatos de salida para diferentes casos de uso:

`json`

JSON legible por máquina. Ideal para canalizar a jq u otras herramientas.

`yaml`

Salida YAML amigable para humanos, para archivos de configuración y legibilidad.

`pretty`

Predeterminado. Salida con colores y formato diseñada para la terminal.

`raw`

Salida sin formato. Útil para scripting y automatización.

Filtrado con --transform

Usa --transform con sintaxis GJSON para consultar y filtrar datos de salida:

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

Habilidad de IA

La CLI también está disponible como AgentSkill, lo que permite a los asistentes de codificación de IA usar bug_Agent_ en tu nombre.

✨

¿Qué es un AgentSkill?

Los AgentSkills permiten a los asistentes de codificación de IA (Claude Code, Cursor, etc.) invocar herramientas CLI contextualmente. La habilidad de bug_Agent_ le da a tu asistente de IA la capacidad de reportar errores, verificar el estado del proyecto y sincronizar con Jira, todo sin que escribas un comando.

Instalar la Habilidad

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

Una vez instalado, el Asistente de IA consciente del contexto puede usar comandos de bug_Agent_ de forma natural, con pleno conocimiento de tu producto, pautas de prueba y documentación subida:

Prompt del Asistente de IA

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

La habilidad traduce el lenguaje natural a los comandos CLI apropiados y los ejecuta.

🎬

Replay de Sesión + Asistente de IA: Cuando el Replay de Sesión está habilitado (plan Enterprise), el Asistente de IA puede hacer referencia a la sesión de usuario capturada (clics, navegación, errores y fallos de red de los últimos 60 segundos) para redactar automáticamente informes de errores más ricos y precisos con contexto completo de reproducción.

Obtener Ayuda

¿Necesitas ayuda? Estamos aquí para ayudarte.

Comunidad de Discord

Únete a nuestro Discord para soporte en tiempo real y discusiones comunitarias.

Soporte por Correo Electrónico

support@bugagent.com — Normalmente respondemos dentro de las 24 horas.