Faster Fixes

by manucoffin

15 329 downloads Not rated yet

About

The open-source feedback pipeline for AI-native dev teams. Built for developers, designed for their clients.

Explore

- Visual feedback widget — clients click on elements to leave feedback, no training needed
- Automatic context capture — screenshot, page URL, DOM selector, component tree, browser info
- Developer dashboard — organized view of all feedback across projects
- Markdown export — copy any feedback item as a structured bug report for AI agents
- MCP server — AI coding agents fetch and resolve feedback programmatically
- Agent skill — install as a skill for autonomous feedback-to-fix workflows
- GitHub integration — automatically create issues from feedback items
- Team collaboration — organizations, projects, and role-based access
- Review links — share a link with clients so they can leave feedback without an account

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Faster Fixes
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

MCP Setup

The MCP server exposes two tools: list_feedbacks and update_feedback_status. It connects to the Faster Fixes API using an organization-scoped agent token.

<details>
<summary><strong>Claude Code</strong></summary>

Add to your .mcp.json:

{
  "mcpServers": {
    "faster-fixes": {
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

</details>

<details>
<summary><strong>Cursor</strong></summary>

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "faster-fixes": {
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

</details>

<details>
<summary><strong>VS Code (GitHub Copilot)</strong></summary>

Add to .vscode/mcp.json:

{
  "servers": {
    "faster-fixes": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

</details>

<details>
<summary><strong>Windsurf</strong></summary>

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "faster-fixes": {
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

</details>

<details>
<summary><strong>Codex</strong></summary>

Add to .codex/config.toml:

[mcp_servers.faster-fixes]
command = "npx"
args = ["-y", "@fasterfixes/mcp"]

[mcp_servers.faster-fixes.env]
FASTER_FIXES_TOKEN = "ff_agent_your_token_here"
FASTER_FIXES_PROJECT = "proj_your_project_id"

</details>

<details>
<summary><strong>Zed</strong></summary>

Add to ~/.config/zed/settings.json:

{
  "context_servers": {
    "faster-fixes": {
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

</details>

You can find your agent token and project ID in Organization Settings on the dashboard.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "faster fixes": {
            "faster-fixes": {
                "command": "npx",
                "args": [
                    "-y",
                    "@fasterfixes/mcp"
                ],
                "env": {
                    "FASTER_FIXES_TOKEN": "<YOUR_TOKEN>",
                    "FASTER_FIXES_PROJECT": "<YOUR_PROJECT_ID>"
                }
            }
        }
    }
}

McpServers

{
    "faster-fixes": {
        "command": "npx",
        "args": [
            "-y",
            "@fasterfixes/mcp"
        ],
        "env": {
            "FASTER_FIXES_TOKEN": "<YOUR_TOKEN>",
            "FASTER_FIXES_PROJECT": "<YOUR_PROJECT_ID>"
        }
    }
}

MCP Setup

The MCP server exposes two tools: list_feedbacks and update_feedback_status. It connects to the Faster Fixes API using an organization-scoped agent token.

<details>
<summary><strong>Claude Code</strong></summary>

Add to your .mcp.json:

{
  "mcpServers": {
    "faster-fixes": {
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

</details>

<details>
<summary><strong>Cursor</strong></summary>

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "faster-fixes": {
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

</details>

<details>
<summary><strong>VS Code (GitHub Copilot)</strong></summary>

Add to .vscode/mcp.json:

{
  "servers": {
    "faster-fixes": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

</details>

<details>
<summary><strong>Windsurf</strong></summary>

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "faster-fixes": {
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

</details>

<details>
<summary><strong>Codex</strong></summary>

Add to .codex/config.toml:

[mcp_servers.faster-fixes]
command = "npx"
args = ["-y", "@fasterfixes/mcp"]

[mcp_servers.faster-fixes.env]
FASTER_FIXES_TOKEN = "ff_agent_your_token_here"
FASTER_FIXES_PROJECT = "proj_your_project_id"

</details>

<details>
<summary><strong>Zed</strong></summary>

Add to ~/.config/zed/settings.json:

{
  "context_servers": {
    "faster-fixes": {
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

</details>

You can find your agent token and project ID in Organization Settings on the dashboard.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.