Posthog

🚀 PostHog MCP 服務器 📊

PostHog MCP 服務器是一個用於與 PostHog 交互的模型上下文協議 (MCP) 服務器。藉助它，你可以通過 Claude Desktop 直接創建註釋並管理項目，為項目管理帶來極大便利。

🚀 快速開始

PostHog MCP 服務器能讓你通過 Claude Desktop 與 PostHog 進行交互，實現項目管理和註釋創建等功能。完成安裝和配置後，即可在 Claude Desktop 中使用相關命令操作 PostHog。

✨ 主要特性

• 列出項目：可查看您組織中所有可用的 PostHog 項目。
• 創建註釋：能向您的 PostHog 項目添加註釋，還可選擇帶有時間戳。 [此列表還可以更長，基本上我們 API 提供的所有功能...]

📦 安裝指南

1. 先決條件

• Python 3.10 或更高版本。
• uv 包管理器。
• 具備 annotation:write 和 project:read 權限的 PostHog API Key，可從您的 項目設置 獲取。

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 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 項目"

創建註釋

使用從項目列表中獲得的項目 ID，請 Claude 執行：

"在項目 53497 中創建一條 PostHog 註釋，內容為 '部署了 v1.2.3'"

高級用法

獲取和搜索見解

請 Claude 執行： "列出我的 PostHog 見解" 或 "在 PostHog 中搜索收入見解"

在線搜索文檔

您可以詢問：

• "如何在 Nextjs 中為 PostHog 設置反向代理？"

創建帶日期的註釋

指定日期創建註釋：

"在項目 53497 中於 3月20日 創建一條註釋，內容為 '啟動新的營銷活動'"

📚 詳細文檔

故障排除

• 如果錘子圖標未出現，請重啟 Claude Desktop。
• 檢查日誌路徑：~/Library/Logs/Claude/mcp*.log（macOS）或 %APPDATA%\Claude\logs（Windows）。
• 確保您的 PostHog API Key 具有正確的權限。
• 確保 claude_desktop_config.json 中的所有路徑都是絕對路徑。

貢獻

隨意提出問題和 PR！我們遵循 PostHog 的貢獻指南。