Visual bug reports your AI agent can actually fix.
Feedbug lets your testers report bugs by clicking on them. Each report captures a screenshot, console logs, failed network requests, a session replay, and the HTML/DOM context of the clicked element, then opens a Linear ticket automatically.
This MCP server plugs that data straight into your AI coding agent (Claude Code, Cursor, Windsurf, VS Code). The agent reads the bug, gets the exact CSS selector and component path, traces it to the source file, proposes the patch, and marks the bug resolved.
Point at the bug. Ship the fix.
Quick start
npx @feedbug/mcp init
The installer asks for your client and your project key, then writes the config for you. Non-interactive:
npx @feedbug/mcp init --client claude pk_your_project_key
Supported clients: claude (Claude Code), cursor, windsurf. Grab your project key (pk_...) from your project page on feedbug.app.
Manual configuration
{
"mcpServers": {
"feedbug": {
"command": "npx",
"args": ["-y", "@feedbug/mcp"],
"env": {
"FEEDBUG_API_URL": "https://api.feedbug.app",
"FEEDBUG_PROJECT_KEY": "pk_your_project_key"
}
}
}
}
| Variable | Required | Default | Description |
|---|---|---|---|
FEEDBUG_PROJECT_KEY | Yes | none | Your project key (pk_...), from the Feedbug dashboard |
FEEDBUG_API_URL | No | https://api.feedbug.app | Override the API base URL |
Tools
Every tool accepts either the feedback UUID or the Linear identifier (e.g. PRE-13).
| Tool | What it does |
|---|---|
feedbug_list_bugs | List reported bugs (filter by status or page URL) |
feedbug_get_bug | Full details: screenshot, viewport, user agent, HTML context |
feedbug_get_html_context | DOM context of the clicked element: CSS selector path, framework component path (Vue/React/Angular/Svelte), attributes, ancestors, siblings |
feedbug_get_diagnostics | Browser diagnostics: page URL, viewport, user agent, reporter |
feedbug_get_replay | Session replay URL (last 30 seconds before the report) |
feedbug_add_comment | Add a comment to the bug's Linear issue |
feedbug_resolve_bug | Mark a bug resolved once it's fixed |
How it works
When a tester clicks a bug, the Feedbug widget snapshots the DOM around the clicked element: the CSS selector path, the framework component name when detectable, the element's attributes and text, plus its ancestors and siblings. That snapshot travels with the Linear ticket.
Through this MCP server, your agent reads that context and maps the bug to the exact file and line, instead of guessing from a vague "it's broken on the dashboard" description.
Learn more at feedbug.app.
Server Config
{
"mcpServers": {
"feedbug": {
"command": "npx",
"args": [
"-y",
"@feedbug/mcp"
],
"env": {
"FEEDBUG_API_URL": "https://api.feedbug.app",
"FEEDBUG_PROJECT_KEY": "pk_your_project_key"
}
}
}
}