BugBoard documentation
The short version of how to start, connect an agent, bring your old board and manage keys. It covers what exists today and links to where the detail is.
Getting started
- Sign up with Google, GitHub or an email and password. Every new workspace starts with a sample project you can look around in.
- Create your first project and add tasks. A task is a bug, a feature or a change; give it a priority, an assignee and tags.
- Invite your team. A plan has a seat package: Free has 3 seats and 3 projects, Starter 5 seats, Business 20. Pending invitations count as seats.
- Bring your old board with you if you have one: Settings, Import, Trello or ClickUp.
- Connect your coding agent with an API key, if you use one. See the section on keys below.
Connect an agent over MCP
BugBoard’s MCP server lets a coding agent search, file, update and comment on tasks, run a duplicate check before filing, log time and more. Create a key on the MCP page of the web app, keep it in an environment variable, and point your client at the server. There is a setup page for each client.
{
"mcpServers": {
"bugboard": {
"type": "http",
"url": "https://api.bugboard.ai/mcp/sse",
"headers": { "Authorization": "Bearer ${BUGBOARD_MCP_TOKEN}" }
}
}
}API keys and scopes
- A key starts with bb_ and is shown once, right after you create it. BugBoard stores only a hash of it. If you lose it, re-issue it, which invalidates the old one at once.
- A key can be narrowed when you create it, by scope (project.read, project.write, project.manage, org.manage, org.roster.view) and by project.
- Scopes only subtract. A key can never do more than the person who made it.
- A key limited to some projects cannot see the others at all.
- Every MCP call is authenticated, rate-limited and logged. The default limit is 300 requests per 60 seconds per key.
Import from another tool
The import wizard brings boards or lists from Trello and ClickUp, with comments, labels, statuses and people. It runs in the background, can be resumed, and ends with a report. Jira and Asana are not supported yet.
For machines
The /llms.txt file at the root of this site points to plain-text descriptions of the MCP server and of the architecture, for agents and search tools that prefer text to pages.
Need help
Write to info@bugboard.ai or use the contact page. If something in BugBoard is broken, use the bug report page.