AI テストエージェントを Cursor または Claude Code に接続するには?

Zheshi Du
AI テストエージェントを Cursor または Claude Code に接続するには? カバー

その方法は Model Context Protocol を使うことで、セットアップは約 2 分で完了します。

Cursor と Claude Code はどちらも MCP をネイティブにサポートしています。AI テストエージェントが MCP サーバーを提供すると、IDE のチャットインターフェース内でネイティブツールとして利用可能になります。開発者がインストラクションを入力すると、エージェントがテストパイプラインを実行し、結果が同じウィンドウに返されます。コンテキストの切り替えも、別のダッシュボードも、別のターミナルも不要です。

TestSprite の自律型 AI テストエージェントを各ツールに接続する方法と、その接続が単なる利便性以上の価値をもたらす理由をご説明します。

テストワークフローにおける MCP の意味

MCP(Model Context Protocol)は、AI IDE が外部ツールとネイティブに通信するために使用するオープンスタンダードです。Cursor と Claude Code が自身のツールインテグレーションに使用しているのと同じレイヤーです。

テストツールが MCP 経由で接続すると、外部に置かれるのではなく、コーディングセッションに参加します。コードを書いたコーディングエージェントと、それを検証するテストエージェントが同じインターフェースを共有します。テストエージェントからの失敗情報はコーディングエージェントに直接届き、同じセッション内で修正を提案できます。

それが重要なクローズドループです。AI がコードを書く。AI がテストする。AI が修正する。すべて IDE の中で完結します。

TestSprite を Cursor に接続する

Cursor の MCP 設定は、グローバルインストールの場合は ~/.cursor/mcp.json に、プロジェクトスコープの場合はプロジェクトディレクトリ内の .cursor/mcp.json に保存されます。

mcpServers セクションに以下を追加してください:

your-testsprite-api-key を TestSprite アカウントの API キーに置き換えてください。ファイルを保存し、Cursor が起動中であれば再起動します。Cursor の設定で TestSprite MCP エントリにグリーンドットが表示されていることを確認してください。

Cursor 固有の設定変更として、Settings → Chat → Auto-Run → Auto-Run Mode に移動し、「Ask Every Time」または「Run Everything」に設定してください。デフォルトの Sandbox Mode は MCP ツールの機能を制限し、TestSprite が正しく動作できなくなります。

TestSprite を Claude Code に接続する

Claude Code の MCP 設定は mcp_config.json に保存されており、Claude Code のドロップダウンメニューから Manage MCP Servers → View raw config でアクセスできます。

以下を追加してください:

保存し、MCP 設定ビューからサーバーを起動してください。Claude Code はデフォルトで MCP インストールを現在のプロジェクトディレクトリにスコープします。TestSprite を複数のプロジェクトで利用したい場合は、プロジェクトごとに追加するか、ユーザースコープで設定する必要があります。

両方のインストールに Node.js が必要です。node --version で確認してください。インストールされていない場合は nodejs.org からインストールしてください。

接続後に起こること

MCP サーバーの設定と動作確認が完了したら、IDE 内からひとつのインストラクションでテストパイプラインを実行できます:

"Help me test this project with TestSprite."

他の検証ツールはコードを読んで推測します。TestSpriteはアプリを開いて実際に使用します。

並列探索エージェントの集団が起動中のアプリケーションにアクセスし、実際のユーザーが行うようにナビゲートします。Cursor や Claude Code で変更したファイルを読み込むのではなく、ライブプロダクトを訪問し、インタラクティブなサーフェスを探索し、フローを通じて操作します。

ボタンをクリックし、実際の入力値でフォームを入力し、エントリーから完了まで複数ステップのジャーニーをたどります。実際のブラウザセッションと同様にセッション状態を引き継ぎます。失敗を検出すると、何が起きたかの構造化された説明が IDE のチャットウィンドウに届き、コーディングエージェントが直接対応できます。

エージェントは直近のコーディングセッションで触れた箇所だけでなく、製品全体のサーフェスをカバーします。それが、最近の diff とは無関係な 3 つ先のフローのリグレッションを検出できる理由です。

