# Bugfender MCP server

> Connects AI clients to Bugfender to access logs, crashes, devices, and user feedback for app monitoring and debugging.

- Repository: https://github.com/bugfender/bugfender-mcp
- Page: https://hostedmcp.org/servers/bugfender/bugfender-mcp
- Transport: stdio
- Stars: 0
- License: Apache-2.0
- Latest version: 0.6.0

## Install

### Claude Code

```sh
claude mcp add --env 'BUGFENDER_API_TOKEN=<YOUR_BUGFENDER_API_TOKEN>' --env 'BUGFENDER_REFRESH_TOKEN=<YOUR_BUGFENDER_REFRESH_TOKEN>' bugfender-mcp -- npx -y @bugfender/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "bugfender-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@bugfender/mcp"
      ],
      "env": {
        "BUGFENDER_API_TOKEN": "<YOUR_BUGFENDER_API_TOKEN>",
        "BUGFENDER_REFRESH_TOKEN": "<YOUR_BUGFENDER_REFRESH_TOKEN>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "bugfender-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bugfender/mcp"
      ],
      "env": {
        "BUGFENDER_API_TOKEN": "<YOUR_BUGFENDER_API_TOKEN>",
        "BUGFENDER_REFRESH_TOKEN": "<YOUR_BUGFENDER_REFRESH_TOKEN>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"bugfender-mcp","type":"stdio","command":"npx","args":["-y","@bugfender/mcp"],"env":{"BUGFENDER_API_TOKEN":"<YOUR_BUGFENDER_API_TOKEN>","BUGFENDER_REFRESH_TOKEN":"<YOUR_BUGFENDER_REFRESH_TOKEN>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "bugfender-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@bugfender/mcp"
      ],
      "env": {
        "BUGFENDER_API_TOKEN": "<YOUR_BUGFENDER_API_TOKEN>",
        "BUGFENDER_REFRESH_TOKEN": "<YOUR_BUGFENDER_REFRESH_TOKEN>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add bugfender-mcp --env 'BUGFENDER_API_TOKEN=<YOUR_BUGFENDER_API_TOKEN>' --env 'BUGFENDER_REFRESH_TOKEN=<YOUR_BUGFENDER_REFRESH_TOKEN>' -- npx -y @bugfender/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.bugfender-mcp]
command = "npx"
args = ["-y", "@bugfender/mcp"]

[mcp_servers.bugfender-mcp.env]
BUGFENDER_API_TOKEN = "<YOUR_BUGFENDER_API_TOKEN>"
BUGFENDER_REFRESH_TOKEN = "<YOUR_BUGFENDER_REFRESH_TOKEN>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'BUGFENDER_API_TOKEN=<YOUR_BUGFENDER_API_TOKEN>' -e 'BUGFENDER_REFRESH_TOKEN=<YOUR_BUGFENDER_REFRESH_TOKEN>' bugfender-mcp npx -- -y @bugfender/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "bugfender-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@bugfender/mcp"
      ],
      "env": {
        "BUGFENDER_API_TOKEN": "<YOUR_BUGFENDER_API_TOKEN>",
        "BUGFENDER_REFRESH_TOKEN": "<YOUR_BUGFENDER_REFRESH_TOKEN>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `BUGFENDER_API_TOKEN` | yes | yes | Bugfender API access token from MCP setup. |
| `BUGFENDER_REFRESH_TOKEN` | no | yes | Refresh token for automatic session renewal (recommended). |
| `BUGFENDER_API_URL` | no | no | API base URL override; defaults to https://dashboard.bugfender.com/api |

## Tools (25)

- `who_am_i`
- `list_teams`
- `list_apps`
- `get_app`
- `list_app_versions`
- `get_sdk_snippet`
- `get_app_summary`
- `get_crashes`: Returns a list of crash groups for an app, optionally filtered by date range. Does not support filtering by status — use list_issues with type=crash and issue_status if you need open/resolved/closed crashes only.
- `get_crash_stats`
- `get_crash_device_stats`
- `get_crash_details`
- `search_logs`
- `count_logs`
- `count_devices_with_logs`
- `get_network_aggregates`
- `get_network_details`
- `search_devices`
- `count_devices`
- `list_issues`: Lists issue groups for an app. Supports filtering by type (issue, crash, feedback) and status (open, resolved, closed). Use this instead of get_crashes or get_feedback when you need status filtering or combined results.
- `get_issue`
- `update_issue_status`: Updates the status of an issue group (issues aggregation). Use this to mark issues as resolved, closed, in progress, etc.
- `get_feedback`
- `get_issue_stats`
- `get_issue_device_stats`
- `get_issue_devices`

## FAQ

### What permissions does the mcp:read scope grant?

It provides read-only access to identity, teams, apps, SDK metadata, logs, devices, crashes, issues, feedback, network data, and summaries.

### Can I use Bugfender MCP for local development?

Yes, you can use the deprecated local stdio fallback via the @bugfender/mcp npm package using npx.

### Does the hosted MCP service store my credentials?

No, the hosted MCP forwards the bearer token to the Bugfender API and does not persist user credentials.
