QA Use
Agent-first E2E testing CLI
What is QA Use?
QA Use is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to agent-first e2e testing cli
Agent-first E2E testing CLI
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Agent-first E2E testing CLI
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @desplega.ai/qa-useManual Installation
npx -y @desplega.ai/qa-useConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use QA Use
QA Use is an agent-first end-to-end testing CLI and MCP server from desplega.ai that lets AI agents create, validate, and run YAML-defined browser automation tests through natural language. It provides browser control (navigate, fill forms, click, screenshot), YAML test management, API health checks, and an AI-powered assertion system — all backed by the desplega.ai cloud service. Development teams and QA engineers use it to generate test suites from prompts, run them in CI/CD pipelines, and verify pull requests automatically through Claude Code integration.
Prerequisites
- Node.js 18 or later installed
- A desplega.ai account and QA_USE_API_KEY (sign up at desplega.ai)
- An MCP-compatible client such as Claude Desktop or Claude Code
- A web application to test (local or remote)
Install QA Use
Install the QA Use CLI globally via npm, or use npx to run it without installing.
npm install -g @desplega.ai/qa-use
# Or run without installing:
npx @desplega.ai/qa-use setupGet your API key
Sign up at desplega.ai and copy your QA_USE_API_KEY from the account settings page. This key authenticates all browser automation sessions.
Configure your environment
Set the required API key via environment variable or a local JSON config file.
# Option 1: Environment variable
export QA_USE_API_KEY=your-api-key-here
# Option 2: JSON config file (.qa-use.json in project or home directory)
{
"api_key": "your-api-key-here",
"region": "us"
}Add QA Use to your MCP client configuration
Add the server to claude_desktop_config.json so Claude can invoke test management and browser automation tools.
{
"mcpServers": {
"qa-use": {
"command": "npx",
"args": ["-y", "@desplega.ai/qa-use"],
"env": {
"QA_USE_API_KEY": "your-api-key-here"
}
}
}
}Create and run your first test
Ask Claude to generate a YAML test definition for a login flow and then run it. The test YAML can be saved and committed to your repository.
# Example test file: tests/login.yaml
name: Login Test
app_config: your-app-config-id
steps:
- action: goto
url: /login
- action: fill
target: email input
value: [email protected]
- action: click
target: login button
- action: to_be_visible
target: dashboardQA Use Examples
Client configuration
claude_desktop_config.json entry for QA Use with the desplega.ai API key.
{
"mcpServers": {
"qa-use": {
"command": "npx",
"args": ["-y", "@desplega.ai/qa-use"],
"env": {
"QA_USE_API_KEY": "qau_xxxxxxxxxxxxxxxxxxxx",
"QA_USE_REGION": "us"
}
}
}
}Prompts to try
Example prompts for generating, running, and managing E2E tests through Claude.
- "Generate a QA Use test for the sign-up flow at https://myapp.com/register and save it as tests/signup.yaml."
- "Run the test suite in the tests/ directory and show me which tests failed."
- "Take a screenshot of https://myapp.com/dashboard after logging in as [email protected]."
- "Create an API health check that verifies https://api.myapp.com/health returns 200 every 5 minutes."
- "Validate the tests/checkout.yaml test definition and fix any syntax errors."Troubleshooting QA Use
Browser sessions fail with 'Unauthorized' errors
Check that QA_USE_API_KEY is set correctly and that your desplega.ai account has an active subscription. Verify the key is valid by running 'npx @desplega.ai/qa-use setup' and checking the connection status.
Tests run in headless mode and fail on visible-element assertions
Headless mode is the default for cloud sessions. If your app has anti-bot measures that block headless browsers, contact desplega.ai support. Do not set QA_USE_FORCE_HEADLESS=true as that enforces headless mode.
YAML test file fails validation with schema errors
Ensure each step has a valid 'action' field. Supported actions include: goto, fill, click, to_be_visible, to_have_text, wait, and screenshot. Run 'npx @desplega.ai/qa-use validate tests/yourtest.yaml' to see specific validation errors.
Frequently Asked Questions about QA Use
What is QA Use?
QA Use is a Model Context Protocol (MCP) server that agent-first e2e testing cli It connects AI assistants to external tools and data sources through a standardized interface.
How do I install QA Use?
Install via npm with the command: npx -y @desplega.ai/qa-use. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with QA Use?
QA Use works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is QA Use free to use?
Yes, QA Use is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
QA Use Alternatives — Similar Developer Tools Servers
Looking for alternatives to QA Use? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up QA Use in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use QA Use?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.