Cara Memulai Server PostHog MCP

Siap meningkatkan permainan data Anda dengan AI? PostHog MCP Server memungkinkan Anda mengelola analitik PostHog—seperti membuat anotasi atau menanyakan tren pengguna—menggunakan bahasa alami di alat seperti Cline atau Cursor. Saya berhasil mengaktifkannya hanya dalam beberapa menit, dan ini benar-benar pengubah permainan! Dalam tutorial ini, kita akan menginstal PostHog MCP Server di Cline dalam VS Code dan Cursor, menjelajahi fitur-fitur unggulannya, dan melihat mengapa PostHog mengalahkan Google Analytics untuk analitik sumber terbuka. Mari selami keajaiban PostHog MCP Server!

💡

Ingin alat Pengujian API hebat yang menghasilkan Dokumentasi API yang indah?

Ingin platform All-in-One yang terintegrasi agar Tim Pengembang Anda dapat bekerja sama dengan produktivitas maksimal?

Apidog memenuhi semua permintaan Anda, dan menggantikan Postman dengan harga yang jauh lebih terjangkau!

tombol

Apa itu PostHog MCP Server?

PostHog MCP Server adalah server Model Context Protocol (MCP) sumber terbuka yang menghubungkan asisten AI (seperti Cline atau Cursor) ke platform analitik PostHog melalui perintah bahasa alami. Ini memungkinkan tugas-tugas seperti membuat anotasi, mengelola proyek, menanyakan wawasan, dan mengaktifkan/menonaktifkan *feature flag*—semuanya tanpa menyentuh UI PostHog. Fitur-fitur utamanya meliputi:

Manajemen Proyek: Daftar dan kelola proyek PostHog.
Anotasi: Tambahkan catatan berstempel waktu untuk peristiwa (misalnya, peluncuran produk).
Kueri Wawasan: Analisis perilaku pengguna (misalnya, tren pendaftaran).
*Feature Flag*: Kontrol dan kueri *feature flag* secara dinamis.
Pelacakan Kesalahan: Debug kesalahan langsung di IDE Anda.

Ini adalah "keharusan" untuk otomatisasi analitik, dengan 34+ bintang GitHub yang menunjukkan kecintaan komunitas. Siap mencobanya? Mari kita mulai

Mengapa Menggunakan PostHog MCP Server?

PostHog MCP Server menyederhanakan alur kerja analitik dengan otomatisasi berbasis AI. Inilah mengapa ini luar biasa:

Bahasa Alami: Kelola analitik dengan perintah sederhana.
Integrasi: Berfungsi dengan Claude Desktop, VS Code, Cursor, dan lainnya.
Sumber Terbuka (bagian terbaik): Gratis, dapat disesuaikan, dan digerakkan oleh komunitas.
Mengutamakan Privasi: Tidak seperti Google Analytics, PostHog menawarkan opsi *self-hosted* untuk kontrol data penuh.

Dibandingkan dengan Google Analytics, PostHog unggul dengan transparansi sumber terbukanya, fleksibilitas *self-hosting*, dan rangkaian produk all-in-one (analitik, *session replay*, *feature flag*). Google Analytics seringkali memerlukan integrasi pihak ketiga dan kurang fokus pada privasi seperti PostHog, menjadikan PostHog MCP Server alternatif yang ramah pengembang untuk tim modern.

Saya menggunakannya untuk membuat anotasi peluncuran produk dalam hitungan detik—jauh lebih cepat daripada mengklik melalui dasbor!

Cara Menginstal dan Menggunakan PostHog MCP Server: Panduan Langkah demi Langkah

Mari kita instal PostHog MCP Server di Cline dalam VS Code dan Cursor, lalu ujicoba dengan contoh. Anda akan membutuhkan Python, kunci API PostHog, dan IDE. Tidak perlu status guru analitik—ikuti saja!

1. Prasyarat

Python: 3.8+ (python3 --version).
uv: Manajer paket Python (pip install uv).
VS Code/Cursor: Versi terbaru dengan ekstensi Cline.
Kunci API PostHog: Dapatkan dari app.posthog.com/settings (Kunci API Pribadi).
Docker: Opsional untuk penyiapan terkonteinerisasi (docker --version).
Ruang Disk: ~500MB untuk repo dan dependensi.

2. Kloning Repositori PostHog MCP

Buka terminal Anda dan kloning repo:

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

Ini menarik proyek berukuran ~5MB. Membutuhkan beberapa detik di Wi-Fi.

3. Instal PostHog MCP Server dengan Cline di VS Code

Siapkan Lingkungan Virtual:

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

Konfigurasi Kunci API:
Buat file .env di root proyek:

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

Ganti your-personal-api-key dengan kunci API PostHog Anda (yang dapat Anda peroleh dari situs web resmi mereka).

Instal Cline:
Di VS Code, buka Ekstensi (Ctrl+Shift+X), instal Cline, dan buka panel obrolan Cline (Ctrl+Shift+P, “Cline: Buka Obrolan”).

Tambahkan MCP Server:
Minta Cline:

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

