AI-Assisted Gatling Simulation Scripting with IDE Extensions

Writing effective Gatling simulations requires knowing the SDK, structuring user journeys correctly, and choosing the right injection profiles and checks. Gatling’s AI extensions accelerate every part of that process by bringing AI-powered assistance directly into your editor — whether you use VS Code, Cursor, Windsurf, or any other IDE that supports the Model Context Protocol. The extensions can generate new simulations from scratch, explain complex expressions, refine existing scenarios, and even deploy and run tests on Gatling Enterprise Edition without leaving your editor.

What the AI Extensions Provide

Gatling AI assistance is packaged in two complementary forms:

IDE Assistants

Extensions for VS Code, Cursor, and Windsurf that add an AI chat panel, contextual code explanation, and refine-selection capabilities directly in your editor.

MCP Server

A Model Context Protocol server that exposes your Gatling Enterprise Edition resources (teams, packages, simulations, locations) to any MCP-compatible AI assistant.

Gatling AI extensions generate code using AI language models. AI models can make mistakes or produce incomplete solutions. Always validate generated simulations by running them against your application, reviewing them in code review, and checking assertion results before using them in production load tests.

IDE Assistants

VS Code

The Gatling AI Assistant for VS Code integrates into your editor’s activity bar and supports JavaScript, TypeScript, Java, Scala, and Kotlin simulations.

Installation

From the VS Code Marketplace:

code --install-extension GatlingCorp.gatling-ai-assistant

For VSCodium or Open VSX-compatible editors:

codium --install-extension GatlingCorp.gatling-ai-assistant

Configure an API Key

The extension communicates directly with your chosen AI provider — no data passes through Gatling servers.

Open the Command Palette

Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS).

Run Gatling: Set API Key

Type Gatling: Set API Key and press Enter.

Choose your provider

Select one of:

OpenAI (gpt-4o-2024-11-20) — recommended for general use
Anthropic Claude (claude-3-5-sonnet-20241022) — strong for complex reasoning
Azure OpenAI — enterprise deployments with data residency requirements

Paste your API key

The key is stored securely in VS Code’s encrypted secrets storage.

Key Features

Feature	How to use
Create simulation	Click the Gatling icon in the activity bar and ask the chat to generate a simulation
Explain code	Select any Gatling code → right-click → Explain Code
Refine selection	Select code → right-click → Refine Selection → describe your goal
Ask questions	Open the Gatling panel and type any question about Gatling concepts
Persistent chat	Conversations are saved per workspace and restored across sessions

Privacy

API keys and conversations never touch Gatling’s servers
Code sent to AI providers is automatically redacted — API tokens, passwords, and secrets are stripped before submission
Each workspace has an isolated conversation history

Cursor

The Gatling AI Assistant for Cursor is identical in scope to the VS Code extension. Install from the Cursor Marketplace:

Open Cursor
Go to Extensions
Search for Gatling AI Assistant
Click Install

Configure an API key using Ctrl+Shift+P → Gatling: Set API Key, exactly as in VS Code. All features — create, explain, refine, chat — work identically.

Windsurf

The Gatling AI Assistant for Windsurf is also feature-equivalent to the VS Code extension. Install from the Windsurf Marketplace:

Open Windsurf
Go to Extensions
Search for Gatling AI Assistant
Click Install

Use the Command Palette (Ctrl+Shift+P → Gatling: Set API Key) to configure your preferred AI provider.

MCP Server

The Gatling MCP Server exposes your Gatling Enterprise Edition resources — teams, packages, simulations, and load generator locations — to any AI assistant that supports the Model Context Protocol. This enables natural-language queries like “list my simulations” or “start simulation X in region Y” without opening the Gatling Enterprise web UI.

Prerequisites

A Gatling Enterprise Edition account
An API token with at least the Configure role
Node.js v24+ (for the npx installation method) or Docker

Set the token in your shell:

export GATLING_ENTERPRISE_API_TOKEN=<your-api-token>

Claude CLI (Recommended)

