Mimetic — Website Growth and Analytics

mim: Mimetic CLI

サイトの成長に関するコンテキストを、ターミナルや普段使っている AI ツールに取り込みます。

AI アシスタントをウェブサイト監査、アナリティクス、広告、実験結果に接続して、収益機会を特定し、レビュー可能な改善を実装できます。

• MCP 接続ガイドとユースケース
• ライブツールカタログと入力スキーマ
• リモート MCP：https://mcp.trymimetic.com/mcp（OAuth サインイン対応の Streamable HTTP）

公開カタログにはツール定義が含まれています。MCP リクエストには認証が必要で、アクセスはご自身のプロジェクトと接続済みアカウントに制限されます。

クイックスタート

インストールしてからセットアップを実行します。セットアップではサインイン、プロジェクトの検出、このマシンで見つかった各エージェントへの MCP 登録を行い、動作したと仮定するのではなく、各手順を実際に検証します。

npm install -g @mimeticinc/mim-cli
mim setup

セットアップでは、見つかった Claude Code、Codex、Cursor、Windsurf、Claude Desktop にサーバーを登録します。各設定ファイルは書き込む前にバックアップされ、既存のほかの MCP サーバーには手を加えません。後から登録するには mim mcp install cursor を実行するか、mim mcp install all を再実行してください。

npx 経由ではなく、グローバルにインストールしてください。エージェントは MCP サーバーとして mim を起動するため、PATH 上に mim が常にある必要があります。また、このドキュメントのすべての例は mim <command> の形式です。Node.js 20 以降が必要です。

セットアップを再実行しても安全です。新しい認証情報を作成するのではなく、既存のログインと登録を再利用します。

インストール後に mim が「command not found」と表示する場合、npm のグローバル bin ディレクトリがシェルの PATH に含まれていません。次を実行すると、お使いのシェルに合わせた正確な修正方法を確認できます。

npx -y @mimeticinc/mim-cli setup

シェルのプロファイルに追加する export PATH= の行が表示されます。単発のコマンドにも npx 形式を使えますが、MCP クライアントを設定する前にグローバルインストールしてください。

Mimetic は監査、リアルタイムアナリティクス、広告のパフォーマンス、ライフサイクルマーケティング、セッションの行動を結び付け、ダッシュボードを行き来せずに、成長を妨げている要因を見つけ、次の施策を決め、レビュー可能な修正ワークフローに進めるようにします。シェルから直接 mim を使うか、同じコンテキストとアクションを Claude Code、Codex、その他の MCP クライアントに提供できます。

Mimetic は CLI の基盤となるホステッドサービスです。詳しくはtrymimetic.comをご覧ください。

実現できること

• 影響の大きい問題を見つける。 サイト監査、優先度付けされた指摘事項、個人情報を伏せたセッションリプレイの分析情報を、1 つのプロジェクトコンテキストにまとめます。
• リアルタイムデータで成長に関する質問に答える。 CSV ファイルにエクスポートせずに、集客、コンバージョン、収益、検索、広告、プロダクトアナリティクス、ライフサイクルのパフォーマンスを照会できます。
• 計測と集客の設定を修復する。 ホステッド版の GA4 と Search Console を用意し、PR、Shopify ピクセル、またはエージェントが適用するスニペットを通じてトラッキングを導入し、Google Ads リソースを作成または接続できます。
• 指摘事項をレビュー可能な作業に変える。 コード修正ワークフローを開始し、提案された PR、差分、プレビュー、または Mimetic のレビューページを開きます。
• コーディングエージェントにビジネスコンテキストを提供する。 MCP クライアントが同じ指摘事項と接続済みデータを確認してから、アクションを提案または開始できるようにします。

連携

連携	できること
Google Analytics 4	セッション、ユーザー、チャネル、ランディングページ、エンゲージメント、コンバージョン、収益をクエリできます。計測が不足している場合は、ホスト型のプロパティとタグを設定できます。
Google Search Console	クエリ、ページ、国、デバイス、クリック数、表示回数、CTR、掲載順位を分析できます。ホスト型の設定では、所有権の確認やサイトマップの送信も処理できます。
Google Ads	キャンペーン、費用、クリック数、コンバージョン、検索語句などの GAQL データを確認できます。アカウントを作成またはリンクし、GA4 に接続して、自動タグ設定を有効にできます。
PostHog	イベントとプロパティに対して読み取り専用の HogQL を実行し、プロダクトの利用状況、ファネル、ユーザー行動を調査できます。
Klaviyo	キャンペーンとフローのパフォーマンス、リスト、セグメント、指標を確認できます。カート放棄フローが稼働中かどうかを確認し、キャンペーンテンプレート内のリンク切れを特定できます。
GitHub	分析の導入やコードの修正を、レビュー可能なプルリクエスト、差分、プレビューとして受け取れます。
Shopify	プロジェクトでその配信方法が利用できる場合は、Mimetic アプリのピクセルを通じてホスト型の分析機能を導入できます。
Claude Code、Codex、MCP クライアント	プロジェクトのコンテキスト、接続済みデータのクエリ、監査、明示的に説明されたアクションツールを AI 支援ワークフローに取り込めます。

