はじめに

Human Testerは、AIエージェントから直接テストを依頼できる完全従量課金型のユーザーテストサービスです。 MCP（Model Context Protocol）またはREST APIで操作します。月額固定費ゼロ。

1

アカウントを作成する

Developerアカウントを作成します。メールアドレスとパスワードを登録するだけで始められます。

手順:

  1. 会員登録ページにアクセス
  2. 氏名、メールアドレス、パスワードを入力
  3. 「登録する」をクリック
  4. ダッシュボードにリダイレクトされたら完了
2

APIキーを取得する

ダッシュボードの設定画面からAPIキーを生成します。このキーをMCP設定やAPIリクエストのヘッダーに使用します。

# APIキーの形式
ht_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# APIリクエストの認証ヘッダー
Authorization: Bearer ht_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

セキュリティ: APIキーはSHA-256でハッシュ化して保存。 ゼロコンテキスト設計のため、万が一漏洩しても個人情報の流出にはつながりません。

3

接続方法を選ぶ

方法A: MCP（AIエージェント経由）

Claude Code、Cursor、WindsurfなどのAIエージェントに設定するだけ。自然言語で依頼できます。

// .claude/mcp.json（Claude Codeの場合）
{
  "mcpServers": {
    "human-tester": {
      "command": "npx",
      "args": ["-y", "@human-tester/mcp-server"],
      "env": {
        "HT_API_KEY": "ht_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

詳しくは MCP セットアップガイドを参照

方法B: REST API（直接呼び出し）

cURL、fetch、任意のHTTPクライアントから呼び出せます。CI/CDパイプラインへの統合にも最適。

curl -X POST https://human-tester.jp/api/tests \
  -H "Authorization: Bearer ht_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "新しいLPのUX評価",
    "description": "LPの第一印象と使いやすさをテスト",
    "category": "ux_test",
    "target_url": "https://example.com",
    "target_testers": 5,
    "test_scenario": {
      "tasks": [{
        "instruction": "トップページの第一印象を教えてください",
        "evaluation_items": [
          { "label": "見やすさ", "type": "rating_5" },
          { "label": "改善点", "type": "free_text" }
        ]
      }]
    }
  }'
4

テストを作成する

テスト種別、対象URL、テスター属性、テストシナリオを指定してテストを作成します。

POST /api/tests
Content-Type: application/json
Authorization: Bearer ht_live_your_api_key

{
  "title": "新LP UXテスト",
  "description": "新しいLPの第一印象と使いやすさを評価してほしい",
  "category": "ux_test",
  "target_url": "https://example.com/lp-new",
  "target_testers": 5,
  "target_attributes": {
    "age_groups": ["twenties", "thirties"],
    "it_proficiency": ["general", "intermediate"]
  },
  "test_scenario": {
    "tasks": [
      {
        "instruction": "トップページを見て第一印象を教えてください",
        "evaluation_items": [
          { "label": "見やすさ", "type": "rating_5" },
          { "label": "わかりやすさ", "type": "rating_5" },
          { "label": "改善点", "type": "free_text" }
        ]
      }
    ]
  }
}

レスポンス: 201

{
  "test": {
    "id": "...",
    "title": "新LP UXテスト",
    "status": "recruiting",
    "estimatedCost": 2500,
    "targetTesters": 5,
    "category": "ux_test"
  }
}
5

結果を取得する

テスターがテストを完了すると、AI集計付きの結果が取得できます。

GET /api/tests/{testId}/results
Authorization: Bearer ht_live_your_api_key

レスポンス例:

{
  "testId": "...",
  "status": "completed",
  "summary": {
    "overall_score": 72,
    "key_findings": [
      "CTAボタンの視認性が低い（5人中4人が指摘）",
      "ファーストビューのコピーは好評"
    ],
    "recommendations": [
      "CTAボタンの色をコントラストの高い色に変更",
      "モバイル向けフォントサイズを16px以上に"
    ],
    "sentiment": "neutral"
  },
  "actualCost": 2500
}

料金一覧

テスト種別category料金/人目安時間
UXテストux_test¥50010分
ユーザビリティテストusability_test¥70010分
アンケート調査survey¥3005分
A/Bテストab_test¥60010分
バグハントbug_hunt¥70010分

オプション: スクリーン録画 +¥200/人、属性3つ以上指定 +¥100/人。 10人以上 15%OFF、20人以上 20%OFF。

次のステップ