Blog

PostHog MCPサーバーの使い方

Ashley Innocent

Ashley Innocent

16 6月 2025

PostHog MCPサーバーの使い方

PostHog MCPサーバーは、PostHogの強力な分析プラットフォームをClaude DesktopやCursorのようなAI強化環境と統合するための堅牢なツールとして際立っています。モデルコンテキストプロトコル（MCP）サーバーにより、開発者は自然言語コマンドを使用して、プロジェクト管理、アノテーション作成、フィーチャーフラグクエリ、エラー分析など、PostHogの機能と対話できます。このシームレスな統合により、手作業が減り、エラーが最小限に抑えられ、ワークフローが加速されるため、開発者とデータチームの両方にとって不可欠なツールとなります。

💡
このセットアップ中のAPI操作を強化するために、PostHogのエンドポイントの操作を簡素化する無料のAPIテストツールであるApidogをお勧めします。Apidogを無料でダウンロードして、PostHog MCPサーバーでのエクスペリエンスを効率化しましょう。
button

PostHog MCPサーバーを理解する

PostHog MCPサーバーは、モデルコンテキストプロトコルを活用してPostHogの分析機能とAIパワードツールを橋渡しする特殊なサーバーです。これにより、開発者はサポートされているデスクトップクライアント内で直感的な自然言語入力を使用して、プロジェクトのリスト表示、タイムスタンプ付きアノテーションの作成、フィーチャーフラグのクエリ、エラーの分析などの複雑なタスクを実行できます。これらのインタラクションを自動化することで、サーバーは反復的な手作業を排除し、データの精度を確保します。

PostHog MCPサーバーの概要図

さらに、PostHog MCPサーバーはローカルまたはコンテナ化されたサービスとして動作し、PostHogデータをAIエージェントセッションに直接パイプします。この統合により、開発環境を離れることなくリアルタイムの分析管理が可能になり、生産性と意思決定が向上します。例えば、フィーチャーフラグを確認するためにPostHogのUIを操作する代わりに、AIツールで直接クエリを実行し、構造化された応答を即座に受け取ることができます。

次に、サーバーをセットアップするための前提条件を準備しましょう。

PostHog MCPサーバーを使用するための前提条件

PostHog MCPサーバーを設定する前に、以下のツールとリソースが揃っていることを確認してください。

button
Apidogのメインインターフェースのスクリーンショット

これらの前提条件が整ったら、サーバーをインストールする準備ができました。

PostHog MCPサーバーのインストール：ステップバイステップ

PostHog MCPサーバーのセットアップには、リポジトリのクローン、環境の設定、依存関係のインストールが含まれます。スムーズなインストールを確実にするために、以下の手順に従ってください。

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

まず、公式のPostHog MCPリポジトリをGitHubからクローンします。ターミナルを開き、以下を実行します。

git clone git@github.com:PostHog/posthog-mcp.git

HTTPSを好む場合やSSHアクセスがない場合は、以下を使用します。

git clone https://github.com/PostHog/posthog-mcp.git

プロジェクトディレクトリに移動します。

cd posthog-mcp

2. 仮想環境を作成する

依存関係を分離するために、uvを使用してPython仮想環境をセットアップします。以下を実行します。

uv venv
source .venv/bin/activate

Windowsユーザーの場合は、以下で環境をアクティベートします。

.\.venv\Scripts\activate

これにより、依存関係がシステムのPythonパッケージと競合しないことが保証されます。

3. Python依存関係をインストールする

以下のコマンドを実行して必要なパッケージをインストールします。

uv pip install .

このコマンドは、PostHog MCPサーバーとその依存関係をインストールし、Pythonバージョンとの互換性を確保します。

4. PostHog APIキーを設定する

PostHogの設定から個人用APIキーを取得します。

PostHog設定パネルでAPIキーを生成する場所を示すスクリーンショット

プロジェクトルートに.envファイルを作成し、以下を追加します。

POSTHOG_API_TOKEN=Bearer your-personal-api-key

your-personal-api-keyを実際のキーに置き換えます。このトークンは、PostHogのAPIエンドポイントでサーバーを認証します。

5. サーバーをローカルでテストする

サーバーを起動してインストールを確認します。

uv run posthog_mcp

成功すると、ターミナルにサーバーが実行中であることを示すメッセージが表示されます（通常はlocalhost:8000）。エラーが発生した場合は、APIキー、依存関係、Pythonバージョンを再確認してください。

6. オプション：Dockerコンテナで実行する

コンテナ化されたセットアップの場合は、公式のPostHog MCPイメージをプルし、APIキーを指定して実行します。

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

