MCP Zebrunner

🚀 Zebrunner MCP Server

Model Context Protocol (MCP)サーバー は、Zebrunner Test Case Management と統合され、ClaudeなどのAIアシスタントを通じて、QAチームがテストケース、テストスイート、およびテスト実行データを管理するのを支援します。

📖 インストールについてヘルプが必要ですか？ 詳細なセットアップ手順については、 を参照してください。

🚀 npmを使用してインストールしますか？ Claude Desktop、Cursor、IntelliJ IDEA、およびChatGPT Desktopの設定については、 を参照してください。

🚀 クイックスタート

このツールの概要

このツールを使用すると、以下のことができます。

• Zebrunnerからテストケースとテストスイートを取得する
• テストカバレッジを分析し、テストコードを生成する
• テスト実行結果と起動詳細を取得する
• インテリジェントルールを使用した自動チェックでテストケースの品質を検証する
• テストデータからレポートと洞察を生成する
• AIによる提案と自動修正でテストケースを改善する

これらすべてを、AIアシスタントでの自然言語コマンドで行うことができます！

前提条件

必要な知識

• 基本的なコマンドラインの使用方法（ターミナルを開き、コマンドを実行する）
• Zebrunnerの資格情報（ログインとAPIトークン）
• テスト管理の基本的な理解（テストケース、テストスイート）

ソフトウェア要件

• Node.js 18以上 - ここからダウンロード
• npm（Node.jsに付属）
• API資格情報を持つZebrunnerインスタンスへのアクセス

Node.jsの確認方法

ターミナル/コマンドプロンプトを開き、以下のコマンドを実行します。

node --version
npm --version

バージョン番号が表示されれば、準備完了です！

クイックスタート手順

1. コードの取得
   • オプションA：リポジトリからクローン（推奨）

git clone https://github.com/maksimsarychau/mcp-zebrunner.git
cd mcp-zebrunner

- **オプションB：ダウンロードして解凍**

プロジェクトファイルをダウンロードし、フォルダに解凍します。

2. 依存関係のインストール

npm install

3. Zebrunner接続の構成 プロジェクトフォルダに .env ファイルを作成し、Zebrunnerの詳細を記入します。

# Your Zebrunner instance URL (without trailing slash)
ZEBRUNNER_URL=https://your-company.zebrunner.com/api/public/v1

# Your Zebrunner login (usually your email)
ZEBRUNNER_LOGIN=your.email@company.com

# Your Zebrunner API token (get this from your Zebrunner profile)
ZEBRUNNER_TOKEN=your_api_token_here

# Optional: Enable debug logging (default: false)
DEBUG=false

# Optional: Enable intelligent rules system (auto-detected if rules file exists)
ENABLE_RULES_ENGINE=true

Zebrunner APIトークンの取得方法

1. Zebrunnerインスタンスにログインします。

2. プロファイル設定に移動します。

3. 「APIアクセス」セクションを見つけます。

4. 新しいAPIトークンを生成します。

5. トークンを .env ファイルにコピーします。

6. プロジェクトのビルド

npm run build

5. 接続のテスト

npm run test:health

「✅ Health check completed」と表示されれば、準備完了です！

新しいバージョンへの更新

現在のバージョンの確認

# Check your current version
npm run version
# or manually check package.json
cat package.json | grep '"version"'

更新手順

# 1. Pull latest changes from master branch
git pull origin master

# 2. Install any new dependencies
npm install

# 3. Rebuild the project
npm run build

# 4. Test your connection (requires valid .env file)
npm run test:health

重要な注意事項

• ✅ .env ファイルが正しく構成されている必要があります。ヘルスチェックが機能するためには、これが必要です。
• ✅ 更新後にClaude Desktop/Codeを再起動して、MCPサーバーを再読み込みしてください。
• ✅ 更新する前に、リリースノートを確認して、破壊的な変更がないかを確認してください。

ヘルスチェックが失敗した場合は、.env の構成とZebrunnerの資格情報を確認してください。

✨ 主な機能

インテリジェントルールシステム

