---
title: "Client setup"
description: "Connect Claude Code, Cursor, VS Code, and other MCP clients."
canonical_url: "https://docs.trytestr.com/docs/mcp/clients"
markdown_url: "https://docs.trytestr.com/docs/mcp/clients.md"
last_updated: "2026-11-16"
x_farming_labs_generated_preamble: true
---

# Client setup
URL: /docs/mcp/clients
LLM index: /llms.txt
Description: Connect Claude Code, Cursor, VS Code, and other MCP clients.

# Client setup

Your client must support **remote Streamable HTTP servers** and **custom headers**. Every client needs the same two values:

- **URL:** `https://owners.trytestr.com/api/mcp`
- **Header:** `Authorization: Bearer <your token>`

<CodeGroup>

```sh title="Claude Code"
claude mcp add --transport http testr https://owners.trytestr.com/api/mcp \
  --header "Authorization: Bearer $TESTR_MCP_TOKEN"
```

```json title="Cursor"
{
  "mcpServers": {
    "testr": {
      "url": "https://owners.trytestr.com/api/mcp",
      "headers": { "Authorization": "Bearer ${env:TESTR_MCP_TOKEN}" }
    }
  }
}
```

```json title="VS Code"
{
  "servers": {
    "testr": {
      "type": "http",
      "url": "https://owners.trytestr.com/api/mcp",
      "headers": { "Authorization": "Bearer ${input:testr-token}" }
    }
  },
  "inputs": [
    {
      "id": "testr-token",
      "type": "promptString",
      "description": "Testr MCP token",
      "password": true
    }
  ]
}
```

```json title="Other"
{
  "mcpServers": {
    "testr": {
      "type": "http",
      "url": "https://owners.trytestr.com/api/mcp",
      "headers": { "Authorization": "Bearer ${TESTR_MCP_TOKEN}" }
    }
  }
}
```

</CodeGroup>

Cursor reads `.cursor/mcp.json` and VS Code reads `.vscode/mcp.json` in your project. VS Code prompts for the token once and stores it securely.

Configuration formats and variable substitution differ between clients and change over time. Check your client's documentation if a snippet doesn't load.

## Check the connection with curl

```sh
curl https://owners.trytestr.com/api/mcp \
  -H "Authorization: Bearer $TESTR_MCP_TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

A successful response lists the tools your token can use. A read-only token will not list write tools.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).
