PostHog MCP Sunucusuna Nasıl Başlanır?

Veri oyununuzu yapay zeka ile süper şarj etmeye hazır mısınız? PostHog MCP Sunucusu, Cline veya Cursor gibi araçlarda doğal dil kullanarak PostHog analitiklerini (örneğin, ek açıklamalar oluşturma veya kullanıcı eğilimlerini sorgulama gibi) yönetmenizi sağlar. Sadece birkaç dakika içinde çalıştırdım ve bu tam bir oyun değiştirici! Bu eğitimde, VS Code ve Cursor'daki Cline'a PostHog MCP Sunucusu'nu kuracak, etkileyici özelliklerini keşfedecek ve PostHog'un açık kaynaklı analitikler için neden Google Analytics'i geride bıraktığını göreceğiz. PostHog MCP Sunucusu'nun büyüsüne dalalım!

PostHog MCP Sunucusu Nedir?

PostHog MCP Sunucusu, yapay zeka asistanlarını (Cline veya Cursor gibi) doğal dil komutları aracılığıyla PostHog'un analitik platformuna bağlayan açık kaynaklı bir Model Bağlam Protokolü (MCP) sunucusudur. Ek açıklamalar oluşturma, projeleri yönetme, içgörüleri sorgulama ve özellik bayraklarını açıp kapatma gibi görevleri PostHog'un kullanıcı arayüzüne dokunmadan yapmanızı sağlar. Başlıca özellikleri şunlardır:

• Proje Yönetimi: PostHog projelerini listeleyin ve yönetin.
• Ek Açıklamalar: Etkinlikler için zaman damgalı notlar ekleyin (örn. ürün lansmanları).
• İçgörü Sorguları: Kullanıcı davranışlarını analiz edin (örn. kayıt eğilimleri).
• Özellik Bayrakları: Özellik bayraklarını dinamik olarak kontrol edin ve sorgulayın.
• Hata Takibi: Hataları doğrudan IDE'nizde ayıklayın.

Analitik otomasyonu için bir “olmazsa olmaz”dır ve 34'ten fazla GitHub yıldızı topluluğun sevgisini göstermektedir. Denemeye hazır mısınız? Başlayalım

Neden PostHog MCP Sunucusu Kullanmalı?

PostHog MCP Sunucusu, yapay zeka destekli otomasyon ile analitik iş akışlarını basitleştirir. İşte neden harika olduğuna dair nedenler:

• Doğal Dil: Basit komutlarla analitikleri yönetin.
• Entegrasyon: Claude Desktop, VS Code, Cursor ve daha fazlasıyla çalışır.
• Açık Kaynak (en iyi yanı): Ücretsiz, özelleştirilebilir ve topluluk odaklı.
• Gizlilik Odaklı: Google Analytics'in aksine, PostHog tam veri kontrolü için kendi kendine barındırma seçenekleri sunar.

Google Analytics ile karşılaştırıldığında, PostHog açık kaynak şeffaflığı, kendi kendine barındırma esnekliği ve hepsi bir arada ürün paketi (analitikler, oturum tekrarı, özellik bayrakları) ile öne çıkıyor. Google Analytics genellikle üçüncü taraf entegrasyonları gerektirir ve PostHog'un gizlilik odaklı yaklaşımından yoksundur, bu da PostHog MCP Sunucusu'nu modern ekipler için geliştirici dostu bir alternatif haline getirir.

Bir ürün lansmanına saniyeler içinde ek açıklama eklemek için kullandım; panolarda tıklamaktan çok daha hızlı!

PostHog MCP Sunucusu Nasıl Kurulur ve Kullanılır: Adım Adım Kılavuz

VS Code ve Cursor'daki Cline'a PostHog MCP Sunucusu'nu kuralım, ardından örneklerle test edelim. Python, bir PostHog API anahtarı ve bir IDE'ye ihtiyacınız olacak. Analitik gurusu olmanıza gerek yok; takip edin!

1. Önkoşullar

• Python: 3.8+ (python3 --version).
• uv: Python paket yöneticisi (pip install uv).
• VS Code/Cursor: Cline uzantısı ile en son sürüm.
• PostHog API Anahtarı: app.posthog.com/settings adresinden bir tane edinin (Kişisel API Anahtarı).
• Docker: Kapsayıcılı kurulum için isteğe bağlı (docker --version).
• Disk Alanı: Depo ve bağımlılıklar için ~500MB.

2. PostHog MCP Deposunu Klonlama

Terminalinizi açın ve depoyu klonlayın:

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

Bu, yaklaşık 5MB'lık bir proje indirir. Wi-Fi üzerinden birkaç saniyemi aldı.

3. VS Code'da Cline ile PostHog MCP Sunucusunu Kurma

• Sanal Ortam Kurulumu:

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

• API Anahtarını Yapılandırma:
  Proje kökünde bir .env dosyası oluşturun:

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

your-personal-api-key yerine PostHog API anahtarınızı (kendi resmi web sitelerinden edinebilirsiniz) yazın.

• Cline Kurulumu:
  VS Code'da Uzantılar'a (Ctrl+Shift+X) gidin, Cline'ı kurun ve Cline sohbet panelini açın (Ctrl+Shift+P, “Cline: Sohbeti Aç”).

• MCP Sunucusu Ekleme:
  Cline'a komut verin:

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

Cline uv run posthog_mcp komutunu çalıştırır ve ~/.aws/amazonq/mcp.json dosyasını günceller:

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

/path/to/mcp yerine depo yolunuzu yazın (örn. /home/user/mcp).

MCP sunucusu Cline'ın MCP pazarında da bulunabilir. Oraya gidin ve "PostHog" aratın, ardından yükle'ye tıklayın.

