Liquidium MCP サーバー

Liquidium を介して PostHog アナリティクスと連携するための Model Context Protocol (MCP) サーバー。Claude Desktop または Smithery から直接アノテーションを作成し、プロジェクトを管理できます。

特徴

プロジェクトの一覧: 組織内で利用可能なすべての PostHog プロジェクトを表示します
注釈の作成: オプションのタイムスタンプを使用して、PostHogプロジェクトに注釈を追加します。
インサイトの一覧表示と検索: PostHog プロジェクトのインサイトを表示および検索します
インサイトの詳細を取得: 特定のインサイトに関する詳細情報を表示します

Related MCP server: PostHog MCP Server

設定

オプション 1: 鍛冶屋 (推奨)

Liquidium MCP を使用する最も簡単な方法は、Smithery を使用することです。

SmitheryのLiquidium MCPをご覧ください
「Claudeに追加」をクリック
プロンプトが表示されたらPostHog APIキーを入力してください
Claude で Liquidium ツールを使い始めましょう!

オプション2: ローカルインストール

前提条件
- Python 3.10以上
- pipまたはuvパッケージマネージャー
- プロジェクト設定から取得したannotation:writeおよびproject:readスコープを含むPostHog APIキー
インストール
# clone the repo git clone https://github.com/Shudufhadzo/liquidium-mcp.git cd liquidium-mcp # Create and activate virtual environment python -m venv .venv # On Windows .venv\Scripts\activate # On macOS/Linux source .venv/bin/activate # Install dependencies pip install -e .
構成
- プロジェクトルートに.envファイルを作成します。
  PERSONAL_API_KEY=phx_your_posthog_api_key_here
クロードデスクトップセットアップ
- 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/python", # Get this by running: which python "args": [ "-m", "posthog_mcp", "--directory", "/path/to/your/posthog-mcp" # Full path to this project ] } } }
  問題が発生した場合は、Claude Desktop を MCP クライアントとして設定する方法についての最新のドキュメントを確認してください。

使用法

セットアップ後、Claude Desktopにハンマーアイコンが表示されます。以下のコマンドが利用可能です。

プロジェクトの一覧

クロードに聞く:

"List my PostHog projects"

洞察の取得と検索

クロードに聞く:

「PostHogのインサイトを一覧表示する」または「PostHogで収益インサイトを検索する」

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

次のように尋ねることができます。

「posthog の nextjs でリバースプロキシを実行するにはどうすればいいですか?」

注釈を作成

プロジェクトリストから取得したプロジェクト ID を使用して、Claude に質問します。

"Create a PostHog annotation in project 53497 saying 'Deployed v1.2.3'"

または特定の日付で:

"Create a PostHog annotation in project 53497 for March 20th saying 'Started new marketing campaign'"

トラブルシューティング

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