MCP Integration

Model Context Protocol (MCP) integration allows you to seamlessly manage TestBeats projects and manual test cases directly from your AI assistant. This powerful integration enables you to create, organize, and maintain test cases using natural language commands.

Getting Started

Prerequisites

• TestBeats account
• Personal access token

Personal Access Token

You can generate a personal access token from the TestBeats platform at https://app.testbeats.com/settings/profile

Configuration

To use TestBeats MCP integration, add the following configuration to your config file:

Cursor

{
  "mcpServers": {
    "testbeats": {
      "url": "https://app.testbeats.com/api/core/v1/mcp",
      "headers": {
        "x-personal-access-token": "<your-personal-access-token>"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "testbeats": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://app.testbeats.com/api/core/v1/mcp",
        "--header",
        "x-personal-access-token: <your-personal-access-token>"
      ]
    }
  }
}

Configuration Location [Cursor]

• macOS/Linux: ~/.cursor/mcp.json
• Windows: %USERPROFILE%/.cursor/mcp.json

Configuration Location [Claude Desktop]

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Available Tools

The TestBeats MCP integration provides five powerful tools for comprehensive test management:

1. manage-projects

Manage your TestBeats projects with full CRUD operations.

Capabilities:

• Create new projects
• List existing projects
• Update project details

Example Usage:

Create a new project called "E-commerce API" in testbeats platform.

2. manage-manual-test-folders

Organize your manual test cases into logical folders and hierarchies.

Capabilities:

• Create test folders
• Organize folder hierarchies
• Rename and restructure folders
• Delete empty folders

Example Usage:

Create a folder structure for "User Authentication" tests with sub-folders for login, registration, and password reset in testbeats platform.

3. manage-manual-test-cases

Create and manage detailed manual test cases with comprehensive test steps.

Capabilities:

• Create detailed test cases
• Define test description and expected results
• Set test priorities and categories
• Update existing test cases

Example Usage:

Create a test case for user login workflows in testbeats platform.

4. manage-automation-results

Manage automation test results and executions in the TestBeats platform.

Capabilities:

• List automation test runs
• List automation test run executions
• List automation test suite executions
• List automation test case executions
• Filter by project, status, date ranges, and search text
• Include related resource details

Example Usage:

List all failed test case executions from the last week in testbeats platform.

5. manage-automation-failure-analysis

Manage automation test failure analysis and categories in the TestBeats platform.

Capabilities:

• Create, list, get, update, attach, and detach test failure analysis
• List automation test failure categories
• Categorize test failures with descriptions
• Link test cases to failure analysis

Example Usage:

Create a new test failure analysis for login timeout issues in testbeats platform.