Provides direct access to the Telebugs SQLite database, allowing AI agents to list projects, retrieve error groups and reports, manage error statuses, and perform full-text searches across error data.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Telebugs MCP ServerShow me the latest open error groups"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Telebugs MCP Server
An MCP (Model Context Protocol) server that allows AI agents to retrieve error reports from Telebugs, a self-hosted Sentry alternative.
Architecture
┌─────────────────┐ ┌─────────────────────────────────────┐
│ Local Machine │ │ Remote VPS │
│ │ HTTPS │ │
│ Claude Desktop │ ◄───────────────────────► │ Bun MCP Server ───► Telebugs │
│ │ (SSE transport) │ :3100 SQLite DB │
└─────────────────┘ └─────────────────────────────────────┘Features
Direct database access - Reads and writes to Telebugs SQLite database
API key authentication - Uses existing Telebugs user API keys
Access control - Users only see projects they're members of
SSE transport - Allows remote Claude Desktop connections
Token efficient - Compact JSON, defaults to open errors only
Single binary - Cross-compile to Linux, no runtime dependencies
Available Tools
Tool | Description |
| List all accessible projects |
| List deduplicated error groups with filtering |
| Get details of a specific error group |
| List individual error occurrences |
| Get full report with backtrace, breadcrumbs, context |
| Get aggregated error statistics |
| Full-text search across errors |
| List all releases for a project with artifact counts |
| List uploaded artifacts for a release |
| Check if a debug ID has sourcemaps available |
| Resolve an error group (mark as fixed) |
| Reopen a resolved error group |
| Mute an error group with optional expiry |
| Unmute a muted error group |
| Add a note to an error group |
| Delete a note from an error group (author only) |
list_error_groups
Parameter | Type | Default | Description |
| number | - | Filter by project ID |
| string |
|
|
| string | - | Filter by exact error type |
| string | - | Filter by error message (substring match) |
| string | - | Start date (ISO 8601) |
| string | - | End date (ISO 8601) |
| number | 20 | Max results (1-100) |
| number | 0 | Skip N results for pagination |
Returns total_count for pagination.
list_reports
Parameter | Type | Default | Description |
| number | - | Filter by error group ID |
| number | - | Filter by project ID |
| string | - | Start date (ISO 8601) |
| string | - | End date (ISO 8601) |
| number | 20 | Max results (1-100) |
| number | 0 | Skip N results for pagination |
Returns total_count for pagination.
search_errors
Parameter | Type | Default | Description |
| string | required | Full-text search query |
| number | - | Filter by project ID |
| number | 20 | Max results (1-100) |
resolve_error_group / unresolve_error_group / unmute_error_group
These tools only require group_id (number).
mute_error_group
Parameter | Type | Default | Description |
| number | required | The error group ID |
| string | - | Optional ISO 8601 date until which the group is muted |
add_note
Parameter | Type | Default | Description |
| number | required | The error group ID |
| string | required | The note content |
delete_note
Parameter | Type | Default | Description |
| number | required | The error group ID |
| number | required | The note ID to delete |
Installation
cd telebugs-mcp
bun installBuild
# Build for current platform
bun run build
# Build for Linux (for VPS deployment)
bun run build:linuxConfiguration
Variable | Description | Default |
| Path to Telebugs SQLite database |
|
| HTTP port to listen on |
|
Running Locally
TELEBUGS_DB_PATH=/path/to/telebugs/storage/db/development.sqlite3 bun run devDeployment
Single Binary
# Copy to server
scp telebugs-mcp-linux root@your-server:~/telebugs-mcp-linux
# On server
chmod +x ~/telebugs-mcp-linux
./telebugs-mcp-linuxsystemd Service
Copy telebugs-mcp.service to /etc/systemd/system/:
cp telebugs-mcp.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable telebugs-mcp
systemctl start telebugs-mcpCheck status:
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 Configuration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"telebugs": {
"url": "http://your-server:3100/mcp",
"headers": {
"Authorization": "Bearer your_telebugs_api_key"
}
}
}
}Getting Your API Key
Log into your Telebugs instance
Go to User → Account Settings → Security
Copy your API key
Security
Write operations limited to error status changes and notes
All mutations scoped to user's project memberships
API keys validated against active users only
All queries filtered by user's project memberships
Parameterized queries (no SQL injection)
Health Check
curl http://localhost:3100/health
# {"status":"ok"}License
MIT
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.