このツールの特別な点

当社のMCPサーバーには、高度な3層ルールシステムが組み込まれており、テストケースの作業方法を革新します。

🎯 テストケースレビュールール (test_case_review_rules.md)

• 目的：核心的な品質基準と記述ガイドライン
• 機能：高品質なテストケースを記述するための基本原則を定義する
• 重要な領域：独立性、単一責任、包括的な前提条件、完全な手順カバレッジ
• 使用ツール：validate_test_case および improve_test_case ツール

✅ テストケース分析チェックポイント (test_case_analysis_checkpoints.md)

• 目的：100以上のチェックポイントを含む詳細な検証チェックリスト
• 機能：徹底的なテストケース分析のための細かい検証基準を提供する
• 重要な領域：構造検証、自動化の準備状況、プラットフォームの考慮事項、品質保証
• 使用ツール：validate_test_case での包括的なスコアリングと問題検出

⚙️ MCP Zebrunnerルール (mcp-zebrunner-rules.md)

• 目的：テスト生成とカバレッジ分析のための技術的な構成
• 機能：フレームワーク検出パターン、コードテンプレート、およびカバレッジしきい値を定義する
• 重要な領域：フレームワーク検出、テスト生成テンプレート、カバレッジしきい値、品質基準
• 使用ツール：generate_draft_test_by_key および get_enhanced_test_coverage_with_rules ツール

ルールの連携方法

graph TD
    A[Test Case] --> B[validate_test_case]
    B --> C[test_case_review_rules.md]
    B --> D[test_case_analysis_checkpoints.md]
    B --> E[Validation Result + Issues]
    
    E --> F[improve_test_case]
    F --> G[AI-Powered Improvements]
    
    A --> H[generate_draft_test_by_key]
    H --> I[mcp-zebrunner-rules.md]
    H --> J[Generated Test Code]
    
    A --> K[get_enhanced_test_coverage_with_rules]
    K --> I
    K --> L[Coverage Analysis + Rules Validation]

ルールシステムの重要性

1. 一貫性：すべてのチームメンバーが同じ品質基準に従います。
2. 自動化：自動検証により、手動レビューの時間を削減します。
3. 学習：新しいチームメンバーは、AIのフィードバックを通じてベストプラクティスを学びます。
4. カスタマイズ：ルールをプロジェクトの特定のニーズに合わせて調整できます。
5. 継続的な改善：AIが実績のあるパターンに基づいて改善提案を行います。

プロジェクトへのルールのカスタマイズ

3つのルールファイルをカスタマイズすることができます。

# Copy default rules to customize
cp test_case_review_rules.md my-project-review-rules.md
cp test_case_analysis_checkpoints.md my-project-checkpoints.md
cp mcp-zebrunner-rules.md my-project-technical-rules.md

# Use custom rules in validation
"Validate test case PROJ-123 using custom rules from my-project-review-rules.md"

カスタマイズの例

• モバイルプロジェクト：モバイル固有の検証ルールを追加する
• APIプロジェクト：APIテストパターンとデータ検証に焦点を当てる
• 異なるフレームワーク：コード生成テンプレートをカスタマイズする
• 会社の標準：組織のテストガイドラインに合わせる

利用可能なツール

接続後、AIアシスタントで自然言語を使用して、これらのツールを利用できます。以下は、カテゴリ別に整理された33以上の利用可能なツールの包括的なリファレンスです。

📋 テストケース管理

コアテストケースツール

バッチテストケース操作

🌳 テストスイート階層と組織

スイート管理

スイート分析ツール

🔍 テストカバレッジと分析

カバレッジ分析

重複分析

🔗 クリック可能なリンク機能：両方の重複分析ツールは、ZebrunnerウェブUIへのクリック可能なリンクをサポートします。

• include_clickable_links: true を追加すると、Markdown出力でテストケースキーがクリック可能になります。
• JSON/DTO形式では、有効にすると自動的に webUrl フィールドが含まれます。
• リンクは、ZEBRUNNER_URL 環境変数から生成されます。
• 例："Analyze suite 17585 for duplicates with clickable links enabled"

