IDE Setup

FastTest Agent runs as an MCP (Model Context Protocol) server inside your AI coding assistant. Pick your IDE below and follow the setup instructions.

Tip

No account or API key is needed to get started — FastTest Agent works locally out of the box. For cloud features (persistent suites, CI/CD, dashboard), run the setup tool after installing.

VS Code

CLI

code --add-mcp '{"name":"fasttest","command":"npx","args":["-y","@fasttest-ai/qa-agent@latest"]}'

Manual

Add to your VS Code MCP config (.vscode/mcp.json):

{
  "mcpServers": {
    "fasttest": {
      "command": "npx",
      "args": ["-y", "@fasttest-ai/qa-agent@latest"]
    }
  }
}

Cursor

UI

1. Open Settings → MCP
2. Click Add new MCP Server
3. Name it fasttest
4. Select type command
5. Enter: npx -y @fasttest-ai/qa-agent@latest

Config file

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "fasttest": {
      "command": "npx",
      "args": ["-y", "@fasttest-ai/qa-agent@latest"]
    }
  }
}

Claude Code

One command to install and auto-approve all tools (no per-tool prompts):

npx -y @fasttest-ai/qa-agent@latest install

This registers the MCP server and adds tool permissions to ~/.claude/settings.json so you won’t be prompted for each tool individually.

Manual setup

claude mcp add --scope user fasttest -- npx -y @fasttest-ai/qa-agent@latest

Or add to your Claude Code MCP config:

{
  "mcpServers": {
    "fasttest": {
      "command": "npx",
      "args": ["-y", "@fasttest-ai/qa-agent@latest"]
    }
  }
}

To auto-approve all tools, add "mcp__fasttest" to ~/.claude/settings.json under permissions.allow.

Claude Desktop

1. Open Settings → Developer → Edit Config

2. Add the following to claude_desktop_config.json:

   {
     "mcpServers": {
       "fasttest": {
         "command": "npx",
         "args": ["-y", "@fasttest-ai/qa-agent@latest"]
       }
     }
   }

3. Restart Claude Desktop

Windsurf

Follow the Windsurf MCP documentation and use this config:

{
  "mcpServers": {
    "fasttest": {
      "command": "npx",
      "args": ["-y", "@fasttest-ai/qa-agent@latest"]
    }
  }
}

Codex

codex mcp add fasttest -- npx -y @fasttest-ai/qa-agent@latest

Or edit ~/.codex/config.toml:

[mcp_servers.fasttest]
command = "npx"
args = ["-y", "@fasttest-ai/qa-agent@latest"]

Copilot

Use the /mcp add command in Copilot chat, or edit ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "fasttest": {
      "type": "local",
      "command": "npx",
      "tools": ["*"],
      "args": ["-y", "@fasttest-ai/qa-agent@latest"]
    }
  }
}

Cline

Add to cline_mcp_settings.json:

{
  "mcpServers": {
    "fasttest": {
      "type": "stdio",
      "command": "npx",
      "timeout": 60,
      "args": ["-y", "@fasttest-ai/qa-agent@latest"],
      "disabled": false
    }
  }
}

Amp

Add to your Amp settings.json:

"amp.mcpServers": {
  "fasttest": {
    "command": "npx",
    "args": ["-y", "@fasttest-ai/qa-agent@latest"]
  }
}

Or via CLI:

amp mcp add fasttest -- npx -y @fasttest-ai/qa-agent@latest

Goose

1. Go to Advanced Settings → Extensions
2. Click Add custom extension
3. Set type to STDIO
4. Set ID to fasttest
5. Set command to: npx -y @fasttest-ai/qa-agent@latest

Kiro

Edit .kiro/settings/mcp.json:

{
  "mcpServers": {
    "fasttest": {
      "command": "npx",
      "args": ["-y", "@fasttest-ai/qa-agent@latest"]
    }
  }
}

Antigravity

Installer

npx -y @fasttest-ai/qa-agent@latest install --ide antigravity

UI

1. Click the … menu in the agent panel
2. Select MCP Servers
3. Click Manage MCP Servers → View raw config
4. Add the FastTest config (see Config file tab)
5. Return to Manage MCP Servers and refresh

Config file

Add to ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "fasttest": {
      "command": "npx",
      "args": ["-y", "@fasttest-ai/qa-agent@latest"]
    }
  }
}

Note

Antigravity does not support per-MCP-server auto-approve. Set your agent mode to Always Proceed or Turbo in Settings to minimize approval prompts.

Warp

1. Open Settings → AI → Manage MCP Servers

2. Click + Add

3. Paste the standard config:

   {
     "mcpServers": {
       "fasttest": {
         "command": "npx",
         "args": ["-y", "@fasttest-ai/qa-agent@latest"]
       }
     }
   }

Or use the /add-mcp slash command in Warp.

---

Uninstalling

For IDEs that support the installer, run:

npx -y @fasttest-ai/qa-agent@latest uninstall

You’ll be prompted to pick your IDE. To skip the prompt:

npx -y @fasttest-ai/qa-agent@latest uninstall --ide claude-code
npx -y @fasttest-ai/qa-agent@latest uninstall --ide cursor
npx -y @fasttest-ai/qa-agent@latest uninstall --ide windsurf
npx -y @fasttest-ai/qa-agent@latest uninstall --ide codex
npx -y @fasttest-ai/qa-agent@latest uninstall --ide antigravity
npx -y @fasttest-ai/qa-agent@latest uninstall --ide vscode

This removes the MCP server registration, tool permissions, and slash commands (where applicable).

For IDEs where you installed manually (config file), just delete the "fasttest" entry from the config file you edited during setup.

---

Cloud Authentication

After installing, all browser tools and local testing work immediately. To enable cloud features (persistent test suites, CI/CD, dashboard, shared healing patterns), ask your AI assistant:

Run setup

A URL is displayed — open it in your browser to complete the device code flow. Your API key is saved automatically to ~/.fasttest/config.json.

CLI Flags

All flags can be appended to the args array in any config above. See Configuration for the full reference, including browser sessions, device emulation, environment variables, and cross-browser testing.

Flag	Description	Default
--api-key <key>	Organization API key. Not needed if you use the setup tool.	—
--base-url <url>	Cloud API URL.	https://api.fasttest.ai
--headed	Run browser visibly (debug mode).	headless
--browser <type>	chromium, firefox, or webkit.	chromium

Verify Installation

After setup, ask your AI assistant:

Test the login flow on https://myapp.example.com

If the browser opens and tests run, you’re good to go. Head to the Getting Started guide for more.