# EXBANK MEO 連携（@exbk/meo-mcp）

EXBANK MEO 管理ツールに入っているお店のデータ（クチコミ・順位・月次レポートなど）を、Claude・Cursor・ChatGPT などの AI に「読ませる」ためのつなぎ込み用プログラムです。

- **見るだけ**です。Google への投稿・返信・設定の変更は、この連携からはできません。
- 料金は、MEO 管理ツールのプランに含まれています。追加の費用はかかりません。

## 1. 鍵を作る（管理者の方）

1. MEO 管理ツールにログインします。
2. 「店舗設定」→「AI 連携」タブを開きます。
3. 「鍵を作る」を押し、名前・使う店舗・有効期限（30日／90日／1年）を選びます。来店アンケートの回答を AI に見せたいときだけ、アンケートを含めるにチェックを入れます。
4. 表示された鍵をコピーします。**鍵が表示されるのはこの1回だけ**です。

## 2. つなぐ

以下の `ここに鍵` を、手順1でコピーした鍵に置き換えてください。Node.js（18 以上）が入っている必要があります。

### Claude デスクトップ

設定 → 開発者 → 「設定を編集」で設定ファイルを開き、次を入れて保存し、Claude を再起動します。

```json
{
  "mcpServers": {
    "exbank-meo": {
      "command": "npx",
      "args": ["-y", "@exbk/meo-mcp"],
      "env": { "EXBK_MEO_API_KEY": "ここに鍵" }
    }
  }
}
```

### Claude Code

```bash
claude mcp add exbank-meo --env EXBK_MEO_API_KEY=ここに鍵 -- npx -y @exbk/meo-mcp
```

鍵を使って直接つなぐこともできます（プログラムの導入は不要）。

```bash
claude mcp add --transport http exbank-meo https://exbk.jp/api/meo/mcp --header "Authorization: Bearer ここに鍵"
```

### Cursor

設定の「MCP」から追加するか、`~/.cursor/mcp.json`（そのプロジェクトだけなら `.cursor/mcp.json`）に次を入れます。

```json
{
  "mcpServers": {
    "exbank-meo": {
      "command": "npx",
      "args": ["-y", "@exbk/meo-mcp"],
      "env": { "EXBK_MEO_API_KEY": "ここに鍵" }
    }
  }
}
```

### ChatGPT（開発者モードのコネクタ）

ChatGPT は自分のパソコンのプログラムを起動できないため、インターネット上の入口に直接つなぎます。

1. 設定 → コネクタ → 詳細設定で「開発者モード」をオンにします。
2. 新しいコネクタを作り、次を入れます。
   - URL：`https://exbk.jp/api/meo/mcp`
   - 認証：ヘッダー `Authorization` に `Bearer ここに鍵`（Bearer のあとに半角スペース、そのあとに鍵）

画面の項目名はバージョンによって違うことがあります。ヘッダーを入れる欄が無い場合は、ChatGPT 側の対応を待つか、Claude などをお使いください。

### git から直接使う（npm を使わない場合）

```bash
npx github:ex-bk/meo-mcp
```

上の設定例の `"args": ["-y", "@exbk/meo-mcp"]` を `"args": ["-y", "github:ex-bk/meo-mcp"]` に置き換えると、同じように使えます。初回は組み立てのために少し時間がかかります。

### 接続先を変えたいとき

環境変数 `EXBK_MEO_URL` で変えられます（既定は `https://exbk.jp`）。ふつうは設定不要です。

## 3. 使えるツール

つないだあと、AI に話しかけるだけで使われます。

| ツール | できること | 話しかけの例 |
|---|---|---|
| `locations_list` | 見られる店舗の一覧 | 「MEO の店舗一覧を出して」 |
| `reviews_list` | クチコミの一覧（星・返信の有無で絞れる） | 「返信していないクチコミを見せて」 |
| `basic_get` | 店名・住所・営業時間・カテゴリ・説明文 | 「登録されている営業時間を教えて」 |
| `performance_get` | 表示回数・通話・ルート検索・サイト訪問 | 「この30日の通話の回数は、前の期間と比べてどう？」 |
| `rank_get` | Google マップの検索順位の推移 | 「『渋谷 カフェ』の順位は先月からどう動いた？」 |
| `reviews_analysis_get` | クチコミの分析（星の分布・よく出る言葉・良い点と課題） | 「お客様が褒めている点と不満の点をまとめて」 |
| `report_get` | 月次レポート（既定は先月） | 「先月のレポートを店主向けにやさしく説明して」 |
| `aio_get` | AI に聞いたときにお店が答えに出るか | 「AI の答えにうちの店は出ている？」 |
| `survey_answers_get` | 来店アンケートの回答（鍵で許可したときだけ） | 「最近のアンケートの声を要約して」 |
| `approvals_list` | 承認待ち・差し戻しの返信や投稿 | 「承認待ちはいくつある？」 |

そのほか、「今週のやること」「未返信クチコミの返信方針」「先月のふりかえり」のひな形（プロンプト）が使えます。

読むのは保存済みのデータです。画面で一度も開いていない項目は「まだ取得していません」と返ります。クチコミなどお客様が書いた文は、AI には「データ」として渡され、中に書かれた命令には従わないようになっています。

## 4. 鍵の取り扱い

- 鍵はパスワードと同じです。チャット・メール・公開の場所（GitHub など）に貼らないでください。
- 設定ファイルに書いた鍵は、そのパソコンの持ち主だけが見られる状態にしてください。
- 使いすぎを防ぐため、1日500回まで、1分に60回を超えると鍵が自動で失効し、管理者にメールが届きます。
- 取り消し方：「店舗設定 → AI 連携」の一覧で、その鍵の「失効」を押します。すべての鍵を止めたいときは「全部の鍵を今すぐ失効」を押します。心当たりがないときや、パソコンをなくしたときは、すぐに失効させてください。
- 「直近の操作」で、いつ・どの鍵で何が読まれたかを確認できます。

## 5. うまくいかないとき

| 表示 | 原因と対処 |
|---|---|
| 鍵が設定されていません | 設定の `EXBK_MEO_API_KEY` が空です。鍵を入れてください |
| 鍵が使えません（401） | 鍵の入れ間違い、失効、期限切れです。鍵を作り直してください |
| 今日の回数の上限（429） | 1日500回に達しました。日本時間の0時に戻ります |

## ライセンス

MIT