TesterArmy

クイックスタート | ドキュメント | プラットフォーム | API キー | スキル | MCP | 使用例

実際のユーザーのようにアプリをテストするエージェントです。

TesterArmy CLI（testerarmy / ta）は、TesterArmy ダッシュボードで QA カバレッジを管理し、TesterArmy クラウドで実行するテストをキューに登録します。

• 平易な言葉で手順を記述して、保存済みテストを作成・整理します。
• 保存済み環境に対して、ブラウザーとモバイルのチェックを実行します。
• 結果を待ち、JSON 出力で実行トランスクリプトを確認します。
• 具体的な検証結果をコーディングエージェントにフィードバックします。

こちらから始めてください。

• ドキュメント：tester.army/docs
• プラットフォーム：tester.army
• API キー： tester.army/dashboard/profile/api-keys

https://github.com/user-attachments/assets/f7524c3f-018e-46eb-9bae-cb69335fda64

クイックスタート

グローバルにインストールします。

npm install -g testerarmy

次に、API キーを作成します。

tester.army/dashboard/profile/api-keys

認証します（いずれかを選択してください）。

ta auth

または、インストールせずに実行します。

npx testerarmy --help

プロジェクトとその保存済みテストを見つけて、クラウドでの実行を待ちます。

ta projects list --json
ta tests list --project <projectId> --json
ta tests run <testId> --wait --json

一覧表示コマンドから返された ID を使用してください。--wait を指定しない場合、コマンドが成功しても実行がキューに登録されたことを確認するだけです。開発時の変更を検証するには、クラウドからアクセスできるプレビュー URL またはトンネル URL をプロジェクト環境として保存し、--env <nameOrSlug> で選択してください。

スキルのインストール

skills CLI を使ってインストールします。

npx skills add tester-army/cli

MCP サーバーとプラグイン

TesterArmy は、https://tester.army/mcp でホスト型 MCP サーバー（Streamable HTTP）としても動作します。OAuth を通じて TesterArmy アカウントでサインインするため、API キーを作成したり貼り付けたりする必要はありません。

Claude Code：

claude mcp add --transport http testerarmy https://tester.army/mcp

Codex：

codex mcp add testerarmy --url https://tester.army/mcp

または、~/.codex/config.toml に追加して、codex mcp login testerarmy を実行します。

[mcp_servers.testerarmy]
url = "https://tester.army/mcp"

Cursor：［Customize］を開いて testerarmy を検索するか、マーケットプレイスの掲載ページで［Add to Cursor］をクリックします。プラグインがまだ掲載されていない場合は、~/.cursor/mcp.json にサーバーを手動で追加します。

{
  "mcpServers": {
    "testerarmy": {
      "url": "https://tester.army/mcp"
    }
  }
}

このリポジトリは、MCP サーバーと testerarmy-cli スキルをまとめてインストールするプラグインでもあります。

Claude Code：/plugin marketplace add tester-army/cli を実行してから、/plugin install testerarmy@testerarmy-agent-skills を実行します。

Codex：このリポジトリはプラグインマーケットプレイスでもあります。TesterArmy が Plugins Directory に掲載されるまでは、こちらから追加できます。

codex plugin marketplace add tester-army/cli
codex plugin add testerarmy@testerarmy-agent-skills

このプラグインはホスト型サーバーを登録します。codex mcp login testerarmy で一度サインインするか、インストール時に ChatGPT アプリに表示されるサインインプロンプトを承認してください。ChatGPT デスクトップアプリで、このリポジトリを Codex で開くと、マーケットプレイスが［Plugins］タブのソースとして表示されます。

サーバーとそのツールの詳細なリファレンス：https://docs.tester.army/cli/mcp

例

ta tests create で保存済みダッシュボードテストを作成する際は、examples/ の Markdown シナリオを作成時の参考にしてください。

• examples/TESTER.md
• examples/tests/01-landing-page.md
• examples/tests/02-auth-smoke.md
• examples/tests/03-project-create.md
• examples/prompts/ad-hoc-regression.md

保存済みのスモークグループを実行します。

ta groups list --project <projectId> --json
ta tests run --group <groupId> --project <projectId> --wait --json

コントリビューション

PR を歓迎します。特に、以下の改善を歓迎します。

• スキルの品質と参考資料の改善
• イシューテンプレートとトリアージプロセスの改善
• 実際の利用に即したテスト例の改善

ライセンス

MIT