Posthog

🚀 PostHog MCP サーバー 📊

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

✨ 主な機能

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

📦 インストール

前提条件

• Python 3.10 以上
• uv パッケージマネージャー
• annotation:write と project:read の権限を持つ PostHog API キー。プロジェクト設定 から取得します。

インストール手順

# リポジトリをクローンします
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 .

設定

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

PERSONAL_API_KEY=phx_your_posthog_api_key_here

Claude Desktop の設定

• Claude Desktop をインストールします。
• Claude Desktop の設定を開き、「編集設定」をクリックします。または、以下のパスでファイルを開くこともできます：
  • 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 Desktop を MCP クライアントとして設定する方法については、最新のドキュメント を参照してください。問題が発生した場合はこちらを確認してください。

💻 使用例

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

基本的な使用法

プロジェクトの一覧表示

Claude に以下を実行させます：

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

インサイトの取得と検索

Claude に以下を実行させます： "私の PostHog インサイトを一覧表示" または "PostHog で収入に関するインサイトを検索"

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

以下のように質問できます：

• "Nextjs で PostHog のリバースプロキシを設定する方法は？"

注釈の作成

プロジェクトリストから取得したプロジェクト ID を使用して、Claude に以下を実行させます：

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

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

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

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

• ハンマーアイコンが表示されない場合は、Claude Desktop を再起動してください。
• ログのパスを確認してください：~/Library/Logs/Claude/mcp*.log（macOS）または %APPDATA%\Claude\logs（Windows）
• PostHog API キーが正しい権限を持っていることを確認してください。
• claude_desktop_config.json 内のすべてのパスが絶対パスであることを確認してください。

🤝 コントリビューション

自由に問題や PR を提出してください！私たちは PostHog のコントリビューションガイドに従っています。