TestRail MCPサーバー

このModel Context Protocol (MCP) サーバーは、Claude AIやCursorなどのMCP対応クライアントから直接TestRailと対話するためのツールを提供します。AIとの会話を離れることなく、テストケース、プロジェクト、スイート、実行などを管理できます。

利用可能なツール

TestRail MCPサーバーは、以下のツールを提供します。

Related MCP server: TestRail MCP Server

使用方法

以下のように設定することで、このMCPサーバーに接続できます。この方法では npx を使用して最新バージョンのパッケージを自動的にダウンロードして実行するため、ローカルへのインストールは不要です。

// Example configuration using npx
{
  "mcpServers": {
    "testrail": {
      "command": "npx",
      "args": ["@bun913/mcp-testrail@latest"],
      "env": {
        "TESTRAIL_URL": "https://your-instance.testrail.io", // Replace with your TestRail URL
        "TESTRAIL_USERNAME": "your-email@example.com", // Replace with your TestRail username
        "TESTRAIL_API_KEY": "YOUR_API_KEY" // Replace with your TestRail API key
      }
    }
  }
}

トラブルシューティング

• spawn node ENOENT エラー: Node.jsが正しくインストールされており、PATHに含まれていることを確認してください。

• 認証の問題: TestRail APIの認証情報を確認してください。

• 会話が長すぎる場合: テストケースやセクションのページネーションには limit および offset パラメータを使用してください。

• テストケース作成/更新時のHTTP 400エラー: TestRailプロジェクトには、テンプレート、カスタムフィールド、必須フィールドの違いがあります。このMCPサーバーはパラメータを直接TestRail APIに渡すため、検証や変換は行いません。400エラーが発生する場合は、LLMが正しいパラメータを送信できるように、プロジェクトのルールを CLAUDE.md または AGENTS.md に定義してください。例:

  # TestRail Rules for This Project
  - Project ID: 1
  - Always use template 2 (Separated Steps) when creating test cases
    - Use `customStepsSeparated` (array of step objects)
    - Do NOT send `customSteps` or `customExpected` with template 2
  - Required custom fields: custom_automation_type (default: 0)
  - Call `getCaseFields` at the start of a session to check available fields

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

謝辞

• TestRail API

• Model Context Protocol SDK