Posthog MCP

🚀 PostHog MCP サーバー 📊

PostHog とやり取りするためのモデルコンテキストプロトコル（MCP）サーバーです。Claude デスクトップから直接注釈を作成し、プロジェクトを管理できます！

✨ 主な機能

• プロジェクトの一覧表示：組織内の利用可能なすべての PostHog プロジェクトを表示します。
• 注釈の作成：PostHog プロジェクトに注釈を追加し、必要に応じてタイムスタンプを付けることができます。 [このリストはもっと長くなる可能性があります。基本的には、私たちの API が提供するすべての機能...]

📦 インストール

事前準備 🛠️

1. 前提条件
   • Python 3.10 以上
   • uv パッケージマネージャー
   • プロジェクト設定 から annotation:write と project:read の権限を持つ PostHog API キーを取得します。
2. インストール手順

   # リポジトリをクローン
   git clone git@github.com:PostHog/posthog-mcp.git
   
   # または https を使用：git clone https://github.com/PostHog/posthog-mcp.git
   
   cd posthog-mcp
   
   uv venv
   source .venv/bin/activate
   
   # 依存関係をインストール
   uv pip install .
   

3. 設定
   • プロジェクトのルートディレクトリに .env ファイルを作成します：

     PERSONAL_API_KEY=phx_your_posthog_api_key_here
     

4. Claude デスクトップの設定
   • Claude デスクトップ をインストールします。
   • Claude デスクトップの設定を開き、「編集設定」をクリックします。または、以下のファイルを直接開くこともできます：
     • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
     • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • 以下の内容を claude_desktop_config.json に追加します（システムに応じてパスを調整してください）：

     {
       "mcpServers": {
         "posthog": {
           "command": "/path/to/uv",  # このコマンドを実行して取得：which uv
           "args": [
             "--directory",
             "/path/to/your/posthog-mcp",  # このプロジェクトの完全なパス
             "run",
             "posthog_mcp"
           ]
         }
       }
     }
     

     最新のドキュメント を参照して、Claude デスクトップを MCP クライアントとして設定する際に問題が発生した場合の対処方法を確認してください。

💻 使用例

インストールが完了すると、Claude デスクトップにハンマー 🔨 アイコンが表示されます。以下のコマンドが使用可能です。

基本的な使用法

プロジェクトの一覧表示

Claude に以下のように問い合わせます：

"私の PostHog プロジェクトを一覧表示"

インサイトの取得と検索

Claude に以下のように問い合わせます： "私の PostHog インサイトを一覧表示" または "PostHog で収益インサイトを検索"

オンラインでドキュメントを検索

以下のように問い合わせることができます：

• "Next.js でリバースプロキシを使用して PostHog でどのように使用するか？"

注釈の作成

プロジェクト一覧から取得したプロジェクト ID を使用して、Claude に以下のように問い合わせます：

"プロジェクト 53497 で 'v1.2.3 をデプロイしました' という内容の PostHog 注釈を作成"

または、特定の日付を指定することもできます：

"プロジェクト 53497 で 3月20日 の '新しいマーケティングキャンペーンを開始' という内容の PostHog 注釈を作成"

トラブルシューティング 🔍

• ハンマーアイコンが表示されない場合は、Claude デスクトップを再起動してください。
• ログのパスを確認してください：
  • macOS：~/Library/Logs/Claude/mcp*.log
  • Windows：%APPDATA%\Claude\logs
• API キーが正しい権限を持っていることを確認してください。

💡 使用アドバイス

使用する前に、環境変数が正しく設定されていることと、ネットワーク接続が正常であることを確認してください。