このアプローチはサーバーを分離するため、本番環境やテスト環境に最適です。

サーバーがインストールされたら、デスクトップクライアントを構成して接続しましょう。

PostHog MCPサーバー用のデスクトップクライアントを構成する

PostHog MCPサーバーは、Claude Desktop、Cursor、またはWindsurfなどのデスクトップクライアントと統合されます。以下では、構成プロセスを示す例としてClaude Desktopを使用します。

1. 構成ファイルを見つける

Claude Desktopで、「Settings」に移動し、「Edit Config」を選択します。または、手動で構成ファイルを見つけます。

2. PostHog MCPサーバー構成を追加する

構成ファイルを編集して、PostHog MCPサーバーを含めます。以下のJSONを挿入します。

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

/path/to/uvをuvへの絶対パス（which uvで見つける）に置き換え、/path/to/your/posthog-mcpをクローンしたリポジトリへのフルパスに置き換えます。

3. Claude Desktopを保存して再起動する

構成ファイルを保存し、Claude Desktopを再起動します。インターフェースにハンマーアイコン（🔨）が表示され、MCPサーバーがアクティブであることを示します。表示されない場合は、以下のログを確認してください。

4. 接続をテストする

セットアップを確認するために、Claude Desktopで自然言語コマンドを入力します。例えば：

List all PostHog projects in my organization

サーバーはPostHogプロジェクトのリストで応答し、統合が成功したことを確認します。

5. 代替クライアントを構成する（オプション）

CursorまたはWindsurfの場合は、MCPサーバーの統合に関するドキュメントを参照してください。プロセスは通常、PostHog MCPサーバー実行可能ファイルを指す同様の構成詳細を追加することを含みます。

クライアントが接続されたら、サーバーを効果的に使用する方法を探求しましょう。

PostHog MCPサーバーの実践的な使用例

PostHog MCPサーバーは、分析タスクの自動化と簡素化に優れています。以下に、その機能を示す5つの実践的なシナリオを紹介します。

1. タイムスタンプ付きアノテーションを作成する

PostHogのアノテーションは、製品のリリースやマーケティングキャンペーンなどの重要なイベントをマークします。MCPサーバーを使用して、アノテーションを簡単に作成できます。Claude Desktopで、以下を入力します。

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

サーバーはコマンドを処理し、PostHogのAPIと対話し、指定されたタイムスタンプと説明付きでアノテーションを追加します。

2. フィーチャーフラグをクエリおよび管理する

フィーチャーフラグを使用すると、アプリケーションの機能を動的に制御できます。手動でフラグを確認する代わりに、以下でクエリを実行します。

List all active feature flags in project 12345

サーバーは、フラグの名前と説明を含むリストを返します。さらに、以下のように尋ねることで拡張できます。

Generate a Python snippet to toggle feature flag 'new-ui' in project 12345

MCPサーバーは、PostHogのAPIを活用したコードを提供し、アプリケーションに統合できます。

3. アプリケーションエラーを分析する

開発環境を離れることなくエラーを追跡およびデバッグします。コマンド：

Show the top 5 recent errors in project 67890 with their stack traces

サーバーはPostHogのエラートラッキングデータをクエリし、詳細なサマリーを返します。これを使用して問題を迅速に特定および解決できます。

4. PostHogプロジェクトを管理する

複数のPostHogプロジェクトを持つ組織にとって、MCPサーバーは監視を簡素化します。例えば：

List all projects in my PostHog organization with their creation dates

サーバーはプロジェクトのメタデータを取得し、リソースの管理や使用状況の監査に役立ちます。

5. インサイトクエリを自動化する

PostHogのインサイト機能を使用すると、ユーザーの行動を分析できます。MCPサーバーを使用してインサイトを直接クエリします。

Show the trend of user sign-ups in project 98765 over the last 30 days

サーバーはデータを取得し、構造化された形式で提示するため、さらなる分析やレポート作成にすぐに使用できます。

これらの使用例は、サーバーが分析ワークフローを効率化する上での多才さを示しています。次に、パフォーマンスを最適化しましょう。

PostHog MCPサーバーのパフォーマンスを最適化する

PostHog MCPサーバーの効率を最大限に高めるために、以下のベストプラクティスを実装してください。

1. APIキーを保護する

スクリプトや構成ファイルにPostHog APIキーをハードコードしないでください。環境変数（例：.envファイル）を使用し、キーのスコープを必要なエンドポイントに限定します。Apidogでキーの権限をテストし、露出を最小限に抑えます。

2. リソース使用量を監視および制限する