回答できる質問

関連するアカウントを接続すると、CLI を使うか、MCP クライアントに次のような質問をすることができます。

• GA4 で、オーガニッククリック数は減ったものの、コンバージョン率は依然として高いランディングページはどれですか？
• コンバージョンが同じように増えていないのに、広告費が増加しているのはどこですか？
• 最近の優先度の高いセッションで、ユーザーは何に苦労していますか？
• カート放棄フローは稼働中ですか？また、リンク切れが含まれているキャンペーンテンプレートはどれですか？
• 最優先で着手できる修正は何ですか？また、提案された変更はどこで確認できますか？

コンテキストからアクションへ

# Build a project brief from audits, findings, and connected signals
mim context --project yourstore.com

# Investigate acquisition and conversion performance
mim query-ga4 --project yourstore.com \
  --metrics sessions,conversions,totalRevenue \
  --dimensions sessionDefaultChannelGroup
mim query-gsc --project yourstore.com --dimensions query,page
mim query-bq --project yourstore.com --describe
mim query-bq --project yourstore.com --sql \
  "SELECT event_name, COUNT(*) AS n FROM \`events_*\` WHERE _TABLE_SUFFIX >= '20260901' GROUP BY 1 ORDER BY n DESC"
mim ads query --project yourstore.com

# Check lifecycle marketing and recent customer friction
mim klaviyo query --project yourstore.com --resource abandoned_cart_status
mim recordings --project yourstore.com

# Move a prioritized finding into a reviewable fix workflow
mim fixes list --project yourstore.com
mim fixes start 1 --project yourstore.com

コマンドの実行

グローバルにインストールしている場合は、mim <command> を実行します。インストールしていない場合も、すべてのコマンドを npx 経由で実行できます。

npx -y @mimeticinc/mim-cli <command>

認証とローカルの認証情報

mim auth login を実行すると、ブラウザーを使ったデバイスフローが開始されます。サーバーが発行するトークンは、設定された有効期間（デフォルトでは 90 日）が経過すると期限切れになります。

ログインは冪等です。このマシンに有効なトークンがすでにある場合、mim auth login はサーバーに対してトークンを検証し、新しいトークンを発行する代わりに既存のものを再利用します。別のアカウントでサインインするには、mim auth login --force を使用してください。

ログインするたびに、CLI は実際に API を呼び出してトークンの有効性を確認し、プロジェクトを一覧表示します。プロジェクトは、Mimetic の監査またはレポートの送信先となったメールアドレスに紐づいています。別のメールアドレス（たとえば仕事用ではなく個人用）でサインインすると、プロジェクト一覧は空になり、CLI は代わりに使用すべきメールアドレスを知らせます。mim auth status を実行すると、同じサーバー側の検証が行われ、このマシンで使用しているアカウントとプロジェクトが正確に表示されます。

ヘッドレスサーバーと SSH

ブラウザーを CLI と同じマシンで実行する必要はありません。デスクトップ環境のないサーバーでは、ローカルブラウザーを起動しようとせずにデバイスフローを開始します。

mim auth login --no-open

そのプロセスを実行したままにして、表示された確認用 URL をノートパソコンまたはスマートフォンで開き、そこでログインを承認します。サーバーは Mimetic をポーリングしてログインを完了し、自身のトークンを ~/.mim/config.json に保存します。

無人デプロイでは、対話型ログインに頼る代わりに、サーバーのシークレットマネージャーまたは環境を通じて MIM_API_TOKEN を設定してください。トークンをコマンド引数に直接指定しないでください。

デフォルトでは、CLI はそのベアラートークンを ~/.mim/config.json にプレーンテキストの JSON として保存します。サポート対象の POSIX システムでは、認証情報を保存するたびに、ディレクトリにモード 0700、ファイルにモード 0600 を設定します。トークンはローカルで暗号化されず、オペレーティングシステムのキーチェーンにも保存されません。

mim auth status
mim auth logout

mim auth logout はローカルファイルを削除する前に、Mimetic のサーバー上にある保存済みの管理対象トークンを失効させます。失効を確認できない場合、CLI はローカルの認証情報を保持し、エラーを報告します。mim auth logout --local-only はローカルのコピーのみを削除します。トークンは、有効期限が切れるか、別の方法で失効されるまで引き続き使用できます。

