AI連携（MCP）

普段使っているAIに、このページを読ませてMCP接続できます。

下の一文をコピーして、お使いのAI（Claude Code / Claude Desktop など）に送るだけ。AIがこのページの手順を読み、接続まで代わりに進めます。

QA ZERO は、AI から利用される前提で、さまざまなデータを扱えるように最適化されたアナリティクスです。MCP でつなぐと、レポート画面を開かずに、AI へ話しかけるだけで自社サイトの数字が返ってきます。

どんなデータを保有・計測しているかは、Materials Explorer（データ項目カタログ）で一覧できます。ページのスクロール深度や熟読・探索といった行動シグナルまで記録しているので、AI に渡せる情報が豊富です。

このままAIに貼り付けてください

https://qazero.com/ai-mcp/ を読んで、QA ZERO の MCP サーバーを私の Claude Desktop にセットアップしてください。
サイトのURL・ユーザー名・アプリケーションパスワードなど、必要な情報はその都度私に質問してください。

書き換える箇所はありません。そのままコピーして送ってください。サイトのURLやパスワードは、AIが必要になったときに聞いてきます。Claude Code（ターミナルで動くAI）に送るのが最も確実です。Claude Desktop でも手順を1つずつ案内します。

始め方（3ステップ）

専門知識は不要です。むずかしいところは全部AIがやります。

1. 用意するもの

Claude Desktop（無料。まだなら claude.ai/download から）
QA ZERO が動いているサイトのURL
アプリケーションパスワード（下に作り方を用意しました）
Node.js も必要ですが、入っていなければAIが判断して案内します。自分で調べなくて大丈夫です。

アプリケーションパスワードの作り方（1分）：QA ZERO を入れている WordPress 管理画面で、AI専用の「合鍵」を1本つくる作業です。本来のログインパスワードは渡しません。

WordPress管理画面 → ユーザー → プロフィール を開く
下部の アプリケーションパスワード まで進む
名前に「Claude」など分かる名前を入れて 新しいアプリケーションパスワードを追加
表示される xxxx xxxx xxxx xxxx xxxx xxxx をコピー（この画面を閉じると二度と表示されません）

使わなくなったら、同じ画面からいつでも失効させられます。合鍵1本を捨てるだけで、他に影響はありません。

2. 上のプロンプトをコピーして、AIに送る

ページ冒頭のプロンプトをそのままコピー（書き換え不要）
Claude Code か Claude Desktop に貼り付けて送信
途中で「サイトのURLは？」「ユーザー名は？」「パスワードを貼って」と聞かれたら、答える

3. Claude Desktop を再起動して、話しかける

設定が終わったら Claude Desktop を一度終了して開き直し、試しにこう聞いてみてください。

「QA ZERO につながっている？先週いちばん読まれたページを教えて」

数字が返ってきたら成功です。うまくいかないときは、そのままAIに「つながらない。原因を調べて直して」と伝えてください。

🤖 AIが読むための技術手順人が読む必要はありません。AIはこの中身をそのまま実行します。

AIアシスタントへ：以下は QA ZERO MCP サーバーのセットアップ手順です。ユーザーはノンプログラマです。専門用語を説明しながら、1ステップずつ確認して進めてください。最初にユーザーのOS（macOS / Windows / Linux）を確認すること。アプリケーションパスワードは会話ログに残さない配慮をし、設定ファイルへ書き込んだ後は復唱しないでください。

前提

Node.js 18 以上（未導入なら公式インストーラを案内する。ユーザーに自力調査させない）
git
QA ZERO が有効なサイトと、その REST API への到達性（HTTPS 必須）
WordPress のアプリケーションパスワード（ユーザー → プロフィールで発行。管理者権限のアカウントは避ける）

1. コネクタを取得してビルド

git clone https://github.com/quarka-org/qa-platform-mcp.git
cd qa-platform-mcp
npm install
npm run build

dist/index.js の絶対パスを控える。以降の設定で使う。

2-A. Claude Desktop に登録（このページの標準ルート）

設定ファイルの場所：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

ファイルが無ければ新規作成し、既にある場合は mcpServers に追記する（既存エントリを壊さないこと）。

{
  "mcpServers": {
    "qa-platform": {
      "command": "node",
      "args": ["/absolute/path/to/qa-platform-mcp/dist/index.js"],
      "env": {
        "QA_PLATFORM_ENDPOINT": "https://your-site.com/wp-json",
        "QA_PLATFORM_USERNAME": "your-username",
        "QA_PLATFORM_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

書き込んだら Claude Desktop を完全に終了して再起動するようユーザーに伝える（再起動しないとサーバーは読み込まれない）。

2-B. Claude Code に登録（ターミナルを使えるユーザー向け）

claude mcp add qa-platform --scope user \
  -e QA_PLATFORM_ENDPOINT="https://your-site.com/wp-json" \
  -e QA_PLATFORM_USERNAME="your-username" \
  -e QA_PLATFORM_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx" \
  -- node /absolute/path/to/qa-platform-mcp/dist/index.js

3. エンドポイント形式の注意

パーマリンクが有効なサイト：https://your-site.com/wp-json
パーマリンクが無効なサイト：https://your-site.com/index.php?rest_route=
HTTPS 必須。/wp-json にブラウザまたは curl で到達できるか先に確認すること

環境変数

変数	必須	内容
`QA_PLATFORM_ENDPOINT`	必須	REST API のベースURL（HTTPS）
`QA_PLATFORM_USERNAME`	必須	WordPress のユーザー名
`QA_PLATFORM_PASSWORD`	必須	アプリケーションパスワード（スペース込みでそのまま）
`QA_PLATFORM_API_VERSION`	任意	APIバージョン固定（既定 `latest`）
`QA_PLATFORM_CACHE_TTL`	任意	ガイドのキャッシュ時間 ms（既定 300000）
`LOG_LEVEL`	任意	error / warn / info / debug（既定 info）

提供ツール

ツール	用途
`qa_get_guide`	接続先サイトの生きた仕様（計測項目・機能フラグ・クエリ可能なトラッキングID）を取得。クエリを書く前に必ず先に呼ぶ
`qa_execute_query`	QAL クエリを実行し、メタデータ付きの行を返す

接続確認

登録後、qa_get_guide を1回呼び、サイト仕様が返ることを確認してからユーザーに「つながりました」と伝える。返らない場合の切り分け順：

エンドポイントURLの形式（/wp-json か ?rest_route= か）
アプリケーションパスワードのコピーミス（スペースを削っていないか）
Node.js のバージョン（18未満なら更新）
dist/index.js の絶対パス（npm run build を実行したか）
Claude Desktop を再起動したか

やってはいけないこと

管理者アカウントの資格情報を設定に使う
アプリケーションパスワードをチャット本文やコミットに残す
設定ファイルの既存 mcpServers エントリを上書き削除する

一次情報：docs.qazero.com — MCP 連携／ github.com/quarka-org/qa-platform-mcp

開発者の方は開発者向けドキュメントを直接どうぞ。