MCP サーバー — Claude Desktop と AI クライアント

QA ZERO MCP サーバー は、AI クライアント — Claude Desktop や、 Model Context Protocol を話す任意のホスト — が QA ZERO の REST API を通じてあなたの分析データを読めるようにする、小さな公式コネクタです。サイトを指定すれば、AI が自然な言葉で質問し、コネクタがそれを安全な QAL クエリへ変換します。

AI にデータベースを渡すわけではありません。人間が使うのと同じ /guide と /query エンドポイントの上に、読み取り専用のツールをちょうど2つだけ公開します。それ以外は何も開きません。

対象読者

コネクタをそのまま 使って AI に QA ZERO のデータを読ませたい方のためのページです。自分で MCP ラッパーや別種のコネクタを作りたい場合は、代わりに拡張を参照してください。

AI に渡されるもの

サーバーは2つのツールを登録します。いつ呼ぶかは AI が判断します。あなたは AI に話しかけるだけです。

ツール	役割
`qa_get_guide`	ライブ仕様を取得します: 利用可能なマテリアル、`since` 日付付きの機能フラグ、問い合わせできる `tracking_id` の一覧。AI はサーバーが何をサポートするかを知るために最初にこれを呼びます。
`qa_execute_query`	QAL クエリを1つ実行し、行と `meta` の件数を返します。AI は `qa_get_guide` が伝えた内容からクエリを組み立てます。

qa_get_guide はサーバーのライブな features マップを返すため、コネクタはあなたのサーバーのバージョンがサポートする内容を自動的に反映します — 対応機能の一覧を手で編集する必要はありません。

はじめる前に

AI クライアントを動かすマシンに Node.js 18 以上。
プラグインが有効で、REST API に到達できる QA ZERO サイト。
コネクタが認証に使うアカウントの WordPress アプリケーションパスワード。wp-admin の ユーザー → プロフィール → アプリケーションパスワード で作成し（例: Claude MCP という名前）、生成された値をスペースごとコピーします。

最小権限

メインの管理者アカウントではなく、必要な権限だけを持つ専用の WordPress ユーザーを使ってください。

インストール

コネクタはオープンソースとして quarka-org/qa-platform-mcp （Apache-2.0）で公開されています。クローンしてビルドします:

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

これで dist/index.js が生成されます。これが AI クライアントから実行されるファイルです。次のステップで必要になるので、その絶対パスを控えておいてください。

npm パッケージ

npx による一行インストールは予定していますが、まだ npm レジストリには公開されていません。公開されるまでは上のクローン＆ビルド手順を使ってください。パッケージが出荷されたら、このページを npx 形式で更新します。

Claude Desktop の設定

Claude Desktop の設定ファイルを開き、qa-platform サーバーのエントリを追加します。

OS	設定ファイル
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

{
  "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 を再起動します。qa-platform のツールがクライアントに表示されるはずです。

エンドポイントを正しく指定する

QA_PLATFORM_ENDPOINT は、REST ルートの 直前まで のベース URL です。コネクタが /qa-platform/guide/ と /qa-platform/query/ を自分で連結するため、ベースの形が WordPress の REST 受け口と一致している必要があります。どちらの形を使うかは、サイトのパーマリンク設定によって決まります:

パーマリンク有効（一般的な本番環境） — wp-json 形式を使います:
```
https://your-site.com/wp-json
```
パーマリンク無効（一部のローカル環境など） — ?rest_route= 形式を使います:
```
https://your-site.com/index.php?rest_route=
```

https://your-site.com/ のような素のドメインは 動きません — WordPress が通常の HTML ページとして返してしまい、コネクタがそこから JSON を解析できないためです。

HTTPS が必須です。

任意の設定

変数	用途	デフォルト
`QA_PLATFORM_API_VERSION`	特定の API バージョンに固定します。未設定なら常に `latest` を要求します。	`latest`
`QA_PLATFORM_CACHE_TTL`	guide レスポンスをキャッシュする時間（ミリ秒）。	`300000`（5分）
`LOG_LEVEL`	`error`、`warn`、`info`、`debug`。	`info`

動作確認

Claude Desktop で、まず guide が必要になる質問をしてみます:

QA ZERO で私のサイトについて何がわかりますか？

AI は qa_get_guide を呼び、あなたのサイトの tracking_id、利用可能なデータ期間、問い合わせできる内容を返してくるはずです。続けて実際のクエリを試します:

直近のページビューを10件見せて。

正常な往復は次のようになります: qa_get_guide → AI が QAL クエリを組み立てる → qa_execute_query → AI が行を整形して見せる。あなたが自分でクエリを書くことはありません。

トラブルシューティング

ツールが表示されない。 設定 JSON が正しいか確認し（cat <file> | jq .）、node --version が 18 以上か確認し、 dist/index.js へのパスが正しく絶対パスになっているか確認し、Claude Desktop を再起動してください。

Authentication failed。 アプリケーションパスワード（スペースごとコピーされ、まだ有効であること）とユーザー名を再確認してください。エンドポイントが HTTPS か確認してください。

404 / rest_no_route。 エンドポイントのベースが違います。 <endpoint>/qa-platform/guide/ をブラウザで直接開いてみてください — JSON ではなく HTML が返るなら、上記の wp-json と ?rest_route= 形式を切り替えてください。QA ZERO プラグインが有効かも確認します。

クエリがタイムアウトする。 時間範囲を狭めるか、limit を小さくします。長期間にわたる広すぎるクエリが原因であることが多いです。

もっと詳しく見たい。 env ブロックに "LOG_LEVEL": "debug" を設定し、クライアントの MCP ログを見てください（macOS の場合: ~/Library/Logs/Claude/mcp*.log）。

セキュリティ上の注意

claude_desktop_config.json は秘密情報として扱ってください — アプリケーションパスワードを含みます。コミットしないでください。パーミッションを制限します（macOS/Linux では chmod 600）。
アプリケーションパスワードは定期的にローテーションし、マシンを紛失した場合は wp-admin から失効させてください。
エンドポイントは必ず HTTPS を使ってください。

AI に渡されるもの​

はじめる前に​

インストール​

Claude Desktop の設定​

エンドポイントを正しく指定する​

任意の設定​

動作確認​

トラブルシューティング​

セキュリティ上の注意​

関連​