Mitr Analytics

@mitr-analytics/mcp

Claude、Gemini、その他のMCPクライアントに、Mitrの分析データについて自然な英語で質問できます。アプリ、レポート、ファネル、アラート、プランの使用状況など、独自のデータを読み取り、アシスタントに渡して分析します。

MitrはCookieを使わない分析サービスなので、同意バナーを設定する必要はありません。このサーバーを導入しても、その点は変わりません。このサーバーはダッシュボードにすでにあるデータを読み取るだけです。

質問できること

• 「今週、訪問者数が最も大きく減少したアプリはどれですか？また、その減少はどこから来ましたか？」
• 「過去30日間の登録ファネルを表示してください。どこで離脱していますか？」
• 「マーケティングサイトの直近のイベントに何かおかしな点はありますか？UTMタグは正しく取得されていますか？」
• 「毎月のイベント割り当てのうち、どれくらい使用しましたか？」
• 「docs.example.com 用の新しいウェブアプリを Docs という名前で登録してください。」

セットアップ（約2分）

Mitrアカウントが必要です。ホスト型エンドポイントを使う場合、インストールは不要です。

1. APIキーを作成します。 ダッシュボードで設定 → APIキーとAIアシスタント → キーを作成を開き、名前（例：「Claude Code」）を付けてコピーします。キーが表示されるのは一度だけです。

キーは、作成時に権限を選択しない限り読み取り専用です。権限には「アプリを登録できる」、「ファネルを管理できる」、「QRキャンペーンを管理できる」、「ウェブフックを管理できる」、「削除できる」（いずれかの管理権限も必要）があります。キーの有効期限は、デフォルトでは365日です（30日、90日、365日、または無期限を選択できます）。キーを作成したワークスペースから退出したり、削除されたりすると、そのキーは使えなくなります。

2. アシスタントを接続します。

ホスト型（インストール不要）

リモートMCPサーバーに対応する任意のクライアントで https://mcp.mitranalytics.dev/mcp を指定し、Authorization ヘッダーにキーを設定します。キーをURLに含めないでください。このエンドポイントはURLにキーが含まれていると拒否します。

Claude Code：

claude mcp add --transport http mitr https://mcp.mitranalytics.dev/mcp --header "Authorization: Bearer mitr_live_..."

Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "mitr": {
      "url": "https://mcp.mitranalytics.dev/mcp",
      "headers": { "Authorization": "Bearer mitr_live_..." }
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "mitr": {
      "type": "http",
      "url": "https://mcp.mitranalytics.dev/mcp",
      "headers": { "Authorization": "Bearer mitr_live_..." }
    }
  }
}

Gemini CLI（~/.gemini/settings.json）：

{
  "mcpServers": {
    "mitr": {
      "httpUrl": "https://mcp.mitranalytics.dev/mcp",
      "headers": { "Authorization": "Bearer mitr_live_..." }
    }
  }
}

ローカル（npx）

Claude Desktopなど、コマンドを実行するクライアント向けです。Node.js 18以降が必要です。claude_desktop_config.json（macOS：~/Library/Application Support/Claude/、Windows：%APPDATA%\Claude\）を開き、次を追加します。

{
  "mcpServers": {
    "mitr": {
      "command": "npx",
      "args": ["-y", "@mitr-analytics/mcp"],
      "env": { "MITR_API_KEY": "mitr_live_..." }
    }
  }
}

同じ設定はClaude Code（claude mcp add mitr --env MITR_API_KEY=mitr_live_... -- npx -y @mitr-analytics/mcp）や、ローカルでの実行を希望する場合はGemini CLIでも使えます。

3. 質問します（ローカル環境の場合は、最初にアシスタントを再起動してください）。キーが最後に使用された日時はダッシュボードで確認できます。

ツール

ツール	機能
list_apps	ワークスペース内のすべてのアプリと、ほかのツールで必要となる siteId を表示します。
get_app_report	1つのアプリの7日間のレポートです。訪問者数、ページビュー数、トラフィック、流入元、国、デバイス、ウェブバイタル、コンバージョンを確認できます。
get_recent_events	1つのアプリの最新の生イベントを表示し、実際に何がトラッキングされているかを確認できます。
list_funnels	保存済みのコンバージョンファネルを表示します。
get_funnel_results	指定した期間について、1つのファネルの各ステップのコンバージョンと離脱を表示します。
get_alert_rule	設定している場合、トラフィックの急増・急減に関するアラート設定を表示します。
get_billing_usage	プラン、サブスクリプションのステータス、イベント使用量を表示します。
get_workspace_overview	すべてのアプリのトラフィック、Webhook、QRキャンペーン、ファネルをまとめて表示し、対応が必要な項目も確認できます。
list_qr_campaigns	QRキャンペーンのID、ステータス、スキャン合計数、プランのQR上限を表示します。
get_qr_campaign	1つのキャンペーンについて、コードとコードごとのスキャン数を表示します。
get_webhook_health	Webhookエンドポイントごとに、ステータス別の配信件数と最新の失敗を表示します。ペイロードは返されません。
add_app	新しいアプリを登録します。「Can register apps」が必要です。アプリのシークレットキーは返されないため、ダッシュボードからコピーしてください。
create_funnel, update_funnel	ページパスまたはイベントの順序付きステップからファネルを作成するか、ファネル名とステップを置き換えます。「Can manage funnels」が必要です。
delete_funnel	ファネルを完全に削除します。「Can manage funnels」と「Can delete」が必要です。
create_qr_campaign, update_qr_campaign	スキャンしたユーザーをhttps URLに誘導するキャンペーンを作成するか、名前や誘導先を変更するか、ステータスをactive、paused、archivedに設定します。「Can manage QR campaigns」が必要です。
add_qr_code	配置場所を示すラベルを付けて、印刷可能なコードをキャンペーンに追加します。「Can manage QR campaigns」が必要です。
create_webhook, update_webhook	https Webhookエンドポイントを作成するか、URLやイベントタイプを変更するか、一時停止します。署名シークレットは返されないため、ダッシュボードからコピーしてください。「Can manage webhooks」が必要です。
delete_webhook	Webhookエンドポイントを完全に削除します。「Can manage webhooks」と「Can delete」が必要です。

