Manual
AI エージェント連携(MCP)— Claude Code などから自分のサイトの数字を読む
最終更新: 2026年8月31日
できること
Analytics CORE は MCP(Model Context Protocol)のサーバーを備えています。Claude Code・Claude Desktop・ChatGPT など MCP に対応した AI エージェントに接続すると、エージェントがあなたのサイトの実データを読んで答えられるようになります。
- 「先月と比べてどの流入経路が落ちた?」→ 訪問の要約と経路別の内訳を読んで答える
- 「順位が下がったキーワードはどれ? AI要約が出ている?」→ 選別キーワードの最新順位と履歴を読む
- 「ChatGPT で自社は言及されている?」→ AI 検索での見え方(登録プロンプトごとの計測結果)を読む
- 「サイト診断で直すべきことを3つに絞って」→ 診断結果の要約(孤立ページ・title・H1・文字数など)を読む
できないこと(読み取り専用です)
- 設定の変更、キーワードやプロンプトの追加・削除、データの削除はできません
- クレジットを使う操作(順位の計測・AI 検索の計測・被リンク取得の実行)はできません。返すのは保存済みの結果だけです
- 他のアカウントのデータには構造的に届きません(キーはあなたのアカウントに紐づきます)
手順 1: API キーを発行する
- Analytics CORE にログインし、設定 → API キー(AI エージェントから数字を読む・MCP)を開きます(オーナー/管理者のみ)
- 用途メモ(例「Claude Code」)を入れて「キーを発行」
- 表示された
ac_ro_…のキーを控えます。この画面を閉じると二度と表示されません(サーバーはキーのハッシュしか保存していません)。 控え忘れたら失効させて発行し直してください
手順 2: エージェントに登録する
Claude Code はターミナルで1行です(キーは発行時に表示されたコマンドをそのまま貼れます):
claude mcp add --transport http analytics-core https://analyticscore.jp/api/mcp \ --header "Authorization: Bearer ac_ro_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Claude Desktop / ChatGPT / その他: MCP サーバー(Streamable HTTP)として次を設定します。
- URL:
https://analyticscore.jp/api/mcp - ヘッダー:
Authorization: Bearer (発行したキー)(x-api-keyヘッダーでも可)
登録後、「whoami を実行して」「list_projects を実行して」と頼むと疎通を確認できます。
使えるツール
| ツール | 返すもの |
|---|---|
whoami | 接続中のキー名と見えるプロジェクト数(疎通確認) |
list_projects | プロジェクト一覧と projectId(他のツールの引数) |
get_traffic_summary | 来た人・PV・成果・直帰率・平均滞在、経路別の内訳、PV 上位ページ(期間 7d / 28d / 3mo / 12mo) |
get_search_queries | Google Search Console のクエリ別 表示回数・クリック・平均掲載順位 |
get_tracked_keyword_ranks | 選別キーワードの最新順位(絶対位置と通常結果だけの順位・AI要約の有無)と直近90日の履歴 |
get_ai_visibility | AI 検索での見え方。プロンプト×エンジンごとの言及回数 k / 試行 n と信頼区間 |
get_site_audit_summary | サイト診断の要約(孤立・title/説明文・深い階層・エラー・canonical・H1・文字数・title の長さ・alt 無し画像) |
数字を読むときの注意(エージェントにも同じ注記を返しています)
- 計測開始日より前の期間は「0」ではなく「計測なし」です。結果の
measurementStartを確認してください - Search Console のクエリ表の合計は、サイト全体の合計と一致しません(Google が少数クエリを匿名化して落とすため)
- 見られる期間はプランの履歴上限までです(上限を超える期間を頼むとその旨のエラーになります)
- 1つのキーにつき 1 分あたり 120 回まで。有効なキーは 10 個まで
安全に使うために
- キーはアカウント全体のデータを読めます。チャットの共有やスクリーンショットに写り込まないよう注意してください
- 使わなくなったキー、渡した相手が変わったキーは、設定画面から失効させてください(即時に使えなくなります)
- キーは書き込みできないため、漏れても設定やデータが壊されることはありません。それでも読み取りは防げないので、失効を優先してください