🧪 テストコード生成と検証

AIパワードのツール

🚀 起動と実行管理

起動操作 ⭐ マネージャーに必須

📊 レポートと分析

テスト失敗分析 🆕 画期的

✅ v5.2.4で修正！ 信頼性とビデオリンクの改善

• 🎥 ビデオURLの修正：現在、信頼性の高いビデオアーティファクト抽出のために、テストセッションAPI (/api/reporting/v1/launches/{id}/test-sessions) を使用しています。
• 🛡️ 包括的なエラーハンドリング：欠落しているスクリーンショット/ログを適切に処理します（エラーをスローする代わりに空の配列を返します）。
• 🚫 "no result received" エラーの解消：すべてのAPI呼び出しには、フォールバック付きの適切なtry-catchブロックがあります。
• 🐛 デバッグの改善：設定で debug: true が有効になっている場合、ロギングが強化されます。
• 📊 スキーマの更新：下位互換性のために、古いAPI構造と新しいAPI構造の両方をサポートしています。

🎫 v4.12.1で新機能！ Jira対応チケット形式

• format: 'jira' を使用して、貼り付け可能なJiraチケットを生成します。
• 自動計算される優先度：安定性と影響に基づいています。
• スマートラベル：test-automation、locator-issue、flaky-test など。
• 完全なJiraマークアップ：テーブル、パネル、コードブロック、クリック可能なリンク。
• 🎥 目立つビデオリンク：美しいパネル + リンクセクション。
• 貼り付け可能：手動でのフォーマットは不要です。
• チケットごとに5 - 10分の節約：一貫した品質です。

🧠 v4.11.1で強化！ detailed_analyze_launch_failures は、Claudeが手動で行うような自動的な深い合成を提供します。

• 🎯 エグゼクティブサマリー：主要な調査結果、パターン、および安定性指標。
• 📅 タイムライン分析：失敗が最初に現れた時期、進行状況の追跡。
• 🔬 パターン分析：根本原因別にグループ化し、影響を受けるテストと安定性%を表示する。
• 🎯 優先度ベースの推奨事項：🔴 高 / 🟡 中 / 🟢 低 と影響分析。
• 📋 強化されたテスト詳細：完全なエラーメッセージ、スタックトレース、タイムスタンプ。
• ❓ スマートなフォローアップ質問：次の調査手順を案内する。
• スマートフィルタリング：デフォルトでは、関連する問題がないテストのみを分析する。
• すべてのテストに対するオプションのAIスクリーンショット分析。
• 手動でのフォローアップ不要 - 1回の呼び出しで完全な情報を取得できます！

🆕 v5.11.0で新機能！ テスト実行履歴と比較

• 📊 実行傾向の追跡：get_test_execution_history で起動間の合格/不合格の履歴を表示する。
• 🔄 最後に合格した実行と比較：analyze_test_failure の新しい compareWithLastPassed パラメータ。
  • ログを比較する（新しいエラーの検出）。
  • 期間を比較する（パフォーマンスの回帰）。
  • 環境を比較する（デバイス/プラットフォームの変更）。
  • スクリーンショットを比較する（視覚的な違い）。
• ⚠️ 重要な検出：最近のすべての実行でテストが失敗した場合を自動的に強調表示する。
• 🎯 回帰分析：合格と不合格の実行間で何が変更されたかを正確に確認する。
• 📈 合格率メトリクス：時間の経過に伴うテストの安定性を計算する。
• 例のプロンプトについては、TOOLS_CATALOG.md を参照してください！

スクリーンショット分析とビジュアルフォレンジックス 🎯 v4.11.0で強化

📸 強化！ スクリーンショット分析は、analyze_test_failure および analyze_launch_failures に直接統合されました - 個別に呼び出す必要はありません！詳細については、スクリーンショット分析ガイド を参照してください。

プラットフォームと結果分析 ⭐ 管理に重要

プロジェクト探索

🏃 テスト実行管理

パブリックAPIテスト実行 ⭐ 分析に強力

構成管理

