TestrDocs
TestrDocs

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>
claude mcp add --transport http testr https://owners.trytestr.com/api/mcp \
  --header "Authorization: Bearer $TESTR_MCP_TOKEN"
{
  "mcpServers": {
    "testr": {
      "url": "https://owners.trytestr.com/api/mcp",
      "headers": { "Authorization": "Bearer ${env:TESTR_MCP_TOKEN}" }
    }
  }
}
{
  "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
    }
  ]
}
{
  "mcpServers": {
    "testr": {
      "type": "http",
      "url": "https://owners.trytestr.com/api/mcp",
      "headers": { "Authorization": "Bearer ${TESTR_MCP_TOKEN}" }
    }
  }
}

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

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.