MCPサーバーは、特にAPIインタラクションが重い場合、かなりのCPUとメモリを消費する可能性があります。htopやDockerのリソース制限などのツールを使用してシステムパフォーマンスを監視します。コンテナ化されたセットアップの場合、以下でリソースを制限します。

docker run -i --rm --memory="512m" --cpus="1" -e PERSONAL_API_KEY=your-personal-api-key ghcr.io/metorial/mcp-container--posthog--posthog-mcp--posthog-mcp posthog-mcp

3. サーバーを最新の状態に保つ

PostHog MCPリポジトリは、新機能、バグ修正、API互換性のために頻繁に更新されます。以下で定期的に変更をプルします。

git pull origin main
uv pip install .

最新情報を得るために、GitHubリポジトリのリリースノートを確認してください。

4. ストリーマブルHTTPトランスポートを使用する

サーバーは非推奨のServer-Sent Events（SSE）プロトコルをサポートしていますが、Streamable HTTPトランスポートを使用するとパフォーマンスが向上します。サポートされている場合は、クライアント構成を更新してStreamable HTTPを使用し、遅延を減らし、信頼性を向上させます。

5. API応答をローカルでキャッシュする

頻繁にアクセスされるデータ（例：プロジェクトリスト）については、ローカルキャッシュを実装してAPI呼び出しを減らします。PostHogのAPIレート制限への準拠を確保しながら、サーバーのコードを変更してSQLiteのような軽量データベースに応答を保存します。

6. ロードバランサーでスケーリングする

複数の開発者がいるチームの場合、PostHog MCPサーバーをロードバランサーの背後にデプロイしてリクエストを分散させます。NginxやHAProxyなどのツールを使用してトラフィックを管理し、高可用性を確保します。

これらの最適化を適用することで、サーバーのパフォーマンスと信頼性が向上します。次に、一般的な問題に対処しましょう。

PostHog MCPサーバーの一般的な問題のトラブルシューティング

注意深くセットアップしても、問題に遭遇する可能性があります。以下に、一般的な問題とその解決策を示します。

1. Claude Desktopでハンマーアイコンが表示されない

ハンマーアイコン（🔨）が表示されない場合は、以下を確認してください。

詳細なエラーについては、~/Library/Logs/Claude/mcp*.log（macOS）または%APPDATA%\Claude\logs（Windows）のログを確認してください。

2. 認証失敗

サーバーが認証に失敗する場合は、.envファイルのPOSTHOG_API_TOKENが正しいこと、およびBearerがプレフィックスとして付いていることを確認してください。Apidogを使用して、https://app.posthog.com/api/projectsへのGETリクエストを実行してキーをテストします。

3. 依存関係のインストールエラー

uv pip installが競合により失敗する場合は、仮想環境をリセットします。

rm -rf .venv
uv venv
source .venv/bin/activate
uv pip install .

Pythonバージョンが3.8以降であることを確認してください。

4. サーバーが遅いまたは応答しない

サーバーが遅い場合は、以下を確認してください。

問題を分離するために、サーバーを再起動するか、コンテナ化されたセットアップに切り替えます。

5. クライアントバージョンの非互換性

デスクトップクライアント（例：Claude Desktop）がサーバーで使用されているMCPプロトコルバージョンをサポートしていることを確認してください。クライアントのドキュメントを確認し、必要に応じて最新バージョンに更新します。

6. レート制限超過エラー

PostHogのAPIはレート制限を適用しています。429 Too Many Requestsエラーが発生した場合は、サーバーのコードに指数バックオフを実装するか、クエリ頻度を減らしてください。必要に応じてPostHogサポートに連絡して、制限の引き上げをリクエストしてください。

これらの解決策はほとんどの問題を解決し、スムーズな運用を保証するはずです。結論に進みましょう。

結論

PostHog MCPサーバーは、開発者とデータチームがPostHogの分析プラットフォームと対話する方法に革命をもたらします。自然言語コマンドを使用してプロジェクトを管理し、アノテーションを作成し、フィーチャーフラグをクエリし、エラーを分析し、インサイトを取得することで、ワークフローを効率化し、生産性を向上させます。この包括的なガイドでは、インストール、構成、実践的な使用例、最適化戦略、トラブルシューティングについて説明し、サーバーの可能性を最大限に活用するための準備を整えました。

セットアップ中のAPIテストを簡素化するために、Apidogを無料でダウンロードしてください。PostHog APIエンドポイントを検証するための直感的なインターフェースを提供することで、PostHog MCPサーバーを補完します。

button
PostHog MCPサーバーとApidogの連携を示すアニメーション画像

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

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

無料会員登録ダウンロード