# OpenFault

OpenFault — an MCP server for Claude Code gives agents access to error reports. It connects them to a self-hosted tracker compatible with Sentry for issue triage.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8 repo stars
- Author: OpenFault
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/OpenFault/openfault
- Updated: 2026-11-08
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/openfault

## What it does

OpenFault receives reports from the Sentry SDK and exposes them to agents for review and triage. The MCP server shares the handlers used by the web interface. The tracker also handles releases and breadcrumbs.

Run it in Docker; the container listens on port `8080` and stores data in SQLite. A setup wizard creates an organization and project, then provides a DSN for the SDK. The project is in early development and is not ready for production. HTTPS deployments require `OPENFAULT_BASE_URL`.

## Requirements
- Needs: Docker
- Remote server: `https://{host}/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http openfault https://{host}/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add openfault --url https://{host}/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "openfault": {
            "url": "https://{host}/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "openfault": {
            "type": "http",
            "url": "https://{host}/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http openfault https://{host}/mcp
```

## When to use it
- triage project errors through an agent
- sort incoming tracker issues
- ingest reports from a Sentry SDK
- inspect releases and breadcrumbs

## Example prompts
- Review new OpenFault issues and group related errors.
- Show the project's reported errors and sort them for triage.
- Inspect errors received through the Sentry SDK.

## Similar
- [sentry-debug-issue](https://affpapa.org/en/nevibecode/skills/sentry-debug-issue.md) — skill · 2200 installs
- [sentry](https://affpapa.org/en/nevibecode/rules/sentry.md) — rule · ★ 3589 repo stars
- [sentry-nextjs-sdk](https://affpapa.org/en/nevibecode/skills/sentry-nextjs-sdk.md) — skill · 3800 installs
- [adding-error-tracking](https://affpapa.org/en/nevibecode/skills/adding-error-tracking.md) — skill · 423 installs
- [openai-sentry](https://affpapa.org/en/nevibecode/plugins/openai-openai-sentry.md) — plugin · ★ 540 repo stars
- [convex-self-heal](https://affpapa.org/en/nevibecode/skills/convex-self-heal.md) — skill · 43700 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
