bugAgent MCP Server

MCP v1

Navegación

Model Context Protocol

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.

Comunidad de Discord [email protected]

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 Model Context Protocol. Se ejecuta localmente y se comunica con la API en la nube de bug_Agent_.

1

Obtén tu clave API

Regístrate en app.bugagent.com y genera una clave API desde la consola.

2

Configura tu cliente de IA

Añade bug_Agent_ como servidor MCP en la configuración de tu cliente (consulta la configuración más abajo).

3

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

Conectar al servidor

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

🔑

Obtén tu clave API primero. Inicia sesión en app.bugagent.com/dashboard/settings/api-keys, haz clic en Crear clave API y copia el valor (empieza por ba_live_). Solo la verás una vez, así que pégala en un lugar seguro. Todos los ejemplos siguientes usan esta clave.

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

La herramienta oficial de Anthropic. Inicia una IU web local donde puedes hacer clic en cada herramienta, rellenar parámetros y ver las respuestas. Configuración cero, no requiere IDE.

macOS (Terminal)

Terminal

npx @modelcontextprotocol/inspector

Windows (PowerShell o CMD)

PowerShell

En la IU del navegador que se abre:

1. Tipo de transporte: selecciona Streamable HTTP
2. URL: https://mcp.bugagent.com/mcp
3. Tipo de conexión: selecciona Proxy (el predeterminado — el Inspector usa un proxy a través de un proceso Node local para evitar CORS del navegador)
4. Haz clic en la pestaña Autenticación → añade una cabecera personalizada:
   • Nombre de cabecera: Authorization
   • Valor: Bearer ba_live_YOUR_KEY_HERE
5. Haz clic en Conectar. Verás todas las más de 60 herramientas de bug_Agent_ en el panel izquierdo.
6. Haz clic en cualquier herramienta (p. ej., list_bug_reports), rellena los parámetros, haz clic en Ejecutar herramienta. La respuesta se muestra 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 de escritorio Claude, puedes añadir bug_Agent_ como servidor MCP permanente. Claude tendrá entonces todas las herramientas de bug_Agent_ disponibles en cada conversación.

macOS

1. Abre Claude Desktop → barra de menú Claude → Configuración → Desarrollador → Editar configuración. Esto abre ~/Library/Application Support/Claude/claude_desktop_config.json.
2. 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"  
      }  
    }  
  }  
}  

3. Guarda el archivo y cierra completamente Claude Desktop (Cmd+Q, no solo cierres la ventana).
4. Reinicia Claude Desktop. El icono del martillo de herramientas en la parte inferior de la entrada de chat debería mostrar ahora las herramientas de bug_Agent_.
5. Pruébalo: escribe “Lista mis 5 informes de error más recientes” — Claude llamará a list_bug_reports automáticamente.

Windows

1. 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).
2. Añade el mismo bloque JSON mostrado en la sección de macOS.
3. Guarda el archivo y cierra completamente Claude Desktop desde la bandeja del sistema (clic derecho en el icono de Claude → Salir), luego reinicia.
4. El icono del martillo de herramientas 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 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. Empieza a usar 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 la CLI de OpenAI Codex, 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 desde tu indicación en lenguaje natural. Prueba: “Lista mis errores abiertos ordenados por gravedad.”

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 puede registrar errores, listar informes, ejecutar análisis, etc. sin salir de tu editor.

1. Abre Cursor → Configuración (Cmd+, en Mac / Ctrl+, en Windows) → MCP en la barra lateral izquierda.
2. Haz clic en + Añadir nuevo servidor MCP.
3. Selecciona el tipo de transporte HTTP.
4. Rellena:
   • Nombre: bugagent
   • URL: https://mcp.bugagent.com/mcp
   • Nombre de cabecera: Authorization
   • Valor de cabecera: Bearer ba_live_YOUR_KEY_HERE
5. Haz clic en Guardar. Cursor muestra un indicador verde cuando está conectado.
6. Abre el chat de Cursor (Cmd+L / Ctrl+L) y escribe “Crea un informe de error titulado 'Inicio de sesión roto' con gravedad 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 mostrado 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 soporta servidores MCP de forma nativa.

