bugsink-mcp

Ein vollwertiger Lese-/Schreib-MCP-Server für Bugsink (selbst gehostetes, mit dem Sentry-Protokoll kompatibles Fehler-Tracking), direkt gegen das /api/canonical/0/-OpenAPI-Schema von Bugsink gebaut.

Er existiert, weil das bisherige npm-Paket bugsink-mcp nur die Lese-Seite der API abdeckt (list/get). Dieses hier deckt die vollständige kanonische API-Oberfläche ab: Issues auflösen, stummschalten, wiedereröffnen und löschen, Kommentieren sowie Teams, Projekte und Releases anlegen/aktualisieren – plus ein paar Korrektur-Fixes gegenüber dem Original (siehe Korrekturen gegenüber dem Original).

Einrichtung

Voraussetzung: Node.js 18.17+.

1. In Bugsink unter Account Settings → Auth Tokens ein Token erstellen.

2. Den Server zum MCP-Client hinzufügen.

Claude Code

Einzeiler mit der claude mcp CLI:

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

Das schreibt sinngemäß Folgendes in ~/.claude.json (oder --scope project übergeben, um eine gemeinsame .mcp.json anstelle der benutzerlokalen Konfiguration zu schreiben):

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

Starten Sie Claude Code danach neu (oder beginnen Sie eine neue Sitzung) – die MCP-Tool-Listen werden beim Sitzungsstart geladen und übernehmen eine Konfigurationsänderung mitten in einer laufenden Unterhaltung nicht.

Andere MCP-Clients

Jeder Client, der eine mcpServers-Map liest (Cursor, Windsurf usw.), kann dieselbe oben gezeigte JSON-Struktur verwenden – mit command: npx, args: ["-y", "github:fers4t/bugsink-mcp"] und den beiden Pflicht-Umgebungsvariablen.

npx installiert direkt aus GitHub (ohne npm-Publish) und führt beim ersten Aufruf das Skript prepare aus, um TypeScript zu kompilieren; bei späteren Starts wird der lokale Cache wiederverwendet.

Umgebungsvariablen

Siehe .env.example. Committen Sie niemals ein echtes Token – der Server liest es ausschließlich aus der Umgebung.

Related MCP server: Sierra Navigator Cloud

Werkzeuge

Konnektivität

Teams

Projekte

Issues

Events

Releases

Korrekturen gegenüber dem Original

• get_stacktrace funktioniert tatsächlich. Bugsinks Stacktrace-Endpoint liefert text/markdown, kein JSON. Das ursprüngliche Paket rief bedingungslos res.json() auf und warf bei jedem Aufruf Unexpected token '#', "# TypeError"... is not valid JSON. Dieser Server behandelt den Endpunkt als Text.

• Schreibunterstützung: Issues auflösen/stummschalten/wiederöffnen/löschen und kommentieren sowie Teams, Projekte und Releases anlegen und aktualisieren – nichts davon hat das reine Lesepaket gezeigt.

• Begrenzte Timeouts (AbortSignal.timeout, Standard 15 s) bei jeder Anfrage, damit ein hängender Upstream nicht den MCP-Prozess endlos blockieren kann.

• Sichere Wiederholungen: Idempotente GET-Anfragen erhalten bei 502/503/504 oder einem Netzwerkfehler einen begrenzten Wiederholungsversuch mit exponentiellem Backoff und Jitter. Mutierende Anfragen (POST/PATCH/DELETE) werden nie automatisch wiederholt, da ein wiederholter Schreibausgang, dessen Antwort nur verloren ging, doppelte Seiteneffekte erzeugen kann (z. B. einen zweiten identischen Kommentar).

• Eingabevalidierung per Zod bei jedem Tool-Argument (numerische IDs, UUIDs, Enums), sodass fehlerhafte Eingaben lokal mit einer klaren Meldung abgewiesen werden, bevor sie die API erreichen.

• Keine Geheimnisse in der Ausgabe. Fehler melden HTTP-Status und einen gekürzten Antworttext; der Wert des Authorization-Headers ist in keinem Log oder geworfenen Fehler enthalten.

Sicherheitshinweise

• Dies ist ein lokaler stdio-Prozess – er öffnet keinen Netzwerk-Listener. Die Zugriffskontrolle besteht aus dem, was Ihr MCP-Client bereits bietet, plus dem Besitz von BUGSINK_TOKEN.

• Alle Diagnoseausgaben gehen an stderr; stdout ist für den JSON-RPC-Protokoll datenfische Stream reserviert.

• BUGSINK_URL muss mit http: oder https: beginnen; einfaches HTTP zu einem nicht-lokalen Host gibt eine Warnung aus (Ihr Token würde unverschlüsselt übertragen), wird aber nicht blockiert, um interne Netzwerke zu unterstützen.

• Behandeln Sie BUGSINK_TOKEN wie jede andere Anmeldeinformation: halte es aus der Versionskontrolle, rotieren Sie ihn in Bugsink, falls er jemals ausgelesen wird, und grenzen Sie ihn auf den Benutzer mit den geringsten Rechten ein, den Ihr Workflow erlaubt.

Entwicklung

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

Lizenz

MIT