# 安装 io.github.uarlouski/testrail-mcp-server

- 类型: MCP 工具
- 说明: Connect AI assistants to TestRail: manage test cases, suites, runs, results, and attachments.
- 仓库: https://github.com/uarlouski/testrail-mcp-server

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "io.github.uarlouski/testrail-mcp-server" MCP 服务：
执行：claude mcp add 'io-github-uarlouski-testrail-mcp-server' -- npx -y @uarlouski/testrail-mcp-server
```

### Codex
```
请帮我安装 askskill 上的 "io.github.uarlouski/testrail-mcp-server" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-uarlouski-testrail-mcp-server]
command = "npx"
args = ["-y","@uarlouski/testrail-mcp-server"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "io.github.uarlouski/testrail-mcp-server" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-uarlouski-testrail-mcp-server": { "command": "npx", "args": ["-y","@uarlouski/testrail-mcp-server"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env TESTRAIL_INSTANCE_URL=YOUR_VALUE --env TESTRAIL_USERNAME=YOUR_VALUE --env TESTRAIL_API_KEY=YOUR_VALUE --env TESTRAIL_ENABLE_SHARED_STEPS=YOUR_VALUE --env TESTRAIL_ENABLE_CASE_HISTORY=YOUR_VALUE --env TESTRAIL_ENABLE_RAG_TOOLS=YOUR_VALUE --env TESTRAIL_ALLOW_WRITE_OPERATIONS=YOUR_VALUE --env TESTRAIL_ALLOW_READ_OPERATIONS=YOUR_VALUE --env TESTRAIL_ALLOW_DELETE_OPERATIONS=YOUR_VALUE --env TESTRAIL_ENABLE_DEPRECATED_TOOLS=YOUR_VALUE --env TESTRAIL_DISABLED_TOOLS=YOUR_VALUE --env TESTRAIL_REQUEST_TIMEOUT_MS=YOUR_VALUE --transport stdio io-github-uarlouski-testrail-mcp-server -- npx -y @uarlouski/testrail-mcp-server
```
需要环境变量：TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY, TESTRAIL_ENABLE_SHARED_STEPS, TESTRAIL_ENABLE_CASE_HISTORY, TESTRAIL_ENABLE_RAG_TOOLS, TESTRAIL_ALLOW_WRITE_OPERATIONS, TESTRAIL_ALLOW_READ_OPERATIONS, TESTRAIL_ALLOW_DELETE_OPERATIONS, TESTRAIL_ENABLE_DEPRECATED_TOOLS, TESTRAIL_DISABLED_TOOLS, TESTRAIL_REQUEST_TIMEOUT_MS

### Codex
```bash
codex mcp add --env TESTRAIL_INSTANCE_URL=YOUR_VALUE --env TESTRAIL_USERNAME=YOUR_VALUE --env TESTRAIL_API_KEY=YOUR_VALUE --env TESTRAIL_ENABLE_SHARED_STEPS=YOUR_VALUE --env TESTRAIL_ENABLE_CASE_HISTORY=YOUR_VALUE --env TESTRAIL_ENABLE_RAG_TOOLS=YOUR_VALUE --env TESTRAIL_ALLOW_WRITE_OPERATIONS=YOUR_VALUE --env TESTRAIL_ALLOW_READ_OPERATIONS=YOUR_VALUE --env TESTRAIL_ALLOW_DELETE_OPERATIONS=YOUR_VALUE --env TESTRAIL_ENABLE_DEPRECATED_TOOLS=YOUR_VALUE --env TESTRAIL_DISABLED_TOOLS=YOUR_VALUE --env TESTRAIL_REQUEST_TIMEOUT_MS=YOUR_VALUE io-github-uarlouski-testrail-mcp-server -- npx -y @uarlouski/testrail-mcp-server
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-uarlouski-testrail-mcp-server]
command = "npx"
args = ["-y","@uarlouski/testrail-mcp-server"]

