Skip to main content

Thunders MCP Server

Ines avatar
Written by Ines
Updated yesterday

Introduction

The Thunders MCP server enables AI systems to interact directly with the Thunders testing platform using natural language.

It can be connected as a remote MCP integration from clients such as Claude, ChatGPT, Cursor, Windsurf, and other MCP-compatible tools.

The server provides tools for creating, managing, and executing automated test cases, as well as accessing projects, environments, and personas. Additional functionality will be introduced over time.

This guide explains how to connect to and use the Thunders MCP server.

Prerequisites

Before connecting to the Thunders MCP server, ensure you have:

  • A valid Thunders platform account

  • Access to an MCP client (Claude, ChatGPT, Devin, Cursor, WindSurf, …) with a Pro license

  • The Thunders MCP server URL: https://api.thunders.ai/v1/mcp

Connection Setup

Step 1: Access MCP Settings example with Claude AI

  1. Log in to your Claude.ai account

  2. Navigate to Settings from the menu

  3. Select Integrations or Connected Services

  4. Click Add MCP Server or Connect New

Step 2: Configure Server Connection

Enter the following connection details:

  • Server Name: Thunders MCP Server (or custom name)

  • Connection Type: URL

  • Server URL: https://api.thunders.ai/v1/mcp

Step 3: OAuth Authentication Flow

After entering the server details, you'll be prompted to authenticate:

  1. Click Authorize or Connect to initiate the OAuth flow

  2. You'll be redirected to the Thunders authentication page

  3. Log in to your Thunders account if not already logged in

  4. Review the permissions that Claude is requesting

  5. Click Authorize or Grant Access to approve the connection

  6. You'll be redirected back to Claude.ai with a successful connection confirmation

The OAuth flow ensures secure, token-based authentication without sharing your Thunders password with Claude. The access token will be automatically refreshed as needed to maintain the connection.

Step 4: Verify Connection

  1. Once redirected back to Claude, you should see a confirmation message

  2. The Thunders MCP server will appear in your list of connected services

  3. Test the connection by asking Claude: "Show me my available Thunders personas"

Usage Examples

Here are some example commands you can use with Claude once connected:

Creating a Test Case

"Create a new test case called 'Login Validation' for project XYZ"

Generating Test Steps

"Generate test steps for validating user login with valid credentials, checking error messages for invalid credentials, and verifying password reset functionality"

Executing Tests

"Run the login test cases in the staging environment using the default persona"

Retrieving Information

"Show me all test cases in my project"

"What environments are available for project ABC?"

"List all available personas"

"Give me a fail rate analysis of my test executions for the last 7 days"

Security & Permissions

OAuth Token Management

  • Access tokens are securely stored and managed by Claude.ai

  • Tokens are automatically refreshed before expiration

  • You can revoke access at any time from either Claude.ai settings or your Thunders account settings

Permission Scopes

The Thunders MCP connection requests the following permissions:

  • Read access: View test cases, projects, environments, and personas

  • Write access: Create and modify test cases

  • Execute access: Queue and run test executions

Did this answer your question?