desplega.ai
MCP/Setup with Claude Code

Setup with Claude Code

Integrate the Desplega.ai MCP Server with Claude Code CLI for seamless AI-powered QA testing in your terminal and VS Code.

Prerequisites

Method 1: Using Claude Code CLI

The quickest way to add the MCP server is using the Claude Code CLI command:

With API Key

claude mcp add desplega-qa npx @desplega.ai/qa-use-mcp@latest --env QA_USE_API_KEY=your-desplega-ai-api-key

Replace your-desplega-ai-api-key with your actual API key.

Without API Key (Configure Later)

claude mcp add desplega-qa npx @desplega.ai/qa-use-mcp@latest

You can add the API key later through interactive setup using the register_user tool.

Method 2: Manual Configuration

Alternatively, you can manually edit your Claude Code configuration file:

1

Open Configuration File

Locate and open your Claude Code configuration file. You can find the config path by running:

claude mcp list
2

Add MCP Server Configuration

{
  "mcpServers": {
    "desplega-qa": {
      "command": "npx",
      "args": ["-y", "@desplega.ai/qa-use-mcp@latest"],
      "env": {
        "QA_USE_API_KEY": "<your-desplega-ai-api-key>"
      }
    }
  }
}
3

Verify Configuration

Check that the MCP server was added successfully:

claude mcp list

You should see desplega-qa in the list of configured MCP servers.

Verify Installation

Test that the MCP server is working correctly:

Start Claude Code:

claude

Try this prompt:

Initialize Desplega QA MCP server

The MCP server should initialize.

Register for an API Key

If you don't have a desplega.ai API key, you can register through the MCP server:

  1. 1. Start Claude Code without an API key configured
  2. 2. Ask Claude to use the register_user tool:
    Register me for Desplega.ai with email: your-email@example.com
  3. 3. Check your email, finish the registration and add the received API key using:
    claude mcp add desplega-qa npx @desplega.ai/qa-use-mcp@latest --env QA_USE_API_KEY=your-new-api-key

Troubleshooting

MCP server not found

Run claude mcp list to verify the server is registered. Check that the configuration syntax is valid.

Authentication errors

Verify your API key is correct. You can check your account at app.desplega.ai.

npx command not found

Make sure Node.js and npm are properly installed. Run node --version and npm --version to verify.

Next Steps

You're all set! Start exploring what you can do with the MCP server.