Cline menjalankan uv run posthog_mcp dan memperbarui ~/.aws/amazonq/mcp.json:

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

Ganti /path/to/mcp dengan jalur repo Anda (misalnya, /home/user/mcp).

Server mcp juga dapat ditemukan di marketplace mcp Cline. Cukup kunjungi dan cari "PostHog", lalu klik instal.

Cline akan secara otomatis melakukan instalasi untuk Anda

Verifikasi: Jalankan /tools di obrolan Cline untuk mencantumkan alat (misalnya, create_annotation, list_projects). Lihat ikon server mcp di Cline? Anda siap

4. Instal PostHog MCP Server dengan Cursor

Kloning dan Instal: Ulangi penyiapan kloning dan lingkungan virtual Langkah 2.
Konfigurasi Cursor:
Buka Cursor, buka Pengaturan > Alat & Integrasi > Alat MCP > Tambahkan Server MCP Kustom, dan tambahkan konfigurasi server ke .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"
      }
    }
  }
}

Temukan jalur uv dengan which uv (macOS/Linux) atau where uv (Windows).

Mulai Ulang Cursor: Klik tombol segarkan di Pengaturan > Alat & Integrasi > Alat MCP.
Verifikasi: Tanyakan pada Cursor: “Daftar alat PostHog MCP Server yang tersedia.” Seharusnya menampilkan create_annotation, list_projects, dll.

5. Uji Fitur PostHog MCP Server

Buat Anotasi:
Di Cline (VS Code) atau Cursor, minta:

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

Server memanggil API PostHog, menambahkan anotasi. Periksa app.posthog.com untuk konfirmasi.

Kueri Wawasan:
Minta:

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

Server mengambil data terstruktur (misalnya, JSON dengan tren pendaftaran). Contoh keluaran:

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

Saya menjalankan ini dan mendapatkan data bersih dalam ~5 detik—sangat mulus

6. Penyiapan Terkontainerisasi (Opsional)

Untuk penyiapan 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

Tambahkan ke mcp.json 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"
      }
    }
  }
}

Mulai ulang dan verifikasi seperti di atas. Pembersihan Docker (--rm) menghemat ruang disk saya

7. Pemecahan Masalah Umum

Tidak Ada Ikon Palu:
Periksa log: ~/Library/Logs/Claude/mcp*.log (macOS) atau %APPDATA%\Claude\logs (Windows).
Pastikan jalur absolut di mcp.json.
Kesalahan Kunci API:
Verifikasi izin kunci di app.posthog.com/settings.
Gunakan variabel lingkungan, bukan kunci yang dikodekan secara langsung.
Server Tidak Berjalan:
Jalankan uv run posthog_mcp secara manual untuk memeriksa kesalahan.
Pastikan Python 3.8+ dan dependensi (uv pip install .).
Butuh Bantuan? Periksa github.com/PostHog/mcp atau X untuk tips.

Mengapa PostHog Mengalahkan Google Analytics

PostHog MCP Server PostHog terintegrasi dengan platformnya, yang mengungguli Google Analytics dalam hal:

Sumber Terbuka: *Self-host* secara gratis, tidak seperti *lock-in* kepemilikan Google Analytics.
Privasi: Kontrol data dengan instans *self-hosted*; Google Analytics berbagi data dengan Google.
All-in-One: Analitik, *session replay*, *feature flag*, dan eksperimen dalam satu platform, dibandingkan dengan alat Google yang terfragmentasi.
Otomatisasi: PostHog MCP Server memungkinkan kueri bahasa alami, tidak seperti dasbor manual Google Analytics.
Komunitas: 1.500+ bintang GitHub dan dukungan aktif, menyaingi Google tetapi dengan fleksibilitas sumber terbuka.

Saya memindahkan proyek sampingan ke PostHog dan menyukai privasi serta kontrol *feature flag*—tidak ada *bloat* Google Analytics!

Menyesuaikan dan Memperluas PostHog MCP Server

Tingkatkan penyiapan Anda:

Alat Kustom: Tambahkan alat baru ke server (misalnya, wawasan SQL kustom) melalui github.com/PostHog/mcp.
Beberapa Proyek: Kueri semua proyek dengan “Daftar semua proyek di organisasi PostHog saya.”
*Feature Flag*: Hasilkan kode untuk mengaktifkan/menonaktifkan *flag*:

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

Berkontribusi: Kirim PR untuk meningkatkan server—PostHog menyambutnya

Mengapa PostHog MCP Server Wajib Dimiliki Pengembang

PostHog MCP Server membuat otomatisasi analitik terasa seperti mengobrol dengan seorang guru data. Antarmuka bahasa alaminya dan keunggulan sumber terbuka PostHog mengalahkan Google Analytics untuk tim yang peduli privasi. Penyiapan bisa jadi rumit (masalah kunci API!), tetapi dokumen PostHog dan komunitas adalah penyelamat.

Siap menggunakan PostHog MCP Server? Nyalakan Cline atau Cursor, kueri wawasan tersebut, dan bagikan kemenangan analitik Anda—saya sangat senang melihat penyiapan Anda bersinar!

💡

tombol