PostHog MCPサーバー入門

Ashley Goolam

Ashley Goolam

30 6月 2025

PostHog MCPサーバー入門

AIでデータ活用を強化する準備はできていますか?PostHog MCP Serverを使えば、ClineやCursorのようなツールで自然言語を使って、アノテーションの作成やユーザー動向のクエリなど、PostHogアナリティクスを管理できます。わずか数分で稼働させることができ、まさにゲームチェンジャーです!このチュートリアルでは、VS CodeとCursorのClineにPostHog MCP Serverをインストールし、その優れた機能を探索し、オープンソースアナリティクスにおいてPostHogがGoogle Analyticsを凌駕する理由を見ていきます。さあ、PostHog MCP Serverの魔法に飛び込みましょう!

💡
美しいAPIドキュメントを生成する優れたAPIテストツールをお探しですか?

最高の生産性で開発チームが協力できる統合されたオールインワンプラットフォームをお探しですか?

Apidogはあなたのすべての要求に応え、Postmanをはるかに手頃な価格で置き換えます
button

PostHog MCP Serverとは?

PostHog MCP Serverは、AIアシスタント(ClineやCursorなど)を自然言語コマンドを介してPostHogのアナリティクスプラットフォームに接続するオープンソースのモデルコンテキストプロトコル(MCP)サーバーです。PostHogのUIに触れることなく、アノテーションの作成、プロジェクトの管理、インサイトのクエリ、機能フラグの切り替えなどのタスクを可能にします。主な機能は以下の通りです。

これはアナリティクス自動化の「必須アイテム」であり、34以上のGitHubスターがコミュニティからの支持を示しています。試してみる準備はできましたか?さあ、始めましょう

公式サイト

PostHog MCP Serverを使用する理由

PostHog MCP Serverは、AI駆動の自動化によりアナリティクスワークフローを簡素化します。その優れた点は以下の通りです。

Google Analyticsと比較して、PostHogはそのオープンソースの透明性、セルフホスティングの柔軟性、そしてオールインワンの製品スイート(アナリティクス、セッションリプレイ、機能フラグ)で際立っています。Google Analyticsはしばしばサードパーティの統合を必要とし、PostHogのプライバシー重視の姿勢が欠けているため、PostHog MCP Serverは現代のチームにとって開発者フレンドリーな代替手段となります。

私はこれを使って製品リリースを数秒でアノテーションしました。ダッシュボードをクリックするよりもはるかに速いです!

PostHog MCP Serverのインストールと使用方法:ステップバイステップガイド

VS CodeとCursorのClineにPostHog MCP Serverをインストールし、例を使ってテストしてみましょう。Python、PostHog APIキー、そしてIDEが必要です。アナリティクスの専門家である必要はありません。一緒に進めましょう!

1. 前提条件

2. PostHog MCPリポジトリをクローンする

ターミナルを開き、リポジトリをクローンします。

git clone https://github.com/PostHog/mcp.git
cd mcp

これにより約5MBのプロジェクトがプルされます。Wi-Fiで数秒かかりました。

3. VS CodeのClineでPostHog MCP Serverをインストールする

uv venv
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate  # Windows
uv pip install .
echo "PERSONAL_API_KEY=your-personal-api-key" > .env

your-personal-api-keyをPostHog APIキー(公式サイトから取得できます)に置き換えてください。

Clineをインストール
Install the PostHog MCP Server using uv and configure it with my API key.

Clineはuv run posthog_mcpを実行し、~/.aws/amazonq/mcp.jsonを更新します。

{
  "mcpServers": {
    "posthog": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp", "run", "posthog_mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

/path/to/mcpをリポジトリのパス(例:/home/user/mcp)に置き換えてください。

MCPサーバーはClineのMCPマーケットプレイスでも見つけることができます。そちらにアクセスして「PostHog」を検索し、インストールをクリックするだけです。

PostHog MCPサーバーをインストール

Clineが自動的にインストールを実行します。

MCPサーバーアイコン

4. CursorでPostHog MCP Serverをインストールする

Cursor MCPサーバー
{
  "mcpServers": {
    "posthog": {
      "command": "/path/to/uv",
      "args": ["--directory", "/path/to/mcp", "run", "posthog_mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

uvのパスはwhich uv(macOS/Linux)またはwhere uv(Windows)で確認できます。

5. PostHog MCP Serverの機能をテストする

Create a PostHog annotation in project 53497 for March 20th, 2025, with the description 'Launched new user onboarding flow' using the PostHog MCP Server.

サーバーはPostHogのAPIを呼び出し、アノテーションを追加します。app.posthog.comで確認してください。

Show the trend of user sign-ups in project 98765 over the last 30 days using 
the PostHog MCP Server.

サーバーは構造化データ(例:サインアップ傾向を含むJSON)を取得します。出力例:

{
  "insight": "user_signups",
  "project_id": 98765,
  "data": [
    {"date": "2025-06-01", "count": 120},
    {"date": "2025-06-02", "count": 135}
  ]
}

これを実行したところ、約5秒でクリーンなデータが得られました。非常にスムーズです。

6. コンテナ化されたセットアップ(オプション)

Docker

Dockerセットアップの場合:

docker run -i --rm -e PERSONAL_API_KEY=your-personal-api-key ghcr.io/metorial/mcp-container--posthog--posthog-mcp--posthog-mcp posthog-mcp

Cline/Cursorのmcp.jsonに追加します。

{
  "mcpServers": {
    "posthog": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/metorial/mcp-container--posthog--posthog-mcp--posthog-mcp", "posthog-mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

上記のように再起動して確認します。Dockerのクリーンアップ(--rm)により、ディスク容量を節約できました。

7. よくある問題のトラブルシューティング

PostHogがGoogle Analyticsを凌駕する理由

PostHogのPostHog MCP Serverは、そのプラットフォームと統合されており、Google Analyticsを以下の点で凌駕しています。

私はサイドプロジェクトをPostHogに切り替えましたが、プライバシーと機能フラグの制御が気に入りました。Google Analyticsのような余計な機能はありません!

PostHog MCP Serverのカスタマイズと拡張

セットアップをレベルアップしましょう。

Generate a Python snippet to toggle feature flag 'new-ui' in project 12345
using the PostHog MCP Server.

PostHog MCP Serverが開発者にとって必須である理由

PostHog MCP Serverは、アナリティクス自動化をデータのエキスパートとチャットしているかのように感じさせます。その自然言語インターフェースとPostHogのオープンソースの優位性は、プライバシーを重視するチームにとってGoogle Analyticsを凌駕します。セットアップは手間がかかることもありますが(APIキーの問題など!)、PostHogのドキュメントとコミュニティは救世主です。

PostHog MCP Serverを使いこなす準備はできましたか?ClineまたはCursorを起動し、インサイトをクエリし、アナリティクスでの成功を共有してください。あなたのセットアップが輝くのを見るのが楽しみです!

💡
美しいAPIドキュメントを生成する優れたAPIテストツールをお探しですか?

最高の生産性で開発チームが協力できる統合されたオールインワンプラットフォームをお探しですか?

Apidogはあなたのすべての要求に応え、Postmanをはるかに手頃な価格で置き換えます
button

ApidogでAPIデザイン中心のアプローチを取る

APIの開発と利用をよりシンプルなことにする方法を発見できる