Use this guide to connect BugHerd to Windsurf so you can access your BugHerd projects, tasks, and comments directly in Windsurf.
Prerequisites
Before you begin:
You have a BugHerd account
You have access to at least one BugHerd organization
You have Windsurf installed
Add BugHerd MCP to Windsurf
1. Open the MCP Registry
In Windsurf:
In the Agent panel, open the MCP Registry
Click the Settings icon (gear icon)
This will open your mcp_config.json file.
2. Add the BugHerd MCP server
Add the following configuration:
{
"mcpServers": {
"bugherd": {
"serverUrl": "https://mcp.bugherd.com/mcp"
}
}
}Save the file.
3. Authorize BugHerd
After saving:
Windsurf will prompt for permission to open an external website
Click Allow
Your browser will open and redirect you to the BugHerd authorization page.
4. Connect your BugHerd account
On the BugHerd page:
Select the organization you want Windsurf to access
Click Allow
Important:
The selected organization determines what data Windsurf can access.
5. Return to Windsurf
After authorizing:
Return to Windsurf
BugHerd should now appear as connected
You’re now ready to use BugHerd MCP in Windsurf.
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