Posthog MCP

🚀 PostHog MCP 服務器 📊

這是一個與 PostHog 交互的模型上下文協議（MCP）服務器。藉助它，你可以通過 Claude 桌面直接創建註釋並管理項目！

🚀 快速開始

PostHog MCP 服務器能讓你通過 Claude 桌面與 PostHog 進行交互。完成安裝和配置後，即可在 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 項目"

創建註釋

使用從項目列表中獲得的項目 ID，詢問 Claude：

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

高級用法

獲取和搜索見解

詢問 Claude： "列出我的 PostHog 見解" 或 "在 PostHog 中搜索收入見解"

在線搜索文檔

您可以詢問：

• "如何在 Next.js 中使用反向代理在 PostHog 中？"

創建帶日期的註釋

指定具體日期，詢問 Claude：

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

🔍 故障排除

• 如果錘子圖標未出現，請重啟 Claude 桌面。
• 檢查日誌路徑：~/Library/Logs/Claude/mcp*.log（macOS）或 %APPDATA%\Claude\logs（Windows）。
• 確保 API 密鑰具有正確的權限。

⚠️ 重要提示

使用前請確保已正確設置環境變量，並檢查網絡連接。