# Testery MCP Server

The Testery MCP Server allows AI assistants like Claude to interact directly with your Testery account. Using the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/), you can manage projects, trigger test runs, review results, and more — all through natural language conversation.

## Prerequisites

* [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
* A [Testery account](https://testery.com/signup?plan=2)

## Setup

### Step 1: Add the MCP Server

Run the following command to add the Testery MCP server to Claude Code:

```bash
claude mcp add testery --transport http "https://mcp.testery.io/mcp"
```

### Step 2: Authenticate

In your Claude Code session, type:

```
/mcp
```

This will open an authentication flow where you can log in with your Testery account. Once authenticated, Claude will have access to your Testery data.

## What You Can Do

Once connected, you can ask Claude to interact with Testery using natural language. For example:

* "List all my Testery projects"
* "Create a new test run for project X"
* "Show me the test results for the latest test run"
* "List environments for project Z"
* "Get details about test suite A"

The MCP server supports the following Testery resources:

| Resource          | Capabilities                      |
| ----------------- | --------------------------------- |
| **Projects**      | List, get, create, update, delete |
| **Test Runs**     | List, get, create, delete         |
| **Test Results**  | List, get                         |
| **Environments**  | List, get, create, update, delete |
| **Test Suites**   | List, get, create, update, delete |
| **Users**         | List, get                         |
| **Organizations** | List, get                         |

## Troubleshooting

**Authentication Issues**

* Run `/mcp` again to re-authenticate
* Make sure you are logging in with the correct Testery account

**Permission Denied**

* Check your organization and project access rights in Testery