1. Instala la extensión Continue desde el marketplace de VS Code.
2. 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
3. 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"  
        }  
      }  
    }  
  ]  
}  

4. Guarda. Continue se recargará automáticamente y mostrará las herramientas de bug_Agent_ en la barra lateral.
5. Abre el panel de chat de Continue y prueba: “Lista mis análisis 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 — Anfitriones con reconocimiento de OAuth (se muestra Claude.ai web como ejemplo)

Algunos anfitriones 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 anfitriones, generas un par de credenciales OAuth con ámbito de espacio de trabajo desde el panel de bug_Agent_ y lo pegas en el formulario del conector del anfitrión. Las credenciales son independientes del anfitrión MCP — cualquier cliente OAuth que soporte Código de autorización + PKCE puede usarlas. El tutorial a continuación usa la aplicación web Claude.ai como el ejemplo más común.

1. En bug_Agent_: abre Configuración → Desarrolladores → Conectores MCP. Haz clic en Generar conector, asígnale un nombre que describa el anfitrión (p. ej., “Claude.ai (trabajo)”), pega la URI de redireccionamiento que requiere tu anfitrión MCP (para la aplicación web Claude.ai es https://claude.ai/api/mcp/auth_callback — consulta la documentación del conector de tu anfitrión para otros), 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.
2. En la configuración del conector / OAuth de tu anfitrión 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.
3. Guarda. El anfitrión 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 handshake OAuth.
4. 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 MCP Inspector 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 anfitriones 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 transmitible.

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 HTTP transmitible de MCP). Cada fragmento es una línea con el prefijo data: seguida de un objeto JSON. La cabecera Accept: application/json, text/event-stream es obligatoria — el servidor rechaza las solicitudes sin ella.

ℹ️

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

Pruébalo — Indicaciones en lenguaje natural

Una vez conectado, no necesitas saber nombres de herramientas o parámetros. Describe lo que quieras en lenguaje natural y tu asistente de IA llamará a la herramienta correcta de bug_Agent_ automáticamente.

Informes de error

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
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 con 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 archivos de configuración para los ocho clientes. Todos los clientes se conectan a https://mcp.bugagent.com/mcp con la cabecera Authorization: Bearer ba_live_YOUR_KEY_HERE mediante HTTP transmitible.

Cliente Ubicación de configuración / comando

MCP Inspector Sin archivo — introduce la URL y la cabecera de autenticación en la IU 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 → IU de 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, ha caducado o ha sido revocada. Verifica Configuración → Claves API — las claves empiezan por ba_live_. Regenera si es necesario.

Las herramientas no aparecen en el cliente Cierra y reinicia completamente el cliente después de editar la configuración. En Claude Desktop, Cmd+Q (no solo cierres la ventana). En Cursor, verifica Configuración → MCP para un punto verde.

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

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 → Claves API.

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 agota el tiempo de espera, verifica las reglas de red/cortafuegos.

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

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

Funciones MCP

El servidor MCP de bug_Agent_ proporciona herramientas para:

🐛

Gestión de informes de error

