Bugasura

Bugasura MCP Server

Connect AI assistants directly to your test management workspace.

Bugasura MCP Server enables AI tools like Claude, VS Code Copilot, and Cursor to interact with your Bugasura projects—manage test cases, track issues, plan sprints, and more—all through natural language.

---

⚠️ Breaking changes in 3.5

⚠️ Breaking changes in 3.3

⚠️ Breaking changes in 3.0

Authentication moved to OAuth 2.0 sign-in. If you're upgrading from 2.x:

⚠️ Breaking changes in 2.0

If you're upgrading from 1.x, update your client configuration:

1.x clients pointed at /sse must migrate to /mcp — SSE has been removed.

---

Features

• 📋 Test Case Management - Create, update, delete, and search test cases
• 💬 Test Case Comments - Add, update, delete, and list comments on test cases with pagination and filtering
• 🐛 Issue Tracking - Report, manage, and delete bugs with rich context
• 💬 Issue Comments - Add, update, delete, and list comments on issues with pagination and filtering
• 📝 Requirements Management - Create, organize, and manage product requirements with folder structure
• 📚 Knowledge Base - Upload, list, star, and delete documents in a project's knowledge base, with folders created on demand; import from a website, Coda, Jira, Confluence or Figma
• 🏃 Sprint Planning - Create, update, delete, and manage agile sprints
• 🏁 Test Runs - Create one-time or scheduled (recurring) runs, edit/rerun/delete them, pick environments and app builds, and add test cases — all by name or ID
• 🧪 Test Data - Manage a project's test data environments (create, rename, duplicate, delete), their variables and the Globals scope, plus test data files (upload, read, download, delete), app builds and file categories — all by name or ID
• 🤖 Testpert Sprints - Full AI-driven test enrichment flow: upload specs, answer requirement questions, edit the test plan, and generate test cases automatically
• 👥 Team Collaboration - Assign work using names or emails (auto-resolves to user IDs)
• 👤 Team Member Management - Add, update roles, and remove team members using team names or IDs
• 🔍 Smart Discovery - Find projects and teams without memorizing IDs
• 🤖 Interactive Workflows - Guided context selection for all operations

---

Quick Start

1. Have a Bugasura account

That's all the hosted server needs. On first use your AI tool opens the Bugasura sign-in page in your browser; approve once and you're connected. Tokens refresh automatically for 30 days.

An API key is only needed for the local STDIO setup described under *Local Development*.

2. Install the MCP Server

Add the server URL to your AI tool. No headers, no keys: the client discovers the OAuth sign-in from the server and walks you through it.

Claude Desktop

Open Claude Desktop → Settings → Connectors → Add Custom Connector

• Name: Bugasura
• URL: https://mcp.bugasura.io/mcp

Click Connect, sign in to Bugasura, and click Allow on the consent page.

VS Code

Install in VS Code, or add to your VS Code MCP config:

{

"servers": { "bugasura": { "type": "http", "url": "https://mcp.bugasura.io/mcp" } } }

VS Code detects the OAuth sign-in and opens the browser the first time a tool is used.

VS Code MCP Documentation

Claude Code

claude mcp add --transport http bugasura https://mcp.bugasura.io/mcp

Then run /mcp inside Claude Code, choose Bugasura → Authenticate, and complete the sign-in in the browser.

Claude Code MCP Documentation

ChatGPT

Settings → Apps & Connectors → Advanced → turn on Developer mode, then Create:

• Name: Bugasura
• MCP Server URL: https://mcp.bugasura.io/mcp
• Authentication: OAuth

Click Create, sign in to Bugasura, and click Allow.

Codex

codex mcp add bugasura --url https://mcp.bugasura.io/mcp

codex mcp login bugasura

Cursor

Add to Cursor, or add to ~/.cursor/mcp.json:

{

"mcpServers": { "bugasura": { "url": "https://mcp.bugasura.io/mcp" } } }

Cursor shows a Needs login badge next to the server; click it to sign in.

