# BugHerd MCP for AI Agents AI Agent Connect

> BugHerd lets you manage visual feedback, website bugs, and QA workflows directly through your AI client. Instead of hunting through a dashboard, you can triage reports, update task priorities, and manage project metadata using natural language. It connects your BugHerd account to any MCP-compatible client so you can handle project oversight and task management without leaving your workspace. You can quickly see which projects are active, pull specific bug details, and coordinate with your team members using simple chat commands.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_bfz6l4KWN5p1LoP0wo0YSH3xHnmhj2dash9piaEu/ai-agent-connect
- **Tags:** bug-tracking, website-feedback, task-management, issue-reporting, collaboration, project-tracking

## Description

BugHerd connects your account to your AI client to manage visual feedback and bug reports. You can stop jumping between browser tabs to check status updates or triage new reports from clients. This Connector lets your agent act as a project coordinator that understands your development URLs, task priorities, and user permissions. You can ask your agent to pull the latest feedback from the queue or create new tasks with specific descriptions on the fly. It turns your AI workspace into a command center for your QA workflows. Instead of manually clicking through a dashboard to find a specific bug, you just describe what you need. Vinkius makes it easy to plug this into your existing setup so you can focus on fixing issues rather than managing the list of issues. This connection gives you a way to handle organization-wide settings and user directory access through a simple chat interface. You'll find it much faster to keep your projects organized when your AI agent can see the metadata for all the sites you're working on. You can also quickly move bugs from one status to another, ensuring that your team stays updated on what is currently being worked on.

## Tools

### create_project
Create a new project in BugHerd. This helps you set up new workspaces for different clients or websites.

### create_task
Create a new task or feedback entry. Use this to quickly log issues as they come in from users.

### get_project
Get specific details for a project. Use this to pull development URLs and other metadata.

### get_task
Get the details of a specific task. This helps you see full descriptions and status history for any bug.

### list_comments
List comments on a BugHerd task

### update_task
Update a task status or details. Use this to move bugs through your workflow without opening the browser.

### add_comment
Add a comment to a BugHerd task

### list_projects
List all your BugHerd projects. This is the best way to see your entire portfolio of active work.

### list_tasks
List all tasks in a project

### list_users
List all users in your organization. Use this to manage permissions and see who is involved in your projects.

## Prompt Examples

**Prompt:** 
```
List all my active projects in BugHerd.
```

**Response:** 
```
I've retrieved your projects. You have 3 active projects:

| Project Name | ID | Status |
| :--- | :--- | :--- |
| Vinkius Redesign | `proj_1` | Active |
| Client Portal | `proj_2` | Active |
| Marketing Blog | `proj_3` | Active |
```

**Prompt:** 
```
Show the new feedback for the 'Vinkius Redesign' project.
```

**Response:** 
```
Retrieving feedback for **Vinkius Redesign**... 

There are 5 items in the queue:
* **Header alignment issue on mobile**
* **Button color doesn't match spec**
* **Footer link broken**
* **Image loading slowly**
* **Text overflow on tablet**

Which one would you like to address?
```

**Prompt:** 
```
Update task task_123 in project proj_456 to status 'Doing'.
```

**Response:** 
```
✅ **Success**

Task `task_123` has been updated to **Doing** in the **Vinkius Redesign** project.
```

## Capabilities

### Triage new feedback
Access the dedicated feedback queue to see and prioritize new reports from your clients.

### Update task statuses
Change the status or priority of an existing bug without opening your browser.

### Create new bugs
Log new feedback or tasks directly into your projects with descriptions and priority levels.

### View project details
Pull metadata and development URLs for any project in your portfolio.

### Manage team users
View and coordinate organization users to manage project involvement.

## Use Cases

### QA Triage
A QA lead asks the agent to show all new feedback in the queue. The agent uses list_feedback to show the latest 5 items.

### Status Sync
A dev wants to move a bug to Done. They tell the agent to use update_task to change the status of a specific ID.

### Project Audit
A manager needs to see all active projects. The agent uses list_projects to generate a summary table.

### New Bug Entry
A designer spots a layout issue and tells the agent to create a new task with a description of the problem using create_task.

## Benefits

- Stop manual status updates by using update_task to change priorities or states from a chat.
- Get a bird's eye view of your work by using list_projects to see every active development site.
- Triage incoming reports faster by using list_feedback to see what clients are reporting in real time.
- Onboard team members quickly by using list_users to manage who has access to your projects.
- Create documentation-ready tasks instantly with create_task to capture feedback as it happens.
- Access deep project metadata using get_project to keep your AI informed about specific dev URLs.

## How It Works

The bottom line is you get to handle your entire BugHerd QA workflow from a single chat interface.

1. Subscribe to this Connector on Vinkius.
2. Enter your BugHerd API Key.
3. Start managing your visual feedback from Claude, Cursor, or any MCP-compatible client.

## Frequently Asked Questions

**Can I use BugHerd to track website bugs with my AI client?**
Yes. You can use BugHerd to manage all your visual feedback and bug reports directly through your AI client, making it easy to see what needs fixing.

**How does BugHerd help with QA workflows?**
It lets you triage reports, update task priorities, and manage project metadata using natural language, which helps keep your QA process moving.

**Can I create new feedback reports using BugHerd?**
Yes, you can ask your agent to create new tasks or feedback reports with specific descriptions and priority levels in your projects.

**How do I manage my team users in BugHerd?**
You can access your organization's user directory and manage project involvement through your AI client to keep your team organized.

**Can I see all my projects at once?**
Yes. You can ask your agent to list all your active projects to get a bird's eye view of your entire portfolio.

**Does BugHerd support visual feedback triaging?**
Yes. This Connector connects to the BugHerd feedback queue so you can triage new reports from clients or your team using simple chat commands.

**Can I update the status of a bug using the agent?**
Yes! Use the `update_task` tool with the Project ID and Task ID. You can change the `status` (e.g., 'To Do', 'Doing', 'Done') or `priority` directly from your workspace.

**How do I see the feedback queue for a specific project?**
Simply ask the agent to `list_feedback` and provide the Project ID. It will retrieve all the tasks currently in the Feedback column, allowing you to triage them using natural language.

**Does the integration allow creating a new project?**
Yes. Use the `create_project` action and provide the project name and optionally a development URL. The project will be created in your BugHerd organization instantly.

**Can the AI Agent resolve or close a task automatically?**
Yes, using the `update_task` tool, the agent can change the task status to 'closed' or 'done' within BugHerd.

**Are attachments or screenshots supported?**
Currently, the MCP Server manages text-based tasks, comments, and project structures. Adding direct screenshot files via AI is not supported in this version.

**Can I read comments from any ticket?**
Yes! The agent can fetch and read all comments attached to a specific task using the `list_comments` tool, provided you supply the Project ID and Task ID.