Hướng Dẫn Bắt Đầu Sử Dụng PostHog MCP Server

Sẵn sàng tăng cường khả năng xử lý dữ liệu của bạn với AI? PostHog MCP Server cho phép bạn quản lý phân tích PostHog—như tạo chú thích hoặc truy vấn xu hướng người dùng—bằng ngôn ngữ tự nhiên trong các công cụ như Cline hoặc Cursor. Tôi đã cài đặt và chạy nó chỉ trong vài phút, và nó thực sự thay đổi cuộc chơi! Trong hướng dẫn này, chúng ta sẽ cài đặt PostHog MCP Server trên Cline trong VS Code và Cursor, khám phá các tính năng nổi bật của nó, và xem tại sao PostHog vượt trội hơn Google Analytics về phân tích mã nguồn mở. Hãy cùng khám phá sự kỳ diệu của PostHog MCP Server!

💡

Bạn muốn một công cụ kiểm thử API tuyệt vời có thể tạo Tài liệu API đẹp mắt?

Bạn muốn một nền tảng tích hợp, tất cả trong một để Đội ngũ Phát triển của bạn làm việc cùng nhau với năng suất tối đa?

Apidog đáp ứng mọi yêu cầu của bạn, và thay thế Postman với mức giá phải chăng hơn nhiều!

nút

PostHog MCP Server là gì?

PostHog MCP Server là một máy chủ Giao thức Ngữ cảnh Mô hình (MCP) mã nguồn mở kết nối các trợ lý AI (như Cline hoặc Cursor) với nền tảng phân tích của PostHog thông qua các lệnh ngôn ngữ tự nhiên. Nó cho phép thực hiện các tác vụ như tạo chú thích, quản lý dự án, truy vấn thông tin chi tiết và bật/tắt cờ tính năng—tất cả mà không cần chạm vào giao diện người dùng của PostHog. Các tính năng chính bao gồm:

Quản lý Dự án: Liệt kê và quản lý các dự án PostHog.
Chú thích: Thêm ghi chú có dấu thời gian cho các sự kiện (ví dụ: ra mắt sản phẩm).
Truy vấn Thông tin chi tiết: Phân tích hành vi người dùng (ví dụ: xu hướng đăng ký).
Cờ Tính năng: Kiểm soát và truy vấn các cờ tính năng một cách linh hoạt.
Theo dõi Lỗi: Gỡ lỗi trực tiếp trong IDE của bạn.

Đây là một công cụ “phải có” để tự động hóa phân tích, với hơn 34 lượt gắn sao trên GitHub thể hiện sự yêu thích của cộng đồng. Sẵn sàng dùng thử chưa? Hãy bắt đầu nào!

Tại sao nên sử dụng PostHog MCP Server?

PostHog MCP Server đơn giản hóa quy trình làm việc phân tích với tự động hóa dựa trên AI. Đây là lý do tại sao nó tuyệt vời:

Ngôn ngữ Tự nhiên: Quản lý phân tích bằng các lệnh đơn giản.
Tích hợp: Hoạt động với Claude Desktop, VS Code, Cursor, và nhiều công cụ khác.
Mã nguồn Mở (phần tốt nhất): Miễn phí, có thể tùy chỉnh và được cộng đồng phát triển.
Ưu tiên Quyền riêng tư: Không giống như Google Analytics, PostHog cung cấp các tùy chọn tự lưu trữ để kiểm soát dữ liệu hoàn toàn.

So với Google Analytics, PostHog nổi bật với tính minh bạch mã nguồn mở, tính linh hoạt khi tự lưu trữ và bộ sản phẩm tất cả trong một (phân tích, phát lại phiên, cờ tính năng). Google Analytics thường yêu cầu tích hợp bên thứ ba và thiếu sự tập trung vào quyền riêng tư như PostHog, khiến PostHog MCP Server trở thành một lựa chọn thân thiện với nhà phát triển cho các đội ngũ hiện đại.

Tôi đã dùng nó để chú thích một lần ra mắt sản phẩm chỉ trong vài giây—nhanh hơn nhiều so với việc nhấp chuột qua các bảng điều khiển!

Cách cài đặt và sử dụng PostHog MCP Server: Hướng dẫn từng bước

Hãy cài đặt PostHog MCP Server trên Cline trong VS Code và Cursor, sau đó kiểm tra nó bằng các ví dụ. Bạn sẽ cần Python, khóa API PostHog và một IDE. Không yêu cầu phải là chuyên gia phân tích—hãy làm theo nhé!