マネージメントに特化したクイックコマンド

📈 日次スタンドアップレポート

# Get yesterday's results
"Get platform results for last 7 days for project MCP"

# Check recent failures  
"Show me top 5 bugs from last week"

# Review recent launches
"Get all launches for project MCP from last 3 days"

🔍 テストスイートの最適化

# Basic duplicate analysis
"Analyze suite 12345 for duplicates with 80% similarity threshold"

# Advanced semantic analysis with step clustering
"Semantic analysis of suite 12345 with 85% step clustering and medoid selection"

# Analyze specific test cases for duplicates
"Analyze test cases MCP-123, MCP-124, MCP-125 for duplicates"

# Project-wide duplicate analysis (use with caution - large datasets)
"Analyze project MCP for test case duplicates with 85% similarity"

# Get detailed similarity matrix with pattern types
"Analyze suite 12345 for duplicates with similarity matrix included"

# Two-phase clustering with semantic insights
"Semantic duplicate analysis with step clustering threshold 90% and insights enabled"

# Enable clickable links for easy navigation
"Analyze suite 17585 for duplicates with clickable links enabled"

📊 週次マネージメントレポート

# Comprehensive project health
"Get all launches for project MCP with milestone filter"

# Platform performance analysis
"Get iOS and Android test results for the last month"

# Quality metrics
"Get all test cases by automation state for project MCP"

🎯 マイルストーンとリリース計画

# Milestone tracking
"Get project milestones for MCP with completion status"

# Build-specific results
"Get launches for build 'mcp-app-2.1.0-release' and milestone '2.1.0'"

# Release readiness
"Get automation readiness for all test cases in project MCP"

🐞 問題分析とトラブルシューティング

# Bug analysis
"Show me top 10 most frequent bugs with issue links"

# Failure investigation
"Get test run 12345 details with all test cases"

# Platform-specific issues
"Get Android test results for last 7 days with failure analysis"

役割別のプロンプトとワークフロー

👩‍💻 マニュアルQAエンジニア

日次テストケースレビュー

"Get test case MCP-45 details and validate its quality"
"Show me all test cases in suite 18708 that need improvement"
"Validate test case MCP-67 and suggest specific improvements"
"Find test cases with title containing 'login' to review authentication tests"
"Get test cases from suite 491 with high priority for today's testing"

テストケースの作成と改善

"I'm writing a test case for login functionality. What should I include based on our quality standards?"
"Improve test case MCP-89 - it's missing some preconditions"
"Check if test case MCP-12 is ready for manual execution"

テストスイートの組織化

"Show me the hierarchy of test suites for project MYAPP to understand the structure"
"Get all subsuites from Authentication suite to review test coverage"
"List test cases in suite 18708 and identify which ones need validation"
"Find test cases with title containing 'payment' to organize payment testing"
"Get all high priority test cases from suite 491 for release testing"

カバレッジ分析

"I executed test case MCP-34 manually. Here's what I did: [paste your execution notes]. Analyze coverage against the documented steps."
"Compare test case MCP-56 with this manual testing session: [paste session details]"

🤖 テスト自動化エンジニアとSDET

自動化の準備状況評価

"Validate test case MCP-78 for automation readiness"
"Get all test cases in suite 18708 and identify which ones are ready for automation"
"Check test case MCP-23 - does it have clear, unambiguous steps for automation?"
"Find test cases with title containing 'API' to prioritize API automation"
"Get automation priorities to understand which test cases to automate first"
"Get test cases from suite 491 with 'Not Automated' state for automation planning"

テストコード生成

"Generate Java/Carina test code for MCP-45 based on this existing framework: [paste framework code]"
"Create JavaScript/Jest test for MCP-67 using this test structure: [paste test example]"
"Generate Python/Pytest code for MCP-89 with these page objects: [paste page object code]"

カバレッジ分析と検証

"Analyze test coverage for MCP-34 against this automated test: [paste test code]"
"Enhanced coverage analysis for MCP-56 with rules validation - here's my implementation: [paste code]"
"Compare test case MCP-78 steps with this Selenium test: [paste selenium code]"

