Feedboon

MCP Setup

Connect Feedboon to your AI-powered editor for seamless bug fixing.

What is MCP?

MCP (Model Context Protocol) allows AI assistants like Claude Code, Cursor, and OpenCode to interact with external tools. The Feedboon MCP server lets you list bugs, view details, update statuses, and add comments — all from your editor.

1. Get your API key

Go to your Feedboon dashboard → Account → API Keys and create a new API key. It will look like fbk_xxxxxxxxxx.

2. Install the MCP server

You can install the server globally, or skip the install entirely by using npx in your editor config (recommended).

Terminal
# Option 1: Global install
npm install -g @feedboon/mcp-server

# Option 2: No install needed (recommended)
# Just use "npx @feedboon/mcp-server" as the command in your editor config below

3. Configure your editor

Claude Code

Project-level (recommended) — add .mcp.json to your project root:

.mcp.json
{
  "mcpServers": {
    "feedboon": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@feedboon/mcp-server"],
      "env": {
        "FEEDBOON_API_KEY": "fbk_your_api_key"
      }
    }
  }
}

User-level — add to ~/.claude/mcp.json to apply across all projects:

~/.claude/mcp.json
{
  "mcpServers": {
    "feedboon": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@feedboon/mcp-server"],
      "env": {
        "FEEDBOON_API_KEY": "fbk_your_api_key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

.cursor/mcp.json
{
  "mcpServers": {
    "feedboon": {
      "command": "npx",
      "args": ["-y", "@feedboon/mcp-server"],
      "env": {
        "FEEDBOON_API_KEY": "fbk_your_api_key"
      }
    }
  }
}

OpenCode

Add to opencode.json in your project root:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "feedboon": {
      "type": "local",
      "command": ["npx", "-y", "@feedboon/mcp-server"],
      "enabled": true,
      "environment": {
        "FEEDBOON_API_KEY": "fbk_your_api_key"
      }
    }
  }
}

Note: If you use a project-level config file with your API key, add it to .gitignore to avoid committing secrets. Alternatively, set the FEEDBOON_API_KEY environment variable in your shell profile and omit the env block from the config.

Available MCP tools

list_projects

List all projects accessible to the authenticated user. Use this first to get your project ID.

list_feedback

List feedback items for a project with optional status and priority filters.

get_feedback

Get detailed feedback including screenshot, metadata, console errors, and comments.

update_feedback

Update feedback status, priority, title, or description.

add_comment

Add a comment to a feedback item with investigation findings or fixes applied.

Quick start workflow

After setup, try these commands in your AI editor:

>“Show me all open bugs from Feedboon”
>“Get details on bug #FB-012 including the screenshot”
>“Fix this bug and mark it as done in Feedboon”

Usage example

Once configured, you can interact with Feedboon directly from your editor:

Claude Code
> Show me all new bugs in my project

Found 3 new feedback items in Acme Corp:
┌────────┬──────────────────────┬─────────┐
│ FB-007 │ Button broken        │ /checkout│
│ FB-008 │ Image 404            │ /listing │
│ FB-009 │ Form error           │ /contact │
└────────┴──────────────────────┴─────────┘

> Get details on FB-007

FB-007: "Button broken"
Status: New  Priority: High
URL: /checkout
Element: button#submit-order
Console Error: TypeError: Cannot read 'id' of undefined
  at handleSubmit (checkout.ts:45)

> Fix FB-007

Analyzing checkout.ts:45...
Found: TypeError: Cannot read 'id' of undefined
Fix: Add null check for order object
✓ Applied fix to checkout.ts

> Mark FB-007 as done

✓ Updated FB-007: New → Done
✓ Added comment: "Fixed null check in checkout.ts:45"

Troubleshooting

Permission denied on npm install -g

Use sudo npm install -g @feedboon/mcp-server or skip global install entirely by using the npx config examples above (recommended).

“MCP server not found” or tools not appearing

Restart your editor after changing the MCP config. Claude Code, Cursor, and OpenCode only read MCP config on startup.

API key invalid or authentication error

Verify your key in the dashboard under Account → API Keys. If the key was revoked, generate a new one and update your config.

npx downloads the package every time

This is normal for the first run. Subsequent runs use the npx cache. If speed is a concern, use the global install option instead.