1. Điều kiện tiên quyết

Python: 3.8+ (python3 --version).
uv: Trình quản lý gói Python (pip install uv).
VS Code/Cursor: Phiên bản mới nhất với tiện ích mở rộng Cline.
Khóa API PostHog: Lấy từ app.posthog.com/settings (Khóa API Cá nhân).
Docker: Tùy chọn cho thiết lập container hóa (docker --version).
Dung lượng Đĩa: ~500MB cho kho lưu trữ và các phụ thuộc.

2. Sao chép kho lưu trữ PostHog MCP

Mở terminal của bạn và sao chép kho lưu trữ:

git clone https://github.com/PostHog/mcp.git
cd mcp

Thao tác này tải xuống một dự án khoảng 5MB. Tôi mất vài giây trên Wi-Fi.

3. Cài đặt PostHog MCP Server với Cline trong VS Code

Thiết lập Môi trường Ảo:

uv venv
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate  # Windows
uv pip install .

Cấu hình Khóa API:
Tạo một tệp .env trong thư mục gốc của dự án:

echo "PERSONAL_API_KEY=your-personal-api-key" > .env

Thay thế your-personal-api-key bằng khóa API PostHog của bạn (bạn có thể lấy từ trang web chính thức của họ).

Cài đặt Cline:
Trong VS Code, vào Extensions (Ctrl+Shift+X), cài đặt Cline, và mở bảng trò chuyện Cline (Ctrl+Shift+P, “Cline: Open Chat”).

Thêm MCP Server:
Nhập lệnh cho Cline:

Install the PostHog MCP Server using uv and configure it with my API key.

Cline chạy uv run posthog_mcp và cập nhật ~/.aws/amazonq/mcp.json:

