e2e-setup

TestRail E2E Setup

Overview

Ensures .mcp.json is configured with valid TestRail credentials so that mcp__testrail__* tools are available in the current Claude Code session.

Output: A valid .mcp.json file that Claude Code recognizes as MCP server config.

Prerequisites

• @playwright/cli is in devDependencies and available as npm run playwright-cli
• Chromium must be installed: npx playwright install chromium if needed

Step 1: Check if .mcp.json already works

test -f .mcp.json && cat .mcp.json

If .mcp.json exists, verify the credentials work:

TESTRAIL_URL=$(node -e "const c=JSON.parse(require('fs').readFileSync('.mcp.json','utf8'));console.log(c.mcpServers.testrail.env.TESTRAIL_URL)")
TESTRAIL_USERNAME=$(node -e "const c=JSON.parse(require('fs').readFileSync('.mcp.json','utf8'));console.log(c.mcpServers.testrail.env.TESTRAIL_USERNAME)")
TESTRAIL_API_KEY=$(node -e "const c=JSON.parse(require('fs').readFileSync('.mcp.json','utf8'));console.log(c.mcpServers.testrail.env.TESTRAIL_API_KEY)")
curl -s -w "\nHTTP_STATUS:%{http_code}" \
  -u "$TESTRAIL_USERNAME:$TESTRAIL_API_KEY" \
  "${TESTRAIL_URL}/index.php?/api/v2/get_projects"

• HTTP 200 -> setup complete, skip to Step 6
• HTTP 401 or file missing -> continue to Step 2

Step 2: Get latest credentials

Use WebFetch on this URL to extract login ID, password, and demo URL:

https://www.techmatrix.co.jp/product/testrail/demo_site.html

Step 3: Login to TestRail via playwright-cli

All playwright-cli commands are run via npm run playwright-cli --.

3a. Open login page

npm run playwright-cli -- open '<DEMO_SITE_URL>/index.php?/auth/login'
npm run playwright-cli -- snapshot

3b. Fill login form and submit

Known selectors (as of 2026-03):

• Email: input[name="name"]
• Password: input[name="password"]
• Submit: #button_primary

Use snapshot refs to fill and click:

npm run playwright-cli -- fill <email_ref> "<LOGIN_ID>"
npm run playwright-cli -- fill <password_ref> "<PASSWORD>"
npm run playwright-cli -- click <login_button_ref>