@briehq/mcp

Connect AI agents to Brie via the Model Context Protocol. Let your AI assistant list, create, update, and manage bug reports directly from your conversation.

Quick Start

Interactive setup (recommended)

npx -y @briehq/mcp init

This walks you through entering your API key, testing the connection, and generating the config for Claude Desktop or Claude Code.

Manual setup

1. Get an API key

Create an API key at app.briehq.com → Settings → Integrations → API Keys.

Select the scopes your agent needs (e.g., slices:read, slices:write, workspaces:read).

2. Add to Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "brie": {
      "command": "npx",
      "args": ["-y", "@briehq/mcp"],
      "env": {
        "BRIE_API_KEY": "brie_pat_your_key_here"
      }
    }
  }
}

3. Add to Claude Code

claude mcp add brie -e BRIE_API_KEY=brie_pat_your_key_here -- npx -y @briehq/mcp

4. Start using it

Ask your AI assistant things like:

• "List all open bugs in my workspace"
• "Create a bug report: login page throws 500 error on Safari"
• "Mark slice abc123 as resolved"
• "What workspaces do I have access to?"

Available Tools

| Tool | Description | Required Scope | |------|-------------|---------------| | list_slices | List bug reports with filtering and pagination | slices:read | | get_slice | Get a single bug report by ID | slices:read | | create_slice | Create a new bug report | slices:write | | update_slice | Update status, priority, description, labels | slices:write | | delete_slice | Delete a bug report | slices:delete | | list_workspaces | List accessible workspaces | workspaces:read | | get_workspace | Get workspace details | workspaces:read | | list_spaces | List spaces (folders) within a workspace | spaces:read | | get_me | Get current user profile | user:read |

Configuration

| Environment Variable | Required | Default | Description | |---------------------|----------|---------|-------------| | BRIE_API_KEY | Yes | — | Your Brie API key (brie_pat_xxx or brie_wst_xxx) | | BRIE_API_URL | No | https://api.briehq.com | API base URL |

Using with a local Brie API

For development against a local Brie instance:

{
  "mcpServers": {
    "brie-local": {
      "command": "npx",
      "args": ["-y", "@briehq/mcp"],
      "env": {
        "BRIE_API_KEY": "brie_pat_your_dev_key",
        "BRIE_API_URL": "http://localhost:3006"
      }
    }
  }
}

API Key Scopes

When creating an API key, select only the scopes your agent needs:

| Scope | What it allows | |-------|---------------| | slices:read | List and view bug reports | | slices:write | Create and update bug reports | | slices:delete | Delete bug reports | | workspaces:read | List and view workspaces | | spaces:read | List spaces within workspaces | | user:read | View your own profile |

Tip: For a read-only agent, use only slices:read + workspaces:read. For a full bug management agent, add slices:write + slices:delete.

Requirements

• Node.js 18 or later
• A Brie account with an API key

Links

• Brie — Bug capture browser extension
• API Documentation — Full API reference
• Help Center — Guides and troubleshooting
• GitHub — Source code and issues

License

Apache-2.0