claude mcp add gatling \
  --env 'GATLING_ENTERPRISE_API_TOKEN=${GATLING_ENTERPRISE_API_TOKEN}' \
  -- npx -y @gatling.io/gatling-mcp-server

Or with Docker:

claude mcp add gatling \
  --env 'GATLING_ENTERPRISE_API_TOKEN=${GATLING_ENTERPRISE_API_TOKEN}' \
  -- docker run --rm --interactive --env GATLING_ENTERPRISE_API_TOKEN \
     gatlingcorp/gatling-mcp-server

Claude Desktop

Add to claude_desktop_config.json (location varies by OS):

NPX
Docker

{
  "mcpServers": {
    "gatling": {
      "command": "npx",
      "args": ["-y", "@gatling.io/gatling-mcp-server"],
      "env": {
        "GATLING_ENTERPRISE_API_TOKEN": "<your-api-token>"
      }
    }
  }
}

{
  "mcpServers": {
    "gatling": {
      "command": "docker",
      "args": [
        "run", "--rm", "--interactive",
        "--env", "GATLING_ENTERPRISE_API_TOKEN",
        "gatlingcorp/gatling-mcp-server"
      ],
      "env": {
        "GATLING_ENTERPRISE_API_TOKEN": "<your-api-token>"
      }
    }
  }
}

VS Code MCP Integration

Add to your VS Code settings.json or .vscode/mcp.json:

{
  "servers": {
    "gatling": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@gatling.io/gatling-mcp-server"],
      "env": {
        "GATLING_ENTERPRISE_API_TOKEN": "<your-api-token>"
      }
    }
  }
}

Available MCP Tools

Tool	Description
`list_gatling_enterprise_teams`	List all teams in your Gatling Enterprise organisation
`list_gatling_enterprise_packages`	List all uploaded simulation packages
`list_gatling_enterprise_tests`	List all configured simulations (tests)
`list_gatling_enterprise_locations`	List all public and private load generator locations

Claude Code Plugin (One-Step Setup)

The quickest way to get all Gatling AI capabilities — IDE skills and MCP server — in Claude Code is through the Gatling plugin in the Claude Marketplace:

/plugin marketplace add gatling/gatling-ai-extensions
/plugin install gatling@gatling-ai-extensions

Then reload Claude. The plugin bundles:

Bootstrap project — create a new Gatling project from scratch
Build tools — deploy and start tests on Gatling Enterprise
Configuration as code — generate or update .gatling/package.conf
Convert from JMeter — convert .jmx test plans to Gatling
Convert from LoadRunner — migrate LoadRunner scripts to Gatling

A valid GATLING_ENTERPRISE_API_TOKEN environment variable with at least the Configure role is required for all skills and MCP tools that interact with Gatling Enterprise Edition.

Writing & Optimizing Tests

CI/CD & Automation

Use Cases

AI Features

AI-Assisted Gatling Simulation Scripting with IDE Extensions

What the AI Extensions Provide

IDE Assistants

MCP Server

IDE Assistants

VS Code

Installation

Configure an API Key

Key Features

Privacy

Cursor

Windsurf

MCP Server

Prerequisites

Claude CLI (Recommended)

Claude Desktop

VS Code MCP Integration

Available MCP Tools

Claude Code Plugin (One-Step Setup)

Build docs developers (and LLMs) love

Writing & Optimizing Tests

CI/CD & Automation

Use Cases

AI Features

Documentation Index

​What the AI Extensions Provide

IDE Assistants

MCP Server

​IDE Assistants

​VS Code

​Installation

​Configure an API Key

​Key Features

​Privacy

​Cursor

​Windsurf

​MCP Server

​Prerequisites

​Claude CLI (Recommended)

​Claude Desktop

​VS Code MCP Integration

​Available MCP Tools

​Claude Code Plugin (One-Step Setup)

Build docs developers (and LLMs) love

What the AI Extensions Provide

IDE Assistants

VS Code

Installation

Configure an API Key

Key Features

Privacy

Cursor

Windsurf

MCP Server

Prerequisites

Claude CLI (Recommended)

Claude Desktop

VS Code MCP Integration

Available MCP Tools

Claude Code Plugin (One-Step Setup)