{
  "mcpServers": {
    "posthog": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp", "run", "posthog_mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

Thay thế /path/to/mcp bằng đường dẫn kho lưu trữ của bạn (ví dụ: /home/user/mcp).

Máy chủ mcp cũng có thể được tìm thấy trên marketplace mcp của Cline. Đơn giản chỉ cần truy cập vào đó và tìm kiếm "PostHog", sau đó nhấp vào cài đặt.

Cline sẽ tự động thực hiện cài đặt cho bạn

Xác minh: Chạy /tools trong trò chuyện của Cline để liệt kê các công cụ (ví dụ: create_annotation, list_projects). Bạn thấy biểu tượng máy chủ mcp trong Cline chứ? Bạn đã sẵn sàng!

4. Cài đặt PostHog MCP Server với Cursor

Sao chép và Cài đặt: Lặp lại bước sao chép và thiết lập môi trường ảo của Bước 2.
Cấu hình Cursor:
Mở Cursor, đi tới Settings > Tools & Integrations > MCP Tools > Add a Custom MCP Server, và thêm cấu hình máy chủ vào .cursor/mcp.json:

{
  "mcpServers": {
    "posthog": {
      "command": "/path/to/uv",
      "args": ["--directory", "/path/to/mcp", "run", "posthog_mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

Tìm đường dẫn uv bằng which uv (macOS/Linux) hoặc where uv (Windows).

Khởi động lại Cursor: Nhấp vào nút làm mới trong Settings > Tools & Integrations > MCP Tools.
Xác minh: Hỏi Cursor: “Liệt kê các công cụ PostHog MCP Server có sẵn.” Nó sẽ hiển thị create_annotation, list_projects, v.v.

5. Kiểm tra các tính năng của PostHog MCP Server

Tạo chú thích:
Trong Cline (VS Code) hoặc Cursor, nhập lệnh:

Create a PostHog annotation in project 53497 for March 20th, 2025, with the description 'Launched new user onboarding flow' using the PostHog MCP Server.

Máy chủ gọi API của PostHog, thêm chú thích. Kiểm tra app.posthog.com để xác nhận.

Truy vấn thông tin chi tiết:
Nhập lệnh:

Show the trend of user sign-ups in project 98765 over the last 30 days using 
the PostHog MCP Server.

Máy chủ lấy dữ liệu có cấu trúc (ví dụ: JSON với xu hướng đăng ký). Ví dụ đầu ra:

{
  "insight": "user_signups",
  "project_id": 98765,
  "data": [
    {"date": "2025-06-01", "count": 120},
    {"date": "2025-06-02", "count": 135}
  ]
}

Tôi đã chạy lệnh này và nhận được dữ liệu sạch chỉ trong khoảng 5 giây—rất mượt mà!

6. Thiết lập Container hóa (Tùy chọn)

Đối với thiết lập Docker:

docker run -i --rm -e PERSONAL_API_KEY=your-personal-api-key ghcr.io/metorial/mcp-container--posthog--posthog-mcp--posthog-mcp posthog-mcp

Thêm vào mcp.json của Cline/Cursor:

{
  "mcpServers": {
    "posthog": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/metorial/mcp-container--posthog--posthog-mcp--posthog-mcp", "posthog-mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

Khởi động lại và xác minh như trên. Tính năng dọn dẹp của Docker (--rm) đã giúp tôi tiết kiệm dung lượng đĩa.

7. Khắc phục sự cố thường gặp

Không có biểu tượng búa:
Kiểm tra nhật ký: ~/Library/Logs/Claude/mcp*.log (macOS) hoặc %APPDATA%\Claude\logs (Windows).
Đảm bảo các đường dẫn tuyệt đối trong mcp.json.
Lỗi Khóa API:
Xác minh quyền của khóa trong app.posthog.com/settings.
Sử dụng biến môi trường, không phải khóa được mã hóa cứng.
Máy chủ không chạy:
Chạy uv run posthog_mcp thủ công để kiểm tra lỗi.
Đảm bảo Python 3.8+ và các phụ thuộc (uv pip install .).
Cần trợ giúp? Kiểm tra github.com/PostHog/mcp hoặc X để biết các mẹo.

Tại sao PostHog vượt trội hơn Google Analytics

PostHog MCP Server của PostHog tích hợp với nền tảng của nó, vượt trội hơn Google Analytics ở các điểm sau:

Mã nguồn Mở: Tự lưu trữ miễn phí, không như Google Analytics bị khóa độc quyền.
Quyền riêng tư: Kiểm soát dữ liệu với các phiên bản tự lưu trữ; Google Analytics chia sẻ dữ liệu với Google.
Tất cả trong một: Phân tích, phát lại phiên, cờ tính năng và thử nghiệm trên một nền tảng duy nhất, trái ngược với các công cụ rời rạc của Google.
Tự động hóa: PostHog MCP Server cho phép truy vấn bằng ngôn ngữ tự nhiên, không như các bảng điều khiển thủ công của Google Analytics.
Cộng đồng: Hơn 1.500 lượt gắn sao trên GitHub và hỗ trợ tích cực, cạnh tranh với Google nhưng với sự linh hoạt của mã nguồn mở.

Tôi đã chuyển một dự án phụ sang PostHog và rất thích quyền riêng tư cùng khả năng kiểm soát cờ tính năng—không còn sự cồng kềnh của Google Analytics!

Tùy chỉnh và Mở rộng PostHog MCP Server

Nâng cấp thiết lập của bạn:

Công cụ Tùy chỉnh: Thêm các công cụ mới vào máy chủ (ví dụ: thông tin chi tiết SQL tùy chỉnh) qua github.com/PostHog/mcp.
Nhiều Dự án: Truy vấn tất cả các dự án với “Liệt kê tất cả các dự án trong tổ chức PostHog của tôi.”
Cờ Tính năng: Tạo mã để bật/tắt cờ:

Generate a Python snippet to toggle feature flag 'new-ui' in project 12345
using the PostHog MCP Server.

Đóng góp: Gửi PR để cải thiện máy chủ—PostHog luôn hoan nghênh.

Tại sao PostHog MCP Server là công cụ không thể thiếu cho nhà phát triển

PostHog MCP Server khiến việc tự động hóa phân tích trở nên giống như trò chuyện với một chuyên gia dữ liệu. Giao diện ngôn ngữ tự nhiên và lợi thế mã nguồn mở của PostHog vượt trội hơn Google Analytics đối với các đội ngũ quan tâm đến quyền riêng tư. Thiết lập có thể hơi phức tạp (những rắc rối về khóa API!), nhưng tài liệu PostHog và cộng đồng là những cứu tinh.

Sẵn sàng để làm chủ PostHog MCP Server chưa? Khởi động Cline hoặc Cursor, truy vấn những thông tin chi tiết đó, và chia sẻ thành công phân tích của bạn—tôi rất mong được thấy thiết lập của bạn tỏa sáng!

💡

nút