Skip to content

Latest commit

 

History

History
88 lines (60 loc) · 2.46 KB

README.md

File metadata and controls

88 lines (60 loc) · 2.46 KB

telebugs-mcp-skills

Example Claude Code skills for working with telebugs-mcp — an MCP server that gives AI agents access to error reports from Telebugs, a self-hosted Sentry alternative.

What's included

Skills (.claude/skills/)

Skill Description
telebugs Core reference for loading deferred MCP tools, fetching error data, and parsing large report responses with Python extraction commands
telebugs-investigation Systematic 5-phase workflow for investigating production errors: data retrieval, pattern recognition, root cause analysis, solution development, and structured deliverables
create-issue-from-telebugs Workflow for fetching a Telebugs error and creating a structured bug ticket in your project tracker

Configuration

File Purpose
.mcp.json Connects Claude Code to your telebugs-mcp server via HTTP with bearer token auth
.env.example Template for the TELEBUGS_API_KEY env var (copy to .env and fill in your key)

Setup

1. Deploy telebugs-mcp

Follow the instructions in telebugs-mcp to deploy the MCP server alongside your Telebugs instance.

2. Configure the MCP endpoint

Edit .mcp.json and replace the placeholder URL with your telebugs-mcp server address:

{
  "mcpServers": {
    "telebugs": {
      "type": "http",
      "url": "https://your-telebugs-mcp-server.example.com",
      "headers": {
        "Authorization": "Bearer ${TELEBUGS_API_KEY}"
      }
    }
  }
}

3. Set your API key

Copy .env.example to .env and fill in your Telebugs API key:

cp .env.example .env
TELEBUGS_API_KEY=your-actual-api-key

You can find your API key in Telebugs under User > Account Settings > Security.

4. Customize the skills

The skills use <your-telebugs-host> as a placeholder for Telebugs dashboard URLs. Replace these with your actual Telebugs instance URL (e.g., bugs.example.com).

Usage

Once configured, Claude Code will automatically use these skills when you:

  • Paste a Telebugs error URL
  • Ask to investigate a production error
  • Ask to create a bug ticket from a Telebugs error

Example prompts:

Look at this error: https://bugs.example.com/errors/42/reports/latest

What's causing the TimeoutError in project 1?

Create a bug ticket for error group 42

License

MIT