AIでデータ活用を強化する準備はできていますか?PostHog MCP Serverを使えば、ClineやCursorのようなツールで自然言語を使って、アノテーションの作成やユーザー動向のクエリなど、PostHogアナリティクスを管理できます。わずか数分で稼働させることができ、まさにゲームチェンジャーです!このチュートリアルでは、VS CodeとCursorのClineにPostHog MCP Serverをインストールし、その優れた機能を探索し、オープンソースアナリティクスにおいてPostHogがGoogle Analyticsを凌駕する理由を見ていきます。さあ、PostHog MCP Serverの魔法に飛び込みましょう!
最高の生産性で開発チームが協力できる統合されたオールインワンプラットフォームをお探しですか?
Apidogはあなたのすべての要求に応え、Postmanをはるかに手頃な価格で置き換えます!
PostHog MCP Serverとは?
PostHog MCP Serverは、AIアシスタント(ClineやCursorなど)を自然言語コマンドを介してPostHogのアナリティクスプラットフォームに接続するオープンソースのモデルコンテキストプロトコル(MCP)サーバーです。PostHogのUIに触れることなく、アノテーションの作成、プロジェクトの管理、インサイトのクエリ、機能フラグの切り替えなどのタスクを可能にします。主な機能は以下の通りです。
- プロジェクト管理: PostHogプロジェクトをリストアップし、管理します。
- アノテーション: イベント(例:製品リリース)にタイムスタンプ付きのメモを追加します。
- インサイトクエリ: ユーザー行動(例:サインアップ傾向)を分析します。
- 機能フラグ: 機能フラグを動的に制御し、クエリします。
- エラー追跡: IDE内で直接エラーをデバッグします。
これはアナリティクス自動化の「必須アイテム」であり、34以上のGitHubスターがコミュニティからの支持を示しています。試してみる準備はできましたか?さあ、始めましょう

PostHog MCP Serverを使用する理由
PostHog MCP Serverは、AI駆動の自動化によりアナリティクスワークフローを簡素化します。その優れた点は以下の通りです。
- 自然言語: シンプルなコマンドでアナリティクスを管理します。
- 統合: Claude Desktop、VS Code、Cursorなどと連携します。
- オープンソース(最高の部分):無料でカスタマイズ可能、コミュニティ主導です。
- プライバシー優先: Google Analyticsとは異なり、PostHogは完全なデータ制御のためのセルフホストオプションを提供します。
Google Analyticsと比較して、PostHogはそのオープンソースの透明性、セルフホスティングの柔軟性、そしてオールインワンの製品スイート(アナリティクス、セッションリプレイ、機能フラグ)で際立っています。Google Analyticsはしばしばサードパーティの統合を必要とし、PostHogのプライバシー重視の姿勢が欠けているため、PostHog MCP Serverは現代のチームにとって開発者フレンドリーな代替手段となります。
私はこれを使って製品リリースを数秒でアノテーションしました。ダッシュボードをクリックするよりもはるかに速いです!
PostHog MCP Serverのインストールと使用方法:ステップバイステップガイド
VS CodeとCursorのClineにPostHog MCP Serverをインストールし、例を使ってテストしてみましょう。Python、PostHog APIキー、そしてIDEが必要です。アナリティクスの専門家である必要はありません。一緒に進めましょう!
1. 前提条件
- Python: 3.8以上(
python3 --version
)。 - uv: Pythonパッケージマネージャー(
pip install uv
)。 - VS Code/Cursor: Cline拡張機能がインストールされた最新バージョン。
- PostHog APIキー: app.posthog.com/settingsから取得(パーソナルAPIキー)。
- Docker: コンテナ化されたセットアップにはオプション(
docker --version
)。 - ディスク容量: リポジトリと依存関係のために約500MB。
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 .
- APIキーの設定:
プロジェクトルートに.env
ファイルを作成します。
echo "PERSONAL_API_KEY=your-personal-api-key" > .env
your-personal-api-key
をPostHog APIキー(公式サイトから取得できます)に置き換えてください。
- Clineのインストール:
VS Codeで拡張機能(Ctrl+Shift+X)に移動し、Clineをインストールし、Clineチャットパネル(Ctrl+Shift+P、「Cline: Open Chat」)を開きます。

- MCPサーバーの追加:
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」を検索し、インストールをクリックするだけです。