• create_bug_report — Presenta un nuevo informe con clasificación automática en 19 tipos: errores, solicitudes de funciones, mejoras, deuda técnica y más (título: 3-500 caracteres). El arreglo 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 rastrear el esfuerzo de QA. Pasa priority (urgent / high / normal / low) para establecer la urgencia de la corrección independientemente de la severidad. La respuesta incluye project_id, project, short_id, legacy_short_id y project_short_id.
• list_bug_reports — Lista y filtra informes (máx. 100 por página). Los filtros de proyecto se aplican del lado del 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, type (una de 19 categorías del panel), severity (s1-s4 o legacy critical/high/medium/low), status (usando los valores exactos del panel: new, awaiting-triage, confirmed, in-progress, blocked, resolved, retesting, closed, reopened — los guiones son intencionales), resolution (fixed / duplicate / works-as-designed / cannot-reproduce / will-not-fix / need-more-info / unresolved), root_cause (etiqueta abierta en formato kebab-case — valores comunes: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch), o reporter_user_id (UUID del miembro del equipo que presentó el informe — llama primero a list_team_members para resolver un nombre a un UUID). Cada resultado incluye reporter_user_id, project_id, project, short_id, legacy_short_id y project_short_id para que los agentes puedan enlazar y actualizar el informe correcto dentro del alcance del proyecto.
• pick_next_bug — Devuelve el/los siguiente(s) error(es) en los que debería trabajar el bucle del agente, en orden de prioridad (S1 → S2 → S3, el más antiguo primero dentro de cada grupo). Automáticamente limitado 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. Parámetros opcionales severity (nivel único), limit (1-50, predeterminado 1). Devuelve filas con la misma estructura que list_bug_reports para facilitar la composición de herramientas. Combínalo con claim_bug para el patrón de leer y 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 realiza la llamada y marca claimed_at=NOW(). Libre de condiciones de carrera entre llamadas concurrentes mediante el patrón UPDATE-WHERE-RETURNING de Postgres: si dos agentes llaman a claim_bug con el mismo id en rápida sucesión, exactamente uno obtiene claimed:true con el cuerpo del error y el otro obtiene claimed:false con una cadena de motivo. Un recolector de pg_cron libera automáticamente las reclamaciones obsoletas (status=in-progress + claimed_at > 30 minutos de antigüedad) de vuelta a new, para que los tickets de un agente caído vuelvan a la cola sin intervención manual. Entradas: id (UUID o ID corto).
• get_bug_report — Obtiene los detalles completos de un informe por ID. Formatos de ID: acepta el UUID (ej. 1fb72a2c-87c7-...), el ID corto con alcance de espacio de trabajo (ej. WRKID-545), o el ID corto con alcance de proyecto (ej. WRKID-APP-042). Las búsquedas por ID corto tienen alcance de equipo: adivinar el ID corto de otro espacio de trabajo devuelve 404. Devuelve project_id, project, short_id, legacy_short_id, project_short_id, ticket_number, project_ticket_number, qualityScore (entero 1–10) y qualityBreakdown (objeto con 10 puntuaciones de dimensión: reproductionSteps, expectedVsActual, environmentDetails, evidence, rootCauseAnalysis, impactAssessment, contextAndHistory, heuristicsAndOracles, clarityAndStructure, actionability — cada una de 0.0 a 1.0).
• update_bug_report — Actualiza campos en un informe existente. Acepta UUID o ID corto (WRKID-545). Los campos actualizables incluyen title, description, type (cualquiera de las 19 categorías del panel), severity, priority (urgent / high / normal / low — urgencia de corrección, independiente de la severidad), status (coincide exactamente con el panel: new, awaiting-triage, confirmed, in-progress, blocked, resolved, retesting, closed, reopened — los guiones son intencionales), resolution (fixed / duplicate / works-as-designed / cannot-reproduce / will-not-fix / need-more-info / unresolved), y root_cause (etiqueta abierta en formato kebab-case — valores comunes: regression, missing-requirement, documentation, incomplete-refactor, not-a-bug, requirements-mismatch). La convención del bucle de agente requiere que tanto resolution como root_cause se establezcan siempre que status transicione fuera de new; el panel, la analítica y el futuro corpus de entrenamiento de claude-bot dependen de esos campos. También incluye assigned_to (ID de usuario de list_team_members) y time_spent_seconds para el seguimiento del temporizador. Cambiar assigned_to activa automáticamente la notificación de campana en la aplicación Y un correo electrónico de cortesía al nuevo asignado (respetando su exclusión voluntaria por usuario en la Configuración de la Cuenta — el mismo flujo que los endpoints del panel).
• 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 a la incidencia de Jira vinculada.
• list_comments — Lista el hilo completo de comentarios 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 son parte de get_bug_report, por lo que esta es la forma de leer la discusión de un ticket. Acepta UUID o ID corto.
• link_bug_reports — Crea un enlace semántico direccional entre dos informes de error en el mismo espacio de trabajo. link_type es uno de duplicate-of, parent-of, related-to o depends-on. Las perspectivas inversas (duplicated-by / subtask-of / blocks) se derivan en el momento de la lectura — solo es necesario almacenar una fila. Tanto from_report_id como to_report_id aceptan UUIDs o IDs cortos (WRKID-545).
• unlink_bug_reports — Elimina un enlace 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 cada enlace curado por el usuario que afecta a un informe de error. Devuelve cada enlace tal como se lee desde la perspectiva del informe proporcionado — ej. una fila duplicate-of almacenada donde este informe es el objetivo se muestra como duplicated-by; parent-of donde este informe es el objetivo se muestra como subtask-of; depends-on donde este informe es el objetivo se muestra como blocks. related-to es simétrico. Complementa el campo de similar_reports detectado automáticamente 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 — Elimina en lote informes antiguos (solo administrador)