TestSpriteがプロジェクトに必要とするもの

最初のセッションを実行する前に、TestSpriteにライブ環境を指定してください。ステージング、プレビュー、またはローカル開発サーバーのいずれでも使用できます。エージェントはナビゲートするための起動済みURLを必要とします。

アプリケーションに認証が必要な場合は、TestSprite Webポータルで認証情報を設定してください。パスワードエンドポイント、OAuthリフレッシュトークン、およびAWS Cognitoフローに対応しています。Auto-Authは、テスト実行のたびに認証を自動的に処理するため、エージェントは実際のログインフローを通じて認証済み状態で開始します。

PRDや仕様書が存在する場合、TestSpriteはそれを解析し、テストの目標を記載されたプロダクトの意図に紐付けます。存在しない場合、MCPサーバーはコードベースから意図を推測します。ルート定義、APIコントラクト、およびコンポーネント構造が、プロダクトの設計意図を示すエビデンスとして使用されます。

シナリオ:両方のツールで変更が生じたインテグレーション

あるデベロッパーが、フロントエンド作業にはCursor、バックエンド作業にはClaude Codeを使い分けています。どちらのツールもTestSprite MCPサーバーに接続されています。

Claude CodeセッションでプロジェクトのAPIレスポンス構造を更新し、CursorセッションでそのAPIを利用するフロントエンドコンポーネントを更新した後、デベロッパーはCursor内からTestSpriteを起動します。

探索エージェントがプロダクトをナビゲートします。ダッシュボードのメインデータテーブルが正常に読み込まれることを確認します。しかし、テーブルにソートを適用してページをリロードすると、ソートの設定が保持されません。Cursorセッションではコンポーネントの状態管理が更新され、Claude CodeセッションではAPIレスポンスのフォーマットが更新されていました。この組み合わせにより不整合が発生しました。ソートの状態は正しく保存されているものの、APIの新しいレスポンスフォーマットには、ページ読み込み時にコンポーネントがソートを復元するために使用するフィールドが含まれていません。

どちらのセッションのdiffにもこの問題は現れません。APIの変更は正しく見えます。コンポーネントの変更も正しく見えます。ソートを適用してからリロードするという実際のユーザー操作のコンテキストにおいて、両者のインテグレーションが壊れていたのです。

失敗の詳細がCursorのチャットに返されます。どのテーブルがナビゲートされたか、どのソートが適用されたか、リロード後にページに何が表示されたか。コーディングエージェントは、コンポーネントが期待するAPIレスポンス内の欠落フィールドを特定します。同じCursorセッション内で修正が適用されます。

CIへのカバレッジの拡張

IDE内のループは、各コーディングセッション後の検証を担います。GitHub Actionsインテグレーションにより、同じカバレッジをCIにまで拡張します。

CursorまたはClaude Codeからのすべてのプルリクエストが、自動テスト実行をトリガーします。結果はレビュー前にPRコメントとして投稿されます。レビュアーはdiffと並んでプロダクトレイヤーの検証結果を確認できます。

MCPサーバーの設定に関する完全なドキュメントはdocs.testsprite.comにあります。

まとめ

AIテストエージェントをCursorまたはClaude Codeに接続するには、Model Context Protocolを使用します。TestSpriteのMCPサーバーはJSON設定エントリを2つ追加するだけで(IDE各1つ)、1つの指示によりチャットインターフェイス内からテストパイプラインが利用可能になります。

この価値は、エディタ内に留まれるという利便性にとどまりません。テストエージェントがコーディングセッション内に存在することで、失敗の情報が、その失敗を生み出したコーディングエージェントに直接フィードバックされます。コード変更からテスト失敗、修正の適用までのループが、翻訳や、コンテキストの切り替え、手動調査なしにIDE内で完結します。

Cursorとclaude Codeを使って素早くリリースするデベロッパーにとって、この閉じたループこそが、検証を本番環境のペースに追随させるものです。

今すぐCursorまたはClaude CodeにTestSprite MCPサーバーをインストールしましょう。