Claude Code

Overview

Claude Code can connect to Leapwork Play through MCP. After connecting, you can ask Claude Code to perform work in Leapwork Play without copying instructions back and forth between tools.

For example, you can ask Claude Code:

  • Create a test case in Leapwork Play for this bug.

  • Search Leapwork Play for test cases mentioning admin.

  • Open the failing test case in Leapwork Play and start a browser session.

Claude Code will use your normal Leapwork Play account, so it has the same access and permissions that you have in the product.

Before You Start

You need:

  • Claude Code installed.

  • Access to Leapwork Play.

The MCP server URL looks like this:

https://mcp.leapwork.ai/mcp

Setup

From a terminal, add Leapwork Play as an HTTP MCP server:

Bash
claude mcp add --transport http play https://mcp.leapwork.ai/mcp

Then open Claude Code and run:

/mcp

Select play, then complete the browser sign-in flow.

After sign-in, Claude Code should show Leapwork Play as connected.

You can also verify the connection from a terminal:

Bash
claude mcp get play

Expected result:

Status: ✓ Connected
Type: http

Using Leapwork Play

Once connected, ask Claude Code for what you want done in Leapwork Play:

Create a test case in Leapwork Play named after a famous musician.

If Leapwork Play needs approval or clarification, Claude Code will show that response and can continue the operation after you answer.

Leapwork Play uses MCP Streamable HTTP for Claude Code. Long-running requests stay connected while Leapwork Play plans and performs the work, and Claude Code receives the final result, approval prompt, or clarification prompt when the operation reaches that state.

Troubleshooting

If Claude Code says the server failed to connect:

  • Make sure the MCP URL ends with /mcp.

  • Make sure Leapwork Play is reachable from your machine.

  • Run claude mcp get play to check the connection status.

  • In Claude Code, run /mcp and reconnect or re-authenticate the play server.

If authentication succeeds but the server still fails to connect, ask your Leapwork Play administrator to check that external MCP authentication is enabled for your Leapwork Play environment.

Current limitations

  • If a connection drops, ask Claude Code to check the pending Leapwork Play request and continue from there.