Telebugs MCP-Server

Ein MCP-Server (Model Context Protocol), der es KI-Agenten ermöglicht, Fehlerberichte von Telebugs, einer selbst gehosteten Sentry-Alternative, abzurufen.

Architektur

┌─────────────────┐                           ┌─────────────────────────────────────┐
│  Local Machine  │                           │              Remote VPS             │
│                 │         HTTPS             │                                     │
│  Claude Desktop │ ◄───────────────────────► │  Bun MCP Server   ───►  Telebugs    │
│                 │      (SSE transport)      │     :3100              SQLite DB    │
└─────────────────┘                           └─────────────────────────────────────┘

Related MCP server: otel-mcp

Funktionen

• Direkter Datenbankzugriff - Lesen und Schreiben in der Telebugs SQLite-Datenbank

• MCP OAuth-Authentifizierung - Browserbasierter OAuth-Ablauf, unterstützt durch Telebugs-Benutzer

• API-Schlüssel-Authentifizierung - Akzeptiert weiterhin bestehende Telebugs-Benutzer-API-Schlüssel als Bearer-Token

• Zugriffskontrolle - Benutzer sehen nur Projekte, deren Mitglieder sie sind

• SSE-Transport - Ermöglicht Remote-Verbindungen mit Claude Desktop

• Token-effizient - Kompaktes JSON, standardmäßig nur offene Fehler

• Einzelne Binärdatei - Cross-Kompilierung für Linux, keine Laufzeitabhängigkeiten

Verfügbare Werkzeuge

list_error_groups

Gibt total_count für die Paginierung zurück.

list_reports

Gibt total_count für die Paginierung zurück.

search_errors

resolve_error_group / unresolve_error_group / unmute_error_group

Diese Werkzeuge erfordern nur die group_id (number).

mute_error_group

add_note

delete_note

create_project (nur für Administratoren)

update_project (nur für Administratoren)

delete_project / regenerate_project_token (nur für Administratoren)

Diese Werkzeuge erfordern nur die project_id (number).

add_project_member / remove_project_member (nur für Administratoren)

get_project_token / list_project_members

Diese Werkzeuge erfordern nur die project_id (number).

list_platforms

Keine Parameter. Gibt alle verfügbaren Plattformnamen zurück.

Installation

cd telebugs-mcp
bun install

Build

# Build for current platform
bun run build

# Build for Linux (for VPS deployment)
bun run build:linux

Konfiguration

Lokal ausführen

TELEBUGS_DB_PATH=/path/to/telebugs/storage/db/development.sqlite3 bun run dev

Bereitstellung

Einzelne Binärdatei

# Copy to server
scp telebugs-mcp-linux root@your-server:~/telebugs-mcp-linux

# On server
chmod +x ~/telebugs-mcp-linux
./telebugs-mcp-linux

systemd-Dienst

Kopieren Sie telebugs-mcp.service nach /etc/systemd/system/:

cp telebugs-mcp.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable telebugs-mcp
systemctl start telebugs-mcp

Status prüfen:

systemctl status telebugs-mcp

Nginx Reverse Proxy (Optional)

location /mcp {
    proxy_pass http://127.0.0.1:3100;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;

    # SSE support
    proxy_set_header Connection '';
    proxy_buffering off;
    proxy_cache off;
    chunked_transfer_encoding off;
}

Claude Desktop-Konfiguration

Für OAuth-fähige MCP-Clients konfigurieren Sie nur die Server-URL. Der Client erkennt die OAuth-Metadaten, öffnet eine Browser-Anmeldeseite und versucht es erneut mit dem ausgestellten Bearer-Token:

{
  "mcpServers": {
    "telebugs": {
      "url": "https://your-server/mcp"
    }
  }
}

Wenn der MCP-Server hinter einem Reverse Proxy läuft, setzen Sie MCP_BASE_URL auf den öffentlichen HTTPS-Ursprung:

MCP_BASE_URL=https://your-server bun run start

Die OAuth-Anmeldeseite wird von React mit CSS gerendert, das von Buns Tailwind-Plugin generiert wurde. Sie entspricht der Telebugs-Anmeldeseite, zeigt den anfragenden Client sowie den Redirect-Ursprung an und erfordert eine explizite Genehmigung, bevor ein Autorisierungscode ausgestellt wird. Sie akzeptiert Ihre Telebugs-E-Mail/Passwort, verifiziert gegen denselben bcrypt users.password_digest, den Telebugs verwendet. Sie kann auch einen Telebugs-Anmelde-Link von /session/transfers/... akzeptieren, wenn TELEBUGS_SECRET_KEY_BASE gesetzt ist, damit der MCP-Server den active_record/signed_id-Verifiziererschlüssel von Rails ableiten und das signierte ID-Payload validieren kann.

Wenn Telebugs mit RAILS_MASTER_KEY anstelle von SECRET_KEY_BASE konfiguriert ist, lesen Sie den Wert aus der Telebugs-App mit bin/rails runner 'puts Rails.application.secret_key_base' aus und übergeben Sie ihn als TELEBUGS_SECRET_KEY_BASE an diesen Server.

Für Clients, die MCP OAuth noch nicht unterstützen, funktioniert weiterhin ein statisches Bearer-Token. Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) hinzu:

{
  "mcpServers": {
    "telebugs": {
      "url": "http://your-server:3100/mcp",
      "headers": {
        "Authorization": "Bearer your_telebugs_api_key"
      }
    }
  }
}

API-Schlüssel abrufen

1. Melden Sie sich bei Ihrer Telebugs-Instanz an

2. Gehen Sie zu Benutzer → Kontoeinstellungen → Sicherheit

3. Kopieren Sie Ihren API-Schlüssel

Sicherheit

• Nur-Admin-Operationen für die Projektverwaltung erzwungen (Erstellen, Aktualisieren, Löschen, Token-Neugenerierung, Mitgliedschaft)

• Schreiboperationen auf Fehlerstatusänderungen, Notizen und Projektverwaltung beschränkt

• Alle Mutationen auf die Projektmitgliedschaften des Benutzers beschränkt

• API-Schlüssel werden nur gegen aktive Benutzer validiert

• OAuth-Zugriffstoken sind kurzlebig und werden vom MCP-Server im Arbeitsspeicher gehalten

• Alle Abfragen nach den Projektmitgliedschaften des Benutzers gefiltert

• Parametrisierte Abfragen (keine SQL-Injection)

Gesundheitsprüfung

curl http://localhost:3100/health
# {"status":"ok"}

Lizenz

MIT