CI またはシークレットマネージャーでは、代わりに MIM_API_TOKEN を設定してください。環境変数のトークンはローカルに保存された認証情報より優先され、mim auth logout によって変更されることはありません。トークンは、シェル履歴やプロセス一覧から漏えいする可能性があるため、意図的にコマンドライン引数では受け付けません。

コマンド

コマンド	内容
mim setup	1つのコマンドでオンボーディングを行います。インストール確認、サインイン、プロジェクトの検出、見つかったすべてのエージェントへの MCP 登録、各手順の検証を実行します。
mim auth login [--no-open] [--force]	デバイスフローで認証します。強制しない限り、有効なトークンを再利用します。
mim auth status	アクティブなアカウント、プロジェクト、デフォルトプロジェクトを表示し、サーバーで検証します。
mim auth logout [--local-only]	保存済みの認証情報を取り消して削除するか、ローカルのコピーのみを削除します。
mim projects	認証済みアカウントで利用できるプロジェクト／サイトを一覧表示します。
mim projects use <key>	デフォルトのプロジェクトを保存し、コマンドで --project を指定する必要がなくなるようにします。
mim properties	プロジェクトの Google 接続から参照できる GA4 プロパティを、直近28日間のセッション数と現在の選択内容とともに一覧表示します。
mim properties use <id>	プロジェクトの接続から参照できることを検証したうえで、特定の GA4 プロパティをプロジェクトに設定します。
mim context	プロジェクトの成長コンテキストパックを出力します。
mim recordings	最近のセッションリプレイの概要を一覧表示します。
mim replay [session_id]	保存済みのリプレイインサイトを1件出力します。デフォルトでは最新のものを表示します。
mim findings	優先度順の監査結果を一覧表示します。
mim query-ga4 --metrics sessions	プロバイダーに対する読み取り専用の GA4 レポートを実行します。
mim query-gsc	プロバイダーに対する読み取り専用の Search Console クエリを実行します。
mim query-bq --sql <q>	プロジェクト独自の GA4 BigQuery エクスポートに対して、読み取り専用の SELECT を実行します（データセットとテーブルの日付を確認するには --describe を指定します）。
mim setup-analytics [--wait]	ホスト型の GA4 と Search Console のセットアップを開始します。
mim setup-analytics --status	ホスト型セットアップの進捗状況を確認します。
mim setup-analytics --channel agent	サーバー側をプロビジョニングし、エージェントが適用するスニペットを返します。
mim ads setup	ホスト型の Google Ads リソースを作成し、サイト所有者を管理者として招待します。
mim ads status	リンク済みの Ads アカウントとセットアップ状態を表示します。
mim ads query [--gaql <q>]	プロバイダーに対する読み取り専用の GAQL レポートを実行します。
mim posthog connect / query	PostHog を認証し、プロバイダーに対する読み取り専用の HogQL を実行します。
mim klaviyo connect / query	Klaviyo を認証し、プロバイダーに対する読み取り専用のレポートとチェックを実行します。
mim audit start <url> [--wait]	監査を開始します。必要に応じて完了までポーリングします。
mim audit rerun <url>	新しい監査を強制的に実行します。
mim audit status <id> / wait <id>	監査を確認またはポーリングします。
mim fixes list	修正可能な結果と PR／レビューの状態を一覧表示します。
mim fixes start <rank>	コード修正ワークフローをキューに追加します。
mim fixes open <rank>	PR、プレビュー、差分、レビュー、またはワークフローを開きます。
mim billing status / checkout / portal	プロジェクトの請求を管理します。
mim mcp install claude	mim MCP サーバーを Claude Code にユーザースコープで登録して検証します。登録できない場合は Claude Desktop に切り替えます。
mim mcp install codex / cursor / windsurf / desktop	エージェントの設定ファイルを書き込みます。既存の内容はバックアップします。代わりにブロックを出力するには --print を追加します。
mim mcp install all	このマシンで見つかったすべてのエージェントに登録します。

すべてのオプションを確認するには、mim --help を実行してください。

MCP

mim-mcp バイナリは、MCP の標準入出力メッセージを Mimetic のホスト型 Streamable HTTP エンドポイントに中継します。mim setup を実行すると、自動的に登録されます。MCP の部分だけを登録するには、次のコマンドを実行します。

mim mcp install all       # every agent found on this machine
mim mcp install claude    # registers with Claude Code at user scope, then verifies
mim mcp install codex     # writes ~/.codex/config.toml
mim mcp install cursor    # writes ~/.cursor/mcp.json
mim mcp install windsurf  # writes ~/.codeium/windsurf/mcp_config.json
mim mcp install desktop   # writes Claude Desktop's config file