[mcp_servers.io-github-uarlouski-testrail-mcp-server.env]
TESTRAIL_INSTANCE_URL = "YOUR_VALUE"
TESTRAIL_USERNAME = "YOUR_VALUE"
TESTRAIL_API_KEY = "YOUR_VALUE"
TESTRAIL_ENABLE_SHARED_STEPS = "YOUR_VALUE"
TESTRAIL_ENABLE_CASE_HISTORY = "YOUR_VALUE"
TESTRAIL_ENABLE_RAG_TOOLS = "YOUR_VALUE"
TESTRAIL_ALLOW_WRITE_OPERATIONS = "YOUR_VALUE"
TESTRAIL_ALLOW_READ_OPERATIONS = "YOUR_VALUE"
TESTRAIL_ALLOW_DELETE_OPERATIONS = "YOUR_VALUE"
TESTRAIL_ENABLE_DEPRECATED_TOOLS = "YOUR_VALUE"
TESTRAIL_DISABLED_TOOLS = "YOUR_VALUE"
TESTRAIL_REQUEST_TIMEOUT_MS = "YOUR_VALUE"
```
需要环境变量：TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY, TESTRAIL_ENABLE_SHARED_STEPS, TESTRAIL_ENABLE_CASE_HISTORY, TESTRAIL_ENABLE_RAG_TOOLS, TESTRAIL_ALLOW_WRITE_OPERATIONS, TESTRAIL_ALLOW_READ_OPERATIONS, TESTRAIL_ALLOW_DELETE_OPERATIONS, TESTRAIL_ENABLE_DEPRECATED_TOOLS, TESTRAIL_DISABLED_TOOLS, TESTRAIL_REQUEST_TIMEOUT_MS

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-uarlouski-testrail-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@uarlouski/testrail-mcp-server"
      ],
      "env": {
        "TESTRAIL_INSTANCE_URL": "YOUR_VALUE",
        "TESTRAIL_USERNAME": "YOUR_VALUE",
        "TESTRAIL_API_KEY": "YOUR_VALUE",
        "TESTRAIL_ENABLE_SHARED_STEPS": "YOUR_VALUE",
        "TESTRAIL_ENABLE_CASE_HISTORY": "YOUR_VALUE",
        "TESTRAIL_ENABLE_RAG_TOOLS": "YOUR_VALUE",
        "TESTRAIL_ALLOW_WRITE_OPERATIONS": "YOUR_VALUE",
        "TESTRAIL_ALLOW_READ_OPERATIONS": "YOUR_VALUE",
        "TESTRAIL_ALLOW_DELETE_OPERATIONS": "YOUR_VALUE",
        "TESTRAIL_ENABLE_DEPRECATED_TOOLS": "YOUR_VALUE",
        "TESTRAIL_DISABLED_TOOLS": "YOUR_VALUE",
        "TESTRAIL_REQUEST_TIMEOUT_MS": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-uarlouski-testrail-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB1YXJsb3Vza2kvdGVzdHJhaWwtbWNwLXNlcnZlciJdLCJlbnYiOnsiVEVTVFJBSUxfSU5TVEFOQ0VfVVJMIjoiWU9VUl9WQUxVRSIsIlRFU1RSQUlMX1VTRVJOQU1FIjoiWU9VUl9WQUxVRSIsIlRFU1RSQUlMX0FQSV9LRVkiOiJZT1VSX1ZBTFVFIiwiVEVTVFJBSUxfRU5BQkxFX1NIQVJFRF9TVEVQUyI6IllPVVJfVkFMVUUiLCJURVNUUkFJTF9FTkFCTEVfQ0FTRV9ISVNUT1JZIjoiWU9VUl9WQUxVRSIsIlRFU1RSQUlMX0VOQUJMRV9SQUdfVE9PTFMiOiJZT1VSX1ZBTFVFIiwiVEVTVFJBSUxfQUxMT1dfV1JJVEVfT1BFUkFUSU9OUyI6IllPVVJfVkFMVUUiLCJURVNUUkFJTF9BTExPV19SRUFEX09QRVJBVElPTlMiOiJZT1VSX1ZBTFVFIiwiVEVTVFJBSUxfQUxMT1dfREVMRVRFX09QRVJBVElPTlMiOiJZT1VSX1ZBTFVFIiwiVEVTVFJBSUxfRU5BQkxFX0RFUFJFQ0FURURfVE9PTFMiOiJZT1VSX1ZBTFVFIiwiVEVTVFJBSUxfRElTQUJMRURfVE9PTFMiOiJZT1VSX1ZBTFVFIiwiVEVTVFJBSUxfUkVRVUVTVF9USU1FT1VUX01TIjoiWU9VUl9WQUxVRSJ9fQ
需要环境变量：TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY, TESTRAIL_ENABLE_SHARED_STEPS, TESTRAIL_ENABLE_CASE_HISTORY, TESTRAIL_ENABLE_RAG_TOOLS, TESTRAIL_ALLOW_WRITE_OPERATIONS, TESTRAIL_ALLOW_READ_OPERATIONS, TESTRAIL_ALLOW_DELETE_OPERATIONS, TESTRAIL_ENABLE_DEPRECATED_TOOLS, TESTRAIL_DISABLED_TOOLS, TESTRAIL_REQUEST_TIMEOUT_MS