Windsurf

Add to your Windsurf MCP config:

{

"mcpServers": { "bugasura": { "serverUrl": "https://mcp.bugasura.io/mcp" } } }

Windsurf opens the sign-in page on first use.

Windsurf MCP Documentation

Cline

1. Open Cline
2. Click ☰ → MCP Servers → Remote Servers tab
3. Click Edit Configuration
4. Add:

{

"mcpServers": { "bugasura": { "url": "https://mcp.bugasura.io/mcp", "type": "streamableHttp" } } }

Roo Code

{

"mcpServers": { "bugasura": { "type": "streamable-http", "url": "https://mcp.bugasura.io/mcp" } } }

Roo Code MCP Documentation

3. Start Using It

Once installed, just talk naturally to your AI assistant:

"List all my Bugasura teams and projects"

"Create a test case for login functionality with high severity"

"Create a requirement for user authentication feature"

"Show me all critical bugs in sprint 5"

---

How It Works

No IDs Required

Bugasura MCP features interactive context selection. You don't need to know team IDs, project IDs, or user IDs—just describe what you want in natural language.

Example: Creating an issue without knowing any IDs:

You: "Create a bug for the login button not working"

AI: [Calls MCP server] "Which team should I use?

1. Acme Corp (Admin)
2. Client Project (Member)"

You: "Acme Corp"

AI: "Which project?

1. Mobile App
2. Web App"

You: "Mobile App"

AI: "Which sprint?

1. Sprint 5 (IN PROGRESS)
2. Sprint 6 (SCHEDULED)"

You: "Sprint 5"

AI: ✓ "Created issue #ISSUE-123 in Sprint 5"

The system guides you through team → project → sprint selection automatically.

Smart Assignee Resolution

Assign work using names, emails, or user IDs—the system automatically converts them:

"Assign issue 123 to John Doe"

"Add jane@example.com and user 789 to issue 456"

"Remove Sarah from issue 321"

Works for both issues and test cases.

Discovery Tools

Find resources without memorizing IDs:

"Find my mobile app project"

→ Searches across ALL teams automatically

"Show me all projects I have access to" → Returns complete context in one call

---

What You Can Do

📋 Test Cases

Create an API test case for user authentication with priority P1

List all test cases for the mobile app project

Update test case 123 to mark it as PASS

Assign test case 456 to john@example.com

Delete test case 789

Delete test case with key "TES5"

Delete test case named "Verify login with valid credentials"

💬 Test Case Comments

List all comments on test case 123

List comments on test case "Verify login with valid credentials"

List only user comments on test case 456 (exclude system comments)

Get details of comment 789

Add a comment "Test passed on Chrome and Firefox" to test case 123

Add a private comment to test case 456

Update comment 789 with new text

Delete comment 456

📝 Requirements

Create a requirement titled "User Authentication" with details and priority P1

List all requirements for the mobile app project

Get requirement details for requirement ID 2036

Update requirement 2036 to change severity to HIGH

Assign requirement 456 to john@example.com

Create a folder named "Sprint 1 Features" for organizing requirements

List all requirement folders in a project

Delete requirement 789

Link test cases to requirement 2036

🐛 Issues & Bugs

Create a critical bug for login page crash in sprint 5

Show me all open issues assigned to me

Update issue 789 to change status to "Fixed"

Add John and Jane as assignees to issue 123

Delete issue 456

Delete issue with key "ISS09"

Delete issue with summary "Login button not working"

💬 Issue Comments

List all comments on issue 123

List comments with pagination (start at 10, show 20 results)

List only user comments, exclude system comments

Get details of comment 456

Add a comment "Fixed in latest build" to issue 789

Add a private comment to issue 123

Update comment 456 with new text

Delete comment 789

🏃 Sprints

Create a new sprint called "Sprint 15" for the mobile app

List all sprints for project 456

Update sprint 789 to mark it as COMPLETED

Show sprint details including issue statistics

Delete sprint 321