📊

Uso y Analítica

• get_usage — Verifica el uso contra los límites del plan
• get_stats — Recuentos 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 convierte automáticamente en predeterminado si es el primero)
• delete_project — Elimina permanentemente un proyecto y todos los datos asociados (informes de error, automatizaciones, casos de prueba, aplicaciones móviles, horarios, instantáneas geográficas, notas, entradas de tiempo). Solo propietario/gerente. 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 error, casos de prueba, automatizaciones y pruebas de rendimiento, seguridad y exploratorias — como un paquete markdown OKF/OQA (el formato Open Query Agent utilizado por oqa.ai). Predeterminado al proyecto activo; pasa el project opcional (slug o nombre) para exportar uno diferente. Devuelve la lista de archivos en el paquete más el paquete en sí como un zip codificado en base64

🔐

Autenticación y Cuenta

• register_account — Crea una nueva cuenta (contraseña: 8-128 caracteres, límite de tasa: 5/15min)
• login — Inicia sesión y recibe tokens de acceso (límite de tasa: 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 API

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

👥

Gestión de Equipos

• list_team_members — Lista todos los miembros de tu espacio de trabajo con roles, estado y flags de booster
• invite_team_member — Invita a un usuario por correo electrónico (los gerentes pueden invitar a colaboradores y gerentes; solo los propietarios pueden invitar a administradores). Enlace de caducidad de 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 para Desarrolladores de 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 plataforma — no se requiere conexión Claude por equipo. Ejecuta una cadena adaptativa: tres pasos en errores s3/medium o s4/low (borrador Sonnet → crítica gpt-5 de OpenAI → síntesis Sonnet), cinco pasos en los dos grupos de mayor severidad — s1/critical o s2/high — (borrador → crítica → refutación Sonnet → adjudicador 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 flag debated. Cualquier paso que falle recurre a la siguiente mejor respuesta. Se activa automáticamente al crear un error; normalmente solo se llama para regeneración manual.
• analyze_fix_area — Genera (o regenera) el sub-bloque "Área Probable de Corrección" de las Notas para Desarrolladores — una salida limitada de Sonnet que nombra dónde en el código base 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 orientación general con un aviso para conectar un repositorio. Devuelve texto likely_fix_area, generated_at, repo_used y un flag grounded. Se activa automáticamente al crear un error — los agentes normalmente solo necesitan llamar a esto para regeneración manual.
• upgrade_plan — Actualiza la suscripción a través de Stripe

⚡

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 opción de creación automática de errores. Solo Enterprise

• run_performance_test — Ejecuta una auditoría de página y prueba de carga para una prueba de rendimiento web. Devuelve un ID de ejecución para consultar los resultados. Las ejecuciones de perfilado de apps móviles se lanzan desde el panel
• get_performance_results — Obtén resultados completos incluyendo 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 (VUs, solicitudes, RPS, latencias p50/p90/p95/p99)
• list_performance_tests — Lista todas las configuraciones de pruebas de rendimiento del equipo actual
• get_performance_usage — Consulta el uso mensual de pruebas de rendimiento. Las pruebas de rendimiento son solo para Enterprise. Gratis=0, Enterprise=ilimitado

Flujo de trabajo de ejemplo

1. get_performance_usage → verificar cuota restante
2. create_performance_test → configurar una prueba para tu URL
3. run_performance_test → lanzar la auditoría + prueba de carga
4. get_performance_results → revisar puntuaciones y 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 análisis binario de APK/IPA. Creación automática de errores 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 resultados completos incluyendo puntuación de seguridad (0-100), hallazgos categorizados por severidad (Crítica, Alta, Media, Baja, Informativa) 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 última puntuación e insignias de autenticación/profundidad
• get_security_usage — Consulta el uso mensual de escaneos de seguridad. El escaneo de seguridad es solo para 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 configuración de notificaciones. Se une con la configuración de escaneo padre (nombre, 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. Opcional timezone, notify_on_fail (ninguno/correo/slack/ambos), notify_email, slack_channel_id. Cada ejecución cuenta contra 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 la configuración de escaneo padre ni las ejecuciones completadas

1. get_security_usage → verificar cuota restante
2. create_security_scan → configurar un escaneo para tu URL o repositorio
3. run_security_scan → lanzar un escaneo de vulnerabilidades único
4. create_security_schedule → automatizar ejecuciones recurrentes (ej. SAST semanal en la rama principal)
5. get_security_results → revisar hallazgos y remediación

📖

Revisión de código

• list_code_reviews — Lista las revisiones de código con IA recientes del equipo. Devuelve puntuaciones de calidad, conteos de severidad, información del 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 (error/seguridad/rendimiento/estilo/lógica/mantenibilidad), título, descripción, sugerencia de código, ruta del archivo y números de línea
• get_code_review_usage — Consulta el uso de revisión de código. La revisión de código con IA es solo para Enterprise; ilimitado 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. Soporta retrospectiva de 7/30/90 días

1. get_code_review_usage → verificar revisiones restantes
2. Revisar un PR en el panel en /dashboard/code-review
3. list_code_reviews → ver revisiones recientes
4. get_code_review → obtener hallazgos y sugerencias

🔍

IA Exploratoria

Buscador de errores autónomo multi-agente para sitios web con hasta 10 agentes paralelos, cada uno usando una estrategia de prueba diferente.

• list_explorations — Lista las configuraciones de IA Exploratoria del equipo
• create_exploration — Crea una nueva exploración. Acepta agent_count (1–10, máx. 10) para ejecutar múltiples agentes paralelos 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 y ejecuciones recientes
• get_exploration_run — Obtén resultados de ejecución con progreso por agente, datos de fase, hallazgos con atribución de agente (agent_index, agent_strategy) y errores vinculados
• get_exploration_usage — Consulta el uso mensual. IA Exploratoria es solo para Enterprise; Enterprise: ilimitado (10 agentes)

1. create_exploration con agent_count: 5 → configurar 5 agentes paralelos
2. Lanzar una ejecución desde el panel o mediante POST /api/explorations/run
3. get_exploration_run → consultar progreso por agente y hallazgos
4. Ver hallazgos deduplicados con atribución de agente en el panel

📝

Notas

• list_notes — Lista notas con búsqueda opcional por palabra clave, filtro de proyecto, filtro de autor y rango de fechas. Devuelve notas que el usuario posee o notas compartidas dentro del equipo.
• create_note — Crea una nota en uno de 5 formatos: markdown, plain_text, rich_text, checklist, outline. Establece visibility a private o shared. Título automático desde 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, video, audio, PDF o texto/JSON. Pasa time_spent_seconds para rastrear el esfuerzo de QA.
• get_note — Obtén detalles completos de la nota incluyendo contenido y adjuntos. Requiere id.
• update_note — Actualiza título, contenido, formato, visibilidad, proyecto o time_spent_seconds. Pasa un array attachments para añadir nuevos archivos (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.

1. create_note → iniciar una nota de sesión de pruebas
2. update_note → añadir observaciones mientras pruebas
3. list_notes → buscar notas pasadas por palabra clave o proyecto
4. get_note → recuperar nota completa con adjuntos

🤖

Automatización

• create_automation — Crea una nueva automatización con un script personalizado de Playwright (no se requiere grabación FAB). Requiere name. Opcional: target_url (se deriva automáticamente de la primera URL page.goto(...) en el script si se omite), script (Node.js/JavaScript/TypeScript o Python — el lenguaje se auto-detecta; por defecto es un marcador de posición), status (draft o active, predeterminado: draft), project_id. Devuelve el id de la automatización. Se requiere plan de equipo. Consejo — Duplicar una automatización: usa get_automation para obtener el script original, luego llama a create_automation con name establecido en "[Copy] Original Name" y pasa el script, target_url y project_id originales. El duplicado comienza en estado draft sin historial de versiones.
• list_automations — Lista scripts de automatización de Playwright. Filtra por project_id o status (draft, active, paused). Devuelve un array de automatizaciones con nombre, target_url, last_run_status y run_count.
• get_automation — Obtén detalles completos de la automatización incluyendo el script de Playwright y ejecuciones recientes. Requiere id. Devuelve la automatización con el script en vivo, una pila script_versions (la más antigua primero, hasta 100 entradas previas, 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. Modo virtual (predeterminado): device opcional para emulación de viewport (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 — no se soporta móvil real vía Python porque el browser_type.connect() de pytest-playwright no puede controlar los endpoints de móvil real de BrowserStack. Video y registros de red capturados automáticamente; registros de consola solo en escritorio. Reproducción de versión: pasa version_index opcional (entero, indexado en 0) para ejecutar una entrada previa del historial script_versions de la automatización. Predeterminado: cuando version_index se omite o es nulo, se ejecuta el script en vivo actual — no pases un valor de marcador de posición solo para "elegir el actual". Se rechazan valores fuera de rango, negativos o no enteros. El registro de ejecución almacena la instantánea exacta que se ejecutó, y cualquier informe de error creado automáticamente desde una ejecución fallida enlaza profundamente a esa versión en el editor.
• list_automation_runs — Lista ejecuciones recientes de una automatización. Requiere automation_id. Devuelve ejecuciones con estado, duration_ms y error_message.
• list_schedules — Lista todas las ejecuciones de automatización web programadas con cron, zona horaria, dispositivo y configuración de notificaciones
• create_schedule — Crea una ejecución de automatización web programada. Requiere automation_id y cron_expression. Soporta opciones de dispositivo, zona horaria, notify_on_fail (correo/slack/ambos) y canal de Slack. BrowserStack Live en ejecuciones programadas: pasa browserstack: true con bs_browser, bs_os y bs_os_version — 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 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 potenciada 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 retienen hasta 10 versiones anteriores. Requiere automation_id. Devuelve el script restaurado y el número de versiones restantes.

1. create_automation → crear una prueba con un script personalizado
2. list_automations → explorar pruebas disponibles
3. get_automation → inspeccionar el script de Playwright
4. run_automation → ejecutar la prueba
5. list_automation_runs → verificar resultados y duración

⏱️

Seguimiento de tiempo

• 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 Team.
• 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 Team.
• update_time_entry — Actualiza una entrada de tiempo existente. Requiere id. Puede actualizar description, category, duration_minutes, project_id o entry_date. Solo plan Team.
• delete_time_entry — Elimina permanentemente una entrada de tiempo. Requiere id. Solo plan Team.

1. create_time_entry → registrar 45 minutos de pruebas de regresión
2. list_time_entries → ver las entradas de tiempo de esta semana
3. update_time_entry → ajustar duración o categoría
4. delete_time_entry → eliminar una entrada incorrecta

☑️

Casos de Prueba

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

Ejecución manos libres: la página de revisión de ejecución es un carrusel con un caso visible a la vez, atajos de teclado (P Pasa · F Falla · B Bloquea · S Omite) y control por voz. Haz clic en el micrófono y di "Pasa", "Falla", "Bloquea", "Omite", "Siguiente", "Anterior", "Añadir notas" (transcribe al campo de notas), "Guardar notas" o "Voz apagada". Avanza automáticamente al siguiente caso no probado en resultados exitosos; se detiene en Fallo para que los testers dicten detalles y generen un bug. Funciona en Chrome, Edge y Safari.

Casos y Carpetas

• list_test_cases — Lista casos de prueba con search opcional, priority (critical, high, medium, low), type (functional, regression, smoke, integration, performance, security, usability, exploratory), status (active, draft, deprecated) y sort (newest, oldest, name, priority).
• create_test_case — Crea un caso de prueba. Dos variantes de plantilla: steps (por defecto) — cuadrícula { action, expected } por paso a través del array steps; text — descripción única de formato libre a través de text_content. Ambos campos pueden enviarse en la misma llamada (la plataforma los almacena independientemente para que un tester que cambie template_type más tarde no pierda los datos de ninguno de los lados). El array opcional urls (máx. 10 URLs http/https) adjunta enlaces de referencia. Requiere name. Opcional: description, preconditions, template_type, steps, text_content, urls, priority, type, tags, estimated_time (segundos). Los archivos adjuntos se suben a través del endpoint POST /api/test-cases/:id/attachments del panel (multipart) — aún no expuesto como herramienta MCP.
• get_test_case — Obtiene detalles completos del caso de prueba incluyendo pasos e historial de ejecución.
• list_test_case_folders — Lista las carpetas del equipo (una carpeta por caso a través de folder_id; distinto de 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" solo para nivel superior).
• create_test_case_folder — Crea una carpeta (anida hasta 3 niveles a través de parent_folder_id). Usa bulk_update_test_cases para mover casos a ella.
• 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 prueba muerta: never_run (90+ días desde creación), always_passes (5+ pases consecutivos en 90d), always_skipped (3+ omisiones consecutivas).
• mark_test_case_review_flags — Persiste los indicadores actuales de candidatos a archivar en test_cases.review_flag. Se ejecuta automáticamente cada lunes a las 09:00 UTC mediante pg_cron.

Importaciones

• Importación Figma (UI del panel + REST): sube una exportación zip de frames 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 frame para que un frame defectuoso no falle el lote. Los casos llegan como status=active, etiquetados ai_generated=true, con source='figma' y source_frame_name preservando un enlace al frame 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 conteo de casos y estado de última ejecución.
• create_test_suite — Crea una suite. Anida hasta 3 niveles a través de parent_suite_id.
• list_test_runs — Lista ejecuciones de prueba con nombre de suite, asignado y resumen pasa/falla.
• create_test_run — Crea una instantánea de una suite en una nueva ejecución. Ejecutar una suite padre incluye automáticamente cada caso de cada sub-suite descendiente (un caso vinculado a ambas se añade exactamente una vez). Cada registro test_run_results registra de qué sub-suite originaria provino el caso, para que las páginas de resultados puedan agrupar por origen.

Informes (analíticas Tier 1 + Tier 4)

• get_test_reports_overview — KPIs principales para una ventana (tasa de pases, ejecuciones completadas, casos ejecutados) con deltas vs la ventana equivalente anterior. Los mismos números que muestra la tira de KPI de la pestaña Informes.
• get_test_reports_failures — Cuatro listas de "¿qué arreglar?": failing_cases (≥50% fallo, mín. 3 ejecuciones), flaky_cases (más cambios pasa/falla), failing_suites (≥30% fallo, mín. 5 ejecuciones), regressed_cases (fallo más reciente con un pase anterior en la ventana).

1. create_test_case_folder → crear un árbol de carpetas (ej. Smoke → Auth)
2. create_test_case → definir casos; moverlos a carpetas con bulk_update_test_cases
3. create_test_suite → construir un plan de prueba (sub-suites opcionales, hasta 3 niveles de profundidad)
4. create_test_run → crear instantánea de una ejecución desde una suite padre — sub-suites auto-incluidas
5. get_test_reports_failures → preguntar "¿qué arreglar esta semana?" una vez que la ejecución termine
6. get_test_reports_overview → seguir la tendencia de tasa de pases semana a semana

⚡

Team Booster

• scale_team — Escala instantáneamente tu equipo de QA 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 Team. No se te cobrará hasta que se haya dado la aprobación.

1. scale_team → aprovisionar 5 testers senior en EE. UU. por 1 mes
2. list_team_members → verificar que los nuevos testers aparecen en tu equipo
3. list_reports → revisar informes presentados por testers booster

📱

Pruebas Móviles

• upload_mobile_app — Sube una app APK (Android) o IPA (iOS) para probar en dispositivos reales. Requiere name, platform (android/ios) y file_url. Para iOS: sube el IPA para ejecuciones en dispositivo real, luego sube una build de simulador .app en la página de detalle de la app para habilitar la grabación.
• update_mobile_app — Reemplaza un binario de app con una nueva versión. Limpia URLs en caché y builds 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.
• 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 (el contenido del script de prueba).
• list_mobile_runs — Obtiene resultados de ejecuciones de pruebas móviles (estado, dispositivo, video, sesión BrowserStack y cualquier bug auto-creado). Las ejecuciones móviles se disparan desde el panel o en un horario. Filtros opcionales: automation_id, status (queued, running, passed, failed, error, archived), limit. Ejecuciones archivadas excluidas del listado por defecto.

Flujo de Trabajo de Ejemplo — Android

1. upload_mobile_app → sube tu APK
2. Graba la prueba en el navegador → acciones capturadas automáticamente
3. Dispara la ejecución en un dispositivo real (ej. Google Pixel 8) desde el panel o un horario
4. list_mobile_runs → revisa resultados con video y registros
5. Los fallos crean automáticamente informes de bug con instantánea del fallo y desglose de pasos

Flujo de Trabajo de Ejemplo — iOS

1. upload_mobile_app → sube tu IPA (para ejecuciones en dispositivo real)
2. Sube la build de simulador .app en la página de detalle de la app (para grabación)
3. Graba la prueba en el navegador → acciones capturadas del simulador
4. Dispara la ejecución en un dispositivo real (ej. iPhone 15 Pro, usa el IPA) desde el panel o un horario
5. update_mobile_app → reemplaza el IPA con nueva versión cuando esté listo

✅

Cumplimiento y Evidencia (Enterprise)

• collect_compliance_evidence — Dispara la recolección automatizada de evidencia de servicios conectados (Cloudflare, GitHub, Sentry, Supabase, Railway). Devuelve ID de ejecución. Recopila configuraciones SSL/TLS, estado WAF, alertas Dependabot, tendencias de errores, historial de despliegues y más.
• check_config_drift — Verifica todos los servicios conectados en busca de desviaciones de configuración de seguridad respecto a 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 acceso. Audita miembros del equipo, roles, estado MFA, uso de claves API y genera recomendaciones (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 auto-correlacionan entre servicios.

Cobertura de Cumplimiento

Estas herramientas ayudan con 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 soporte el Protocolo de Contexto de Modelo. Aquí hay guías de configuración para clientes populares:

🤖

Claude Desktop

Abre Configuración → Desarrollador → Editar Config, luego añade:

claude_desktop_config.json

Reinicia Claude Desktop después de guardar.

✳️

Cursor

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

.cursor/mcp.json

🌊

Windsurf

Abre Configuración → MCP → Añadir Servidor, o edita tu archivo de configuración MCP:

mcp_config.json

💻

Claude Code (CLI)

Añade 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 lanzar.

🔧

Otros Clientes MCP

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

• Comando: npx
• Args: ["-y", "@bugagent/mcp-server"]
• Env: BUGAGENT_API_KEY

CLI

Comenzando con CLI

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

• Automatizar flujos de trabajo — Integra el reporte de bugs en pipelines CI/CD, scripts y trabajos cron
• Operaciones masivas — Lista, filtra y gestiona informes sin salir de tu terminal
• Salida amigable para pipes — Formatos JSON, YAML y raw para componer con jq, yq y otras herramientas
• Iteración rápida — Sin navegador necesario — crea y actualiza informes en segundos

Instalación

npm install -g @bugagent/cli

Verifica la instalación:

bugagent --version

Autenticación

Establece tu clave 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 API desde la consola de bug_Agent_. Las claves comienzan con ba_live_.

Para una autenticación persistente, añade 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

Funciones 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 API

jira Conectar, sincronizar informes y configurar ajustes de Jira

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

stats Ver analíticas y desgloses

profile Ver y actualizar tu perfil y configuración

auth Iniciar sesión, registrarse y gestionar credenciales

Banderas globales

Bandera Descripción

--api-key <key> Anular la clave 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 coloreada y formateada 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, permitiendo que los asistentes de codificación de IA usen bug_Agent_ en tu nombre.

✨

¿Qué es un AgentSkill?

Los AgentSkills permiten que los asistentes de codificación de IA (Claude Code, Cursor, etc.) invoquen herramientas CLI contextualmente. La habilidad de bug_Agent_ le da a tu asistente de IA la capacidad de archivar 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 los comandos de bug_Agent_ de forma natural — con pleno conocimiento de tu producto, pautas de prueba y documentación cargada:

Indicación 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.

🎬

Repetición de sesión + Asistente de IA: Cuando la Repetición de Sesión está habilitada (plan Team), 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 asistencia? Estamos aquí para ayudarte.

Comunidad de Discord

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

Soporte por correo electrónico

[email protected] — Normalmente respondemos en un plazo de 24 horas.