bugsink-mcp

Un servidor MCP completo de lectura/escritura para Bugsink (seguimiento de errores autoalojado y compatible con el protocolo Sentry), construido directamente contra el esquema OpenAPI /api/canonical/0/ de Bugsink.

Existe porque el paquete bugsink-mcp existente en npm solo envuelve la parte de lectura de la API (list/get). Este cubre toda la superficie canónica de la API: resolver, silenciar, reabrir y eliminar incidencias, comentar y crear/actualizar equipos, proyectos y versiones — además de un par de correcciones sobre el original (ver Fixes over the original).

Configuración

Requiere Node.js 18.17+.

1. En Bugsink, ve a Account Settings → Auth Tokens y crea un token.

2. Añade el servidor a tu cliente MCP.

Claude Code

Con una sola línea, usando la CLI claude mcp:

claude mcp add bugsink \
  -e BUGSINK_URL=https://bugs.example.com \
  -e BUGSINK_TOKEN=<your token> \
  -- npx -y github:fers4t/bugsink-mcp

Esto escribe el equivalente de lo siguiente en ~/.claude.json (o pasa --scope project para escribir un .mcp.json compartido en lugar de la configuración local del usuario):

{
  "mcpServers": {
    "bugsink": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:fers4t/bugsink-mcp"],
      "env": {
        "BUGSINK_URL": "https://bugs.example.com",
        "BUGSINK_TOKEN": "<your token>"
      }
    }
  }
}

Reinicia Claude Code (o inicia una nueva sesión) después — las listas de herramientas MCP se cargan al inicio de la sesión y no detectarán un cambio de configuración a mitad de conversación.

Otros clientes MCP

Cualquier cliente que lea un mapa mcpServers (Cursor, Windsurf, etc.) puede usar la misma estructura JSON que se muestra arriba: apúntalo a command: npx, args: ["-y", "github:fers4t/bugsink-mcp"], y las dos variables de entorno obligatorias.

npx instala directamente dede GitHub (no resides in npm publishing) y ejecuta el script prepare para compilar TypeScript en el primer uso; luego reuse su caché local en los lanzamientos siguientes.

Variables de entorno

Consulta .env.example. Nunca hagas commit de un token real — el servidor solo lo lee del entorno.

Related MCP server: Sierra Navigator Cloud

Herramientas

Conectividad

Equipos

Proyectos

Incidencias

Eventos

Versiones

Fixes over the original

• get_stack_trace en realidad funciona. El endpoint de stacktrace de Bugsink devuelve text/markdown, no JSON. El paquete original llamaba a res.json() incondicionalmente y lanzaba Unexpected token '#', "# TypeError"... is not valid JSON en cada llamada. Este servidor leee ese endpoint como texto.

• Soporte de escritura: resolver/silenciar/reabrir/eliminar/comentar incidencias y crear/actualizar equipos, proyectos y versiones — nada de lo cual exponía el original de solo lectura.

• Tiempos de espera limitados (AbortSignal.timeout, 15s por defecto) en cada solicitud, de modo que una petición colgada no pueda bloquear el proceso MCP indefinidamente.

• Reintentos seguros: las solicitudes GET idempotentes reciben un reintento acotado con retroceso exponencial con jitter ante 502/503/504 o fallos de red. Las solicitudes de mutación (POST/PATCH/DELETE) no se reintentan nunca automáticamente, porque reintentar una escritura cuyo respuesta simplemente se perdió podría duplicar efectos secundarios (p. ej., un mismo comentario dos veces).

• Validación de entrada mediante Zod en cada argumento de la herramienta (IDs numéricos, UUIDs, enums), de modo que la entrada malformada se rechaza localmente con un mensaje claro en lugar de llegar a la API.

• Sin secreto en la salida. Los errores informan del estado HTTP y de un cuerpo de respuesta truncado; el valor de la cabecera Authorization nunca se incluye en ningún log ni error lanzado.

Notas de seguridad

• Se trata de un proceso local stdio — no abre un listener de red. El control de acceso es el que tu cliente MCP ya proporciona, más la posesión de BUGSINK_TOKEN.

• Todos los diagnósticos van a stderr; stdout está reservado para el flujo de protocolo JSON-RPC.

• BUGSINK_URL debe ser http: o https:; HTTP simple hacia un host no local muestra una advertentica (tu token se enviaría sin cifrar), pero no se bloquea, para admitir redes internas.

• Trata BUGSINK_TOKEN como cualquier otra credencial: mantenlo fuera del control de versiones, rótalo en Bugsink si se llega a filtrar y delimítalo al usuario de mínimo privilegio que tu flujo de trabajo permit.

Desarrollo

npm install     # installs deps and runs the TypeScript build (prepare script)
npm run typecheck
npm run build   # compile src/ -> dist/
npm run dev     # watch mode

Licencia

MIT