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 three 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 subfolders 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.