ファイルへの書き込みは毎回、事前にバックアップを作成し、書き込み後に読み戻して確認します。また、ファイル内に既存の他の MCP サーバーがある場合は、その設定を保持します。Codex の設定は TOML 形式のため、ファイルを再解析して書き換えるのではなく、設定を末尾に追加します。これらのコマンドを複数回実行しても、設定は重複しません。書き込みを行わずに設定ブロックを確認するには、いずれかのコマンドに --print を追加します。

mim mcp install claude は、意図的にユーザースコープで登録します。Claude Code のデフォルトであるローカルスコープは、コマンドを実行したディレクトリにしか適用されないため、「成功した」と表示されてもセッションに反映されない最も一般的な原因となっています。登録後、CLI は claude mcp get mim を通じて設定を読み戻し、ホスト型エンドポイントにライブ呼び出しを行います。そのため、成功した場合はコマンドが終了コード 0 で終了しただけでなく、サーバーに到達できることも確認されています。

MCP の機能には、検出結果、匿名化されたリプレイインサイト、プロバイダーへの読み取り専用分析クエリに関する読み取りツールが含まれます。また、監査を開始したり、分析／広告リソースを作成・設定したり、レビュー可能な修正ワークフローを開始したりする、明示的に説明されたアクションツールも含まれます。アクションを承認する前に、ツールの説明とクライアントに表示される承認プロンプトを確認してください。

クライアントの設定、データフロー、リモート HTTP の設定、レジストリへの公開に関する注意事項については、docs/MCP.md を参照してください。

接続データへのアクセス

CLI と MCP ラッパーは Mimetic のホスト型 API のクライアントであり、お使いのコンピューターから Google、PostHog、Klaviyo に直接クエリを実行するものではありません。認証情報、ツールの引数、リクエストされたプロバイダーの結果は Mimetic のシステムを経由します。そのため、リクエストの処理中、Mimetic は接続された認証情報とデータに技術的にアクセスできます。コネクターの「読み取り専用」という表示は、サードパーティプロバイダーに対する権限を示すものであり、データが Mimetic から見えないことを意味するものではありません。

PostHog のクエリでは、接続されたプロジェクトで利用可能な一意の識別子やイベント／ユーザープロパティが返される場合があります。現在の Klaviyo コネクターは、プロフィールまたは書き込みスコープを要求しません。AI クライアントを通じてツールを呼び出した場合、返されたデータは、設定した AI クライアントとアカウントにも提供されます。

本番データを接続する前に、プライバシーポリシーと利用規約を確認してください。

トランスポートのセキュリティ

デフォルトでは、ベアラートークンは HTTPS URL にのみ送信されます。localhost、127.0.0.1、::1 などのループバックホストでは、プレーン HTTP が許可されます。特殊なローカル開発環境でのみ、MIM_ALLOW_INSECURE_HTTP=1 を明示的に設定してこの保護を無効にできます。本番環境の認証情報では使用しないでください。

環境

変数	用途
MIM_API_TOKEN	ベアラートークン。保存済みの認証情報より優先されます。
MIM_API_BASE_URL	API のオリジン。デフォルトは https://trymimetic.com です。
MIM_MCP_URL	MCP URL 全体。デフォルトは <API origin>/api/mim/mcp です。
MIM_PROJECT	デフォルトのプロジェクト／サイトキー。
MIM_CONFIG_DIR	認証情報のディレクトリ。デフォルトは ~/.mim です。
MIM_MCP_TIMEOUT_MS	MCP リクエストのタイムアウト。デフォルトは 30000 です。
MIM_TELEMETRY=0	メタデータのみを含む CLI／MCP 使用状況イベントを無効にします。
MIM_DISABLE_TELEMETRY=1	テレメトリを無効にする別の方法です。
MIM_ALLOW_INSECURE_HTTP=1	開発時に限り、ループバック以外への平文 HTTP を許可します。

メタデータテレメトリには、クライアントのバージョン、プロジェクト、コマンドまたはツール名、ステータス、所要時間、トレース ID、HTTP ステータス、上限付きの診断情報が含まれます。アクセストークン、クエリテキスト、MCP の引数、リプレイのナラティブ、プロバイダーの結果は含まれないように設計されています。テレメトリを無効にしても、ホスト型リクエストとその結果は引き続き Mimetic に送信されます。

開発

npm install
npm run typecheck
npm test
npm run build
npm pack --dry-run

MIT ライセンスに基づいてライセンスされています。Copyright © 2026 Mimetic Inc.