ClaudeとMixpanelを連携する方法 — 分析データを会話で操作する
MixpanelコネクタでClaudeにセグメント・ファネル・リテンション分析を任せる手順です。書き込み系ツールの扱い、EU・IN地域の接続、Claude Codeでの使い方をまとめます。
ClaudeとMixpanelの連携とは — 分析データをどう操作するか
Mixpanelコネクタは、プロダクト分析ツールMixpanelのデータをClaudeの会話から照会・管理できるようにするConnectorです。開発元はMixpanel自身で、Connectorsディレクトリではデータ・分析カテゴリに分類されています。Anthropic verifiedの表示があり、追加時期は2026年3月、サインインが必須です。接続先は https://mcp.mixpanel.com/mcp です。
できることは3系統あります。
- セグメント・ファネル・リテンションの分析
- イベントやプロパティの棚卸しと、Lexicon(データ辞書)のメタデータ管理
- セッションリプレイの分析と、データ品質の問題の解消
ダッシュボードを開いて条件を組む代わりに、「先月と今月でサインアップから購入までの転換率はどう違うか」と聞けば済みます。
ここで押さえたいのは、このConnectorが読み取り専用ではない点です。接続するとAIアシスタントはMixpanelに対して読み取りも書き込みもできると、Mixpanelのドキュメントに明記されています。イベントの説明文の書き換え、タグの削除、ダッシュボードの作成まで会話から実行できるため、Similarwebのような読み取り専用のConnectorとは同じ感覚で使えません。
接続手順 — 個人アカウントとEU・IN地域
事前条件: MixpanelのMCPを有効にする
Claude側の操作より先に、Mixpanel側でMCPが有効になっている必要があります。
| アカウントの種類 | MCPの状態 |
|---|---|
| 2026年8月1日以降に作成した無料・Growthプラン | MCPの状態既定で有効(組織の管理者は無効化できる) |
| それ以外のアカウント | MCPの状態組織の管理者が「Settings → Org → Overview」で有効化するまで接続できない |
変更が反映されるまで最大15分かかります。有効化されていない状態で接続すると、「MCP access is not enabled for this project」というエラーが出ます。この場合は組織の管理者に有効化を頼みます。無料プランではQuery APIのアクセス上限がかかる場合があり、詳細はMixpanelの料金ページに従います。
USリージョンの接続手順
USリージョンなら、ディレクトリから追加するのが最短です。
- Claudeで「Customize」→「Connectors」を開く
- データ・分析カテゴリまたは検索窓からMixpanelを探す
- 「Connect」を押し、ブラウザーでMixpanelのOAuth認証を完了する
認証はユーザー本人のMixpanel資格情報で行われます。Claudeから見えるのは、そのユーザーがMixpanel上で既に閲覧権限を持つプロジェクトだけで、既存のロールと権限はそのまま効きます。
EU・INリージョンはカスタムコネクタで追加する
ディレクトリ版のURLはUSリージョンのものです。EUまたはINリージョンのプロジェクトは、「Settings → Connectors → Add Custom Connector」から次のURLを入れて追加します。
| リージョン | MCPサーバーのURL |
|---|---|
| US | MCPサーバーのURLhttps://mcp.mixpanel.com/mcp |
| EU | MCPサーバーのURLhttps://mcp-eu.mixpanel.com/mcp |
| IN | MCPサーバーのURLhttps://mcp-in.mixpanel.com/mcp |
カスタムコネクタは、無料・Pro・Max・Team・Enterpriseのいずれのプランでも使えます。ただし無料プランは1件までです。接続はAnthropicのクラウドから行われるため、公開インターネットから到達できるサーバーが前提になります。Mixpanelのサーバーはこの条件を満たしています。カスタムコネクタ自体の仕組みはCoworkカスタムコネクタ自作ガイドで扱っています。
Team・Enterpriseでの展開
Team・Enterpriseプランでは、メンバーが使い始める前にOwnerまたはPrimary Ownerがコネクタを組織に対して有効化します。有効化しても全員に自動で権限が付くわけではなく、各メンバーがMixpanelで個別に認証します。二重の関門があると考えると分かりやすいでしょう。
- Mixpanel側: 組織の管理者がMCPを有効化する
- Claude側: Ownerがコネクタを有効化し、各メンバーが認証する
Mixpanelのツール一覧 — ディレクトリ掲載と公式ドキュメントの違い
Connectorsディレクトリのページには20個のツールが載っています。一方、Mixpanelのドキュメントにはコホート、ルックアップテーブル、メトリクス、実験、フィーチャーフラグなど、より多くのツールが分類別に載っています。両者は食い違っており、ツールの全体像を知るにはMixpanel側のドキュメントが詳しい、という関係です。
ディレクトリに載っている20個を役割で分けると次のとおりです。
| 分類 | ツール | 役割 |
|---|---|---|
| 探索 | ツールGet-Projects / Get-Events / Get-Event-Details / Get-Property-Names / Get-Property-Values | 役割プロジェクト、イベント、プロパティの一覧と値の確認 |
| 分析 | ツールGet-Query-Schema / Run-Query / Get-Report | 役割クエリの組み立てと実行、保存済みレポートの取得 |
| ダッシュボード | ツールList-Dashboards / Get-Dashboard / Create-Dashboard | 役割一覧・取得・新規作成 |
| Lexicon管理 | ツールEdit-Event / Edit-Property / Create-Tag / Rename-Tag / Delete-Tag | 役割メタデータの編集とタグ操作 |
| データ品質 | ツールGet-Issues / Dismiss-Issues / Get-Lexicon-URL | 役割問題の取得・一括却下、Lexiconへのリンク |
| セッションリプレイ | ツールGet-User-Replays-Data | 役割特定ユーザーのリプレイをイベントデータと併せて分析 |
Mixpanelのドキュメント側には、上の表に無い次のようなツールもあります。
- ダッシュボードの更新・複製・削除
- コホートの作成・更新・削除
- カスタムプロパティ
- 最大50件をまとめて編集するBulk-Edit系
- 重複グループのマージ(Merge-Group)
ディレクトリ掲載の20個に含まれないため、Claudeで実際に呼べるかはディレクトリの掲載だけでは確認できません。使いたい操作があれば、接続後にClaudeへ「Mixpanelのツールで何ができるか」を尋ねるのが確実です。
何を頼めるか — Mixpanel推奨の依頼文の例
Mixpanelのドキュメントには、接続後に試せる依頼文の例が用途別に載っています。ここでは代表的なものを、Claudeでの使い方に合わせて並べます。
| 用途 | 依頼文の例(ドキュメントの例に沿ったもの) |
|---|---|
| データを知る | 依頼文の例(ドキュメントの例に沿ったもの)「今週もっとも多く発火したイベントは?」 |
| 分析する | 依頼文の例(ドキュメントの例に沿ったもの)「今月と先月のサインアップから購入までの転換率を比べて」 |
| 分析する | 依頼文の例(ドキュメントの例に沿ったもの)「オンボーディングを完了したユーザーの7日リテンションを見せて」 |
| ダッシュボード | 依頼文の例(ドキュメントの例に沿ったもの)「サインアップ・アクティベーション・解約を並べた週次のダッシュボードを作って」 |
| Lexiconの整備 | 依頼文の例(ドキュメントの例に沿ったもの)「説明文が無いイベントに説明を付けて」 |
| データ品質 | 依頼文の例(ドキュメントの例に沿ったもの)「Signupイベントの未対応の品質問題を一覧にして」 |
| ユーザー調査 | 依頼文の例(ドキュメントの例に沿ったもの)「バグを報告したこのユーザーの直近3セッションで何があった?」 |
分析系の依頼では、内部で Get-Query-Schema でクエリの構造を確認し、Run-Query で実行する流れになります。Mixpanelが示す標準的な流れは、探索、クエリ、作成、反復の4段階です。同じ会話の中で条件を絞り込んでいけるため、最初から完成形の質問を作る必要はありません。
書き込みを伴う操作のリスクと制限のかけ方
読み取りだけなら失敗しても実害は限られますが、Lexiconの編集やタグの削除、品質問題の一括却下は、チーム全員が見るデータ辞書を書き換えます。Claudeが依頼文を取り違えたり、条件を広く解釈したりすると、意図しない範囲に及ぶ可能性があります。
制限のかけ方は3つあります。
Owner側でツールの権限を絞る
Team・Enterpriseでは、Ownerがコネクタの「Tool permissions」から、ツールの分類ごとに「Always allow」「Needs approval」「Blocked」を選べます。読み取りは許可し、書き込み・削除は承認制やブロックにする使い方が可能です。この設定は組織全体に効き、個人では上書きできません。Claude側で書き込みを許可しても、Mixpanel側で本人にその権限が無ければ変更は通りません。
Mixpanelのロールを閲覧専用にする
Claudeに渡る権限は、接続したユーザーのMixpanelでの権限と同じです。分析だけに使う目的なら、閲覧権限のユーザーで認証するのが最も確実な絞り方です。
依頼文で対象を限定する
「タグを付けて」ではなく「名前が checkout_ で始まるイベントだけにタグを付けて。実行前に対象一覧を見せて」と頼みます。一括の変更は、対象を先に一覧で出させてから実行させると、範囲のずれに気づけます。
このほか、次の制約もMixpanelのドキュメントに書かれています。
- MCPサーバーはHIPAAの要件に対応しておらず、MixpanelのBAAの対象外
- Mixpanelのデータは利用中のAIプロバイダーにも送られる
- 個人データを含むプロジェクトでは、GDPRやCCPAなどの適用要件を確認する
- 共有のワークスペースでは、会話履歴が他のメンバーに見える可能性がある
- 上限は1ユーザーあたり1時間に600リクエスト
Claude CodeでMixpanelを使う — コードと分析データを同じ場で扱う
Mixpanelの説明文には、コードやドキュメントと並べてプロダクトデータを推論できる、とあります。この特徴が最も生きるのはClaude Codeです。計測コードを書く場所と、その結果を見る場所が同じ会話に収まるためです。
接続コマンド
Mixpanelのドキュメントに沿って、USリージョンなら次のコマンドで追加します。
claude mcp add --transport http mixpanel https://mcp.mixpanel.com/mcp追加後にClaude Code内で /mcp を実行し、ブラウザーでMixpanelのOAuth認証を完了します。EUやINならURLを差し替えます。
CI/CDや共有環境のように、ブラウザーでのログインができない場面向けに、サービスアカウント認証(ベータ)もあります。静的なAuthorizationヘッダーで接続する方式です。base64化した資格情報はパスワードと同じ扱いで、.mcp.json にべた書きせず環境変数から渡します。
{
"mcpServers": {
"mixpanel": {
"type": "http",
"url": "https://mcp.mixpanel.com/mcp",
"headers": {
"Authorization": "Bearer Basic ${MIXPANEL_SA_TOKEN}"
}
}
}
}書き込みツールをpermissionsで止める
Claude Codeでは、権限ルールでツール単位に止められます。ツール名は mcp__サーバー名__ツール名 の形です。次は、読み取り系だけを通し、Lexiconの編集・タグの削除・品質問題の却下・ダッシュボードの作成を拒否する .claude/settings.json の例です。ツール名は前掲の表のとおりで、書式はMCP権限ルールの書き方にまとめています。
{
"permissions": {
"allow": [
"mcp__mixpanel__Run-Query",
"mcp__mixpanel__Get-Query-Schema",
"mcp__mixpanel__Get-Events",
"mcp__mixpanel__Get-Report"
],
"deny": [
"mcp__mixpanel__Edit-Event",
"mcp__mixpanel__Edit-Property",
"mcp__mixpanel__Delete-Tag",
"mcp__mixpanel__Dismiss-Issues",
"mcp__mixpanel__Create-Dashboard"
]
}
}CLAUDE.mdに分析の作法を書く
依頼のたびにイベント名の規則や期間の基準を説明するのは手間です。プロジェクトのCLAUDE.mdに短い規約を置くと、Claudeが毎回同じ前提で動きます。次は一例です(イベント名は仮のものです)。
## Mixpanel分析のルール
- 転換率は signup_completed から purchase_completed までのファネルで測る
- 期間は明示されなければ直近30日、比較は同じ長さの直前期間
- 集計後は必ず対象プロジェクト名と期間を先頭に書く
- Lexiconの編集・タグ操作は実行前に対象一覧を見せ、承認を待つ計測コードの実装と結果の確認を往復させる
Claude Codeでは、新機能の計測コードを書いたあとで、実際にイベントが届いているかを同じ会話で確かめられます。実装後に Get-Events で新しいイベントの有無を確認させ、Get-Issues でデータ品質の問題が出ていないか読ませる、という往復です。実装と検証を分けて別の画面で行う手間が減ります。
Mixpanelは、Claude Code向けのプラグインも用意しています。トラッキングの実装、指標の調査、ダッシュボード作成、実験の管理といった手順をスキルとして持つもので、claude plugin marketplace add mixpanel/ai-plugins で追加します。既に上記のMCP接続があれば、スキルはその接続を自動で使います。
他のデータ系Connectorとの使い分け
同じ「分析データを会話で扱う」Connectorでも、データの置き場所が異なります。
| 観点 | Mixpanel | Databricks | Similarweb |
|---|---|---|---|
| 扱うデータ | Mixpanel自社プロダクトのイベントデータ | Databricks自社のデータレイクのテーブル | Similarweb外部サイトの推定トラフィック |
| 分析の単位 | Mixpanelイベント・ファネル・リテンション | DatabricksSQLやGenieによる問い合わせ | Similarwebサイト・アプリ単位の集計 |
| 書き込み | Mixpanelあり(メタデータ・ダッシュボード等) | Databricks構成による | Similarweb読み取り専用 |
ユーザーの行動を追いたいならMixpanel、全社のデータ基盤に対する問い合わせならDatabricks(ClaudeとDatabricksを連携する方法)、競合の外形的な動きならSimilarwebという分け方になります。
よくあるつまずき
「MCP access is not enabled for this project」と出る
MixpanelのMCPが組織で有効化されていません。組織の管理者が「Settings → Org → Overview」で有効にします。反映には最大15分かかります。
「Missing scope」エラーが出る
保存済みの認証トークンが古い権限の範囲で作られています。対処は、認可コマンドを実行したディレクトリの .mcp-auth フォルダを削除して、再認可することです。mcp-remote 経由で接続している場合の案内です。
EUやINのプロジェクトが見えない
ディレクトリから追加したConnectorはUSリージョンのURLに向いています。カスタムコネクタでリージョン別のURLを追加し直します。
認可が通らない
Mixpanelアカウントが少なくとも1つのプロジェクトにアクセスできること、組織単位でMCPが有効なことを確認します。設定ファイルを直した場合は、アプリを再起動しないと反映されません。
依頼が急に失敗するようになった
1ユーザーあたり1時間600リクエストの上限に当たっている可能性があります。長い調査を続けると消費が早まると考えられます。
よくある質問
実験やフィーチャーフラグもClaudeから操作できますか
Mixpanelのドキュメントでは、実験とフィーチャーフラグのツールはオープンベータとして掲載されています。ただしオーディエンスのターゲティングとコホートの編集は、MCPではまだ扱えず、Mixpanelの画面から行う必要があります。
まとめ
Mixpanelコネクタは、プロダクト分析のクエリ実行からLexiconの整備までを会話で行える、書き込みも可能なConnectorです。使う前に押さえたいのは3点でした。Mixpanel側でMCPが有効か、EU・INはカスタムコネクタで別URLを使うか、書き込み系ツールをどこまで許すかです。分析だけなら閲覧権限のユーザーで認証するのが簡単で、Claude Codeならpermissionsで書き込み系を止めた上で、CLAUDE.mdに分析の作法を置くと運用が安定します。接続全般の考え方はClaude Connectorsとはにまとめています。