変更ごとにキーに対する個別の権限が必要です。また、削除には「Can delete」も必要です。アラートとチーム管理はアシスタントでは利用できません。

セキュリティとプライバシー

• キーからアクセスできる範囲は、あなたが見られる範囲と同じです。 ダッシュボードであなたがワークスペースに対して持つものと同じ読み取りアクセス権があります。パスワードと同様に取り扱ってください。
• いつでも取り消せます。 Settings → API keysから取り消してください。取り消すと、すぐに機能しなくなります。
• アシスタントの設定ファイルにプレーンテキストで保存されます。 ツールごとに別のキーを使うことで、ほかのツールに影響を与えずに1つのキーを取り消せます。
• 問い合わせたデータはAIプロバイダーにも送られます。 レポートと最近のイベント（ページパス、UTMタグ、デバイスと位置情報の概要、送信したカスタムイベントプロパティ）はアシスタントに返されるため、そのプロバイダーの利用規約が適用されます。Mitr自体はハッシュ化された識別子のみで訪問者を識別します。詳しくはCookieを使わずに訪問者をカウントする方法をご覧ください。
• 訪問者データには信頼できないデータとして印が付けられます。 ページパス、リファラー、UTMタグ、イベントプロパティは訪問者が書き込むため、AIに向けたテキストを含め、誰でも任意のテキストを入れられます。レポートと最近のイベントからは隠し文字が除去され、アシスタントに対して、それらを指示ではなくデータとして扱うよう伝える untrusted_data エンベロープに入れて返されます。
• 会話にシークレットは含まれません。 add_app は新しいアプリのSDKシークレットキーを返さず、Webhookツールも署名シークレットを返しません。ダッシュボードからコピーしてください。
• キーが送信されるのはHTTPS経由のみです（localhostに限り、プレーンなhttp://も使用できます）。

プラン

早期アクセス期間中、MCP サーバーは Free を含むすべての Mitr プランで利用できます。早期アクセス終了後は有料プランの一部となります。Free のワークスペースには 料金 を案内するメッセージが表示され、アップグレードすると同じキーで再びアクセスできます。

トラブルシューティング

ホステッド：ブラウザーで https://mcp.mitranalytics.dev/ を開くと、サーバーのバージョンが表示されます。ローカル：ターミナルで npx -y @mitr-analytics/mcp --version を実行します。どちらかが動作する場合、問題はクライアント設定にあります。

表示される内容	対処方法
MITR_API_KEY is not set	クライアント設定で env ブロックが不足しているか、正しい場所にありません。
"Your Mitr API key was rejected"	キーの有効期限が切れている、取り消されている、コピーに誤りがある、またはそのキーのワークスペースに所属していません。Settings → API keys で新しいキーを作成してください。
"missing the 'apps:write' permission"（または funnels:write、qr:write、webhooks:write、delete）	キーにその権限がありません。そのツールを使うには、該当する権限にチェックを入れてキーを作成してください。
"early-access period has ended for the Free plan"	ワークスペースをアップグレードすると、同じキーが再び機能します。
ホステッドエンドポイントからの 401	クライアント設定で Authorization: Bearer mitr_live_… ヘッダーが欠落しているか、形式が正しくありません。
"Mitr is rate-limiting this key"	短時間にリクエストが多すぎます。1 分ほど待ってください。
npx: command not found	Node.js 18+ をインストールし、新しい PATH が反映されるようアシスタントを再起動してください。
"Could not reach Mitr"	接続またはプロキシを確認してください。指示された場合にのみ MITR_API_BASE_URL を設定してください。

設定

変数	必須	デフォルト
MITR_API_KEY	はい	なし
MITR_API_BASE_URL	いいえ	https://api.mitranalytics.dev

開発

npm install
npm test                                        # builds, then unit tests + an end-to-end stdio test against a stub API
npx @modelcontextprotocol/inspector node dist/index.js   # try the tools by hand (set MITR_API_KEY first)

ご質問や問題については、[email protected] までお問い合わせください。

ライセンス

MIT