Telebugs MCP Server
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: nr-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
Werkzeug | Beschreibung |
| Alle zugänglichen Projekte auflisten |
| Deduplizierte Fehlergruppen mit Filterung auflisten |
| Details einer bestimmten Fehlergruppe abrufen |
| Einzelne Fehlervorkommen auflisten |
| Vollständigen Bericht mit Backtrace, Breadcrumbs und Kontext abrufen |
| Aggregierte Fehlerstatistiken abrufen |
| Volltextsuche über Fehler hinweg |
| Alle Releases für ein Projekt mit Artefaktanzahl auflisten |
| Hochgeladene Artefakte für ein Release auflisten |
| Prüfen, ob für eine Debug-ID Sourcemaps verfügbar sind |
| Eine Fehlergruppe als gelöst markieren |
| Eine gelöste Fehlergruppe wieder öffnen |
| Eine Fehlergruppe mit optionalem Ablaufdatum stummschalten |
| Eine stummgeschaltete Fehlergruppe wieder aktivieren |
| Eine Notiz zu einer Fehlergruppe hinzufügen |
| Eine Notiz aus einer Fehlergruppe löschen (nur für den Autor) |
| Ein neues Projekt erstellen (nur für Administratoren) |
| Name oder Zeitzone eines Projekts aktualisieren (nur für Administratoren) |
| Ein Projekt logisch löschen (nur für Administratoren) |
| Token/DSN eines Projekts für die SDK-Konfiguration abrufen |
| Token eines Projekts neu generieren (nur für Administratoren) |
| Einen Benutzer zu einem Projekt hinzufügen (nur für Administratoren) |
| Einen Benutzer aus einem Projekt entfernen (nur für Administratoren) |
| Projektmitglieder mit Rollen auflisten |
| Verfügbare Plattformnamen für die Projekterstellung auflisten |
list_error_groups
Parameter | Typ | Standard | Beschreibung |
| number | - | Nach Projekt-ID filtern |
| string |
|
|
| string | - | Nach exaktem Fehlertyp filtern |
| string | - | Nach Fehlermeldung filtern (Teilübereinstimmung) |
| string | - | Startdatum (ISO 8601) |
| string | - | Enddatum (ISO 8601) |
| number | 20 | Maximale Ergebnisse (1-100) |
| number | 0 | N Ergebnisse für Paginierung überspringen |
Gibt total_count für die Paginierung zurück.
list_reports
Parameter | Typ | Standard | Beschreibung |
| number | - | Nach Fehlergruppen-ID filtern |
| number | - | Nach Projekt-ID filtern |
| string | - | Startdatum (ISO 8601) |
| string | - | Enddatum (ISO 8601) |
| number | 20 | Maximale Ergebnisse (1-100) |
| number | 0 | N Ergebnisse für Paginierung überspringen |
Gibt total_count für die Paginierung zurück.
search_errors
Parameter | Typ | Standard | Beschreibung |
| string | erforderlich | Volltext-Suchanfrage |
| number | - | Nach Projekt-ID filtern |
| number | 20 | Maximale Ergebnisse (1-100) |
resolve_error_group / unresolve_error_group / unmute_error_group
Diese Werkzeuge erfordern nur die group_id (number).
mute_error_group
Parameter | Typ | Standard | Beschreibung |
| number | erforderlich | Die Fehlergruppen-ID |
| string | - | Optionales ISO 8601-Datum, bis zu dem die Gruppe stummgeschaltet ist |
add_note
Parameter | Typ | Standard | Beschreibung |
| number | erforderlich | Die Fehlergruppen-ID |
| string | erforderlich | Der Inhalt der Notiz |
delete_note
Parameter | Typ | Standard | Beschreibung |
| number | erforderlich | Die Fehlergruppen-ID |
| number | erforderlich | Die zu löschende Notiz-ID |
create_project (nur für Administratoren)
Parameter | Typ | Standard | Beschreibung |
| string | erforderlich | Projektname (eindeutig) |
| string | erforderlich | Plattformname — verwenden Sie |
| string |
| Projektzeitzone (z. B. |
update_project (nur für Administratoren)
Parameter | Typ | Standard | Beschreibung |
| number | erforderlich | Die zu aktualisierende Projekt-ID |
| string | - | Neuer Projektname |
| string | - | Neue Zeitzone |
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)
Parameter | Typ | Standard | Beschreibung |
| number | erforderlich | Die Projekt-ID |
| number | erforderlich | Die Benutzer-ID zum Hinzufügen/Entfernen |
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 installBuild
# Build for current platform
bun run build
# Build for Linux (for VPS deployment)
bun run build:linuxKonfiguration
Variable | Beschreibung | Standard |
| Pfad zur Telebugs SQLite-Datenbank |
|
| HTTP-Port, auf dem gelauscht werden soll |
|
| Öffentliche Basis-URL für OAuth-Metadaten und Redirects | aus Anfrage abgeleitet |
| Lebensdauer für MCP OAuth-Zugriffstoken |
|
| Telebugs Rails | nicht gesetzt |
Lokal ausführen
TELEBUGS_DB_PATH=/path/to/telebugs/storage/db/development.sqlite3 bun run devBereitstellung
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-linuxsystemd-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-mcpStatus prüfen:
systemctl status telebugs-mcpNginx 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 startDie 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
Melden Sie sich bei Ihrer Telebugs-Instanz an
Gehen Sie zu Benutzer → Kontoeinstellungen → Sicherheit
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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for Sentry - error monitoring, issue tracking, and debugging for AI assistants
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that guides an AI agent through stack trace triage, from raw error to the commit and PR that introduced it.2MIT
- AlicenseCqualityDmaintenanceMCP server allowing AI agents to query New Relic for debugging incidents.2MIT
- AlicenseAqualityDmaintenanceMCP server for integrating self-hosted Sentry with AI assistants, enabling project and issue listing, issue details with stack traces, and event retrieval.715 npm1MIT
- AlicenseNot gradedqualityDmaintenanceHosted MCP server that exposes your self-hosted Bugsink error tracker as tools for LLMs, enabling issue management, release tracking, and stacktrace retrieval via chat prompts.112 npmMIT