PostHog MCP Server (Official)

PostHog MCP Server (Official) とは？

PostHog MCP server は、PostHog が公式に提供する無料のホスト型 Model Context Protocol エンドポイント（https://mcp.posthog.com/mcp）です。AI エージェントが PostHog プロジェクトで分析データのクエリ、SQL の実行、feature flag や実験の管理、エラーのトリアージを行えるようにします。

リモートサーバーなので、ローカルで何かを動かす必要はありません。Claude Code、Claude Desktop、Cursor、Codex、VS Code、Windsurf、Zed などの MCP クライアントに URL を追加し、OAuth で PostHog にサインインすれば、エージェントが PostHog の各プロダクトを読み書きできます。ソースは PostHog monorepo の services/mcp にあり、旧 PostHog/mcp リポジトリは現在そこを案内しているだけです。

PostHog MCP Server (Official) の使い方

PostHog アカウント（US または EU Cloud）が必要です。OAuth 対応クライアントでは API key は不要です。エージェントが初めてサーバーを使うときにブラウザが開いてログインを求められ、PostHog の認証サーバーが正しいデータリージョンへ自動でルーティングします。

最も手早いのは PostHog Wizard を使う方法で、PostHog MCP server を PostHog Desktop、Cursor、Claude Code、Claude Desktop、Codex、VS Code、Zed にインストールできます。

npx @posthog/wizard mcp add

Claude Code

claude mcp add --transport http posthog https://mcp.posthog.com/mcp -s user

または PostHog プラグインをインストールします。同じツールに加えて、/posthog:flags、/posthog:insights、/posthog:errors などのスラッシュコマンドが使えます。

claude plugin install posthog

インストール後に /mcp を実行し、ブラウザの案内に従ってログインします。

Claude Desktop

Claude のコネクタディレクトリにある PostHog connector で Connect をクリックします。手動で設定する場合は Settings > Developer > Edit Config を開いて次を追加します。

{
  "mcpServers": {
    "posthog": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.posthog.com/mcp"]
    }
  }
}

Cursor

Cursor Marketplace から PostHog プラグインをインストールするか、Cursor Settings > Tools & Integrations > New MCP Server で mcp.json に次を追加します。

{
  "mcpServers": {
    "posthog": {
      "url": "https://mcp.posthog.com/mcp"
    }
  }
}

VS Code

コマンドパレットで MCP: Open User Configuration を実行し、次を追加します。

{
  "servers": {
    "posthog": {
      "type": "http",
      "url": "https://mcp.posthog.com/mcp"
    }
  }
}

以降、Copilot chat でサーバーが使えるようになります。

Codex

codex mcp add posthog --url https://mcp.posthog.com/mcp

Codex はネイティブで OAuth に対応しているため、初回利用時にログインを求められます。

Windsurf

Windsurf Settings > Cascade > MCP Servers > Manage MCP Servers > View raw config を開き、Claude Desktop の項で示した mcp-remote ブロックを mcp_config.json に追加します。

OAuth の代わりに API key を使う

クライアントが OAuth に対応していない場合は、MCP Server プリセットで personal API key を作成し、ヘッダーで送信します。

{
  "mcpServers": {
    "posthog": {
      "url": "https://mcp.posthog.com/mcp",
      "headers": {
        "Authorization": "Bearer ${POSTHOG_API_KEY}"
      }
    }
  }
}

PostHog MCP Server (Official) の主な機能

• PostHog が公式に保守し、単一の Streamable HTTP エンドポイントでホストされています。
• OAuth サインインと US/EU リージョンへの自動ルーティング。personal API key も代替手段として利用可能。
• 分析、SQL（HogQL）、ダッシュボード、インサイト、feature flag、実験、サーベイ、session replay、エラートラッキング、ログ、CDP destination、サポートチケットをカバー。
• 2 つのツールモード：CLI モードはトークンを節約する単一の exec ツールを公開し、tools モードはすべてのツールを個別に登録します。モードは自動検出され、?mode=cli または ?mode=tools で上書きできます。
• ?readonly=true または x-posthog-read-only ヘッダーで読み取り専用セッションにできます。
• カテゴリ（?features=flags,dashboards,insights）や正確な名前（?tools=dashboard-get,execute-sql）でツールを絞り込めます。
• x-posthog-organization-id と x-posthog-project-id ヘッダーでコンテキストを固定できます。
• プロキシとして動作し、分析データは保存しません。

