CursorにTestSprite MCPサーバーをインストールするには？
Zheshi Du
CursorへのTestSprite MCPサーバーのインストールは約2分で完了します。方法は2つあります。ドキュメントページからワンクリックでインストールする方法と、セットアップを細かく制御できる手動設定の方法です。どちらも最終的に同じ状態になります。
どちらの方法を選ぶ場合も、事前に2つの準備が必要です。TestSpriteアカウントと、マシンへのNode.jsのインストールです。
始める前に：必要なもの
TestSpriteアカウント。testsprite.comでサインアップしてください。無料プランはクレジットカード不要で、毎月150クレジットから始められます。
APIキー。サインイン後、アカウント設定に移動してAPIキーを生成してください。MCPサーバーはこのキーを使ってTestSpriteのバックエンドに認証します。
Node.js。ターミナルで node --version を実行してインストール済みか確認してください。バージョン番号が返ってくれば問題ありません。返ってこない場合は、続行する前にnodejs.orgからNode.jsをインストールしてください。TestSprite MCPサーバーの実行にはNode.jsが必要です。
これらが揃えば、インストール自体は簡単です。
方法1：ワンクリックインストール
最も手軽な方法は、TestSpriteドキュメントからワンクリックでインストールする方法です。インストールページの「Add to Cursor」ボタンをクリックすると、Cursorがサーバー設定が事前に入力されたダイアログを開きます。
プロンプトが表示されたらAPIキーを入力してください。CursorがTestSprite MCPサーバーを自動的に設定に追加します。
CursorのMCP設定パネルでTestSprite MCPサーバーのアイコンに緑のドットが表示され、ツールが読み込まれていることを確認してください。それらが表示されれば、インストールは完了です。
方法2：手動設定
手動で設定したい場合や、ご利用のCursorのバージョンでワンクリック方式が使えない場合は、MCPサーバーを手動で追加できます。
CursorのMCP設定ファイルを開くか新規作成してください。すべてのプロジェクトで有効なグローバルインストールの場合は ~/.cursor/mcp.json です。プロジェクト固有のインストールの場合は、プロジェクトディレクトリ内の .cursor/mcp.json です。
mcpServers セクションに以下を追加してください：
{
"mcpServers": {
"TestSprite": {
"command": "npx",
"args": ["@testsprite/testsprite-mcp@latest"],
"env": {
"API_KEY": "your-api-key"
}
}
}
}
your-api-key をTestSpriteアカウントのAPIキーに置き換えてください。ファイルを保存し、Cursorがすでに起動していた場合は再起動して、TestSprite MCPエントリに緑のドットが表示され、ツールが読み込まれていることを確認してください。
Cursorで変更が必要な重要な設定
CursorはMCPツール向けにサンドボックスモードを導入しており、ツールの動作を制限します。デフォルト設定では、TestSpriteの機能が制限され、テストパイプラインが正常に実行できなくなります。
これを修正するには、Cursor設定 → Chat → Auto-Run → Auto-Run Mode に移動し、設定を「Ask Every Time」または「Run Everything」に変更してください。どちらのオプションでも、TestSpriteに必要なすべての機能が復元されます。
この設定変更は一度だけ行えば済みます。設定後は、Cursorでのすべての将来のTestSpriteセッションに適用されます。
最初のテストを実行する
MCPサーバーのインストールとサンドボックスモードの設定が完了したら、Cursorのチャットを開いて次のように入力してください：
"Help me test this project with TestSprite."
この指示により、追加の設定なしで自律的なパイプライン全体がトリガーされます。
他の検証ツールはコードを読んで推測します。TestSpriteはアプリを開いて実際に使用します。
並列探索エージェントの集団が実行中のアプリケーションにアクセスし、実際のユーザーと同じようにナビゲートします。UIフローをクリックし、実際の入力でフォームに記入し、入口から完了まで複数ステップのジャーニーをたどり、各ステップで何が起こるかを観察します。エージェントはソースファイルを読み込むのではなく、ライブアプリケーションとの直接的なインタラクションを通じて、製品のユーザージャーニーの構造的なマップを構築します。
結果はCursorのチャットウィンドウに返されます。テストが失敗した場合、失敗の説明はCursorのコーディングエージェントが直接対応できる形式で届きます。コードの変更から動作の検証、修正の適用までのループが同一セッション内で完結します。
シナリオ：セットアップから最初の発見まで20分
CursorでB2B SaaS製品を開発しているある開発者が、上記の手順に従ってTestSprite MCPサーバーをインストールしました。アカウントの作成とAPIキーの取得を含め、セットアップ全体に約10分かかりました。
開発者はTestSpriteをステージング環境に向けて、最初のセッションをトリガーしました。
探索エージェントが製品をナビゲートします。サインインフロー、メインダッシュボード、プロジェクト作成、チーム招待、そして請求セクションです。開発者は3カラムのインターフェースを見守ります。左にはライブアプリケーションのプレビュー、中央にはユースケースフローグラフ、右にはエージェントごとのインタラクション詳細が表示されています。
最初のセッションで、エージェントはチーム招待フローが招待を正しく作成してメール通知を送信しているにもかかわらず、招待されたユーザーの承認フローが正しいロールを付与していないことを発見しました。承認ハンドラーは招待レコードからロールを読み取りますが、直近のCursorセッションで招待レコードの構造が変更された際に承認ハンドラーが更新されていませんでした。新しいユーザーは、招待で指定されたMemberロールではなく、Viewerロールでワークスペースに参加してしまいます。
ユニットテストではこれを検出できません。コードレビューでも表面化しません。エージェントは、ワークスペースに招待される実際のユーザーが実行するように、招待から承認、自分のワークスペースロールの確認まで、招待フローをナビゲートすることでこれを発見しました。
失敗の説明がCursorのチャットに届きます。コーディングエージェントは承認ハンドラーの古いロールルックアップを特定し、同じセッション内で修正を適用します。開発者はTestSpriteを再実行して確認します。セットアップ開始から修正済みのリグレッションを得るまで20分。
まとめ
CursorへのTestSprite MCPサーバーのインストールは2分で完了します。TestSpriteアカウント、APIキー、そしてNode.jsが必要です。ドキュメントからワンクリックインストールを選ぶか、MCP JSONファイルに手動で設定を追加してください。CursorのAuto-Run Mode設定を変更して、MCPの全機能を復元してください。
その後、1つの指示でテストパイプライン全体が起動します。探索エージェントが実際のユーザーのようにライブアプリケーションをナビゲートし、1回のセッションでフロントエンドとバックエンドの両方をカバーし、構造化された失敗情報がCursorのチャットに返され、コーディングエージェントが直接対応できます。
TestSprite MCPサーバーをインストールして、今日Cursorで最初のテストセッションを実行しましょう。