Skip to main content

BugHerd and Claude Code: Set up the MCP server

K
Written by Kriztin Abellon

Use this guide to connect BugHerd to Claude Code so you can access BugHerd projects, tasks, and comments directly from your terminal.

Prerequisites

Before you begin:

  • You have a BugHerd account

  • You have access to at least one BugHerd organization

  • You have Claude Code installed and set up

  • You have an active Claude account/subscription

1. Install BugHerd MCP

Run the following command in your terminal:

claude mcp add --transport http BugHerd https://mcp.bugherd.com/mcp

This will:

  • Add BugHerd as an MCP server in Claude Code

  • Configure the correct connection endpoint

2. Connect your BugHerd account

After running the command:

  1. Claude Code will prompt you to authenticate

  2. Open Manage MCP Servers

  3. Select BugHerd (Needs authentication)

  4. Press Enter to begin authentication

Your browser will open automatically.

3. In the browser

  • Log in to BugHerd (if needed)

  • Select the organization you want to connect

  • Click Allow

Important:
The selected organization determines what data Claude Code can access.

4. Back in your terminal

Once authentication is complete:

  • You’ll return to Claude Code

  • BugHerd will show as connected

Verify the Connection

Run:

claude mcp list-tools BugHerd

If connected successfully, you’ll see available tools such as:

  • list_projects

  • list_my_tasks

  • add_comment

Test It

Try a prompt in Claude Code like:

“List my BugHerd projects”

If you see results, your setup is complete.

What You Can Do

Once connected, you can:

  • View projects

  • View your assigned tasks

  • Explore project details

  • View tasks across projects

  • Add comments to tasks

Did this answer your question?