TestSprite MCP Server — Memulai Panduan (Bahasa Indonesia)
TestSprite の公式ドキュメントは、AI ベースのソフトウェアを自動でテストしたいインドネシアの開発者向けに、インドネシア語に翻訳されています。
原文: https://docs.testsprite.com
翻訳者: インドネシアの開発者コミュニティのためのインドネシア人開発者
目次
- TestSprite の紹介
- 概要 — TestSprite MCP Server とは?
- インストール — TestSprite MCP Server の入れ方
- 最初のテスト — 10 分で自動テストを実行
- 新しいプロジェクトのためのテスト作成
- TestSprite の重要な用語
1. TestSprite の紹介
TestSprite は、完全に自律したテストのための、最も使いやすい AI ベースのソフトウェアテストエージェントです。ノーコードの AI はテストサイクルを 10〜20分 で完了するため、手動の QA 作業を必要とせずに、自信を持って製品をリリースできます。
TestSprite MCP Server は、AI アプリを外部システムに接続するためのオープンソース標準である Model Context Protocol の統合です。これにより、IDE 内の AI アシスタントがエディタから TestSprite のワークフロー全体を直接設定できるようになります。
2. 概要 — TestSprite MCP Server とは?
TestSprite MCP Server は、IDE 内の AI アシスタント(Cursor や Windsurf など)を、賢い TestSprite のテストエンジンに接続する Model Context Protocol の統合です。これにより、完全に自動化されたテストワークフローを、開発環境の中でそのまま実現できます。
仕組み
IDE に TestSprite MCP をインストールしたら、シンプルな 自然言語のプロンプト を使って、当社の AI テストエージェントにテストワークフロー全体をあなたの代わりに任せることができます。
次のプロンプトを使い、プロジェクトフォルダをチャットにドラッグするか、必要なテスト要件を説明してください。TestSprite MCP Server が残りを処理します。
このプロジェクトを TestSprite でテストするのを手伝ってください。
TestSprite が 8 つの簡単なステップで動作する方法
- ユーザー PRD を読み取る — 製品の要件と目的を理解します。
- コードを分析する — プロジェクト構造、機能、実装をスキャンします。
- TestSprite PRD を生成する — 正規化された製品要件ドキュメントを作成します。
- テスト計画を作る — PRD とコードに基づいて包括的なテストケースを生成します。
- テストコードを生成する — 実行可能なテストスクリプト(Playwright、Cypress など)を作成します。
- テストを実行する — 安全なクラウド環境でテストを実行します。
- 結果を提示する — 実行可能な洞察を含む詳細なレポートを共有します。
- 改善を可能にする — IDE が当社の分析を使って問題を自動的に修正します。
主なメリット
開発者向け: テスト作成ゼロでより早くリリースし、数分でフィードバック(何時間もかけるのではなく)を得て、AI のパワーを活かした分析で問題を自動的に修正—そしてすべてIDE を離れることなくできます。
チーム向け: 広範で一貫した 予測可能な品質 と より迅速なリリースを、エッジケースを含めて実現しつつ、手動 QA の工数とテスト保守のオーバーヘッドを削減します。
従来のテストとの比較
| 機能 | 従来のテスト | TestSprite MCP Server |
|---|---|---|
| テストケース作成 | テストケースを手動で作成 | AI がテストケースを自動生成 |
| セットアップ | 複雑なフレームワークを準備 | ほぼ セットアップ不要 |
| デバッグ | 失敗を手動でデバッグ | 問題を分析し、あなたのために修正 |
| 統合 | テストを開発から切り離して実行 | コーディングのワークフローに統合 |
| カバレッジ | 限定されたカバレッジで重要なエッジケースを見落とす | 自動で包括的なカバレッジ |
テストの能力
フロントエンドのテスト(ビジネスフロー E2E):
- ユーザーの移動経路
- フォームのフロー & バリデーション
- 視覚的ステータス & レイアウト
- インタラクティブなコンポーネント & 状態を持つ UI
- 認可 & 認証のフロー
- エラー処理(UI)
バックエンドのテスト(API & 統合):
- 機能的な API ワークフロー
- 契約 & スキーマのバリデーション
- エラー処理 & 耐障害性
- 認可 & 認証
- 境界条件 & エッジケース
- データの完全性 & 永続化
- セキュリティテスト
対応しているテクノロジー
フロントエンドのフレームワーク:
- React, Vue, Angular, Svelte, Next.js, Vite, Vanilla JavaScript/TypeScript
バックエンドのテクノロジー:
- Node.js, Python, Java, Go, Express.js, FastAPI, Spring Boot, REST API、GraphQL
具体的な成果
- コード品質 90%+ — プロレベルのコード品質を達成
- 10 倍速いテスト — 時間から分へ
- 学習曲線ゼロ — テストの専門スキルは不要
- バグの自動修正 — AI が問題を自動で修正
3. インストール — TestSprite MCP Server の入れ方
2 分未満で IDE に TestSprite MCP Server をセットアップしましょう。
前提条件
TestSprite MCP Server をインストールする前に、次のものを用意してください:
- 互換性のある IDE — TestSprite は Trae、Cursor、Claude Code、Windsurf、VS Code、GitHub Copilot をサポートしています。
- TestSprite アカウント — ここで無料登録
- Node.js >= 22 — Node.js をダウンロード(MCP サーバーを実行するために必要)
Node.js のバージョン確認方法:
node --version
API キーの取得
まず、どのインストール方法でも TestSprite の API キーが必要です:
- TestSprite ダッシュボード にログインします。
- Settings の下にある API Keys に移動します。
- 「New API Key」 をクリックします。
IDEごとのインストール
Trae
- APIキーを取得します。
- Traeで
AI Sidebar > AI Managementに移動します。 MCP > Add > Add from Marketplaceを選択します。- TestSprite を検索して、MCPの一覧に追加します。
- TraeにAPIキーを入力し、Confirm を押します
- Builder with MCP を選択して、テストを開始します。
Cursor
重要: Cursorのデフォルトモード「Run in Sandbox」はTestSpriteの機能を制限します。以下の設定を参照してください。
ワンクリックインストール(最も簡単):
- APIキーを取得します。
- このワンクリックインストールのリンク をクリックします。
- CursorにAPIキーを入力します。
- テストを開始します。
手動インストール:
- Cursorの設定を開きます(
Cmd/Ctrl + Shift + J) - Tools & Integration に移動します
- Add custom MCP をクリックします
- 以下の設定 を追加します:
{
"mcpServers": {
"TestSprite": {
"command": "npx",
"args": ["@testsprite/testsprite-mcp@latest"],
"env": {
"API_KEY": "api-key-kamu"
}
}
}
}
Cursor Sandbox Modeの設定:
CursorでTestSprite MCP Serverの機能を完全に使えるようにするには:
Cursor→Settings→Cursor SettingsChat→Auto-Run→Auto-Run Modeを開き、設定を"Ask Everytime" または "Run Everything" に変更します。
Claude Code
- ターミナルでプロジェクトのディレクトリへ移動します:
cd /path/to/your/project
- インストールコマンドをターミナルに貼り付けます:
claude mcp add TestSprite --env API_KEY=api_key_kamu -- npx @testsprite/testsprite-mcp@latest
api_key_kamuを実際のTestSpriteのAPIキーに置き換えますインストール のコマンドを実行します
このコマンドをプロジェクトディレクトリで実行して、インストールを確認します:
claude mcp list
次が表示されるはずです:
TestSprite: npx @testsprite/testsprite-mcp@latest - ✓ Connected
注: この方法でMCPサーバーをインストールすると、現在のプロジェクトディレクトリ内でClaude CodeにTestSpriteを追加するだけです。別のプロジェクトディレクトリでClaude Codeを使う場合は、MCPサーバーをもう一度追加する必要があります。
VS Code
-
開く Command Palette(
Cmd/Ctrl + Shift + P) - 実行する MCP: Add Server コマンド
- 選択する Commandのインストールタイプ(stdio)
-
入力する Command to runとして
npx @testsprite/testsprite-mcp@latest - 入力する テストスプライトとして、MCPサーバーのidentifier/名前はTestSprite
- 選択する MCPサーバーを設定したい範囲
-
設定を追加する
env:
{
"servers": {
"testsprite": {
"command": "npx",
"args": ["-y", "@testsprite/testsprite-mcp@latest"],
"env": {
"API_KEY": "api-key-kamu"
}
}
}
}
- インストール後、あなたが新しく設定した
mcp.jsonの中のTestSprite MCPのエントリの上にあるstartボタンをクリックします。
その他のIDE
この設定をあなたのMCPの設定に追加します:
{
"mcpServers": {
"TestSprite": {
"command": "npx",
"args": ["@testsprite/testsprite-mcp@latest"],
"env": {
"API_KEY": "api-key-kamu"
}
}
}
}
インストールの確認
成功の指標:
- あなたのAIアシスタントが TestSprite MCPツール を見ることができる
- エラー "command not found" がない
- プロジェクトのテストを開始する準備ができている
クイックテスト:
次のプロンプトを試してください:
Help me test this project with TestSprite.
あなたのアシスタントは、TestSprite MCPツールを使う提案をするはずです。
インストールの削除
TestSprite MCPサーバーを削除するには:
- あなたのMCP IDEの設定から設定を削除する
- IDEを再起動する
4. 最初のテスト — 10分以内に自動テストを実行
10分未満で初めての自動テストを実行し、TestSprite MCPサーバーの驚きを体験してください。
このガイドの最後には、あなたは最初の自動テストスイートを実行し、AIが包括的なテスト計画を生成するのを見て、クラウド上でテストが実行されるのを目撃し、詳細なテストレポートを受け取り、自動バグ修正を適用していることでしょう。
開始する前に、TestSprite MCPサーバーをインストールし、あなたのIDEが開いていることを確認してください。
ステップ1:プロジェクトを準備する
アプリケーションを起動 — アプリがローカルで動作していることを確認してください:
# フロントエンドアプリ(例)
npm run dev # 通常はポート3000、5173、または8080で動作
# バックエンドアプリ(例)
node index.js # 通常はポート8000、3001、または4000で動作
プロジェクト構成の例:
my-project/
├── frontend/ # React、Vue、Angularなど
│ ├── src/
│ ├── package.json
│ └── ...
├── backend/ # Node.js、Pythonなど
│ ├── app.py
│ ├── requirements.txt
│ └── ...
├── README.md
└── package.json
ステップ2:魔法のコマンド
あなたのIDEのChatを開き、次の手順に従ってください:
- IDEで新しいチャットウィンドウを開く
- 魔法のコマンドを入力します:
Can you test this project with TestSprite?
- 特定のサブプロジェクトをテストしたい場合は、プロジェクトフォルダをチャットにドラッグ&ドロップします
Shift + Enterを押す
以上です!あなたのAIアシスタントが引き継ぎ、テストの全プロセスを通して案内します。
ステップ3:設定(必須)
注: テスト設定ページがブラウザで開きます。ここで設定を完了してからテストを進めてください。
ブートストラップツールが開いたら、次を設定する必要があります:
1. テストの種類:
-
モード:
- フロントエンド: UIやユーザーフロー(例:ボタン、フォーム、ナビゲーション)をテストしたい場合はこれを選びます。
- バックエンド: API、サービス、またはサーバー側のロジックをテストしたい場合はこれを選びます。
-
範囲(Scope):
- コードベース: プロジェクト全体に対してテストを実行します。完全なテストのスイープを行う、またはMCPを以前に実行したことがない場合に使用します。
- コード差分(Code Diff): 最新の変更のみに対してテストを実行します(コミットされていないGitの変更)。すべてをもう一度テストせずに、新しい作業を素早く検証するのに使用します。
2. テストアカウントのクレデンシャル — アプリがログインを必要とする場合:
フロントエンド:
ユーザー名: test@example.com
パスワード: あなたのテスト用パスワード
バックエンドの場合、サポートされている認証タイプ:
| 認証タイプ | 説明 |
|---|---|
| Basic | ユーザー名&パスワードを使用 |
| Bearer | 安全なトークンベースの認証 |
| API-key | アクセス用の一意なAPIキーを使用 |
| None | 認証は不要 |
3. アプリケーションURL:
フロントエンド: http://localhost:5173
バックエンド: http://localhost:4000
4. プロダクト要件ドキュメント(PRD):
既存のPRDをアップロード(必須)。たとえ下書きや品質の低いPRDであっても問題ありません。AI TestSpriteは、アップロード内容に基づいてPRDを正規化された形で生成します。
ステップ4:自動ワークフロー
あなたのAIアシスタントは、次の手順を実行することでテストの全プロセスを自動的に処理します。プロジェクトの理解から実際のテスト実行まで、すべてを管理するため、手作業で何かを行う必要はありません。
ステップ5:テスト結果を確認する
テスト後、あなたのプロジェクト内で次のファイルが見つかります:
testsprite_tests/
├── tmp/
│ ├── prd_files/ # アップロードされたPRDファイル
│ ├── config.json # テスト設定
│ ├── code_summary.json # コード分析
│ ├── report_prompt.json # AI分析データ
│ └── test_results.json # 詳細なテスト結果
├── standard_prd.json # 正規化されたPRD
├── TestSprite_MCP_Test_Report.md # 人が読めるレポート
├── TestSprite_MCP_Test_Report.html # HTMLレポート
├── TC001_Login_Success_with_Valid_Credentials.py
├── TC002_Login_Failure_with_Invalid_Credentials.py
└── ... # 追加のテストファイル
テスト結果を理解する — テストレポートには、全体のカバレッジ、合格率、失敗したテストと詳細な失敗分析、カテゴリ(機能、UI/UX、セキュリティ、パフォーマンス)が表示されます。
ステップ6:自動バグ修正
修正を依頼する — テスト結果を確認したら、次のように尋ねるだけです:
TestSpriteのテスト結果に基づいて、コードベースを修正してください。
AIは失敗したテストを分析し、問題のあるコード部分を特定し、標的を絞った修正を自動的に適用し、修正を検証するためにテストを再実行し、問題が解消されるまで反復します。
出力例
生成されたテスト計画:
{
"testCases": [
{
"id": "TC001",
"title": "ユーザー認証のログイン",
"description": "有効な認証情報でユーザーがログインできることをテスト",
"category": "Functional",
"priority": "High",
"steps": [
"ログインページに移動する",
"有効なユーザー名とパスワードを入力する",
"ログインボタンをクリックする",
"ログインに成功したことを確認する"
]
}
// ... 17 件の 他の テストケース
]
}
テストレポートの要約:
{
"summary": {
"totalTests": 18,
"passed": 12,
"failed": 6,
"passRate": "67%",
"coverage": "85%"
},
"failures": [
{
"testId": "TC005",
"title": "管理者パネルへのアクセス",
"error": "ボタンが見つかりません:#admin-delete-btn",
"recommendation": "管理者パネルに削除ボタンがないので追加する"
}
]
}
成功のためのヒント
- アプリが動作していることを確認: フロントエンドとバックエンドは標準ポートでアクセス可能である必要があります
- プロジェクト構成: 設定手順と説明的なフォルダ名を含むREADMEを用意してください
- テスト認証情報: 本番以外のデータでテスト用ユーザーアカウントを準備します
- 生成されたファイルを確認: PRDと生成されたテスト計画を精度の観点から確認します
5. 新しいプロジェクトのためのテストを作成する
TestSprite MCP Serverを使って、新しいプロジェクト向けの包括的なテストスイートを生成します。
いつこれを使うか
自動テストがほとんどない、またはまったくないプロジェクトをオンボーディングする際に、このガイドを使用してください。MCPのワークフローは、あなたのコードベースを分析し、正規化されたPRDを導き出し、フロントエンドとバックエンドのテスト計画を生成し、実行可能なテストを作成し、それらを実行してレポートを生成します。
前提条件
- TestSprite MCP がIDEにインストールされ、設定済みであること
- アプリケーションがローカルで動作可能(フロントエンドのdevサーバーまたはバックエンドAPI)であること
- 認証が必要な場合は基本的なテスト認証情報を用意すること
クイックスタート(オールインワン)
あなたのIDEアシスタントに次のように聞いてください:
TestSpriteでこのプロジェクトをテストするのを手伝って。
アシスタントが全体の流れを自動的にセットアップします。
完全なテスティングのワークフロー
TestSpriteは、コードを徹底的にテスト済みのソフトウェアに変えるために、8つの体系的なステップのプロセスに従います:
Bootstrap 環境 → PRDを読み込む(利用者) → コードを解析
→ PRD TestSprite を生成 → テスト計画を作成
→ テストコードを生成 → テストを実行 → 結果&分析 → AIが問題を修正
ステップ 1: テスト環境をブートストラップ
AIは testsprite_bootstrap_tests を呼び出してテスト環境を初期化します。
プロセス:
-
プロジェクトの検出: プロジェクトの種類を特定する(
frontendまたはbackend) - ポートの発見: 実行中のアプリとそのポートを見つける
- 設定ポータル: TestSpriteの設定インターフェースを開く
-
スコープの定義: テスト範囲を決める(全プロジェクトの場合は
codebase)
testsprite_bootstrap_tests({
localPort: 5173, // またはあなたのポート
type: "frontend", // または "backend"
projectPath: "/absolute/path/to/your/project",
testScope: "codebase" // プロジェクト全体をテスト
})
{
"projectType": "frontend",
"localPort": 5173,
"testScope": "codebase",
"needLogin": true,
"credentials": {
"username": "test@example.com",
"password": "testpassword123"
}
}
6. TestSpriteにおける重要な用語
Generate & Regenerate
これらの操作は、TestSpriteがあなたのテストスイートをどのように作成し、更新するかを制御します。
Generate(生成)
初めて、PRDとあなたのプロジェクトに基づいてテストを作成します。
プロンプト例:
Help me test this project with TestSprite.
使用するタイミング: テストを初めて作る必要があるときは Generate を使います:
- 新しいプロジェクトを開始する
- 既存のプロジェクトに、テストがまだない状態からテストを追加する
- 最初のテスト範囲を作る
起きること:
- あなたのコードを分析する
- テスト計画を作成する
- テストファイルを生成する
- テストを実行する
Regenerate(再生成)
PRDと更新されたコードに基づいて、最初からテストを作り直す。
プロンプト例:
Regenerate tests for the updated checkout flow.
使用するタイミング: 最初からテストを作り直す必要があるときは Regenerate を使います:
- アプリが大きく変わった(新機能、リファクタしたフローなど)
- 新しい要件に合わせてテスト計画を更新する必要がある
- 現在の状態を反映した新しいテスト範囲が欲しい
Run & Rerun
この操作は、TestSpriteがあなたのテストをどのように実行するかを制御します。
Run(実行)
新しく生成されたテストを初めて実行します。
使用するタイミング: テストを初めて実行するときは Run を使います:
- テストを生成した後
- あなたのアプリの初期妥当性確認
- テストの初回実行
Rerun(再実行)
以前に生成されたテストを、変更せずにもう一度実行します。
プロンプト例:
Rerun the login and checkout tests with TestSprite.
使用するタイミング: 既存のテストをもう一度実行するときは Rerun を使います:
- 新しく適用した修正を検証する
- アプリを再起動した後にテストが通ることを確認する
- 既存テストによる素早いスモークチェック
Healing(ヒーリング/修復)
機能しない変更によって失敗する脆いテストに対する自動または半自動の修正(本当の不具合ではない)を行い、実際のプロダクトの問題を隠さずにテストを強くします。
よくあるヒーリングのシナリオ:
-
UIセレクタ: 要素のID/クラスが変わったときに更新する(例:
#login-btn→[data-testid="login"]) - 時間の問題: 読み込みが遅いコンポーネントやアニメーションに合わせて待機時間を調整する
- テストデータ: データスキーマが変わったときにフィクスチャを更新する
- 環境: ポートの不一致、欠落したクレデンシャル、または設定の問題を修正する
- API契約: 実際のAPIレスポンスに合わせてスキーマの主張を引き締める
仕組み:
- Detect: TestSpriteがテストの脆さを識別する(プロダクトのバグではない)
- Classify: セレクタのドリフト、時間の不一致、環境の問題、または契約違反のどれかを判断する
- Propose Fix: 安全な修正案を生成する
- Apply: リスクが低い場合は自動適用し、それ以外は大きな変更について承認を求める
- Verify: 修正が成功したことを検証するためにテストを再実行する
Healingではないもの vs. Healingであるもの:
| Healingではないもの | Healingであるもの |
|---|---|
| 本当のプロダクトのバグを隠す | 機能しないコード変更に対してテストを耐性化する |
| 本来失敗すべきテストを通す | テストの保守作業を減らす |
Test Scope(テスト範囲)
返却形式: {"translated": "翻訳されたHTML"}TestSpriteで分析・テストされるコードベース内のどの部分かを定義します。
| 機能 | コードベース | コード差分 |
|---|---|---|
| テスト対象 | プロジェクト全体をテスト | 変更されたファイル/機能だけをテスト(git diffに基づく) |
| ユースケース | 新規プロジェクト、大規模リリース、包括的な監査 | 機能ブランチ、段階的な開発、迅速な検証 |
| 速度 | より時間がかかる | 素早いフィードバック |
| カバレッジ | フルカバレッジ | 最新の変更のみ |
PRD & Normalized PRD
TestSpriteは、プロジェクトを理解し、それに合ったテストを生成するためにプロダクト要件ドキュメント(PRD)を使用します。
PRD(プロダクト要件ドキュメント)
元のドキュメントで、プロダクトに何を実装する必要があるかを説明します。
次のいずれでも構いません:
- インフォーマルなメモやREADME
- 正式な仕様書ドキュメント
- Jiraのチケットまたはユーザーストーリー
- デザインドキュメントまたはウィキ
Normalized PRD(正規化PRD)
TestSpriteの標準プロダクト要件ドキュメント形式。元のPRDのスタイルに関わらず、テスト作成を一貫してスムーズに行えるようにします。
含まれるもの:
- プロダクトの概要と目的
- 受け入れ基準付きの主要機能
- ユーザーフローと検証ルール
- コード分析の技術的な文脈
注:TestSpriteは、さまざまな種類のプロジェクトにおいてテスト作成を予測可能にするために、この形式を作成します。
テストプラン(Test Plan)
TestSpriteが、normalized PRDとコード分析に基づいて生成するテストケースの体系的な一覧です。
例:
{
"id": "TC001",
"title": "Login with valid credentials",
"category": "functional",
"priority": "High",
"steps": [...]
}
通常、次が含まれます:
- テストケースID(TC001、TC002など)
- 説明および手順
- カテゴリ(機能、セキュリティ、UIなど)
- 優先度(高・中・低)
- 期待される結果
プランは
frontend_test_plan.jsonまたはbackend_test_plan.jsonとして保存されます。
追加リソース
- 完全なドキュメント(英語): https://docs.testsprite.com
- TestSprite公式サイト: https://www.testsprite.com
- Discordコミュニティ: https://discord.gg/QQB9tJ973e
- GitHub: https://github.com/wangy44624/docs
この翻訳ドキュメントは、日本の開発者がTestSpriteを日本語で理解し、利用できるよう支援するために作成されました。すべての変数名、コードのコマンド、コードブロックは、国際的なプログラミングの標準に従い英語のままにしています。
翻訳総語数:2,000語以上