フレームワーク統合

"Generate test code for MCP-45 using our Carina framework with these page objects: [paste existing code]"
"Create test automation for MCP-67 that integrates with this CI/CD pipeline: [paste pipeline config]"
"Generate API test for MCP-89 using this RestAssured setup: [paste API test framework]"

バッチ自動化分析

"Validate all test cases in Authentication suite for automation readiness"
"Generate coverage report for all test cases in project MYAPP"
"Identify test cases in suite 18708 that have automation blockers"
"Find test cases with title containing 'regression' for automation sprint planning"
"Get test cases from suite 491 created after 2025-01-01 with high priority for next automation cycle"
"Get automation priorities and states to create automation roadmap"

👨‍💻 開発者

テストケースの理解

"Get test case MCP-45 details to understand what I need to implement"
"Show me test cases related to login functionality in project MYAPP"
"Explain test case MCP-67 requirements in developer-friendly format"
"Find test cases with title containing 'authentication' for my feature development"
"Get high priority test cases from suite 491 that I need to implement"

実装の検証

"I implemented this feature: [paste code]. Analyze coverage against test case MCP-34"
"Here's my API implementation: [paste code]. Check coverage against test case MCP-56"
"Validate my UI implementation against test case MCP-78: [paste component code]"

テスト用のコード生成

"Generate unit tests for test case MCP-45 using Jest framework"
"Create integration tests for MCP-67 based on this API: [paste API code]"
"Generate test data setup for MCP-89 using this database schema: [paste schema]"

バグ分析

"Get test execution results for launch 118685 to understand recent failures"
"Show me top bugs from last week related to my feature area"
"Get detailed bug review for Android project from last 14 days"
"Show me comprehensive failure information for hashcode 1051677506"
"What are the top 50 bugs affecting our project this month?"
"Give me a summary of bug failures with reproduction dates from last 7 days"
"Analyze test case MCP-34 - why might it be failing in automation?"

👔 テストマネージャーとチームリード

チームの品質メトリクス

"Get quality metrics for all test cases in project MYAPP"
"Show me test cases that need improvement in suite 18708"
"Generate quality report for test cases created this month"
"Find test cases with title containing 'critical' to assess critical path quality"
"Get automation priorities to align team efforts with business priorities"
"Get test cases from suite 491 with high priority that need quality improvements"

テストスイートの分析

"Show me the complete test suite hierarchy for project MYAPP"
"Analyze test coverage across all suites in project MYAPP"
"Get automation readiness status for all test cases in Authentication suite"

チームのパフォーマンスと計画

"Get test execution results by platform for the last 30 days"
"Show me top 10 most frequent bugs to prioritize fixes"
"Analyze test case quality trends in project MYAPP"
"Get all launches for project MYAPP from last 30 days with milestone tracking"
"Show me platform results for last 7 days to track team performance"
"Get test runs with status 'FAILED' from last week for team retrospective"

プロセスの改善

"Validate all test cases in suite 18708 to identify common quality issues"
"Generate improvement recommendations for test cases created by junior team members"
"Analyze which test cases are consistently failing automation"
"Get top 10 bugs from last month to identify process improvements"
"Show me test runs with detailed failure analysis for process optimization"
"Get automation readiness metrics across all test cases"
"Find test cases with title containing 'flaky' to address test stability"
"Get test cases from suite 491 with medium priority that could be automated"
"Get automation priorities to optimize team resource allocation"

レポートと利害関係者へのコミュニケーション

"Generate comprehensive test coverage report for project MYAPP in markdown format"
"Get test execution summary for launch 118685 for stakeholder presentation"
"Show me test quality metrics and improvement suggestions for quarterly review"
"Get platform results by period for executive dashboard"
"Create milestone progress report with test execution data"
"Generate weekly team performance report with launch and bug metrics"

日次管理タスク

"Get all launches for project MYAPP from yesterday"
"Show me top 5 bugs from last 7 days with issue links"
"Get platform results for iOS and Android from last week"
"Check automation readiness for upcoming release milestone"
"Get test run details for failed runs from last 24 hours"
"Show me project milestones and their completion status"