PostHog MCP Server (Official) のツール

サーバーは数百のツールを公開しており、PostHog のプロダクトごとに分類されています。

• 分析と SQL：execute-sql は SQL クエリを実行し、query-trends や query-funnel などのクエリツールはインサイト形式のクエリを実行します。ダッシュボード系ツール（dashboard-get、dashboard-create、dashboards-get-all）でダッシュボードの参照と作成ができます。
• Feature flag と実験：feature-flag-get-all、create-feature-flag、update-feature-flag、experiment-create、experiment-results-get により、エージェントがロールアウトを公開・評価できます。
• エラートラッキング：query-error-tracking-issues-list や error-tracking-issues-partial-update などで issue の一覧表示、確認、アサイン、解決ができます。
• ユーザーとデータ：persons-list、cohorts-create、session-recording-get、surveys-get-all、survey-create。
• ログ：query-logs と関連するログツールでクエリやアラート設定ができます。
• ワークスペースとドキュメント：switch-organization、switch-project、projects-get、そして PostHog ドキュメントを検索する docs-search。

CLI モードでは、エージェントは exec を使ってこれらのツールを必要に応じて検索・確認・呼び出します。MCP apps に対応したクライアントでは、render-ui で可視化を描画できます。

PostHog MCP Server (Official) のユースケース

• エディタから本番エラーをデバッグ：「今週プロジェクトで多いエラーのトップ 5 は？」、続けて「最新のクラッシュのスタックトレース全体を表示して、修正案を出して」。
• プロンプトから feature flag を公開：「new-checkout という flag を作成して、ユーザーの 10% に公開して」。
• 自然言語や SQL でプロダクトについて質問：「先週のサインアップ数を国別に教えて」。
• 実験結果を確認：「pricing-page 実験の結果を要約して」。
• issue のトリアージと担当割り当て：「この issue を解決済みにして、今後の TypeError はすべてバックエンドチームにアサインして」。
• ダッシュボードの作成：「デイリーアクティブユーザーとサインアップファネルを含むダッシュボードを作って」。

PostHog MCP Server (Official) と代替ツールの比較

• Google Analytics MCP Server は GA4 レポートの読み取りが中心です。PostHog MCP server は flag、実験、ダッシュボード、サーベイの書き込みも可能です。
• Sentry MCP Server (Official) はエラー監視に特化しています。PostHog は 1 つの接続でエラートラッキングとプロダクト分析の両方を扱えます。
• Grafana MCP Server (Official) はプロダクト分析ではなく、オブザーバビリティのダッシュボードとメトリクスが対象です。

PostHog MCP Server (Official) のトラブルシューティング

• クライアントが OAuth 非対応：MCP Server プリセットの personal API key を Authorization: Bearer ヘッダーで使うか、mcp-remote ブリッジを使います。
• エージェントが別のプロジェクトに書き込む：x-posthog-project-id で接続を固定する（switch-* ツールも除外されます）か、プロジェクトごとに名前を付けたサーバーエントリを追加します。
• アカウントやリージョンが 2 つある：アカウントごとに別の接続を追加します。共有ブラウザセッションで OAuth を使うと、両方を同じアカウントで認可してしまいがちです。エントリごとの API key で防げます。
• ツールが多すぎる・コンテキストを使いすぎる：CLI モード（?mode=cli）を使うか、features/tools で絞り込みます。
• AI 機能付きのツールが表示されない：組織設定で AI データ処理を有効にした場合にのみ表示されます。