Qmesh Mcp

QMesh MCP サーバー

Claude Code、Cursor、Claude Desktop、Codex、その他あらゆるModel Context ProtocolクライアントからQMeshクラウドテストプラットフォームにクエリを実行できます。

QMeshは、AIが検出したシグナルと人間によるQA判断を組み合わせ、リリースの信頼性を判断します。このMCPサーバーを使うと、AI アシスタントが必要に応じてQMeshのデータを取得できます。また、認証を設定すれば、AIが検出した品質上の問題をQMeshのSignal Engineに送信し、人間による検証につなげられます。

---

デモ

Claude Desktopでsearch_bug_patternsを使い、QMeshの実際の匿名化パターンをもとにQAの質問に回答しています。

---

ツール

読み取り専用（認証不要）

ツール	説明
verify_install 🆕	MCPが接続されているかを確認するスモークテストです。インストール後、正常に動作することを確認するために最初に呼び出してください。ステータス、ツール数、次に試すプロンプトの候補を返します
get_platform_stats	プラットフォーム全体の指標 — テスター、QA認定テスター、企業、バグ、タスク
get_leaderboard	QIS、重大／高重要度のバグ件数、有効率を含む、日／週／月／年ごとのテスターランキング
list_pricing_plans	予算、機能、返金ポリシーを含む公開テストプラン
search_bug_patterns	匿名化されたバグパターンのナレッジベース — シナリオテンプレート、検出手法、チェックリスト。カテゴリ、重大度、ドメイン、またはフリーテキストで絞り込み可能

アクションツール（API Keyが必要）

ツール	説明
submit_ai_signal	自分が所有するタスクについて、AIが検出した品質シグナルを送信します。QMeshは重複を排除してスコアを付け（信頼度 × 重大度 × パターン一致度）、価値の高いシグナルを人間のQA担当者に振り分けます
create_test_task 🆕	QMeshで新しいクラウドテストタスクを開始します。現在、支払いは不要です（budget=0で、他の無料QMeshタスクと同様に動作します）。実際のテスターがタスクに取り組み、バグを報告する場合があります。APIキーあたり24時間で5タスクまでに制限されています
get_task_status 🆕	タスクの進行状況を追跡します。状態と、重大度およびステータス別のバグ件数を確認できます
list_bugs 🆕	タスクで報告されたバグを取得します。重大度／ステータスで絞り込めます。1回の呼び出しにつき最大100件です
export_report 🆕	リリース準備状況レポートをMarkdown形式で生成します（重大度／ステータスの表、上位10件のバグ）。AIによるデプロイ判断、Slack／Notionへの投稿、PRコメントに便利です

🆕 = v0.5.0で追加。4つのアクションツールにより、AI エージェントは人の介入なしにクラウドテストを自律的に開始・追跡できます。これにより、IDEを離れることなく「AIがバグを発見」してから「人間が検証」するまでの一連の流れが完結します。

---

インストール

npx -y @q-mesh/mcp

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

npm install -g @q-mesh/mcp

Claude Desktop

Claude Desktopの設定に追加します。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %AppData%\Claude\claude_desktop_config.json

最小構成（読み取り専用ツール）：

{
  "mcpServers": {
    "qmesh": {
      "command": "npx",
      "args": ["-y", "@q-mesh/mcp"]
    }
  }
}

submit_ai_signalを有効にする場合：