🏢 プロジェクトオーナーとプロダクトマネージャー

プロジェクトの健全性の概要

"Get overall test coverage status for project MYAPP"
"Show me test execution results by platform for the last quarter"
"Generate project testing health report in markdown format"
"Get all launches for project MYAPP with milestone and build tracking"
"Show me platform results summary for executive review"
"Get project milestones with completion status and testing metrics"

機能テストのステータス

"Get test cases related to [feature name] in project MYAPP"
"Show me test execution results for [feature name] functionality"
"Analyze test coverage for [epic/story] requirements"
"Get launches filtered by milestone for feature release tracking"
"Show me test runs for specific build versions"

品質保証メトリクス

"Get quality metrics for all test cases in project MYAPP"
"Show me test case validation results and improvement areas"
"Generate testing quality report for stakeholder presentation"
"Get top bugs analysis for quality trend assessment"
"Show me automation vs manual testing ratio across the project"
"Find test cases with title containing 'smoke' to assess smoke test coverage"
"Get automation priorities to communicate testing strategy to stakeholders"
"Get test cases from suite 491 with critical priority for risk assessment"

リスク評価

"Show me top 10 most frequent bugs in project MYAPP"
"Get test cases that are not ready for automation and assess risk"
"Analyze test execution trends to identify potential quality risks"
"Get platform-specific failure rates for the last month"
"Show me test runs with high failure rates for risk mitigation"
"Get milestone-based testing progress for release risk assessment"

計画とリソース配分

"Get automation readiness assessment for all test cases in project MYAPP"
"Show me test cases that need quality improvement and estimate effort"
"Analyze test suite structure to identify optimization opportunities"
"Get testing resource utilization by platform and time period"
"Show me milestone testing progress for sprint planning"
"Get comprehensive launch analysis for capacity planning"
"Find test cases with title containing 'performance' to plan performance testing"
"Get automation priorities to allocate automation resources effectively"
"Get test cases from suite 491 created in last month to plan review sessions"

エグゼクティブレポート

"Generate executive dashboard with platform results and bug trends"
"Get quarterly testing metrics with milestone progress"
"Show me ROI analysis of automation vs manual testing efforts"
"Create board-ready testing status report with key metrics"
"Get testing velocity trends for project timeline assessment"

📖 出力形式

すべてのツールは、複数の出力形式をサポートしています。

• json - 構造化データ（デフォルト）
• markdown - セクションとテーブル付きのリッチなフォーマット出力
• string - 人間が読みやすいテキスト要約
• dto - 生データオブジェクト

例：

"Get test case PROJ-123 in markdown format"
"Show me test suites as JSON"

⚙️ 設定オプション

環境変数

# Required
ZEBRUNNER_URL=https://your-instance.zebrunner.com/api/public/v1
ZEBRUNNER_LOGIN=your.email@company.com
ZEBRUNNER_TOKEN=your_api_token

# Optional - Basic Settings
DEBUG=false                        # Enable detailed logging (default: false)
DEFAULT_PAGE_SIZE=100             # Default items per page (optional)
MAX_PAGE_SIZE=100                 # Maximum items per page (optional)

# Optional - Intelligent Rules System
ENABLE_RULES_ENGINE=true          # Enable intelligent rules (auto-detected if rules file exists)
MCP_RULES_FILE=custom-rules.md    # Custom technical rules file (optional)
MIN_COVERAGE_THRESHOLD=70         # Minimum coverage percentage (optional)
REQUIRE_UI_VALIDATION=true        # Require UI validation in tests (optional)
REQUIRE_API_VALIDATION=true       # Require API validation in tests (optional)

ルールシステムの設定

ルールシステムは、プロジェクトルートのルールファイルを自動的に検出して使用します。

自動検出

プロジェクトルートに mcp-zebrunner-rules.md ファイルがある場合、ルールエンジンは自動的に有効になります。

カスタムルールファイル

3種類のルールをカスタマイズすることができます。

