OpenFault — Claude Code MCP server: setup
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.
MIT ★ 8 updated 2026-11-08
Open on GitHubWhat OpenFault 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.
What it helps with
- triage project errors through an agent
- sort incoming tracker issues
- ingest reports from a Sentry SDK
- inspect releases and breadcrumbs
Example prompts for the agent
- 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.
How to install OpenFault
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http openfault https://{host}/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add openfault --url https://{host}/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"openfault": {
"url": "https://{host}/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"openfault": {
"type": "http",
"url": "https://{host}/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http openfault https://{host}/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about OpenFault
How do I install OpenFault in Claude Code?
Run claude mcp add --transport http openfault https://{host}/mcp, replacing {host} with the address of your server.
What does OpenFault do?
OpenFault collects error reports from Sentry SDKs and lets agents inspect and triage them over MCP. The tracker can run on a server you manage.
What does OpenFault need to run?
The tracker runs in Docker and needs a server reachable at its MCP address. Sending reports requires a Sentry SDK; OpenFault provides a DSN after project setup.