Clineが自動的にインストールを実行します。
- 確認: Clineのチャットで
/tools
を実行してツール(例:create_annotation
、list_projects
)をリストします。ClineのMCPサーバーアイコンが見えますか?これで準備完了です。

4. CursorでPostHog MCP Serverをインストールする
- クローンとインストール: ステップ2のクローンと仮想環境のセットアップを繰り返します。
- Cursorの設定:
Cursorを開き、Settings > Tools & Integrations > MCP Tools > Add a Custom MCP Serverに移動し、サーバー設定を.cursor/mcp.json
に追加します。

{
"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)で確認できます。
- Cursorの再起動: Settings > Tools & Integrations > MCP Toolsの更新ボタンをクリックします。
- 確認: Cursorに「利用可能なPostHog MCP Serverツールをリストして」と尋ねます。
create_annotation
、list_projects
などが表示されるはずです。
5. PostHog MCP Serverの機能をテストする
- アノテーションの作成:
Cline(VS Code)またはCursorで、次のようにプロンプトします。
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 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. よくある問題のトラブルシューティング
- ハンマーアイコンがない:
- ログを確認してください:
~/Library/Logs/Claude/mcp*.log
(macOS) または%APPDATA%\Claude\logs
(Windows)。 mcp.json
に絶対パスが指定されていることを確認してください。- APIキーのエラー:
- app.posthog.com/settingsでキーの権限を確認してください。
- ハードコードされたキーではなく、環境変数を使用してください。
- サーバーが実行されていない:
uv run posthog_mcp
を手動で実行してエラーを確認してください。- Python 3.8以上と依存関係(
uv pip install .
)が揃っていることを確認してください。 - ヘルプが必要ですか? ヒントについてはgithub.com/PostHog/mcpまたはXを確認してください。
PostHogがGoogle Analyticsを凌駕する理由
PostHogのPostHog MCP Serverは、そのプラットフォームと統合されており、Google Analyticsを以下の点で凌駕しています。
- オープンソース: Google Analyticsのプロプライエタリなロックインとは異なり、無料でセルフホストできます。
- プライバシー: セルフホストインスタンスでデータを制御できます。Google AnalyticsはデータをGoogleと共有します。
- オールインワン: アナリティクス、セッションリプレイ、機能フラグ、実験が1つのプラットフォームに統合されています。Googleの断片化されたツールとは対照的です。
- 自動化: PostHog MCP Serverは自然言語クエリを可能にします。Google Analyticsの手動ダッシュボードとは異なります。
- コミュニティ: 1,500以上のGitHubスターと活発なサポートがあり、Googleに匹敵しますが、オープンソースの柔軟性があります。
私はサイドプロジェクトをPostHogに切り替えましたが、プライバシーと機能フラグの制御が気に入りました。Google Analyticsのような余計な機能はありません!
PostHog MCP Serverのカスタマイズと拡張
セットアップをレベルアップしましょう。
- カスタムツール: github.com/PostHog/mcpを介して、新しいツール(例:カスタムSQLインサイト)をサーバーに追加します。
- 複数のプロジェクト: 「PostHog組織内のすべてのプロジェクトをリストして」で、すべてのプロジェクトをクエリします。
- 機能フラグ: フラグを切り替えるコードを生成します。
Generate a Python snippet to toggle feature flag 'new-ui' in project 12345
using the PostHog MCP Server.
- 貢献: サーバーを強化するためのPRを提出してください。PostHogはそれらを歓迎します。
PostHog MCP Serverが開発者にとって必須である理由
PostHog MCP Serverは、アナリティクス自動化をデータのエキスパートとチャットしているかのように感じさせます。その自然言語インターフェースとPostHogのオープンソースの優位性は、プライバシーを重視するチームにとってGoogle Analyticsを凌駕します。セットアップは手間がかかることもありますが(APIキーの問題など!)、PostHogのドキュメントとコミュニティは救世主です。
PostHog MCP Serverを使いこなす準備はできましたか?ClineまたはCursorを起動し、インサイトをクエリし、アナリティクスでの成功を共有してください。あなたのセットアップが輝くのを見るのが楽しみです!
最高の生産性で開発チームが協力できる統合されたオールインワンプラットフォームをお探しですか?
Apidogはあなたのすべての要求に応え、Postmanをはるかに手頃な価格で置き換えます!