1. テストケースレビュールール (test_case_review_rules.md)

# Custom Test Case Review Rules

## Rule 1: Title Quality
- Titles must be descriptive and specific
- Minimum length: 10 characters
- Should not contain vague terms like "test", "check"

## Rule 2: Test Steps
- Each step must have clear action and expected result
- Steps should be numbered and sequential
- Avoid combining multiple actions in one step

2. 分析チェックポイント (test_case_analysis_checkpoints.md)

# Custom Analysis Checkpoints

## Independence Assessment
- [ ] Can this test case run independently?
- [ ] Are all preconditions explicitly stated?
- [ ] No dependencies on other test cases?

## Automation Readiness
- [ ] All steps are unambiguous?
- [ ] Technical feasibility confirmed?
- [ ] Stable selectors available?

3. 技術的なルール (mcp-zebrunner-rules.md)

# Technical Configuration

## Coverage Thresholds
- Overall Coverage: 80%
- Critical Steps: 95%
- UI Validation Steps: 85%

## Framework Detection
**Java/TestNG**:
- Keywords: @Test, TestNG, WebDriver
- File patterns: *Test.java, *Tests.java

🧪 セットアップのテスト

ヘルスチェックの実行

npm run test:health

API接続のテスト

npm run smoke

完全なテストスイートの実行

npm test

特定のテストタイプの実行

npm run test:unit           # Fast unit tests
npm run test:integration    # API integration tests
npm run test:e2e           # End-to-end tests

🔍 トラブルシューティング

一般的な問題

"Authentication failed" または 401エラー

• ✅ ZEBRUNNER_LOGIN と ZEBRUNNER_TOKEN を確認してください。
• ✅ APIトークンがまだ有効であることを確認してください。
• ✅ Zebrunnerでユーザーが適切な権限を持っていることを確認してください。

"Project not found" または 404エラー

• ✅ プロジェクトキーのスペルを確認してください（例："MYAPP"、"myapp" ではなく）。
• ✅ Zebrunnerでプロジェクトへのアクセス権があることを確認してください。
• ✅ 一部のエンドポイントは、すべてのZebrunnerインスタンスで利用できるとは限りません。

"Connection timeout" エラー

• ✅ ZEBRUNNER_URL が正しいことを確認してください。
• ✅ ネットワークがZebrunnerインスタンスに到達できることを確認してください。
• ✅ 設定でタイムアウトを増やしてみてください。

MCP統合が機能しない

• ✅ dist/server.js へのパスが正しいことを確認してください。
• ✅ プロジェクトが正常にビルドされたことを確認してください（npm run build）。
• ✅ MCP構成で環境変数が設定されていることを確認してください。
• ✅ Claude Desktop/Codeのログを見て、エラーメッセージを確認してください。

ルールエンジンが機能しない

• ✅ .env ファイルで ENABLE_RULES_ENGINE=true であることを確認してください。
• ✅ ルールファイルが存在し、意味のある内容が含まれていることを確認してください。
• ✅ ルールファイルを変更した後、MCPサーバーを再起動してください。
• ✅ デバッグログを確認して、ルールの解析エラーを確認してください。

デバッグモード

詳細なロギングを有効にして、問題をトラブルシューティングします。

DEBUG=true

これにより、以下が表示されます。

• APIリクエストとレスポンス
• エラー詳細とスタックトレース
• パフォーマンスメトリクス
• 機能の可用性
• ルールの解析と検証の詳細

ヘルプの取得

1. ログを確認する - デバッグモードを有効にして、エラーメッセージを探します。
2. 接続をテストする - npm run test:health を実行します。
3. 構成を確認する - .env ファイルを再確認します。
4. Zebrunnerの権限を確認する - ユーザーが適切なアクセス権を持っていることを確認します。
5. ルールファイルを検証する - ルールファイルに意味のある内容が含まれていることを確認します。

🎯 例のワークフロー

ワークフロー1: テストケースレビュー（マニュアルQA）

