Use this guide to connect BugHerd to Zed so you can access your BugHerd projects, tasks, and comments directly in Zed.
Prerequisites
Before you begin:
You have a BugHerd account
You have access to at least one BugHerd organization
You have Zed installed
Add BugHerd MCP to Zed
1. Open MCP settings
In the Zed Agent panel:
Click the three dots menu (...)
Select Add Custom Server...
2. Add the BugHerd MCP server
Open the Remote tab
In the URL field, enter:
https://mcp.bugherd.com/mcp
Click Add Server
3. Authenticate with BugHerd
After adding the server:
Click Authenticate
Your browser will open and redirect you to the BugHerd authorization page.
4. Authorize access
On the BugHerd page:
Log in (if needed)
Select the organization you want Zed to access
Click Allow
Important:
The selected organization determines what data Zed can access.
5. Return to Zed
After authorizing:
Return to Zed
BugHerd should now appear as connected
Test the connection
Try a prompt like:
“List my BugHerd projects”
If your projects are returned, the connection is working.
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