MCP / Conectar IA

Wutbug incluye un servidor MCP (Model Context Protocol). Con él, tu asistente de código puede listar reportes, leer la consola con stack traces ya traducidos a tu código, revisar las requests fallidas y marcar el reporte como resuelto cuando termina el arreglo.

#Sin MCP: pega el link

No necesitas instalar nada para que una IA entienda un reporte:

• Pega el link compartido (…/share/<token>) en Claude, ChatGPT, Cursor o Perplexity. Cuando un asistente abre el link, Wutbug le responde una versión en texto (Markdown) del reporte en vez de la página interactiva. También está siempre en …/share/<token>/md.
• "Copiar para IA": en el reporte (dashboard) copia el reporte completo con una instrucción para arreglarlo; en la página compartida copia solo el contexto.

El texto incluye una línea de tiempo con los eventos clave en orden (clics del usuario, errores, requests fallidas o lentas, clics de frustración), la consola, el network (con el cuerpo de las respuestas fallidas), el dispositivo, la metadata y el link a la captura de pantalla. Los datos sensibles ya vienen enmascarados.

0:01.0  USER  Clic en “Pagar” ×3
0:01.5  NET   POST /api/checkout → 500 in 1200 ms
0:02.0  ERROR (uncaught) TypeError: Cannot read 'total'
0:08.0  SENT  user opened the report form

#1. Crea un token

En el dashboard, abre Conectar IA y crea un token personal. Empieza con wbt_ y se muestra una sola vez: cópialo en ese momento.

El token actúa como tú: ve los proyectos de los equipos a los que perteneces, y si dejas un equipo, pierde ese acceso de inmediato. Solo guardamos un hash; puedes revocarlo cuando quieras desde la misma página.

#2. Conecta tu cliente

La URL del servidor es la de la API seguida de /mcp, por ejemplo https://api.wutbug.dev/mcp. La página Conectar IA muestra los comandos con tu URL y tu token.

#Claude Code

claude mcp add --transport http wutbug https://api.wutbug.dev/mcp \
  --header "Authorization: Bearer wbt_tu_token"

#Cursor

Agrégalo a .cursor/mcp.json en tu proyecto (o a ~/.cursor/mcp.json para todos):

{
  "mcpServers": {
    "wutbug": {
      "url": "https://api.wutbug.dev/mcp",
      "headers": { "Authorization": "Bearer wbt_tu_token" }
    }
  }
}

#VS Code (Copilot en modo agente)

{
  "servers": {
    "wutbug": {
      "type": "http",
      "url": "https://api.wutbug.dev/mcp",
      "headers": { "Authorization": "Bearer wbt_tu_token" }
    }
  }
}

#Otros clientes

Cualquier cliente con transporte HTTP (streamable) sirve:

URL:    https://api.wutbug.dev/mcp
Header: Authorization: Bearer wbt_tu_token

#3. Pídele que arregle un bug

Arregla el reporte WB-128 de Wutbug.

También puedes pasarle el link del reporte (del dashboard o el compartido) en vez del código: get_report acepta los tres.

El servidor incluye el prompt fix-report, que guía al asistente: leer el reporte, encontrar la causa en tu repositorio, hacer el arreglo mínimo con un test, resumirlo y marcar el reporte como resuelto (te pregunta antes de avisarle a quien lo reportó). En Claude Code aparece como /mcp__wutbug__fix-report.

#Herramientas

Un reporte se identifica por su código (WB-20, o solo 20) o por su UUID.

#list_projects

Proyectos a los que tienes acceso, con su equipo, key pública e id. Sin parámetros.

#list_reports

Reportes, del más nuevo al más antiguo. Por defecto, los abiertos de todos tus proyectos.

#get_report

Todo lo necesario para depurar un reporte: lo que dijo la persona, los pasos que siguió, los errores de consola con stack traces originales y el código fuente alrededor (si subiste source maps), las requests fallidas, el dispositivo y el entorno, y el resumen con IA si existe.

#get_console_logs

Entradas de consola del reporte (los 2 minutos previos al envío), con stack traces traducidos cuando hay source maps.

#get_network_requests

Requests fetch/XHR del reporte con status, tiempos y bodies (ya enmascarados).

#update_report_status

Mueve un reporte por el flujo de trabajo. Es la única herramienta que modifica datos.

#Privacidad

El asistente recibe los mismos datos que ves en el dashboard, ya enmascarados en el navegador del usuario. Ten en cuenta que esos datos pasan al proveedor del modelo que usa tu asistente, según tu acuerdo con ese proveedor.