1. "Get test case PROJ-123 details"
2. "Validate test case PROJ-123"
3. "Improve test case PROJ-123 with specific suggestions"
4. "Check if test case PROJ-123 is ready for manual execution"

ワークフロー2: テスト自動化（SDET）

1. "Validate test case PROJ-456 for automation readiness"
2. "Generate Java/Carina test code for PROJ-456"
3. "Analyze coverage between test case and my implementation"
4. "Get automation readiness assessment"

ワークフロー3: 実装の検証（開発者）

1. "Get test case PROJ-789 details to understand requirements"
2. "Analyze coverage for PROJ-789 against my implementation"
3. "Generate unit tests based on test case requirements"
4. "Validate implementation completeness"

ワークフロー4: 品質管理（チームリード）

1. "Get quality metrics for all test cases in project MYAPP"
2. "Show me test cases that need improvement"
3. "Generate team quality report"
4. "Identify automation readiness across the project"

ワークフロー5: プロジェクトの健全性（プロダクトマネージャー）

1. "Get overall test coverage status for project MYAPP"
2. "Show me test execution results by platform"
3. "Generate project testing health report"
4. "Identify quality risks and improvement opportunities"

🔧 高度な機能

バッチ操作

一度に複数のテストケースを処理します。

"Validate all test cases in suite 18708"
"Generate coverage report for all test cases in project MYAPP"
"Improve all test cases that have quality issues"

カスタム出力形式

必要な形式でデータを取得します。

"Get test cases as JSON for API integration"
"Show test suite hierarchy in markdown for documentation"
"Generate quality report in markdown for stakeholder presentation"

フィルタリングと検索

必要なものを正確に見つけます。

"Get test cases created after 2025-01-01"
"Find test cases with automation state 'Manual'"
"Show me test cases that are not ready for automation"

ルールベースの分析

インテリジェントな検証を活用します。

"Validate test case PROJ-123 using custom rules from my-project-rules.md"
"Enhanced coverage analysis with framework-specific rules"
"Generate improvement suggestions based on team quality standards"

📚 追加ドキュメント

📖 ツールリファレンス

• TOOLS_CATALOG.md - 🆕 40以上のすべてのツールの完全なカタログと自然言語の例
• INSTALL-GUIDE.md - 📥 ステップバイステップのインストールとセットアップガイド

🧠 インテリジェントルールシステム

• docs/INTELLIGENT_RULES_SYSTEM.md - 🧠 3層のインテリジェントルールシステムの完全なガイド
• docs/RULES_QUICK_REFERENCE.md - ⚡ ルールシステムのコマンドと設定のクイックリファレンス

📋 ルールファイル（カスタマイズ可能）

• test_case_review_rules.md - 🎯 核心的な品質基準と記述ガイドライン
• test_case_analysis_checkpoints.md - ✅ 100以上の詳細な検証チェックポイント
• mcp-zebrunner-rules.md - ⚙️ テスト生成とカバレッジ分析のための技術的な構成

🔍 専用ガイド

• docs/SCREENSHOT_ANALYSIS.md - 📸 スクリーンショットのダウンロードとビジュアル分析ガイド
• change-logs.md - 📝 バージョン履歴と機能更新

🛠️ 機能ドキュメント

• docs/NEW_LAUNCHER_TOOL.md - 起動とレポートツールの詳細情報
• docs/SUITE_HIERARCHY.md - スイート階層機能の完全なガイド
• docs/TEST_CASE_VALIDATION_IMPLEMENTATION.md - テストケース検証システムの詳細
• docs/ENHANCED_VALIDATION_FEATURES.md - 高度な検証と改善機能
• docs/SCREENSHOT_ANALYSIS.md - 📸 スクリーンショット分析とビジュアルフォレンジックスガイド 🆕

🤝 コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 適切なテストを含めて変更を加えます。
4. すべてのテストが通過することを確認します：npm test
5. プルリクエストを送信します。

📄 ライセンス

このプロジェクトは、AGPL-3.0 ライセンスの下で公開されており、MCPサーバーへのすべての改善がオープンソースとして維持されることを保証します。特に、ソフトウェアが