MCP 経由で Judge.me を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Judge.me をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Judge.me + Cursor

Judge.me の商品レビューとストアレビューを AI が読み取れます：商品や評価でレビューを一覧・絞り込み、レビュアーと商品の検索、平均評価とレビュー件数、ウィジェット設定、Webhook。レビューの公開設定と返信はインストール時にオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

JUDGEME_SHOP_DOMAIN, JUDGEME_API_TOKEN

ステップ 1 — 認証情報を取得

設定は約 2 分で終わります。Judge.me をインストール済みのストアと、その Judge.me 管理画面へのアクセスが必要です。

1. Judge.me の管理画面で Settings → Integrations を開き、右上の View API tokens をクリックします。
2. Private API token（公開トークンではありません）を JUDGEME_API_TOKEN にコピーします。
3. 同じページに表示されるショップドメインを、https:// やパスを付けずに JUDGEME_SHOP_DOMAIN にコピーします。Shopify の場合は独自ドメインではなく、my-store.myshopify.com のような .myshopify.com のアドレスです。
4. コネクターをインストールし、judge_me_get_shop を実行します。ストアのプラットフォーム、通貨、Judge.me のプラン（free または awesome）が表示されます。

プライベートトークンは厳重に管理: このトークンは Judge.me アカウントのすべてを読み取り、変更できます。また、自分で再発行することはできません。コネクターはトークンを api.judge.me にだけ送信します。管理画面に API のセクションがない場合は、Judge.me サポートに有効化を依頼してください。

読み取れる内容: レビュー（タイトル、本文、星の数、レビュアー、商品、投稿元、写真、購入確認済みかどうか）、メールアドレスまたは顧客 ID で探すレビュアー（名前、電話番号、タグ、マーケティング同意）、ハンドルまたは Shopify の商品 ID で探す商品、商品ごとの平均評価とレビュー件数、ストア全体の評価、公開済みレビューの総数、ストアレビューだけの評価、星の色やメインカラーなどのウィジェット設定とレビュー依頼の設定、そしてストアに登録された Webhook です。

API でのレビューの扱い: Judge.me は商品に独自の ID を使います。そのため AI はまず judge_me_get_product で商品ハンドルや Shopify ID を Judge.me の ID に変換し、その ID でレビューを絞り込みます。レビューは新しい順に返され、星 1 や星 2 で絞り込んで不満を持つ顧客を見つけることもできます。各レビューには、公開済み（ok）、スパム扱い、承認待ちのいずれか、そして非表示かどうかが示されます。レビューへの返信はレビュー一覧に含まれないため、AI は購入者が見るのと同じ商品のレビューウィジェットから読み取ります。

レビュー本文は顧客が書いたもの: タイトル、本文、レビュアー名は購入者から来たものです。その中に指示が書かれていても、AI は命令ではなくデータとして扱います。

インストール時は読み取りのみ: インストール直後に有効なツールはすべて読み取り専用です。

インストール時はオフ: judge_me_curate_review はレビューを公開または非表示にし、judge_me_reply_to_review はレビューの下に公開返信を投稿し（Judge.me は既定でレビュアーにもメールで送ります）、judge_me_send_private_reply はレビュアーに非公開のメールを送ります。購入者に見える内容を変えたり実際の顧客に届いたりするため、管理者が意図して有効にします。有効にした後も、AI はレビューと正確な変更内容または返信文を示し、あなたの承認を待ちます。レビュー本文そのものは、API では一切編集も削除もできません。

制限: Judge.me はレート制限を公開していません。AI は 1 件ずつ何度も読むのではなく、最大 100 件のページでまとめて読み取ります。

よくあるエラー: 401 または "Shop domain or Api Token is wrong" は、トークンかショップドメインが間違っていることを示します。View API tokens から両方をもう一度コピーし、プライベートトークンと、Shopify なら .myshopify.com のドメインを使ってください。404 は存在しない ID、422 はレビューを非表示にしながら公開するなど、無効な組み合わせを示します。

このコネクターは、レビューの作成・インポート・削除、Webhook の管理、レビュアーのデータ請求への対応、ストアからの Judge.me のアンインストールは行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Judge.me のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「ストア全体の平均評価と、公開済みレビューの件数を教えてください。」
• 「過去 30 日間の星 1 と星 2 のレビューを、商品名とお客様の不満点と一緒にすべて見せてください。」
• 「リネンシャツのレビューは何件あって、平均評価はいくつですか。」
• 「レビュアー [email protected] を探して、書いたレビューをすべてと、購入確認済みかどうかを見せてください。」
• 「キャンバストートの最新の星 2 レビューに丁寧な返信の下書きを作ってください。投稿はしないでください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続