{
  "mcpServers": {
    "qmesh": {
      "command": "npx",
      "args": ["-y", "@q-mesh/mcp"],
      "env": {
        "QMESH_API_KEY": "qk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Windowsでは、npxをcmd /cでラップしてください。

{
  "mcpServers": {
    "qmesh": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@q-mesh/mcp"]
    }
  }
}

Claude Desktopを再起動します。ハンマーアイコンにQMeshツールが10個（読み取り専用が5個、アクションツールが5個。後者にはQMESH_API_KEYが必要です）と表示されるはずです。

**ヒント：**まずClaudeに"use qmesh verify_install"と尋ねてください。認証不要のスモークテストをすぐに実行できます。

QMESH_API_KEY の取得

5 つのアクションツール（submit_ai_signal、create_test_task、get_task_status、list_bugs、export_report）で必要です。4 つの読み取り専用ツールは、キーがなくても使用できます。

1. q-mesh.com にログインします（対象タスクの所有者、または管理者である必要があります）。
2. 設定 → API Keys に移動し、Create API Key をクリックします。
3. 名前（例：「Claude Desktop」）を付け、qk_ で始まる生成済みキーをコピーします。

   ⚠️ キー全体が表示されるのは一度だけです。ダイアログを閉じる前に保存してください。

4. 設定の env.QMESH_API_KEY に貼り付けます。

API キーの有効期間は長く（デフォルトで 90 日間）、同じページからいつでも失効させることができます。

レガシー：QMESH_USER_TOKEN（非推奨）

まだ API Key を作成できない場合は、代替手段として Supabase JWT も使用できます。DevTools → Local Storage → sb-cvizjnidcgonqsrwxubz-auth-token から access_token を取得してください。注：JWT の有効期限は約 1 時間のため、継続的な使用にはおすすめしません。

---

Claude Code / Cursor / Codex / その他の MCP クライアント

同じ stdio トランスポート設定を使用します。お使いのクライアントの MCP セットアップドキュメントを参照してください。

---

プロンプトの例

インストール後、Claude で次のプロンプトを試してみてください。

読み取り専用（認証不要）：

• 「今週の QMesh リーダーボードを見せて」
• 「QMesh が提供するテストプランと、その内容を教えて」
• 「現在、QMesh にはテスターが何人いますか？」
• 「XSS に関する QMesh のバグパターンを検索して」
• 「QMesh には、フォーム UX に関するどのような一般的なバグが記録されていますか？」
• 「QMesh の重大なセキュリティバグパターンをすべて一覧表示して」

認証あり（タスク所有者向け）：

• 「自分の QMesh タスク <task-id> をテスト中です。ログインページで存在しないアカウントが受け入れられます。重要度 high の AI シグナルとして送信してください。」
• 「自分の製品でアクセシビリティチェックを実行し、見つかった WCAG 違反をタスク <task-id> にシグナルとして送信してください。」

アクションツール（v0.5 以降）：

• 「自分の EC サイトのチェックアウトフローで QMesh テストを開始してください。タイトルは 'Cart 結帳流程驗收'、説明は 'Verify the full cart-to-payment flow works on mobile Safari and Chrome'、優先度は high、期間は最大 7 日です。」
• 「QMesh タスク <task-id> のステータスを教えてください。見つかったバグの数と重要度は？」
• 「タスク <task-id> で、未対応の重大または高重要度のバグをすべて一覧表示して」
• 「タスク <task-id> のリリース準備状況を確認できる Markdown レポートを生成して。デプロイするか判断したいです。」

---

Signal Engine の仕組み

  Your AI agent              QMesh                    Human QA
 (Claude / Cursor)       Signal Engine                on QMesh
     │                      │                           │
     │──submit_ai_signal──▶ │                           │
     │                      │─ dedupe ────────────▶     │
     │                      │  (same title + task?)     │
     │                      │                           │
     │                      │─ score ─────────────▶     │
     │                      │  (conf × severity ×       │
     │                      │   pattern bonus)          │
     │                      │                           │
     │                      │─ route ──────────────────▶│
     │                      │  (score ≥ 0.5)            │
     │                      │                           │ ← promotes valid
     │                      │                           │   or dismisses
     │                      │                           │
     │                      │◀─ visible to task owner ──│

AI は幅広く対応し、人的 QA は判断を担います。QMesh はその両方を統合し、リリースへの確信度を判断します。

---

開発

git clone https://github.com/onedaysoftware-support/qmesh-mcp
cd qmesh-mcp
npm install
npm run build
node dist/index.js       # stdio — connects to any MCP client

スモークテスト

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"0.0.1"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | node dist/index.js

10 個のツールすべてが一覧表示されるはずです。

---

ロードマップ

現在のリリース（0.5.x）：10 個のツール — 読み取り専用 5 個 + アクションツール 5 個（API Key による制限あり）。

0.3 以降に完了：

• ✅ API Key の仕組み（有効期間が長く、失効可能で、JWT を置き換えます）
• ✅ create_test_task（現時点では支払い不要）
• ✅ get_task_status / list_bugs / export_report

予定：

• get_release_readiness — シグナル、バグ、カバレッジから QCI スコアを算出します（今後の目玉ツール）
• subscribe_to_task — 新しいバグが届いた際の Server-Sent Events / webhook
• Custom Pattern Library — 組織ごとのパターン注入（独自のスタイル、誤検出リスト）

最新情報は github.com/onedaysoftware-support/qmesh-mcp をフォローしてください。

トラブルシューティング

「プロセスの起動に失敗しました：そのようなファイルやディレクトリはありません」 — MCP クライアントが PATH 内で npx を見つけられません。絶対パスを試してください：/opt/homebrew/bin/npx（Homebrew を使用している macOS の場合）、または /Users/you/.nvm/versions/node/vXX.X.X/bin/npx（nvm の場合）。

submit_ai_signal で「アクセスが拒否されました」 — JWT の有効期限が切れているか、タスクの所有者ではありません（送信には tasks.business_id = auth.uid() または管理者ロールが必要です）。

submit_ai_signal が「無効または期限切れの API キー」を返す — QMESH_API_KEY の入力が間違っているか、無効化されているか、90 日の有効期限を過ぎています。q-mesh.com の Settings → API Keys で新しいキーを作成してください。

submit_ai_signal が「アクセスが拒否されました」を返す — 対象のタスクは API キーの所有者のものではありません（または所有者が管理者ではありません）。

create_test_task が「レート制限を超えました」を返す — 1 つの API キーで過去 24 時間以内に 5 件のタスクを作成しています。待つか、別の API キーを使用してください。

create_test_task が「タイトルは 5 文字以上である必要があります」／「説明は 20 文字以上である必要があります」と表示する — 実際に何をテストすべきかテスターが把握できるよう、最低文字数が設定されています。具体的なタイトルと、実行可能な説明を記入してください。

get_task_status／list_bugs／export_report が「タスクは API キーの所有者のものではありません」を返す — API キーの所有者はタスクの business_id ではありません（また、管理者でもありません）。タスクの作成者が所有するキーを使用してください。

---

変更履歴

0.5.1 (2026-05-10)

• ✨ verify_install を追加 — 初回インストール時の即時スモークテスト（認証不要）
• 🩹 インストールから初回成功までにかかる時間を数分から数秒に短縮

0.5.0 (2026-05-10)

• ✨ B サイドのアクションツールを 4 つ追加：create_test_task、get_task_status、list_bugs、export_report
• ✨ AI エージェントが Claude Code／Cursor／Codex 内からクラウドテストのタスクを自律的に開始・追跡できるようになりました
• 🆓 現時点では create_test_task に支払いは不要です（budget=0）
• 🛡️ 1 つの API キーにつき 24 時間あたり 5 件にレート制限

0.4.0

• ✨ API キー認証方式（長期間有効、取り消し可能）を導入し、書き込みツールの 1 時間有効な JWT に置き換え

0.3.x

• 5 つのツール：読み取り専用ツール 4 つ + submit_ai_signal

---

ライセンス

MIT © Oneday Software