Cline kurulumu sizin için otomatik olarak gerçekleştirecektir.

• Doğrulama: Cline'ın sohbetinde araçları listelemek için /tools komutunu çalıştırın (örn. create_annotation, list_projects). Cline'daki mcp sunucuları simgesini görüyor musunuz? Hazırsınız.

4. Cursor ile PostHog MCP Sunucusunu Kurma

• Klonlama ve Kurulum: 2. Adım'daki klonlama ve sanal ortam kurulumunu tekrarlayın.
• Cursor'ı Yapılandırma:
  Cursor'ı açın, Ayarlar > Araçlar ve Entegrasyonlar > MCP Araçları > Özel Bir MCP Sunucusu Ekle'ye gidin ve sunucu yapılandırmasını .cursor/mcp.json dosyasına ekleyin:

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

uv yolunu which uv (macOS/Linux) veya where uv (Windows) ile bulun.

• Cursor'ı Yeniden Başlatın: Ayarlar > Araçlar ve Entegrasyonlar > MCP Araçları'ndaki yenile düğmesine tıklayın.
• Doğrulama: Cursor'a sorun: “Mevcut PostHog MCP Sunucusu araçlarını listele.” create_annotation, list_projects vb. göstermelidir.

5. PostHog MCP Sunucusu Özelliklerini Test Etme

• Ek Açıklama Oluşturma:
  Cline (VS Code) veya Cursor'da komut verin:

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

Sunucu, PostHog'un API'sini çağırarak ek açıklamayı ekler. Onaylamak için app.posthog.com adresini kontrol edin.

• İçgörüleri Sorgulama:
  Komut verin:

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

Sunucu yapılandırılmış verileri (örn. kayıt eğilimleri içeren JSON) getirir. Örnek çıktı:

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

Bunu çalıştırdım ve yaklaşık 5 saniyede temiz veriler aldım; süper akıcı.

6. Kapsayıcılı Kurulum (İsteğe Bağlı)

Bir Docker kurulumu için:

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

Cline/Cursor'ın mcp.json dosyasına ekleyin:

{
  "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"
      }
    }
  }
}

Yukarıdaki gibi yeniden başlatın ve doğrulayın. Docker'ın temizliği (--rm) disk alanımdan tasarruf etmemi sağladı.

7. Sık Karşılaşılan Sorunları Giderme

• Çekiç Simgesi Yok:
• Günlükleri kontrol edin: ~/Library/Logs/Claude/mcp*.log (macOS) veya %APPDATA%\Claude\logs (Windows).
• mcp.json dosyasında mutlak yolların olduğundan emin olun.
• API Anahtarı Hataları:
• app.posthog.com/settings adresinde anahtar izinlerini doğrulayın.
• Sabit kodlanmış anahtarlar yerine ortam değişkenleri kullanın.
• Sunucu Çalışmıyor:
• Hataları kontrol etmek için uv run posthog_mcp komutunu manuel olarak çalıştırın.
• Python 3.8+ ve bağımlılıkların (uv pip install .) olduğundan emin olun.
• Yardıma mı İhtiyacınız Var? İpuçları için github.com/PostHog/mcp veya X'i kontrol edin.

PostHog Neden Google Analytics'i Geride Bırakıyor?

PostHog'un PostHog MCP Sunucusu, Google Analytics'i şu konularda geride bırakan kendi platformuyla entegre olur:

• Açık Kaynak: Google Analytics'in tescilli kilitlenmesinin aksine, ücretsiz olarak kendi kendinize barındırın.
• Gizlilik: Kendi kendine barındırılan örneklerle verileri kontrol edin; Google Analytics verileri Google ile paylaşır.
• Hepsi Bir Arada: Google'ın parçalanmış araçlarının aksine, analitikler, oturum tekrarı, özellik bayrakları ve deneyler tek bir platformda.
• Otomasyon: PostHog MCP Sunucusu, Google Analytics'in manuel panolarının aksine doğal dil sorgularına olanak tanır.
• Topluluk: 1.500'den fazla GitHub yıldızı ve aktif destek, Google'ınkine rakip ama açık kaynak esnekliğiyle.

Bir yan projeyi PostHog'a geçirdim ve gizlilik ile özellik bayrağı kontrolünü çok sevdim; Google Analytics şişkinliği yok!

PostHog MCP Sunucusunu Özelleştirme ve Genişletme

Kurulumunuzu geliştirin:

• Özel Araçlar: github.com/PostHog/mcp aracılığıyla sunucuya yeni araçlar (örn. özel SQL içgörüleri) ekleyin.
• Birden Fazla Proje: "PostHog organizasyonumdaki tüm projeleri listele." ile tüm projeleri sorgulayın.
• Özellik Bayrakları: Bayrakları değiştirmek için kod oluşturun:

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

• Katkıda Bulunma: Sunucuyu geliştirmek için PR'lar gönderin—PostHog bunları memnuniyetle karşılar.

PostHog MCP Sunucusu Neden Geliştiriciler İçin Olmazsa Olmazdır?

PostHog MCP Sunucusu, analitik otomasyonunu bir veri gurusuyla sohbet ediyormuş gibi hissettirir. Doğal dil arayüzü ve PostHog'un açık kaynak avantajı, gizliliğe önem veren ekipler için Google Analytics'i geride bırakır. Kurulum zorlu olabilir (API anahtarı sorunları!), ancak PostHog belgeleri ve topluluğu cankurtarandır.

PostHog MCP Sunucusu'nu kullanmaya hazır mısınız? Cline veya Cursor'ı başlatın, o içgörüleri sorgulayın ve analitik başarılarınızı paylaşın—kurulumunuzun parladığını görmek beni heyecanlandırıyor!